MAXScript
Çoğu Chaos Corona ayarına MAXScript aracılığıyla erişilebilir ve değiştirilebilir. Corona’nın etkin görüntü oluşturucu olarak ayarlandığından emin olun, ardından MAXScript Dinleyicisi’ni açın ve show renderers.current komutunu çalıştırın. Bu, Corona’ya özgü tüm görüntü oluşturma özelliklerini ve mevcut değerlerini listeler.
Corona ayrıca CoronaRenderer.CoronaFp arayüzü aracılığıyla birçok işlev sunar. Dinleyici’de showInterface CoronaRenderer.CoronaFp komutunu çalıştırarak tüm kullanılabilir Corona MAXScript işlevlerini listeleyebilirsiniz. Listelendikten sonra, CoronaRenderer.CoronaFp.<FunctionName>(parametreler) sözdizimini kullanarak betiklerinizde bu işlevlerden herhangi birini çağırabilirsiniz. Örneğin, Corona’nın görüntü oluşturma ayarlarını betik aracılığıyla varsayılanlara sıfırlamak için CoronaRenderer.CoronaFp.resetSettings() komutunu çağırın. Çoğu işlev, işlemin başarılı olup olmadığını belirtmek için bir durum kodu (başarı için 0, başarısızlık için sıfırdan farklı) döndürür.
Fonksiyon | Parametre | Açıklama |
|---|---|---|
VFB and Rendering | ||
showVfb | <boolean>show | VFB penceresini görüntüler veya gizler. Argüman doğru olduğunda, çağırmak kullanıcı arayüzündeki “VFB’yi Göster” düğmesine tıklamakla aynıdır. |
resumeRender | Son işleme devam eder. İşlemler sekmesindeki “Son işleme devam et” düğmesine tıklamakla aynıdır. | |
loadAndResume | <string>filename | resumeRender ile aynıdır, ancak daha önce boşaltılan EXR dosyasından son render’ı yükler. |
dumpVfb | <string>filename | Mevcut VFB içeriğini daha sonra loadAndResume kullanılarak devam ettirilebilmesi için belirtilen dosyaya kaydeder. |
setDisplayedChannel | <integer>channel | Corona VFB kullanılıyorsa, o anda görüntülenen kanalı ayarlar. 0 güzellik kanalı, 1 alfa kanalı ve daha yüksek değerler ekstra render geçişleridir. |
getVfbContent | <integer>channel <boolean>toneMapping <boolean>renderStamp | Geçerli kare arabelleğinden bir render kanalı içeren bit eşlemi döndürür. İsteğe bağlı olarak ton eşlemesi ve render damgası eklenebilir. Tam sayı kodunu değil, doğrudan bit eşlemini (veya çağrı başarısız olduysa null değerini) döndürür. |
getStatistic | <int>statisticId | Bu makalede yer alan “İstatistik Kimliği” tablosundan, çift hassasiyetli kayan nokta biçimindeki istatistiklerden birini döndürür. Şu anda etkin olan veya son render’dan elde edilen sonuçları döndürür. Oturumda henüz render gerçekleşmediyse veya son render’dan sonra 3dsmax sıfırlandıysa/oluşturucu değiştirildiyse, sonuçlar tanımsızdır. |
startInteractive | Corona VFB’de etkileşimli görüntüleme başlatılır. | |
startInteractiveDocked | Corona görüntü alanına yerleştirilmiş VFB’de etkileşimli görüntülemeyi başlatır. Bu yöntemin çalışması için görüntü alanının (genişletilmiş görünüm) mevcut ve etkin olmaması gerekir. Komut aşağıdaki kodları döndürür: | |
stopRender | Şu anda devam eden herhangi bir işlemeyi durdurur | |
reparseInteractive | Etkileşimli işleme oturumundayken, tüm sahneyi yeniden ayrıştırır ve etkileşimli işlemeyi yeniden başlatır. | |
getRenderType | Şu anda devam eden bir render yoksa 0, çevrimdışı (etkileşimsiz render) için 1, yerleştirilmiş VFB ile etkileşimli render için 2 ve normal Corona VFB’de etkileşimli render için 3 döndürür. | |
saveAllElements | <string>filename | Tüm render öğelerini belirtilen konuma kaydeder – Corona VFB düğmesi işlevi kullanılırken olduğu gibi. Sağlanan parametre, güzellik kanalının dosya adıdır, diğer dosya adları bundan türetilir. |
resetSettings | Render ayarlarını varsayılan değerlere sıfırlar. Eylemler sekmesindeki “Ayarları Sıfırla” düğmesine tıklamakla aynıdır. | |
UI | ||
showLightMixSetupDialog | Şu anda oluşturulmuyorsa LightMix kurulum iletişim kutusunu gösterir. | |
bakeLightMix | Sahneye ilk LightMix öğesini ekler. Bu işlev, VFB’deki pişirme düğmesine tıklamakla aynı şey değildir. MAXScript, hangisinin seçildiğini bilmediği için her zaman ilk LightMix öğesini ekler. Bu işlevi kullanmak için VFB’yi açmanıza gerek yoktur. | |
bakeIthLightMix | <integer>lightMixIndex | Belirtilen LightMix’i, sağlanan lightMixIndex’e göre sahneye ekler. Yalnızca Corona 12 ve daha yeni sürümlerde kullanılabilir. |
showListerDialog | <integer>tab | Corona Lister iletişim kutusunu açar. Sekme argümanı, iletişim kutusu açıldığında hangi sekmenin seçileceğini belirler; burada 0 son etkin sekme, 1 Işıklar sekmesi ve 2 Dağılımlar sekmesi anlamına gelir. |
showErrorWindow | Corona Hata Penceresini gösterir. | |
savePostSettings | <string>filename | VFB Post sekmesindeki tüm mevcut ayarları bir .conf dosyasına kaydeder (Post sekmesindeki “Kaydet” düğmesini kullanmakla eşdeğerdir). Yalnızca Corona 12 ve üzeri sürümlerde kullanılabilir. Yalnızca VFB2 ile çalışır. |
loadPostSettings | <string>filename | Belirtilen .conf dosyasından post-işleme ayarlarını yükler (Post sekmesindeki “Yükle” düğmesini kullanmaya eşdeğerdir). Yalnızca Corona 12 ve üzeri sürümlerde kullanılabilir. Yalnızca VFB2 ile çalışır. |
Sürümleme | ||
getVersionNumber | Mevcut Corona sürümünü, tek bir karşılaştırılabilir 64 bit tam sayı sürüm numarası olarak kodlanmış olarak döndürür. Önceki sürümlerde döndürülen sürüm numaraları, sonraki sürümlerde döndürülen sürüm numaralarından her zaman daha düşüktür. | |
getVersionString | Güncel Corona sürümünü, insanların anlayabileceği bir dize olarak biçimlendirilmiş olarak döndürür. Kullanıcıya sunulmaya uygundur. | |
getVersionMajorNumber | Güncel Corona versiyonunun ana numarasını döndürür. | |
getVersionMinorNumber | Güncel Corona versiyonunun alt numarasını döndürür. | |
getVersionBuildType | Güncel Corona sürüm derleme türünü dize olarak biçimlendirilmiş olarak döndürür. Örneğin, “StableRelease”, “ReleaseCandidate” ve “DailyBuild” türlerinden biri. | |
Diğer | ||
exportScene | <string>filename <bool>renderImmediately <bool>keepAssets | Mevcut sahneyi, Corona Standalone veya Vantage’da açılıp işlenebilmesi için belirli bir dosyaya aktarır. Desteklenen dosya biçimleri şunlardır: .cdo – Corona Standalone .vrscene – Vantage .vantage – Vantage renderImmediately değeri true ise, uygulama Corona Standalone / Vantage yürütülebilir dosyasını da arar ve çalıştırmaya ve dışa aktarma işleminden hemen sonra işlemeye başlamaya çalışır. KeepAssets değeri true ise, hiçbir doku dışa aktarılmaz; bunun yerine, orijinal konumlarında tutulurlar. keepAssets değeri false ise, tüm dokular sahne dosyasıyla birlikte dışa aktarılır. |
loadDrIpFile | <string>filename | DR düğümleri listesine, satır başına 1 IP içeren bir metin dosyası yükler. Kullanıcı arayüzünde “Dosyadan…” düğmesine tıklayıp sağlanan dosyayı seçmekle aynıdır. |
getBlackbodyColor | <float>temperature | Belirtilen sıcaklıktaki (Kelvin cinsinden) siyah gövdeli bir yayıcı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ç normalleştirilmiştir – en parlak renk kanalı her zaman 1’e eşittir ve rengin mutlak parlaklığı gerçeğe uymaz (sadece farklı renk kanalları arasındaki oran anlamlıdır). Giriş rengi 1000-99000K aralığında olmalıdır. |
getScriptsDirectory | Corona ile birlikte gelen MAXScript betiklerinin (örneğin Corona Converter veya Corona Proxy Exporter) depolandığı dizine giden yolu döndürür. | |
getDefaultRoughnessMode | 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. | |
getDefaultIorMode | 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 | <material>material | Belirtilen malzemeyi Corona malzemesine dönüştürür. MetalnessType, metalliğin nasıl işleneceğini belirler: |
İstatistik Kimliği | Anlam |
|---|---|
0 | Geçen geçiş sayısı |
1 | Sahnedeki ilkel sayısı, örnekler hariç |
2 | Örneklemeli sahnedeki ilkel sayısı |
3 | Saniyede işlenen ortalama ışın sayısı |
4 | Her görüntü örneği için işlenen ortalama ışın sayısı |
5 | Toplam işleme süresi (milisaniye) |
6 | İşleme aşamasında harcanan toplam süre (milisaniye cinsinden). Bu süre, zaman sınırı belirlenerek aşamalı işlemenin ne zaman durdurulacağına karar vermek için kullanılır. |
7 | Resimdeki tahmini gürültü miktarı (yüzde olarak). Tahmin yoksa 0 döndürür. |
8 | Tahmini kalan işleme süresi (milisaniye cinsinden). Tahmin yoksa 0 döndürür. |
9 | Şu anda Corona’nın ayırdığı hafıza. |
10 | Son render sırasında Corona tarafından tahsis edilen en yüksek bellek. |
11 | İşlem tarafından şu anda kullanılan sanal bellek. |
12 | İşlem tarafından şu anda kullanılan en yüksek sanal bellek. |
13 | Sistem tarafından kullanılan sanal bellek. |
14 | Sahne ayrıştırma süresi (ms) |
15 | Yer değiştirme ilkelleri. |
Corona Proxy API
Proxy nesnesi [proxy] üzerinde bir yöntemi çağırmak için CProxy.ProxyFp.[method_name] [proxy] [isteğe bağlı diğer argümanlar] kullanın.
Fonksiyon | Parametre | Açıklama |
|---|---|---|
getOriginalObjectName | <node>proxy | Proxy’nin oluşturulduğu orijinal nesnenin adını içeren dizeyi döndürür. |
getOriginalMaterialName | <node>proxy | Proxy’nin oluşturulduğu orijinal nesnenin malzemesinin adını içeren dizeyi döndürür. |
fromScene | <node>proxy <node>source <filename>filename | Sahne nesnesi kaynağından bir proxy oluşturur ve bunu dosya adı ile belirtilen dosyaya kaydeder |
fromSceneAnimated | <node>proxy <node>source <filename>filename <integer>frameFrom <integer>frameTo <integer>pointCloudSize <integer>samplesPerFrame | Diğer fromScene ile aynıdır, ancak ek parametrelerin belirtilmesine olanak tanır – animasyon aralığı (frameFrom – frameTo), dosyada önceden hesaplanıp saklanacak görünüm noktası bulutunun boyutu ve alınacak hareket bulanıklığı örneklerinin sayısı |
duplicateToMesh | <node>proxy | Proxy’den 3ds Max Düzenlenebilir Mesh oluşturur (proxy’yi silmez). Kullanıcı arayüzündeki Mesh’e Çoğalt düğmesine tıklamakla aynıdır. |
Corona Material Library API
CoronaMaterialLibrary.MaterialLibraryFp arayüzü kullanılarak çağrılabilen birkaç yayınlanmış işlev bulunmaktadır. Bunları showInterface CoronaMaterialLibrary.MaterialLibraryFp komutunu çalıştırarak listeleyebilirsiniz.
Fonksiyon | Parametre | Açıklama |
|---|---|---|
isInstalled | Kütüphane şu anda yüklüyse TRUE değerini döndürür. Aksi takdirde FALSE değerini döndürür (kullanıcı Corona kurulumu sırasında kütüphaneyi seçmemiştir). | |
showBrowserIfPossible | <boolean>show | Mümkünse, kütüphanenin tarayıcı penceresini görüntüler veya gizler. Başarılıysa 0, başarısızsa sıfırdan farklı bir değer döndürür. |
Corona Scatter API
Corona Scatter’ın yerini kendi API’sine sahip daha gelişmiş Chaos Scatter’ın aldığı 8. versiyona kadar geçerlidir.
Her CScatter nesnesinde çağrılabilen birkaç yayınlanmış yöntem vardır. Bunları s = CScatter(); showInterfaces s komutunu çalıştırarak listeleyebilirsiniz. Orada ScatterFpInterface arayüzünü arayın.
Fonksiyon | Parametre | Açıklama |
|---|---|---|
update | <interval>timeInterval <integer>referenceTime | Belirtilen boş olmayan zaman aralığı için örneklerin dağılımını günceller. Belirtilen referans zamanı, enterpolasyon yapılamayan dağılım parametrelerini belirler. Aralıkta yer alması beklenir. Başarılı olursa 0 döndürür. Kullanıcının geçerli bir lisansı yoksa 1 döndürür. Şu anda yalnızca 1 zaman dilimi uzunluğundaki aralıklar desteklenmektedir. |
clear | Son güncelleme çağrısıyla oluşturulan örneklerin dağılımını temizler. Tahsis edilen kaynakları serbest bırakmak için çağrılabilir, ancak dağılım nesnesine bağlı olarak haritalar o zaman yanlış değerlendirilebilir. | |
getModelCount | Tüm model nesnelerinin sayısını döndürür. Bunlar, dağılım nesnesi tarafından örneklenen orijinal nesnelerdir. Sayı, son güncelleme çağrısıyla ilgilidir. | |
getModelNode | <integer>index | Belirtilen indeks tarafından seçilen bir model nesnesinin düğümünü döndürür. Düğüm, son güncelleme çağrısıyla ilgilidir. Düğüm bu arada silinmişse null döndürür. İndeks, getModelCount tarafından döndürülen sayım olan N’nin bulunduğu [0, N) aralığının dışındaysa, yine null döndürür. |
getInstanceCount | Örnek sayısını döndürür. Son güncelleme çağrısı için belirtilen tüm zaman aralığına dağılmış tüm örnekler burada dikkate alınır. Örneğin, dağılım 2 uzun zaman dilimi için güncellenirse ve ilk karede A, B, C dağınık örnekleri ve ikinci karede B ve D dağınık örnekleri alırsa, 4 döndürür. | |
convertInstancesToGeometry | <integer>time | Belirtilen zamanda dağılmış tüm örnekleri gerçek geometri nesnelerine dönüştürür (çoğaltır). Zamanın son güncelleme çağrısı için belirtilen aralıkta olmasını bekler. Başarılı olursa 0 döndürür. Çok sayıda örnek için bunun maliyetli olabileceğini unutmayın. |
CScatter.StaticFpInterface arayüzü kullanılarak çağrılabilen birkaç yayınlanmış yöntem de mevcuttur. Bunları showInterface CScatter.StaticFpInterface komutunu çalıştırarak listeleyebilirsiniz.
Fonksiyon | Parametre | Açıklama |
|---|---|---|
getVersionNumber | Geçerli eklenti sürümünü, tek bir karşılaştırılabilir 64 bit tam sayı sürüm numarası olarak kodlanmış olarak döndürür. Önceki sürümlerde döndürülen sürüm numaraları, sonraki sürümlerde döndürülen numaralardan her zaman daha düşüktür. | |
getVersionString | Eklentinin güncel sürümünü, insanlar tarafından okunabilir bir dize olarak biçimlendirilmiş olarak döndürür. Kullanıcıya sunulmaya uygundur. |
Example scripts
Corona VFB’yi gösterir:
1 CoronaRenderer.CoronaFp.showvfb true
Mevcut işlemeyi durdurur (VFB’deki DURDUR düğmesine basmakla aynıdır):
1 CoronaRenderer.CoronaFP.stopRender()
VFB’de bir render bölgesi çizer (çıktı çözünürlüğünün 1280×720px olduğunu varsayıyoruz):
1 renderers.current.system_vfbRegions = #([1280,720,0], [0,0,0], [1280,720,0], [10,20,0], [100,200,0], [0,0,0])
Tüm VFB bölgelerini temizler (öncelikle VFB’nin kapatılması gerekir):
1 brenderers.current.system_vfbRegions_enabled=false
Mevcut sahneyi 3ds Max’ten C:\Corona\ dizinine myscene.cdo olarak aktarır, render etmeye başlamaz ve tüm dokuları da aktarır:
1 CoronaRenderer.CoronaFp.exportScene @”C:\Corona\myscene.cdo” false false
Mevcut sahneyi 3ds Max’ten C:\Corona\ dizinine myscene.vantage adıyla aktarır ve işlemeye başlar. Sahnede kullanılan dokular dışa aktarma dizininde saklanmaz, bunun yerine orijinal konumlarında bırakılır:
1 CoronaRenderer.CoronaFp.exportScene @”C:\Corona\myscene.vantage” true true
VFB’nin geçerli içeriğini belirtilen CXR dosyasına döker:
1 CoronaRenderer.CoronaFp.dumpVfb “D:\yourfilename.cxr”
Teapot001’i bir proxy’ye dönüştürür ve C:\proxy\myproxy.cgeo olarak kaydeder:
1 CProxy.ProxyFp.fromScene (CProxy()) $Teapot001 @”C:\proxy\myproxy.cgeo”
my_proxy’yi tekrar mesh’e dönüştürür:
1 CProxy.ProxyFp.duplicateToMesh $my_proxy
Corona 8 Yeni Ton Eşleme Boru Hattı Örnekleri
Son operatörü alma:
1 getProperty renderers.current “colorMap.pipeline”
Her operatör bir sonraki operatörü tutar (UI’da yukarıdaki operatördür):
1 getProperty (getProperty renderers.current “colorMap.pipeline”) “colorMappingOperator.nextOperator”
Belirli parametre değerleri şu şekilde elde edilebilir:
1 getProperty (getProperty renderers.current “colorMap.pipeline”) “colorMappingOperator.opacity”
Özelliğin adını ve ayarını kullanarak belirli bir operatör aranıyor:
– önceki kod, değeri yalnızca bulduğu ilk operatöre ayarlar; aynı türden birden fazla operatöre sahip daha karmaşık bir boru hattına ihtiyaç duyulması durumunda, bunu sıfırdan oluşturmak ve parametreleri hemen ayarlamak daha kolaydır, aşağıya bakın
Operatör ekleme (benzersiz bir kimlik belirlemek gerekir) – mevcut boru hattını tek bir kontrast operatörüyle değiştirir:
Birden fazla operatörle kendi boru hattını kurmak:
Tüm operatörler:
(Aşağıdakiler dahili amaçlar içindir, bunları manuel olarak eklemenize veya değerlerini değiştirmenize gerek yoktur):
Tüm parametreler:
Main paramblock (renderers.current):
T_BOOL, PARAM_COLORMAP_ENABLED, “colorMap.enabled”
T_FLOAT, PARAM_COLORMAP_GAMMA, “colorMap.gamma”
TYPE_REFTARG, PARAM_COLORMAP_PIPELINE, “colorMap.pipeline”ACES
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_ACES_OT_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_ACES_OT_OP_OPACITY, TYPE_FLOAT, _T(“colorMappingOperator.opacity”),CONTRAST
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_CONTRAST_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_CONTRAST_OP_CONTRAST, TYPE_FLOAT, _T(“colorMappingOperator.contrast”),CURVES
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_CURVES_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_CURVES_OP_MASTER_NODES, TYPE_POINT3_TAB, _T(“colorMappingOperator.master.nodes”),
PARAM_CURVES_OP_MASTER_INTERPOL, TYPE_INT, _T(“colorMappingOperator.master.interpol”),
PARAM_CURVES_OP_RED_NODES, TYPE_POINT3_TAB, _T(“colorMappingOperator.r.nodes”),
PARAM_CURVES_OP_RED_INTERPOL, TYPE_INT, _T(“colorMappingOperator.r.interpol”),
PARAM_CURVES_OP_GREEN_NODES, TYPE_POINT3_TAB, _T(“colorMappingOperator.g.nodes”),
PARAM_CURVES_OP_GREEN_INTERPOL, TYPE_INT, _T(“colorMappingOperator.g.interpol”),
PARAM_CURVES_OP_BLUE_NODES, TYPE_POINT3_TAB, _T(“colorMappingOperator.b.nodes”),
PARAM_CURVES_OP_BLUE_INTERPOL, TYPE_INT, _T(“colorMappingOperator.b.interpol”),FILMIC
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_FILMIC_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_FILMIC_OP_HIGHLIGHTS_COMPRESSION, TYPE_FLOAT, _T(“colorMappingOperator.highlightCompression”),
PARAM_FILMIC_OP_RICH_SHADOWS, TYPE_FLOAT, _T(“colorMappingOperator.richShadows”),ADV FILMIC
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_FILMIC_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_ADVANCED_FILMIC_OP_TOE_STRENGTH, TYPE_FLOAT, _T(“colorMappingOperator.toeStrength”),
PARAM_ADVANCED_FILMIC_OP_TOE_LENGTH, TYPE_FLOAT, _T(“colorMappingOperator.toeLength”),
PARAM_ADVANCED_FILMIC_OP_SHOULDER_STRENGTH, TYPE_FLOAT, _T(“colorMappingOperator.shoulderStrength”),
PARAM_ADVANCED_FILMIC_OP_SHOULDER_LENGTH, TYPE_FLOAT, _T(“colorMappingOperator.shoulderLength”),
PARAM_ADVANCED_FILMIC_OP_SHOULDER_ANGLE, TYPE_FLOAT, _T(“colorMappingOperator.shoulderAngle”)GM TINT
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_GMTINT_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_GMTINT_OP_GREEN_MAGENTA_TINT, TYPE_FLOAT, _T(“colorMappingOperator.greenMagentaTint”),LUT
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_LUT_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_LUT_OP_PATH, TYPE_FILENAME, _T(“colorMappingOperator.path”),
PARAM_LUT_OP_OPACITY, TYPE_FLOAT, _T(“colorMappingOperator.opacity”),
PARAM_LUT_OP_LOGARITHMIC, TYPE_BOOL, _T(“colorMappingOperator.logarithmic”),PHOTOGRAPHIC EXPOSURE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_EXPOSURE_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),REINHARD
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_REINHARD_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_REINHARD_OP_HIGHLIGHT_COMPRESSION, TYPE_FLOAT, _T(“colorMappingOperator.highlightCompression”),SATURATION
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_SATURATION_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_SATURATION_OP_SATURATION, TYPE_FLOAT, _T(“colorMappingOperator.saturation”),SIMPLE EXPOSURE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_EXPOSURE_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_EXPOSURE_OP_SIMPLE_EXPOSURE, TYPE_FLOAT,_T(“colorMappingOperator.simpleExposure”),TINT
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_TINT_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_TINT_OP_TINT, TYPE_RGBA, _T(“colorMappingOperator.tint”),TONE CURVE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_TONE_CURVE_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_TONE_CURVE_OP_HIGHLIGHTS, TYPE_FLOAT, _T(“colorMappingOperator.highlights”),
PARAM_TONE_CURVE_OP_LIGHTS, TYPE_FLOAT, _T(“colorMappingOperator.lights”),
PARAM_TONE_CURVE_OP_DARKS, TYPE_FLOAT, _T(“colorMappingOperator.darks”),
PARAM_TONE_CURVE_OP_SHADOWS, TYPE_FLOAT, _T(“colorMappingOperator.shadows”),VIGNETTE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_VIGNETTE_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_VIGNETTE_OP_INTENSITY, TYPE_FLOAT, _T(“colorMappingOperator.intensity”),
PARAM_VIGNETTE_OP_FALLOFF, TYPE_FLOAT, _T(“colorMappingOperator.falloff”),WHITE BALANCE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T(“colorMappingOperator.nextOperator”),
PARAM_WHITE_BALANCE_OP_ENABLED, TYPE_BOOL, _T(“colorMappingOperator.enabled”),
PARAM_WHITE_BALANCE_OP_COLOR_TEMPERATURE, TYPE_FLOAT, _T(“colorMappingOperator.colorTemperature”),
Chaos Dağılımı MAXScript API
Her Chaos Scatter nesnesi için çağrılabilen birkaç yayınlanmış yöntem vardır. Bunların hepsini showInterface ChaosScatter.FpInterface komutunu çalıştırarak listeleyebilirsiniz (MAXScript Listener çıktısına bakın).
İşlev | Parametreler | Tanım |
|---|---|---|
güncelleme | <aralık>zamanAralığı | Çağrıyı engellerken, belirtilen boş olmayan zaman aralığı için saçılımı günceller. Belirtilen referans zamanı, enterpolasyon yapılamayan saçılım parametrelerini belirler. Aralıkta yer alması beklenir. Başarılı olursa 0 döndürür. Kullanıcının geçerli bir lisansı yoksa 1 döndürür. Güncelleme gerekmiyorsa hiçbir şey yapmaz. Şu anda yalnızca 1 zaman dilimi uzunluğundaki aralıklar desteklenmektedir. |
temizlemek | Son güncelleme çağrısıyla oluşturulan dağılımı temizler. Tahsis edilen kaynakları serbest bırakmak için çağrılabilir, ancak örneğin dağılım nesnesine bağlı olarak haritalar bu durumda yanlış değerlendirilebilir. | |
getModelCount | Tüm model nesnelerinin sayısını döndürür. Bunlar, dağılım nesnesi tarafından örneklenen orijinal nesnelerdir. Sayı, son güncelleme çağrısıyla ilgilidir. | |
getModelNode | <tamsayı>indeks | Belirtilen indeks tarafından seçilen model nesnesinin düğümünü döndürür. Düğüm, son güncelleme çağrısıyla ilgilidir. Düğüm bu sırada silinmişse null döndürür. Dizin, getModelCount tarafından döndürülen sayı olan N’nin de olduğu [0, N) aralığının dışındaysa , yine null döndürür. Performans nedenleriyle ve mümkünse, bu yöntemin aynı indeksle toplu ve tekrarlayan çağrılarının önlenmesi önerilir. |
getInstanceCount | Toplam örnek sayısını döndürür. Son güncelleme çağrısı için belirtilen tüm zaman aralığına dağılmış tüm örnekler burada dikkate alınır. Örneğin, dağılım 2 uzun zaman dilimi için güncellenirse ve ilk karede A, B, C dağınık örnekleri, ikinci karede ise B ve D dağınık örnekleri alırsa, 4 döndürür. | |
ÖrnekleriGeometriyeDönüştür | <tamsayı>zaman | Belirtilen zamanda dağıtılmış tüm örnekleri gerçek geometri nesnelerine dönüştürür (çoğaltır). Zamanın, son güncelleme çağrısı için belirtilen aralıkta olmasını bekler. Başarılı olursa 0 döndürür. Çok sayıda örnek için çağrılması maliyetli olabilir. |
Yapılandırmayı kaydet | <string>filePath | Dağılım yapılandırmasını belirtilen dosyaya kaydeder. Biçimi belirtilmemiştir ancak loadConfiguration ile geri yüklenebilir . Başarılı olması durumunda 0 döndürür. |
yükYapılandırması | <dize>dosyaYolu | Belirtilen dosyadan dağılım yapılandırmasını yükler. Dosyanın daha önce saveConfiguration ile kaydedilmesini bekler . Başarılı olması durumunda 0 döndürür. |
‘Chaos Scatter001’ adlı halihazırda var olan Chaos Scatter nesnesi için örnek kod:
showProperties $’Chaos Scatter001′
Corona 7 ve önceki sürümlerde bulunan Corona Scatter’a kıyasla mülk adları değişti (daha net).
Ayrıca, yayınlanmış birkaç bağımsız fonksiyon da mevcuttur. Bunların hepsini showInterface ChaosScatter.StaticFpInterface komutunu çalıştırarak listeleyebilirsiniz (MAXScript Listener çıktısına bakın).
İşlev | Parametreler | Tanım |
|---|---|---|
SürümNumarasınıal | Geçerli eklenti sürümünü, tek bir karşılaştırılabilir 64 bit tam sayı sürüm numarası olarak kodlanmış olarak döndürür. Önceki sürümlerde döndürülen sürüm numaraları, sonraki sürümlerde döndürülen numaralardan her zaman daha düşüktür. | |
getVersionString | Eklentinin güncel sürümünü, insanlar tarafından okunabilir bir dize olarak biçimlendirilmiş olarak döndürür. Kullanıcıya sunulmaya uygundur. |
Örnek kod:
ChaosScatter.StaticFpInterface.getVersionString()
