MAXScript

VFB ve İşleme

showVfb

<boolean>göster</boolean>

VFB penceresini görüntüler veya gizler. Argüman doğru olduğunda, bu fonksiyonu çağırmak, kullanıcı arayüzündeki “VFB’yi Göster” düğmesine tıklamakla aynıdır.

resumeRender

Son oluşturulan görüntüyü devam ettirir. İşlemler sekmesindeki “Son oluşturulan görüntüyü devam ettir” düğmesine tıklamakla aynı işlevi görür.

Yükle ve Devam Et

<string>dosya adı</string>

resumeRender ile aynı işlevi görür, ancak önceden kaydedilmiş bir EXR dosyasından son render işlemini yükler.

dumpVfb

<string>dosya adı</string>

Geçerli VFB içeriğini, daha sonra loadAndResume kullanılarak devam ettirilebilmesi için belirtilen dosyaya kaydeder.

setDisplayedChannel

<tamsayı>kanal

Corona VFB kullanılıyorsa, şu anda görüntülenen kanalı ayarlar. 0 güzellik kanalı, 1 alfa kanalıdır ve daha yüksek değerler ek render geçişleridir.

getVfbContent

<integer>kanal <boolean>ton eşleme <boolean>renderStamp

Geçerli çerçeve arabelleğinden tek bir işleme kanalına sahip bir bitmap döndürür. İsteğe bağlı olarak ton eşleme ve işleme damgası da içerebilir. Tamsayı kodu döndürmez, doğrudan bitmap’i (veya çağrı başarısız olursa null) döndürür.

İstatistik al

<tamsayı>istatistikKimliği

Bu makalede yer alan “İstatistik Kimliği” tablosundaki istatistiklerden birini çift hassasiyetli kayan noktalı biçimde döndürür. Şu anda etkin olan veya son render işleminden elde edilen sonuçları döndürür. Oturumda henüz bir render işlemi gerçekleşmediyse veya son render işleminden sonra 3dsmax sıfırlandıysa/render motoru değiştirildiyse, sonuçlar tanımsızdır.

etkileşimli başlat

Corona VFB’de etkileşimli görüntülemeyi başlatır.

startInteractiveDocked

Corona görünüm penceresine kenetlenmiş VFB’de etkileşimli oluşturmayı başlatır. Bu yöntemin çalışması için görünüm penceresinin (genişletilmiş görünüm) mevcut ve etkin olmaması gerekir. Komut aşağıdaki kodları döndürür:
0 – Başarılı
1 – Başarısız – Corona etkin oluşturucu olarak seçilmedi
2 – Başarısız – Corona zaten oluşturma yapıyor
3 – Başarısız – Geçerli kenetlenmiş pencere yok

stopRender

Devam eden tüm render işlemlerini durdurur.

yeniden ayrıştırmaEtkileşimli

Etkileşimli render işlemi devam ederken, tüm sahneyi yeniden ayrıştırır ve etkileşimli render işlemini yeniden başlatır.

getRenderType

Şu anda herhangi bir render işlemi gerçekleşmiyorsa 0, çevrimdışı (etkileşimli olmayan render) için 1, kenetlenmiş VFB ile etkileşimli render için 2 ve normal Corona VFB’de etkileşimli render için 3 değerini döndürür.

Tüm öğeleri kaydet

<string>dosya adı</string>

Tüm render öğelerini belirtilen konuma kaydeder – tıpkı Corona VFB düğme işlevini kullanırken olduğu gibi. Sağlanan parametre, güzellik kanalının dosya adıdır, diğer dosya adları bundan türetilir.

Ayarları sıfırla

Görüntüleme ayarlarını varsayılan değerlere sıfırlar. İşlemler sekmesindeki “Ayarları Sıfırla” düğmesine tıklamakla aynı işlevi görür.

LightMix

Not: MAXScript’i LightMix ile kullanabilmek için en az bir kez render işlemini başlatmanız gerekmektedir. Kullanım örnekleri için aşağıdaki Örnek Komut Dosyaları bölümüne bakın.

