V-Ray App SDK bələdçisi: Python ilə səhnə yükləmək və render almaq

V-Ray App SDK V-Ray render mühərrikini tətbiqə inteqrasiya etmək istəyən tərtibatçılar üçün API təqdim edir. Rəsmi sənədlərdə render prosesinin əsas tətbiqin prosesi daxilində icra oluna biləcəyi və ya paylanmış renderdən istifadə etməklə bu prosesdən kənarda yerinə yetirilə biləcəyi bildirilir. C++, C#, Python və Node.js bağlamaları olan SDK səhnə yükləmə, render rejimlərinin seçilməsi və prosesin vəziyyətinin izlənməsi addımlarını əhatə edir. Aşağıdakı bələdçi sənədlərdəki Python nümunəsinə əsaslanır; mənbədə konkret SDK versiyası göstərilmədiyi üçün addımlar versiya nömrəsinə bağlanmır.

1. SDK fayllarının və Python modulunun yolunu təyin edin

V-Ray App SDK-nın tələb olunan kitabxanaları tapa bilməsi üçün sənədlərdə ilk növbədə VRAY_SDK mühit dəyişəni göstərilir. Bu dəyişən təyin edildikdə SDK bağlaması V-Ray kitabxanasını və asılılıqlarını VRAY_SDK/bin daxilində axtarır. Məhsulun qovluq strukturunda /bin qovluğu yoxdursa, ikili faylların yerləşdiyi qovluq birbaşa VRAY_APPSDK_BIN vasitəsilə göstərilə bilər. Mühit dəyişənlərindən istifadə mümkün olmadıqda axtarış yolu iş zamanı da təyin edilə bilər.

Python bağlamasının işləməsi üçün SDK daxilindəki python qovluğunu Python modul axtarış yollarına əlavə etmək lazımdır. Sənədlərdə bunun PYTHONPATH vasitəsilə edilə biləcəyi bildirilir. Chaos-un setenv skripti tələb olunan mühit dəyişənlərini təyin edə bilər: Windows-da setenv.bat, Linux və MacOS-da isə source setenv.sh istifadə olunur. Python-da kitabxana qovluğunu iş zamanı göstərmək lazım gəldikdə vray.setSDKLibraryPath(bin_folder) metodundan istifadə etmək mümkündür.

Bu iki yol tələbini ayrı-ayrılıqda yoxlayın: Python-ın vray modulunu tapması ilə V-Ray ikili fayllarının tapılması eyni məsələ deyil. VRAY_SDK istifadə edilirsə, sənədlərdə göstərilən /bin mövqeyini yoxlayın; qovluq strukturu fərqlidirsə, VRAY_APPSDK_BIN və ya iş zamanı axtarış yolunun təyin edilməsi variantını nəzərdən keçirin.

2. Səhnəni yükləyin və renderi başladın

Əsas axında əvvəlcə konfiqurasiya edilə bilən VRayRenderer obyekti yaradılır. Səhnəni V-Ray-in yerli səhnə formatı olan .vrscene faylından yükləmək və ya tətbiqdəki səhnə təsvirini V-Ray plaginlərinə çevirərək yaddaşda hazırlamaq mümkündür. Daha sonra start() çağırışı ilə render başladılır, görüntü əldə edilərək fayla yazılır və resurslar bağlanır.

Aşağıdakı Python nümunəsi sənədlərdəki əsas axını göstərir:

import vray

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

start() gözləmədən geri qayıdan çağırışdır; V-Ray mühərriki render prosesini ayrıca axında icra edir. Nümunədəki waitForRenderEnd(6000) renderin bitməsini gözləyən çağırışdır. Buradakı 6000 sənədləşdirmə nümunəsində verilən dəyərdir; hər səhnə üçün tövsiyə edilən və ya zəmanətli render müddəti demək deyil. getImage() həmin andakı görüntü məlumatını əldə edir, save() isə nümunədə bu görüntünü PNG faylına yazır. Sənədlərdəki ümumi iş axınına proses başa çatdıqda renderer resurslarının bağlanması da daxildir.

3. Önizləmə və yekun nəticə üçün rejimi seçin

V-Ray App SDK Interactive və Production olmaqla iki render rejimi təqdim edir. Interactive səhnə parametrlərini sınaqdan keçirərkən sürətli önizləmə və keyfiyyətin mərhələli şəkildə artırılmasını təmin edir. Production isə konfiqurasiyası tamamlanmış səhnədən yekun görüntü almaq üçün uyğundur. Sənədlərdə VRayRenderer sinfinin standart rejiminin Interactive (CPU) olduğu bildirilir.

