V-Ray App SDK ilə render avtomatlaşdırması: səhnənin yüklənməsi və nəticənin alınması

V-Ray Application SDK (App SDK) üçüncü tərəf tətbiqlərə V-Ray mühərrikini başladıb idarə etmək imkanı verir. Chaos-ın App SDK sənədlərində səhnənin yaddaşda V-Ray plaginlərinə çevrilməsi və ya .vrscene faylından yüklənməsi, renderin başladılması və nəticənin təsvir kimi alınması izah olunur. Bu bələdçi memarlıq və vizuallaşdırma alətlərinə render inteqrasiyası hazırlayan komandalar üçün SDK-nın əsas iş axınını nəzərdən keçirir. Sənədlərdə konkret V-Ray və ya App SDK versiyası göstərilmədiyindən addımlar sənədləşdirilmiş App SDK interfeysinə aiddir.

1. SDK-nı iş mühitinə hazırlayın

App SDK-nın əsas komponenti VRayRenderer sinfidir. Bu sinif səhnənin yüklənməsi, renderin başladılması və təsvirə giriş kimi əməliyyatları bir araya gətirir. İşə başlamazdan əvvəl kitabxana fayllarının yerləşdiyi qovluq tətbiq üçün əlçatan olmalıdır.

1. SDK-nın yerləşdiyi yolu göstərmək üçün VRAY_SDK mühit dəyişənini təyin edin. Python bağlamasından istifadə edəcəksinizsə, SDK-nın içindəki python qovluğu Python modul axtarış yollarında olmalıdır; sənədlərdə bunun üçün PYTHONPATH istifadəsi nümunə göstərilir.

2. Sənədlərdə Windows üçün setenv.bat, Linux və macOS üçün isə source setenv.sh skriptləri göstərilir. Bu skriptlər hər iki mühit dəyişənini təyin edir.

3. VRAY_SDK təyin edildikdə bağlama VRaySDKLibrary ikilisini və onun asılılıqlarını VRAY_SDK/bin qovluğunda axtarır. Məhsulun qovluq strukturunda /bin yoxdursa, VRAY_APPSDK_BIN dəyişənindən istifadə etmək mümkündür; bu halda ikili fayllar göstərilən qovluqda axtarılır.

4. Mühit dəyişənlərinin istifadə oluna bilmədiyi quraşdırmada kitabxana axtarış yolu iş zamanı təyin edilə bilər. Sənədlərdə Python üçün vray.setSDKLibraryPath(bin_folder), C++ üçün isə VRayInit konstruktoru nümunə göstərilir.

Bu hazırlıq, xüsusilə başqa proqramın daxilinə yerləşdirilən və ya müstəqil işləyən inteqrasiya üçün vacibdir: SDK bağlaması render başlamazdan əvvəl V-Ray kitabxanalarını və tələb olunan asılılıqları tapa bilməlidir. İstifadə olunan dilin bağlama sənədlərində müvafiq başlatma üsulunun təfərrüatları ayrıca yoxlanmalıdır.

2. Səhnəni yükləyib render alın

Əsas iş axını VRayRenderer yaratmaq, səhnə hazırlamaq və ya fayldan yükləmək, renderi başlatmaq, təsviri əldə etmək və resursları bağlamaqdan ibarətdir. Səhnə V-Ray plaginlərinin parametrlərini sazlayaraq yaddaşda qurula və ya .vrscene faylından oxuna bilər. Nümunədə Python vasitəsilə faylın yüklənməsi və PNG nəticəsinin alınması göstərilir:

import vray
with vray.VRayRenderer() as renderer:
    renderer.load('./intro.vrscene')
    renderer.start()
    renderer.waitForRenderEnd(6000)
    image = renderer.getImage()
    image.save('intro.png')

start() asinxron işləyir: V-Ray mühərriki ayrıca axında renderi davam etdirərkən əsas tətbiqin icrası tamamilə renderə bağlanmır. getImage() yalnız proses başa çatdıqda deyil, render davam edərkən də həmin andakı təsvir məlumatlarını əldə edə bilər. Beləliklə, tətbiq aralıq təsviri göstərə və ya dəstəklənən sıxılma formatlarından biri ilə fayla yaza bilər. Renderin tamamlanmasını gözləmək üçün sənədlərdə waitForRenderEnd() istifadə olunur; nümunələrdəki parametrin vahidi mənbədə izah edilmir, buna görə burada zaman vahidi fərz edilməməlidir.

Tətbiq işini başa çatdırdıqda renderer bağlanmalı və ayrılmış yaddaş resursları azad edilməlidir. Python-da kontekst meneceri nümunəsi rendererin həyat dövrünü idarə edir; digər dil bağlamalarında bağlama addımı üçün müvafiq API qarşılığından istifadə olunmalıdır.

3. Önizləmə və son render üçün rejimi seçin