ışık seçimini etkinleştir

<tamsayı>lightMixChannel

<tamsayı>ışıkSeçimKanalı

<boolean>etkinleştir</boolean>

Belirtilen LightMix kurulumunun belirtilen LightSelect öğesini etkinleştirir veya devre dışı bırakır.

setLightSelectIntensity

<tamsayı>lightMixChannel

<tamsayı>ışıkSeçimKanalı

<float>yoğunluk

Belirtilen LightMix kurulumunun belirli LightSelect öğesinin yoğunluk değerini ayarlar.

setLightSelectTint

<tamsayı>lightMixChannel

<tamsayı>ışıkSeçimKanalı

<RGBA>tonu

Belirtilen LightMix kurulumunun belirtilen LightSelect öğesi için renk tonunu ayarlar.

numLightMixChannels

LightMix öğelerinin sayısını döndürür. Tüm LightMix öğeleri üzerinde yineleme yapmak için bir döngü içinde kullanılabilir.

numLightSelectChannels

LightSelect öğelerinin sayısını döndürür. Tüm LightSelect öğeleri üzerinde yineleme yapmak için bir döngü içinde kullanılabilir.

getLightSelectName

<tamsayı>ışıkSeçimKanalı

i-inci LightSelect öğesinin adını alır. Bu, tüm render öğeleri arasında değil, yalnızca LightSelect öğeleri arasında bir dizindir. 0 tabanlıdır (0 ilk öğedir). Verilen dizine sahip bir öğe yoksa (örneğin, yalnızca 1 LightSelect öğeniz varsa ve argüman olarak 1 geçerseniz) null döndürür.

setDisplayedLightMixChannel

<tamsayı>lightMixChannel

Corona VFB’deki i-inci LightMix öğesini görüntüler. Bu, tüm render öğeleri arasında değil, yalnızca LightMix öğeleri arasındaki indekstir. 0 tabanlıdır (0 ilk öğedir).

showLightMixSetupDialog

Şu anda render işlemi yapılmıyorsa LightMix kurulum iletişim kutusunu gösterir.

bakeLightMix

Sahneye ilk LightMix öğesini ekler . Bu işlev, VFB’deki “ekle” düğmesine tıklamakla aynı şey değildir. MAXScript her zaman ilk LightMix’i ekler çünkü hangisinin seçili olduğunu bilmez. Bu işlevi kullanmak için VFB’yi açmanıza gerek yoktur. 

hafif karışımla pişir

<tamsayı>lightMixIndex

Belirtilen LightMix’i, verilen lightMixIndex’e göre sahneye uygular. Yalnızca Corona 12 ve üzeri sürümlerde mevcuttur.

Kullanıcı arayüzü

Listeleyici iletişim kutusunu göster

<tamsayı>tab

Corona Lister iletişim penceresini açar. Sekme argümanı, iletişim penceresi açıldığında hangi sekmenin seçileceğini belirler; 0 en son etkin sekmeyi, 1 Işıklar sekmesini ve 2 Dağılımlar sekmesini ifade eder.

Hata Penceresini göster

Corona Hata Penceresini gösterir.

savePostSettings

<string>dosya adı</string>

VFB Post sekmesindeki tüm mevcut ayarları bir .conf dosyasına kaydeder (Post sekmesindeki “Kaydet” düğmesini kullanmaya eşdeğerdir). Yalnızca Corona 12 ve üzeri sürümlerde mevcuttur. Yalnızca VFB2 ile çalışır.

YüklePostAyarları

<string>dosya adı</string>

Belirtilen .conf dosyasından işlem sonrası ayarlarını yükler (İşlem Sonrası sekmesindeki “Yükle” düğmesini kullanmaya eşdeğerdir). Yalnızca Corona 12 ve üzeri sürümlerde mevcuttur. Yalnızca VFB2 ile çalışır.

Sürümleme