Hər iki rejim CPU və ya GPU ilə işləyə bilər. Sənədlərdə GPU üçün NVIDIA sistemlərində CUDA və OptiX, Apple sistemlərində isə Metal və MetalRT seçimləri sadalanır. Hansı seçimin istifadə ediləcəyi mövcud avadanlıq və iş mühitinə əsasən müəyyənləşdirilməlidir; mənbədə bütün səhnələr üçün keçərli olan vahid seçim tövsiyə edilmir.

Render rejimini VRayRenderer obyektinin renderMode xüsusiyyəti vasitəsilə dəyişmək mümkündür. Sənədlərdə fərqli renderlər arasında keçid zamanı səhnəni yenidən yükləməyə və ya renderer-i yenidən yaratmağa ehtiyac olmadığı bildirilir. Beləliklə, eyni səhnəni əvvəlcə Interactive rejimdə yoxlayıb, sonra Production rejiminə keçirmək mümkündür.

4. Renderin gedişatını və problemləri izləyin

Tətbiq renderer-in vəziyyət dəyişikliyi hadisəsini dinləyərək renderin başlaması, tamamlanması və ya xəta səbəbindən dayanması kimi hadisələri izləyə bilər. Yekun görüntü IDLE_DONE vəziyyətində hazır olur; render davam edərkən həmin ana qədər əldə edilən görüntünü də almaq mümkündür.

Asinxron start() çağırışında PREPARING vəziyyəti vacibdir. Sənədlərdə bu mərhələ başa çatmadan səhnədə və ya renderer-də dəyişiklik edilməməli olduğu, belə cəhdlərin rədd ediləcəyi bildirilir. V-Ray-in səhnə yüklənərkən və render zamanı yaratdığı mesajları da log hadisəsi ilə tutmaq mümkündür. Bu hadisə mesaj mətnindən əlavə məlumat, xəbərdarlıq, xəta və ya sazlama səviyyəsini də ötürə bilir.

Hadisə callback-ləri render axınından ayrı bir axında işləyir. Bu quruluş callback əməliyyatlarının render prosesinə əlavə yük yaratmadan icra olunmasını nəzərdə tutur; lakin ləng callback-lər digər callback-lərin işini gecikdirə bilər. Buna görə hadisə emalçılarını qısa saxlamaq və ağır işləri birbaşa callback daxilində yerinə yetirməmək məqsədəuyğundur.

Memarlıq və vizuallaşdırma iş axınına təsiri

App SDK V-Ray renderini başqa proqram təminatına inteqrasiya etmək və ya render prosesini xüsusi tətbiqdən idarə etmək istəyən tərtibatçılar və texniki qruplar üçün əhəmiyyətlidir. Memarlıq, interyer dizaynı və archviz sahələrində .vrscene yükləmə və render alma axınını daha geniş iş prosesinə daxil etmək mümkündür. Bununla belə, sənədlərdə hazır memarlıq proqramı inteqrasiyası və ya istifadəçi interfeysi təqdim olunduğu deyilmir; SDK-dan istifadə proqram təminatının hazırlanmasını tələb edir.

Tətbiqə keçməzdən əvvəl Python modul yolunun, V-Ray kitabxana qovluğunun və seçilmiş CPU/GPU rejiminin iş mühitinə uyğun olduğu yoxlanmalıdır. Mənbələrdə qiymət, lisenziya şərtləri və versiyalararası uyğunluq haqqında məlumat yoxdur; bu məsələlər ayrıca yoxlanmalıdır. İstehsal prosesinə keçməzdən əvvəl seçiləcək render rejiminin mövcud avadanlıqla işlədiyini sınaqdan keçirmək də vacibdir.

Tez-tez edilən səhvlər

• Qovluq strukturunu yoxlamadan yalnız VRAY_SDK təyin etmək, lazım gəldikdə VRAY_APPSDK_BIN və ya iş zamanı axtarış yolu seçimlərini nəzərdən keçirməmək.

• Python modul yolunu V-Ray ikili fayllarının axtarış yolu ilə eyni parametr hesab etmək.

• start() çağırışından sonra PREPARING mərhələsində səhnə və ya renderer parametrlərini dəyişməyə çalışmaq.

• Nümunədəki 6000 dəyərini hər render üçün dəqiq gözləmə müddəti hesab etmək.

• Render zamanı aralıq görüntü əldə etməyin mümkün olduğunu, tamamlanmış görüntünün isə IDLE_DONE vəziyyətində hazır olduğunu gözdən qaçırmaq.