App SDK iki əsas render rejimi təklif edir. Interactive təsviri tez önizləmək və məzmun və ya səhnə parametrlərini sınayarkən gedişatı görmək üçün nəzərdə tutulub. Production isə səhnə diqqətlə sazlandıqdan sonra hədəflənən son təsviri almaq üçündür; bütün təsvirin hazır olması daha uzun çəkə bilər.

Sənədlərdə VRayRenderer sinfinin standart rejimi Interactive (CPU) kimi göstərilir. GPU tərəfində CUDA və OptiX NVIDIA, Metal və MetalRT isə Apple üçün sadalanıb. Bu seçimlər hər kompüterdə hər render növünün mümkün olduğu demək deyil: iş stansiyasının və SDK quraşdırmasının seçilən yolu dəstəklədiyi yoxlanmalıdır.

Rejimi VRayRenderer obyektinin renderMode xüsusiyyəti vasitəsilə təyin etmək olar. Sənədlərə görə renderlər arasında rejimi dəyişmək üçün səhnəni yenidən qurmaq və ya yükləmək lazım deyil. Bu, dizayn zamanı Interactive rejimində işləyib son mərhələdə Production-a keçməyə eyni inteqrasiya axınında imkan verir.

4. Vəziyyət və xətaların izlənməsini inteqrasiyaya əlavə edin

Render arxa planda işləyərkən SDK hadisələr yaradır. Vəziyyət dəyişikliyi hadisəsi renderin başlaması, tamamlanması və ya xəta səbəbindən dayanması kimi keçidləri tətbiqə bildirmək üçün istifadə edilə bilər. Son təsvirin hazır olduğu vəziyyət IDLE_DONE-dur; proses davam edərkən də aralıq təsvirləri əldə etmək mümkündür.

Jurnal mesajı hadisəsində mətn və səviyyə məlumatı verilir. Sənədlərdə səviyyələr info, warning, error və debug kimi sıralanır. Tətbiq bu mesajları öz diaqnostika axınına ötürərək səhnənin yüklənməsi və render mərhələlərindəki problemləri görünən edə bilər.

Hadisə geri çağırışları render axınından ayrı bir axında icra olunur. Bu quruluş yavaş geri çağırışın render müddətinə təsir etməsinin qarşısını almağı hədəfləyir; bununla belə, yavaş istifadəçi geri çağırışları digər geri çağırışların icrasını gecikdirə bilər. Həmçinin, asinxron start() çağırışından sonra renderer PREPARING vəziyyətindən çıxana qədər səhnə və ya renderer dəyişdirilməməlidir; sənədlərdə bu müddətdə edilən dəyişikliklərin rədd olunacağı bildirilir.

Memarlıq və archviz iş axınında nə dəyişir?

App SDK, modelləşdirmə interfeysindəki konkret menyu parametrindən daha çox V-Ray-i başqa tətbiqin iş axınına qoşmaq üçün əhəmiyyətlidir. Məsələn, komanda öz səhnə hazırlama alətində .vrscene yükləmə, render başlatma, gedişat təsvirini əldə etmə və nəticəni yadda saxlama addımlarını bir araya gətirə bilər. Burada üstünlük render mühərrikini tətbiqin daxilindən idarə etmək və önizləmə ilə son renderi eyni renderer vasitəsilə icra etməkdir.

Ofislər əvvəlcə istifadə etdikləri dil bağlamasını, V-Ray kitabxanalarının yerini və hədəf maşındakı CPU/GPU seçimini yoxlamalıdır. Mənbələr lisenziya şərtləri, qiymət, konkret host proqramı ilə uyğunluq və ya avadanlıq tələbləri barədə məlumat vermir; bunlarla bağlı fərziyyə yürütmək olmaz. Səhnə vəziyyətini və jurnalları izləmək istifadəçiyə yalnız render düyməsi təqdim etməkdən daha etibarlı inteqrasiya qurmağa kömək edir.

Tez-tez edilən səhvlər

• VRAY_SDK və ya Python istifadə edilirsə modul yolu təyin edilmədən SDK bağlamasını başlatmaq. Kitabxana və ya Python modulu tapılmadıqda əvvəlcə mühit dəyişənlərini və qovluq yollarını yoxlayın.

• start() çağırışını sinxron əməliyyat kimi qəbul edib renderin dərhal tamamlandığını fərz etmək. Çağırış arxa planda işləyir; tətbiq tamamlanma vəziyyətini izləməlidir.

• PREPARING mərhələsində səhnə və ya renderer üzərində dəyişiklik etmək. Vəziyyət dəyişikliyi hadisəsindən istifadə edərək düzəlişləri təhlükəsiz mərhələyə saxlayın.

• Callback daxilində uzunmüddətli əməliyyatlar icra etmək. Sənədlərdə bunun digər callback-ləri gecikdirə biləcəyi bildirilir; ağır işləri hadisə emalçısından ayrı idarə edin.