Hata ayıklama

2 dakika okuma

İçindekiler

Hata kaydı
Hata kontrolü
Eklenti parametreleri
Ek dokümantasyon
İnceleme için sahne dosyasını kaydedin.
Koordinat sistemi

Bu bölüm, V-Ray ve Uygulama SDK’sı için bazı sorun giderme ipuçları içermektedir.

Hata kaydı #

V-Ray’in hata ve uyarılarını her zaman takip etmek için LogMessage geri çağırma işlevini kullanın. Aşağıdaki örnekte, bunun nasıl yapıldığını ve farklı günlük seviyelerinin nasıl yorumlandığını gösteriyoruz:

def logMessage(renderer, message, level, instant):

if level == vray.LOGLEVEL_ERROR:

print("[ERROR]", message)

elif level == vray.LOGLEVEL_WARNING:

print("[Warning]", message)

elif level == vray.LOGLEVEL_INFO:

print("[info]", message)

# Uncomment for testing, but you might want to ignore these in real code

#else: print("[debug]", message)

# It's recommended to always have a console log

renderer.setOnLogMessage(logMessage)

# Returns the last error that occurred when a method was called. Use this to understand why a method returned false.

err = renderer.lastError

void logMessage(VRay::VRayRenderer &renderer, const char* message, VRay::MessageLevel level, double instant, void* userData) {

switch (level) {

case VRay::MessageError:

printf("[ERROR] %s\

", message);

break;

case VRay::MessageWarning:

printf("[Warning] %s\

", message);

break;

case VRay::MessageInfo:

printf("[info] %s\

", message);

break;

case VRay::MessageDebug:

// Uncomment for testing, but you might want to ignore these in real code

//printf("[debug] %s\

", message);

break;

}

// It's recommended to always have a console log

renderer.setOnLogMessage(logMessage);

// Returns the last error that occurred when a method was called. Use this to understand why a method returned false.

VRayRenderer::Error err = renderer.getLastError();

// It's recommended to always have a console log

renderer.LogMessage += new EventHandler<MessageEventArgs>((source, e) =>

{

// You can remove the if for testing, but you might want to ignore Debug in real code

if (e.LogLevel != LogLevelType.Debug)

{

Console.WriteLine(String.Format("[{0}] {1}", e.LogLevel.ToString(), e.Message));

}

});

// Returns the last error that occurred when a method was called. Use this to understand why a method returned false.

Error err = renderer.LastError;

// It's recommended to always have a console log

renderer.on('logMessage', function (message, level, instant) {

if (level == vray.LOGLEVEL_ERROR)

console.log("[ERROR] ", message);

else if (level == vray.LOGLEVEL_WARNING)

console.log("[Warning] ", message);

else if (level == vray.LOGLEVEL_INFO)

console.log("[info] ", message);

// Uncomment for testing, but you might want to ignore these in real code

//else console.log("[debug] ", message);

});

// Returns the last error that occurred when a method was called. Use this to understand why a method returned false.

var err = renderer.lastError;

Hata kontrolü #

Başarısız olabilecek yöntemlerin çoğunun en azından bir boolean dönüş değeri vardır, bu nedenle sorunlarla karşılaştığınızda bunu kontrol ettiğinizden emin olun.

Eklenti parametreleri #

SDK’nın ikili dosya klasöründe bulunan plgparams.exe, temel parametre bilgileri için oldukça kullanışlı bir araçtır. Belirtilen eklentinin (veya -list ile tüm eklentilerin) tüm parametrelerini, türlerini, varsayılan değerlerini ve metin yorumlarını listeler. Benzer bilgiler, Temel Bilgiler bölümünde ele alınan eklenti ve parametre meta-bilgi API’si kullanılarak da elde edilebilir. C++ klasöründeki ListAllPluginsAndProperties örneği (veya başka bir dil için eşdeğer kod) bu API’yi kullanır.

Parametre bilgileri, C++ ve .Net somut Eklenti sınıflarının yorumlarında da (IDE’de ipucu olarak) mevcuttur.

Ek dokümantasyon #

Uygulama SDK’sı ve bu kendi kendine eğitim programıyla birlikte gelen dokümantasyonun yanı sıra, docs.chaosgroup.com adresindeki 3dsMax ve Maya yardım sayfaları da parametre bilgileri ve örnekleri için iyi bir kaynaktır; ancak bu sayfalarda tür ve parametre adları ilgili uygulamanın kullanıcı arayüzündeki halleriyle kullanılır – bunlar genellikle benzerdir ancak altta yatan V-Ray eklentilerinden farklıdır.

İnceleme için sahne dosyasını kaydedin. #

Sahnenizi bir dosyaya kaydedip her şeyi doğru yapıp yapmadığınızı kontrol etmek genellikle faydalıdır. Örneğin, bazı parametreleri doğru şekilde ayarlayamamış olabilirsiniz ve bunu dosyada eksik veya yanlış bir değer olarak görebilirsiniz; ancak kodunuzda (setValue kullanırken) ayarlama işleminin sonucunu da kontrol edebilirsiniz. Sahne dosyasının bazı bölümlerini (parametreler veya tüm eklentiler) silerek ve yeniden render alarak sorunları belirlemeye çalışabilirsiniz.

Eğer 3dsMax veya Maya için bir V-Ray’iniz varsa ve bunu kullanarak vrscene dosyalarını dışa aktarıyorsanız, hangi eklentilerin ve parametrelerin yazıldığını görmek çok faydalı olabilir. 3dsMax ve Maya için dışa aktarıcılar “gerçek referans” olarak kabul edilebilir (ara sıra bir hata veya eksik özellik içerebilseler bile).

Koordinat sistemi #

Siyah bir görüntü alıyorsanız, kameranızın doğru konumlandırıldığından ve yönlendirildiğinden, bir nesnenin içinde olmadığından emin olun. Varsayılan yukarı eksenin Z olduğunu, ancak genellikle Y olmak üzere başka bir değere ayarlanabileceğini unutmayın. Ayrıca, bağlı materyalde bir sorun varsa görünmez veya siyah nesneler de alabilirsiniz. Bu durumda, arkasında hiçbir şey yoksa nesneyi alfa kanalında hala görebilirsiniz – ortamın alfa değeri 0’dır.

Ayrıca V-Ray’in sütun öncelikli matrisler kullandığını da unutmayın (OpenGL gibi, ancak DirectX’ten farklı olarak)