V-Ray App SDK ilə render avtomatlaşdırması: səhnədən çıxışa 6 addım

V-Ray App SDK V-Ray mühərrikindən tətbiqin içində və ya ayrıca prosesdə istifadə edərək renderi başlatmaq və idarə etmək üçün API təqdim edir. Chaos-un rəsmi sənədlərinə əsasən, bu iş axınında səhnə V-Ray plaginləri ilə yaddaşda yaradıla və ya .vrscene faylından yüklənə bilər. Bu bələdçi App SDK-nın əsas render dövrünü və səhnənin müxtəlif mərhələlərində hansı render rejiminin uyğun olduğunu izah edir. Sənədlərdə App SDK üçün qüvvədə olan proqram versiyası göstərilmədiyindən, burada təsvir olunanlar sənədlərdə nümayiş etdirilən ümumi iş axınına əsaslanır.

1. Mühiti hazırlayın

1. App SDK fayllarının yerini müəyyənləşdirin. Sənədlərə əsasən, SDK-dan istifadə etmək üçün VRAY_SDK mühit dəyişəni təyin edilməlidir. Python binding-indən istifadə ediləcəksə, python qovluğu Python modullarının axtarış yollarına əlavə olunmalıdır; sənədlərdə buna PYTHONPATH üzərindən nümunə verilir. Tətbiqin SDK komponentlərini tapa bilməsi üçün bu hazırlıq vacibdir.

2. Hazır mühit skriptini işə salın və ya alternativ yolu nəzərdən keçirin. Sənədlərdə Windows üçün setenv.bat, Linux və macOS üçün isə source setenv.sh istifadə olunur. Bu skriptlər müvafiq mühit dəyişənlərini təyin edir. SDK ikili faylları məhsulun /bin qovluq strukturunda deyilsə, sənədlərdə VRAY_APPSDK_BIN dəyişənindən istifadə oluna biləcəyi qeyd olunur. Mühit dəyişənlərindən istifadə mümkün olmadıqda, API vasitəsilə axtarış yolunu təyin etmək seçimi də var.

Bu mərhələdə kompüterdəki qovluq strukturu ilə tətbiqin SDK kitabxanasını axtardığı yerin uyğunluğunu yoxlamaq lazımdır. Sənədlərdə konkret əməliyyat sistemi quraşdırması və ya aparat tələbləri sadalanmır; buna görə quraşdırma təfərrüatlarında istifadə olunan binding-in öz API sənədlərini əsas götürmək lazımdır.

2. Səhnəni yaradın və ya yükləyin

1. Render nəzarətçisini başladın. App SDK-dakı VRayRenderer sinfi render prosesini başladır və idarə edir. Səhnəni V-Ray plagin obyektləri yaradıb parametrlərini təyin etməklə yaddaşda qurmaq mümkündür; digər seçim V-Ray-in səhnə formatı olan .vrscene faylını yükləməkdir. Sənədlərdə hər iki üsulun birlikdə istifadə edilə biləcəyi də bildirilir.

Səhnənin necə yaradılması mövcud istehsal zəncirindən asılıdır. Məsələn, tətbiq öz səhnə məlumatlarını V-Ray plaginlərinə çevirə və ya əvvəlcədən ixrac edilmiş .vrscene faylını aça bilər. App SDK-nın məqsədi konkret modelləşdirmə proqramını məcburi etmək deyil, V-Ray render mühərriki ilə bu cür inteqrasiya yaratmaqdır.

1. Səhnə hazır olduqdan sonra render rejimini seçin. Sənədlərdə iki əsas seçim təsvir olunur:

Hər iki rejim CPU və GPU seçimləri ilə dəstəklənir. Sənədlərdə GPU tərəfində CUDA və OptiX-in yalnız NVIDIA, Metal və MetalRT-nin isə yalnız Apple üçün olduğu bildirilir. Render növü VRayRenderer obyektinin renderMode xüsusiyyəti ilə seçilir. Sənədlərdə sinif üçün standart rejim Interactive (CPU) kimi göstərilib; buna görə istifadə ediləcək rejim tətbiqin məqsədinə və sistemdəki dəstəyə uyğun olaraq açıq şəkildə seçilməlidir.

3. Renderi başladın və nəticəni əldə edin

1. Render prosesini başladın. start() metodu render prosesini ayrı bir iş parçasında icra edən və gözləmədən geri qayıdan çağırışdır. Bunun sayəsində tətbiq render davam edərkən başqa əməliyyatları yerinə yetirə və ya irəliləyiş təsvirini almaq üçün hazır vəziyyətdə qala bilər. Sənədlərdəki Python nümunəsi səhnəni yükləyir, renderi başladır, tamamlanmasını gözləyir və əldə etdiyi təsviri PNG formatında saxlayır:

import vray

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

Kod nümunəsindəki 6000 dəyəri sənədlərdə waitForRenderEnd çağırışına verilən nümunə arqumentdir; bu, hər səhnə üçün tövsiyə edilən və ya məcburi müddət kimi təqdim olunmur. İstehsal kodunda gözləmə davranışını istifadə edilən API binding-in sənədlərinə uyğun qurmaq lazımdır.

1. Render davam edərkən də təsviri yoxlayın və resursları bağlayın. App SDK render tamamlanmamışdan əvvəl də mövcud təsvir məlumatlarının əldə edilə bildiyini bildirir. Bu xüsusiyyət, xüsusilə Interactive rejimində önizləməni tətbiqin interfeysində göstərmək və ya prosesi izləmək üçün faydalı ola bilər. Sənədlərdə yekun təsvirin hazır olduğu an renderer-in IDLE_DONE vəziyyətinə çatması ilə göstərilir. İş başa çatdıqdan sonra renderer bağlanmalıdır; Python nümunəsində bu həyat dövrünü with bloku idarə edir.

Sənədlərdə həmçinin render vəziyyəti dəyişəndə, V-Ray mesaj yaratdıqda və ya tapşırıq və irəliləyiş məlumatı bildiriləndə hadisələri dinləmək mümkün olduğu izah edilir. Bu bildirişlər inteqrasiyaya yükləmə, render və tamamlanma mərhələlərində tətbiq tərəfindəki davranışları tənzimləməyə kömək edir. Bununla belə, geri çağırış funksiyaları ayrıca iş parçasında işləyir; istifadəçi kodunun ləng işləməsi digər geri çağırışların icrasını gecikdirə bilər.

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

App SDK təkrarlanan render addımlarını tətbiqə inteqrasiya etmək və ya V-Ray səhnəsini fərqli prosesdən idarə etmək istəyən komandalar üçün faydalıdır. Memarlıq ofisləri və archviz istehsalçıları Interactive rejimini səhnə və məzmun sınaqlarında, Production rejimini isə yekun təsvir mərhələsində nəzərdən keçirə bilər. Beləliklə, önizləmə ilə yekun çıxış arasındakı iş rejimini eyni renderer üzərindən dəyişmək mümkündür.

Bununla belə, mənbələrdə konkret 3D proqramı üçün uyğunluq matrisi, aparat tələbləri, lisenziya şərtləri və ya qiymət məlumatı verilmir. CPU və ya GPU seçərkən yalnız sənədlərdə göstərilən render seçimlərini və müvafiq GPU texnologiyalarının platforma məhdudiyyətlərini nəzərə almaq olar; performans nəticəsi barədə isə nəticə çıxarmaq mümkün deyil. Tətbiq inteqrasiyası qurulmazdan əvvəl istifadə olunan dil binding-inin API sənədlərini və SDK kitabxanalarının yerləşəcəyi qovluq strukturunu yoxlamaq lazımdır.

Tez-tez edilən səhvlər

• VRAY_SDK və ya uyğun alternativ yol təyin edilmədən SDK binding-ini başlatmaq kitabxanaların tapılmamasına səbəb ola bilər.

• start() çağırışını renderin tamamlanması kimi yozmaq düzgün deyil; sənədlərdə bu metod asinxron və gözləmədən geri qayıdan çağırış kimi təsvir olunur.

• Render davam edərkən PREPARING vəziyyətində səhnə və ya renderer üzərində dəyişiklik etməyə cəhd rədd edilə bilər. Sənədlərdə bu xəbərdarlıq startSync() əvəzinə start() istifadə edilən hal üçün verilir.

• V-Ray hadisələrinə qoşulan ləng geri çağırışlar digər geri çağırışların icrasını gecikdirə bilər; buna görə hadisə emalçılarının gördüyü işə diqqət yetirilməlidir.

• Nümunə kodundakı gözləmə arqumentini hər layihədə tətbiq ediləcək sabit parametr kimi istifadə etmək sənədlərdə verilən məlumatı aşır.

Bu sənədləşmə istifadəçi interfeysində konkret render parametrlərinin necə seçiləcəyini deyil, App SDK vasitəsilə səhnə yükləmə və render idarəetməsinin əsaslarını izah edir. Tətbiq daxilindəki təfərrüatlı parametrlər üçün müvafiq binding-in API arayışına baxılmalıdır.