Sürüm numarasını al

Geçerli Corona sürümünü, karşılaştırılabilir tek bir 64 bit tamsayı sürüm numarası olarak kodlanmış şekilde döndürür. Daha önceki sürümlerde döndürülen sürüm numaraları, daha sonraki sürümlerde döndürülen sürüm numaralarından her zaman daha düşüktür.

SürümDizesini al

Corona’nın güncel sürümünü insan tarafından okunabilir bir metin dizesi olarak döndürür. Kullanıcıya sunulmaya uygundur.

Sürüm Ana Numarasını al

Mevcut Corona sürümünün ana numarasını döndürür.

SürümAltıncıNumarasınıAl

Mevcut Corona sürümünün alt numarasını döndürür.

getVersionBuildType

Geçerli Corona sürümünün derleme türünü string biçiminde döndürür. Yani “StableRelease”, “ReleaseCandidate” ve “DailyBuild” seçeneklerinden birini.

Diğer

dışa aktarma sahnesi

<string>dosyaadı <bool>hemenişlet <bool>varlıklarıkoru

Mevcut sahneyi, Corona Standalone veya Vantage’da açılıp işlenebilmesi için belirtilen bir dosyaya dışa aktarır . Desteklenen dosya formatları şunlardır:

.cdo – Corona Bağımsız Sürümü

.vrscene – Vantage

.vantage – Vantage

Eğer `renderImmediately` değeri `true` ise, uygulama ayrıca Corona Standalone / Vantage yürütülebilir dosyasını arar ve dışa aktarma işleminden hemen sonra çalıştırmayı ve render işlemine başlamayı dener. 

Eğer `keepAssets` değeri `true` ise, hiçbir doku dışa aktarılmaz; bunun yerine orijinal konumlarında saklanırlar. Eğer `keepAssets` değeri `false` ise, tüm dokular sahne dosyasıyla birlikte dışa aktarılır. 

DrIPDosyasını yükle

<string>dosya adı</string>

Her satırda 1 IP adresi bulunan bir metin dosyasını DR düğümleri listesine yükler. Bu, kullanıcı arayüzündeki “Dosyadan…” düğmesine tıklayıp sağlanan dosyayı seçmekle aynıdır.

getBlackbodyColor

<float>sıcaklık

Belirtilen sıcaklıkta (Kelvin cinsinden) siyah cisim yayıcısının rengini döndürür. Döndürülen değer HDR doğrusal sRGB renk uzayındadır (gama düzeltmesi olmadan). Sonuç normalize edilmiştir – en parlak renk kanalı her zaman 1’e eşittir ve rengin mutlak parlaklığı gerçekliğe karşılık gelmez (yalnızca farklı renk kanalları arasındaki oran anlamlıdır). Giriş rengi 1000-99000K aralığında olmalıdır.

getScriptsDirectory

Corona ile birlikte gelen MAXScript komut dosyalarının (örneğin Corona Converter veya Corona Proxy Exporter) saklandığı dizinin yolunu döndürür.

Varsayılan PürüzlülükModu’nu al

Corona Sistem Ayarlarında ayarlandığı gibi, Corona PhysicalMtl pürüzlülük modu için varsayılan modu döndürür. 0 = pürüzlülüğü kullan, 1 = parlaklığı kullan.

VarsayılanIorMode’u al

Corona Sistem Ayarlarında ayarlandığı gibi, Corona PhysicalMtl IOR modu için varsayılan modu döndürür. 0 = IOR kullan, 1 = Disney Specular kullan.

convertToCoronaMtl

<malzeme>malzeme
<tam sayı>metaliklikTipi

Belirtilen malzemeyi Corona malzemesine dönüştürür. MetalnessType, metalliğin nasıl ele alınacağını belirler:
0 – Otomatik algılama
1 – Metal olmayan malzemeyi zorla
2 – Metal malzemeyi zorla.
Yalnızca Corona 12 ve üzeri sürümlerde mevcuttur.