Bu sayfa, V-Ray Standalone için komut satırı parametrelerini tanıtmaktadır.
Genel Bakış #
Aşağıda V-Ray Standalone için komut satırı parametrelerinin bir listesi bulunmaktadır. Ek komut satırı parametreleri belirtmek için VRAY_CMD_PREFIX ve VRAY_CMD_SUFFIX ortam değişkenlerini kullanabilirsiniz – bkz. V-Ray Standalone Ortam Değişkenleri sayfası. V-Ray Standalone’u herhangi bir parametre olmadan çalıştırırsanız, her olası seçeneğin açıklamalarını içeren kısa bir yardım metni de yazdıracaktır. Köşeli parantez [] içindeki seçeneklerin bölümleri isteğe bağlıdır ve küme parantez {} içindeki bölümler sıfır veya daha fazla kez tekrarlanabilir.
Komutlarla Çalışmaya Başlama sayfasında, başlamanıza yardımcı olacak pratik örnekler bulabilirsiniz .
Sistem Seçenekleri #
-help – Mevcut tüm komut satırlarının ve kullanımlarının listesini yazdırır.
-version – V-Ray sürümünü yazdırır.
-Kaynaklar- V-Ray ve üçüncü taraf telif hakkı bildirimlerini içerir.
-configFile=”path/to/config/file” – V-Ray eklentilerinin yollarını içeren V-Ray yapılandırma dosyasının yolu ve dosya adı. VRAY_PLUGINS_x86 ve VRAY_PLUGINS_x64 ortam değişkenleriyle V-Ray eklentileri için ek yollar da belirtilebilir. Varsayılan değer, vray.exe ile aynı klasörde bulunan vrayconfig.xml dosyasıdır.
-numThreads=nnn – İşleme iş parçacığı sayısını ayarlar. Varsayılan değer 0’dır – otomatik iş parçacığı sayısı.
-profilerMode=0/1/2 – V-Ray Profiler’ın modunu belirtir :
0 – devre dışı
1 – basitleştirilmiş çıktı
2 – tam çıktı
Varsayılan değer 0’dır – devre dışı.
-profilerOutputDir=\directoryPath\ – V-Ray Profiler sonuçlarının çıkış dizinini belirtir. Parametre boş bırakılırsa veya atlanırsa, işletim sisteminin varsayılan geçici dizini kullanılır.
Giriş Dosyaları #
-sceneFile=”filename.vrscene” – Oluşturulacak sahne dosyasını belirtir.
-include=”includePath{;includePath}” – Dahil edilecek dosyalar için yol(lar)ı belirtir. Birden fazla -include seçeneği belirtilebilir.
-remapPath=”fromPath=toPath{;fromPath=toPath}” – Yol yeniden eşleme çiftini belirtir. Birden fazla -remapPath seçeneği belirtilebilir.
-remapPathFile=”remapFile.xml” – Yol yeniden eşleme verilerini içeren bir XML dosyasının yolunu belirtir. Alternatif olarak, XML dosyasının yolunu belirtmek için VRAY_PATH_REMAP_FILEPATH ortam değişkeni kullanılabilir ( daha fazla bilgi için V-Ray Bağımsız Ortam Değişkenleri sayfasına bakın). Örnek dosya:
-parameterOverride=”<plugin-parameter-id>=<value>” – vrscene dosyasını düzenlemeden eklenti parametrelerinin değerlerini değiştirmeyi mümkün kılar.
<plugin-parameter-id> – İki biçimde olabilir: PluginType::parameterName veya pluginName.parameterName .
PluginType ::parameterName formatı, belirtilen türe sahip tüm eklenti örnekleri için belirli bir parametreyi değiştirmek istediğinizde kullanılır.
Belirli bir eklenti örneğindeki bir parametreyi değiştirmek istediğinizde ` pluginName.parameterName` formatı kullanılır.
<value> – Biçimi, geçersiz kılmak istediğiniz parametrenin türüne bağlıdır. Desteklenen türler bool, int, float, color, acolor, vector, texture ve float texture’dır. bool, int ve float için basit bir sayı beklenir. color için Color(1, 0.0, 1.0) beklenir. acolor için AColor(1.0, 0, 0, 0.3) beklenir. vector için Vector(1, 2.0, 3.0) beklenir. texture için biçim, acolor ile aynı olmalı veya parametreye bağlanacak bir eklentinin adı olmalıdır. Float texture parametreleri için ya bir float değeri ya da bir eklentinin adı beklenir. Birden fazla -parameterOverride seçeneği belirtilebilir ve komut satırında belirtilen sırayla yürütülecektir. Örnekler:
Artık -parameterOverride seçeneği, Standalone komut satırından vektör parametrelerini de geçersiz kılabilir.
Örneğin, bir 3ds Max sahnesi VRayTriplanarTex içeriyorsa, bunu .vrscene dosyası olarak dışa aktardıktan sonra aşağıdaki komut satırını kullanabilirsiniz:
Bu sayede, .vrscene dosyasını değiştirmeden dokuyu doğrudan bağımsız konsol üzerinden döndürebilirsiniz.
-camera=”<sceneName>” – Birden fazla kamerayla render işlemi için hangi kameranın kullanılacağını belirtir. Ad, kamera ayarlarındaki scene_name parametresiyle eşleşmelidir. Örnekler (burada InteriorCamera, ExteriorCamera ve VRayCam001 , aynı vrscene dosyasındaki mevcut kameraların adlarıdır):
-camera seçeneği için lütfen şunu dikkate alın :
-
Birden fazla Standart Fiziksel kamera ve Pozlama kontrolü yüklü sahnelerde, render işlemi yalnızca aktif görünümle yapıldığında fiziksel olarak doğru olur.
Oluşturma Çıktısı #
-imgFile=”<yol>/dosyaAdı.<uzantı>” – Oluşturulan görüntüyü belirtilen dosyaya yazar. Dosya adı boşsa, dosyaya hiçbir görüntü yazılmaz. Alternatif olarak, yol (img_dir) ve dosya adı (img_file) .vrscene çıktı ayarları içeriğinde tanımlanmışsa, bu seçeneği komut satırında kullanmadan da dosyalar kaydedilebilir .
-imgWidth=nnn – Çıktı görüntüsünün genişliğini ayarlar. Varsayılan değer 640’tır veya .vrscene dosyasında belirtildiği gibidir.
-imgHeight=nnn – Çıktı görüntüsünün yüksekliğini ayarlar. Varsayılan değer 480’dir veya .vrscene dosyasında belirtildiği gibidir.
-region=x0;y0;x1;y1 – Oluşturulacak bölgeyi ayarlar. Tamsayı değerleri, görüntünün sol üst köşesine göre piksel cinsindendir. Bir bölge, .vrscene dosyasının kendisinde belirtilebilir ve -region bayrağı ile geçersiz kılınmadığı veya -region=none bayrağı ile devre dışı bırakılmadığı sürece oluşturmada kullanılacaktır.
-region=none – .vrscene dosyasında belirtilen herhangi bir bölgeyi yok sayar.
-crop=x0;y0;x1;y1 – Oluşturulacak kırpma bölgesini ayarlar. Tam sayı değerleri, görüntünün sol üst köşesine göre piksel cinsindendir. Varsayılan değer, tüm görüntü veya .vrscene dosyasında belirtilen değerdir.
-frames=b0[-e0[,s0]]{;bn[-en[,sn]]} – Oluşturulacak kareleri ve/veya kare aralıklarını belirtir. Birden fazla kare seçeneği belirtilebilir: bX başlangıç karesi, eX bitiş karesi ve sX kare artışıdır. Belirtilmezse, sahne açıklamasındaki kareler oluşturulur.
|
Örnek |
Tanım |
|---|
|
Örnek |
Tanım |
|---|---|
|
-çerçeveler=1;3;5-10 |
1, 3 ve 5’ten 10’a kadar olan kareleri oluşturun. |
|
-çerçeveler=10-100,5 |
10’dan 100’e kadar her 5. kareyi işleyin (yani, 10, 15, 20, 25, …, 95, 100). |
-noFrameNumbers=0/1 – -frames seçeneğinin, oluşturulan görüntü dosyalarının adlarına otomatik olarak kare numaralarının eklenmesine neden olup olmayacağını kontrol eder. Varsayılan değer sıfırdır; bu durumda -frames seçeneği her zaman çıktı görüntü dosyalarına kare numaralarının eklenmesine neden olur.
-skipExistingFrames=0/1 – V-Ray’in çıktı klasöründe mevcut olan belirtilen kare aralığından kareleri işleyip işlemeyeceğini kontrol eder.
-resume=0/1 – V-Ray, kısmen tamamlanmış render işlemlerine devam edecektir. Bu yalnızca .vrimg dosyasına yazılırken kova render işlemleri (derin olmayan görüntüler) için geçerlidir .
-progressiveAutoSave= – İşleme sırasında devam ettirilebilir dosyaların kaydedilmesi için dakika cinsinden bir aralık belirtir. Bu yalnızca aşamalı örnekleme için geçerlidir; kova işlemeleri her tamamlanan kovada kaydedilir. 0 değeri, işleme sırasında otomatik kaydetmeyi devre dışı bırakır ve devam ettirilebilir dosyalar yalnızca işlemenin sonunda kaydedilir.
-deleteResumableFileOnSuccess=0/1 – Kare başarıyla tamamlandığında devam ettirilebilir dosyayı otomatik olarak siler. Ek .vrimg veya .vrprog dosyaları için geçerlidir ve çıktı görüntü dosyası .vrimg olduğunda uygulanmaz . Varsayılan değer 0’dır ve devam ettirilebilir dosyayı saklar.
VFB (V-Ray Çerçeve Tamponu) Görüntüleme Seçenekleri #
-display=0/1 – V-Ray çerçeve arabelleğinde işlenmiş görüntüyü gösterir. Varsayılan değer 1’dir ve işlenmiş görüntüyü gösterir.
-autoClose=0/1 – Oluşturma tamamlandığında görüntülenen resmi otomatik olarak kapatır. Varsayılan değer 0’dır ve kullanıcının VFB’yi kapatmasını bekler.
-setFocus=0/1 – Görüntüleniyorsa VFB penceresine odaklanmayı sağlar. Varsayılan değer VFB penceresine odaklanmayı sağlar. Bu özellik yalnızca Windows’ta güvenilir şekilde çalışır.
-displaySRGB=0/1/2 – V-Ray VFB’nin sRGB seçeneğinin başlangıçta açık veya kapalı olup olmayacağını belirler. 0 değeri, VFB için varsayılan değerin kullanılacağı anlamına gelir (genellikle sRGB etkinleştirilmiştir). 1 değeri, sRGB düğmesinin etkinleştirilmesini zorlar. 2 değeri, sRGB düğmesinin devre dışı bırakılmasını zorlar. Bu, VRAY_VFB_SRGB ortam değişkeniyle de belirtilebilir. Komut satırı seçeneği, ortam değişkenini geçersiz kılar. Varsayılan değer 0’dır; burada sRGB, VFB varsayılanıdır (etkin).
-displayLUT=0/1 – V-Ray VFB’nin LUT seçeneğinin başlangıçta açık veya kapalı olup olmayacağını belirler. Bu, VRAY_VFB_LUT ortam değişkeniyle de belirtilebilir. Komut satırı seçeneği, ortam değişkenini geçersiz kılar. LUT dosyası, VRAY_VFB_LUT_FILE ortam değişkeniyle belirtilebilir . Varsayılan değer 0’dır, bu durumda LUT kapalıdır.
-displayOCIO=0/1 – V-Ray VFB’nin OCIO seçeneğinin başlangıçta açık veya kapalı olup olmayacağını belirler. Bu, VRAY_VFB_OCIO ortam değişkeniyle de belirtilebilir. Komut satırı seçeneği, ortam değişkenini geçersiz kılar. OCIO yapılandırması, OCIO ortam değişkeniyle belirtilebilir. Varsayılan değer 0’dır, bu durumda OCIO kapalıdır.
-displayAspect=0/1 – V-Ray VFB’nin piksel en boy oranı seçeneğinin başlangıçta açık veya kapalı olup olmayacağını belirler. Bu, VRAY_VFB_PIXEL_ASPECT ortam değişkeniyle de belirtilebilir . Komut satırı seçeneği, ortam değişkenini geçersiz kılar. Varsayılan değer 0’dır; bu durumda piksel en boy oranı kapalıdır.
Konsol Çıktısı #
-verboseLevel=n – Standart çıktıya yazdırılacak bilginin ayrıntı düzeyini belirtir:
0 – Hiçbir bilgi yazdırılmıyor
1 – Yalnızca hatalar
2 – Hatalar ve uyarılar
3 – Hatalar, uyarılar ve bilgilendirme mesajları
4 – Tüm çıktılar
Varsayılan değer 3’tür.
-detailedTiming=0/1 – Çalışmanın sonunda özet zamanlama bilgilerinin standart çıktıya yazdırılıp yazdırılmayacağını belirtir.
0 – Devre dışı (varsayılan değer);
1 – Etkin;
-showProgress=n – Hesaplama ilerlemesinin standart çıktıya yazdırılıp yazdırılmayacağını belirtir:
0 – İlerleme durumunu gösterme
1 – İlerleme durumunu yalnızca verboseLevel > 0 ise göster
2 – İlerleme durumunu her zaman göster
Varsayılan değer 1’dir.
-progressUpdateFreq=n – İşleme ilerleme güncelleme sıklığını milisaniye cinsinden belirtir. Varsayılan değer 200 ms’dir. Komut satırında en son hangisi belirtilirse, -progressUpdateFreq ve -progressIncrement seçeneklerinden yalnızca biri kullanılır.
-progressIncrement=n – Yeni bir ilerleme mesajı yazdırıldığında yüzde olarak ilerleme artışını belirtir. Komut satırında en son hangisi belirtilirse, -progressUpdateFreq ve -progressIncrement’ten yalnızca biri kullanılır.
-progressUseCR=0/1 – Yazdırma ilerleme bilgisi verilirken satır başı kullanımının nasıl yapılacağını kontrol eder.
-progressUseColor=0/1 – Çıktının renklendirilip renklendirilmeyeceğini belirtir:
0 – Devre dışı
1 – Etkin (varsayılan değer)
RT Motoru #
-rtEngine=0/1/3/5/7/8/9 – Hangi işleme motorunun kullanılacağını belirtir:
0 – Normal render motoru kullanılır.
1 – CPU RT motoru kullanılır.
3 – (Kullanımdan kaldırıldı) OpenCL üzerinde çalışan GPU RT motoru kullanılır.
5 – CUDA üzerinde çalışan GPU RT motoru kullanılır.
7 – RTX üzerinde çalışan GPU RT motoru kullanılır.
8 – macOS: Metal üzerinde çalışan GPU motoru kullanılır (CPU ve GPU üzerinde çalışan hibrit render için kullanılabilir).
9 – macOS: Metal RT üzerinde çalışan GPU RT motoru kullanılır.
Varsayılan değer 0’dır.
-rtTimeOut=fff – RT motoru kullanılırken, kayan noktalı bir işleme süresi değeri (dakika cinsinden) belirtir. Varsayılan değer 0.0’dır, yani zaman sınırı yoktur.
-rtNoise=fff – Gerçek zamanlı çalışma motoru kullanılırken bir kare için kayan noktalı gürültü eşiğini belirtir. Varsayılan değer 0,001’dir.
-rtSampleLevel=nnn – RT motoru kullanılırken bir kare için piksel başına maksimum yol sayısını belirtir. Varsayılan değer 0’dır, yani herhangi bir sınır yoktur.
Dağıtılmış İşleme #
Sunucu #
-server – Sunucu modunda başlatılır, bağlantılar beklenir.
-autoCloseIfIdle=n – Sunucunun kendini kapatmadan önce bekleme süresini (dakika cinsinden) belirtir. 0 değeri bu özelliğin devre dışı olduğunu gösterir; aksi takdirde bekleme süresini dakika cinsinden temsil eder.
Müşteri #
-distributed=0/1/2 – Dağıtılmış işlemenin kullanılıp kullanılmayacağını ve nasıl kullanılacağını belirtir:
0 – Dağıtılmış işleme devre dışı bırakıldı.
1 – Dağıtılmış işleme etkinleştirildi ve yerel makine işlemeye dahil edildi.
2 – Dağıtılmış işleme etkinleştirildi ve yerel makine işlemeden hariç tutuldu.
Varsayılan değer 0’dır.
-renderhost=”host{;host}” – Dağıtılmış işleme için kullanılacak sunucuların noktalı virgülle ayrılmış listesi. Sunucular bilgisayar adı veya IP adresiyle belirtilebilir. Birden fazla -renderhost seçeneği seçilebilir.
-transferAssets=0/1/2 – Eksik varlıkların DR sunucularına aktarılıp aktarılmayacağını belirtir:
0 – Aktarma yapma.
1 – Eksik varlıkları aktar.
2 – Aktarmadan önce varlık önbelleği klasöründe varlıkları kontrol et. Varlık önbelleği klasörünü belirtmek için VRAY_ASSETS_CACHE_PATH ortam değişkeni kullanılabilir; belirtilmezse, varlıklar geçerli kullanıcının geçici klasöründeki “vray_assets_cache” dizininde saklanır.
Varsayılan değer 0’dır.
-cachedAssetsLimitType=0/1/2 – DR sunucusunda önbelleğe alınmış varlıklar için kullanılan sınırlama türü:
0 – Sınır yok (varsayılan değer);
1 – Belirtilen saatten daha eski varlıklar silinecektir;
2 – Önbellek boyutu: Varlık önbelleği belirtilen boyutu (GB) aşarsa, en eski varlıklar önbellekten silinecektir.
-cachedAssetsLimitValue=fff – Önbelleğe alınmış varlıklar için limit değerini belirtir. fff, değeri temsil eden ondalıklı bir sayıdır. Değerin anlamı, -cachedAssetsLimitType parametresine bağlıdır. Varsayılan değer 0.0’dır.
-overwriteLocalCacheSettings=0/1 – Varlık önbelleği sınırlamaları için hangi ayarların dikkate alınacağını belirtir.
0 – Sunucunun ayarlarını kullanır. Bu varsayılan değerdir. Varlık önbelleği sınırlamaları için sunucunun ayarlarını kullanmanız önerilir.
1 – İstemcinin ayarlarını kullanır.
-limitHosts=N – Dağıtılmış işleme için kullanılan işleme sunucularının sayısını, -renderHost seçeneğinde belirtilen ilk N boş sunucuyla sınırlandırır. Varsayılan değer 0’dır ve bu da tüm kullanılabilir sunucuların kullanılması anlamına gelir.
Yaygın #
-portNumber=n – Dağıtılmış işleme için kullanılacak port numarasını belirtir. Dağıtılmış işlemenin çalışması için işleme sunucularının ve işleme istemcisinin port numaraları eşleşmelidir. Bu komut satırı seçeneği ortam değişkenini geçersiz kılar. Varsayılan değer 20207’dir.
Dağıtılmış İşleme DR2 #
– sunucu – Sunucu modunda başlatılır ve bağlantılar beklenir. Ağdaki başka bir makine (veya istemci iş istasyonunun kendisi) dağıtıcı görevi görmelidir. Özel dağıtıcıların normal sunucular olarak da yanıt vermesine olanak sağlamak için -run-dispatcher ile birlikte kullanılabilir.
– run-dispatcher=1/2 – Bir DR dağıtıcısı (1) veya sunucu olarak gerçek işlemeye de yardımcı olacak bir dağıtıcı (2) olarak hareket etme yeteneğiyle sunucu modunda başlayın. Ancak bu sunucu, başkasının dağıtıcısıyla sunucu olarak kullanılamaz.
– distributed=0/1/2 – dağıtılmış işlemeyi kullanıp kullanmamayı belirtir:
0 – dağıtılmış işlemeyi kullanmayın;
1 – Yerel makine de dahil olmak üzere dağıtılmış işlemeyi kullanın.
2 – Yerel makine hariç, dağıtılmış işlemeyi kullanın. (varsayılan değer 0’dır – dağıtılmış işleme yok)
– renderhost=”host{;host}” – dağıtılmış işleme için bu sunucuları kullanın. Sunucular bilgisayar adı veya IP adresiyle belirtilebilir. Birden fazla -renderhost seçeneği belirtilebilir. -run-dispatcher ile birlikte kullanıldığında, işleme sunucuları için kullanılabilir sunucuların tam listesini ayarlar. Yerel makine istemci olarak hareket ettiğinde, kendi dağıtıcısı olarak işlev görecektir.
– use-dispatcher=”host” – Dağıtılmış işleme için bu sunucuyu dağıtıcı olarak kullanın. -renderhost ile birlikte kullanılamaz. Yerel bilgisayar işlemeye katılamaz.
– distributed-udp – bir DR dağıtıcısına veya render sunucusuna uygulandığında, yerel ağ segmentinde UDP otomatik keşif mekanizmasına katılmasına olanak tanır. Bunun çalışması için dağıtıcı ve sunucuların aynı portta başlatılması gerekir.
– portNumber=n – Dağıtılmış işleme için kullanılacak port numarasını belirtin. Dağıtılmış işlemenin çalışması için işleme sunucularının ve işleme istemcisinin port numaraları eşleşmelidir. Port, VRAY_DR_CONTROLPORT ortam değişkeni kullanılarak da geçersiz kılınabilir. Bu komut satırı seçeneği, ortam değişkenini geçersiz kılar. (varsayılan değer 20209’dur)
– transferAssets=0/1/2 – Eksik varlıkların DR sunucularına aktarılıp aktarılmayacağını belirtir:
0 – Aktarma yapma;
1 – Eksik varlıkları aktar;
2 – Aktarmadan önce varlık önbelleği klasöründe varlıkları kontrol et. Varlık önbelleği klasörünü belirtmek için VRAY_ASSETS_CACHE_PATH ortam değişkeni kullanılabilir; belirtilmezse, varlıklar geçerli kullanıcının geçici klasöründeki “vray_assets_cache” dizininde saklanır. (varsayılan değer 0’dır – varlıkları aktarma)
– cachedAssetsLimitType=0/1/2 – DR sunucusunda önbelleğe alınmış varlıklar için kullanılan sınırlama türü: 0 – sınır yok; 1 – belirtilen saatten daha eski varlıklar silinecektir. 2 – önbellek boyutu, varlık önbelleği belirtilen boyutu (GB) aşarsa, en eski varlıklar önbellekten silinecektir. (varsayılan değer 0 – sınır yok)
– cachedAssetsLimitValue=fff – önbelleğe alınmış varlıklar için limit değerini belirtir. fff, değeri temsil eden ondalıklı bir sayıdır. Değerin anlamı, -cachedAssetsLimitType parametresine bağlıdır. (varsayılan değer 0.0’dır)
– overwriteLocalCacheSettings=0/1 – Varlık önbelleği sınırlamaları için hangi ayarların dikkate alınacağını belirtir. 0 – sunucunun ayarları.
1 – istemcinin ayarları. (varsayılan değer 0’dır – varlık önbelleği sınırlamaları için sunucunun ayarlarını kullanın)
– limitHosts=N – Dağıtılmış işleme için kullanılan işleme sunucularının sayısını, -renderHost parametresinde belirtilen ve rastgele seçilen N sunucuyla sınırlandırır. Uzak bir dağıtıcıya bağlanırken, işleme sunucularının sayısını dağıtıcının yapılandırılmış işleme sunucularının N tanesiyle sınırlandırır (-renderHost dağıtıcılar için yok sayılır). Varsayılan değer 0’dır, tüm kullanılabilir sunucuları kullanın veya uzak bir dağıtıcı için onun karar vermesine izin verin.
– autoCloseIfIdle=n – Sunucunun kendini kapatmadan önce bekleme süresini dakika cinsinden belirtir. 0 değeri bu özelliğin devre dışı olduğunu gösterir; aksi takdirde, bekleme süresini dakika cinsinden temsil eder. Bu seçenek DR2 ile geçici olarak çalışmamaktadır.
– dr:parameter=value – Bir DR dağıtıcısının, render sunucusunun veya bunlara olan ağ bağlantısının performansını ince ayar yapmak için ek parametreler belirtin. Parametreler ve izin verilen değerleri için belgelere bakın.
– secure – -use-dispatcher veya -server ile birlikte kullanıldığında, yukarı akış (istemci veya dağıtıcı) bağlantısına SSL/TLS şifrelemesi sağlar.
