Blender Python API ilə Image məlumatı və ImageTexture teksturaları

Bu bələdçidə nə öyrənəcəksiniz?

Blender Python API-dən istifadə edərək Image məlumat bloku yaratmağı, təsvir buferini miqyaslandırmağı və piksel dəyərlərini dəyişməyi öyrənəcəksiniz. Həmçinin edilən dəyişikliklərin təsvirə əks olunması üçün update() çağırışının rolunu və Image məlumat blokunu kopyalayarkən buferlə bağlı nəzərə alınmalı məqamları araşdıracağıq. Son bölümdə ImageTexture seçimlərinin teksturanın təkrarlanması, alfa və təsvir sərhədləri ilə əlaqəsinə baxacağıq.

Bu izah təsvir məlumatlarını skriptlərlə hazırlamaq və ya tekstura davranışını daha dəqiq araşdırmaq istəyən memarlıq vizuallaşdırması komandaları və Blender istifadəçiləri üçün nəzərdə tutulub. Nümunələr API sənədlərində izah edilən əməliyyatlarla məhdudlaşır; səhnəyə material təyin etmək və ya düyün şəbəkəsi qurmaq addımları bu çərçivəyə daxil deyil.

Tələblər

• Blender daxilində Python API-yə giriş tələb olunur. Mənbələr Blender-in cari API sənədləridir; göstərilən əməliyyatlar üçün tələb olunan minimum Blender versiyası bu səhifələrdə açıqlanmır.

• Kod nümunələrində Blender Python mühitində bpy modulundan istifadə edilir. Mənbələrdə xarici hesab tələbi göstərilmir.

• API sənədlərində bu əməliyyatlar üçün avadanlıq tələbləri, ödəniş və ya lisenziya xərcləri barədə məlumat verilmir. Bu məsələlərlə bağlı konkret tələb fərz edilməməli, istifadə olunacaq versiya və iş mühiti ayrıca yoxlanmalıdır.

Image məlumat bloku ilə addım-addım işləyin

1. Təsvir məlumat bloku yaradın

bpy.data.images.new() ilə yeni Image məlumat bloku yarada bilərsiniz. Aşağıdakı nümunədə mənbə sənəddəki başlanğıc ölçüdən istifadə olunur. size xüsusiyyəti təsvir buferinin en və hündürlüyünü piksel ilə oxumağa imkan verir.

import bpy

image_src = bpy.data.images.new("Mimari_Kontrol", 1024, 102)
print(image_src.size)

Image məlumat blokunu təsvirin özündəki bütün məlumatların saxlandığı yer kimi qəbul etmək olmaz. Sənədlərdə bildirilir ki, piksel buferi və ölçü kimi məlumatlar təsvir buferində saxlanılır; Image məlumat bloku isə təsvir faylına və ya yaradılmış təsvirə istinad edir. Bu fərq, xüsusilə buferdə dəyişiklik edib sonra məlumat blokunu kopyalayarkən əhəmiyyətlidir.

2. Buferi miqyaslandırın və dəyişikliyi təsvirə tətbiq edin

scale() təsvir buferinin ölçüsünü dəyişir. pixels xüsusiyyəti üzən nöqtəli dəyərlərdən ibarət piksel buferinə giriş verir. Aşağıdakı nümunə təsviri 1024 × 720 ölçüsünə miqyaslandırır, buferin ilk dörd dəyərini dəyişir və sonra təsviri yeniləyir.

image_src.scale(1024, 720)
image_src.pixels[0:4] = (0.5, 0.5, 0.5, 0.5)
image_src.update()

print(image_src.size)
print(image_src.pixels[0:4])

Bu kod yalnız buferin ilk dörd dəyərinə qiymət verir; bu, təsvirin hamısının doldurulduğu demək deyil. update() çağırışı üzən nöqtəli buferdəki dəyişikliyin təsvirin göstərilməsində əks olunmasını təmin edir. Nəticə gözləniləndən fərqlidirsə, əvvəlcə istifadə olunan dəyişənin düzgün Image məlumat blokuna istinad etdiyini və yeniləmə çağırışının işlədiyini yoxlayın.

3. Kopyalama davranışını yoxlayın

Image məlumat blokunu kopyalamaq buferdəki dəyişikliklərin də avtomatik kopyalanması demək deyil. Sənədlərdə buferlərin müxtəlif Image məlumat blokları arasında paylaşılmadığı və təsvir kopyalandıqda çoxaldılmadığı barədə xəbərdarlıq var. Buna görə diskdə saxlanmamış bufer redaktələri surətdə olmaya bilər.

image_dest = image_src.copy()
image_dest.update()

print(image_dest.size)
print(image_dest.pixels[0:4])

Surət yaradıldıqdan sonra ölçünü və bufer dəyərlərini ayrıca yoxlayın. Mənbə təsvirdə etdiyiniz son dəyişikliklərin surətdə olacağını fərz etməyin. Buferdəki dəyişikliklərin surətə keçməsi lazımdırsa, əvvəlcə təsviri diskdə saxlamağın tələb olunub-olunmadığını nəzərdən keçirin və surəti yoxlayın.

4. Təsviri yadda saxlayın və ya layihə faylına paketləyin

Image API təsviri yadda saxlamaq üçün save(), səhnənin render parametrlərindən istifadə edərək müəyyən yola saxlamaq üçün isə save_render() funksiyalarını təklif edir. pack() təsviri .blend faylına daxil edilmiş məlumat kimi əlavə etmək üçün istifadə edilə bilər.

image_src.pack()

Paketləmə, yadda saxlama və yenidən yükləmə müxtəlif əməliyyatlardır. API-də unpack() paketlənmiş təsviri diskə çıxarır, reload() isə təsviri mənbə yolundan yenidən yükləyir. Hansı üsulun uyğun olması təsvirin fayl yolunu və layihədəki məlumatları necə idarə etmək istədiyinizdən asılıdır. Təhvil verməzdən əvvəl təsvirin gözlənilən yerdə olduğunu və layihə faylındakı vəziyyətini yoxlayın.

ImageTexture parametrlərini necə seçmək olar?

ImageTexture seçimləri təsvirin tekstura kimi necə işlənəcəyini müəyyən edir. extension xüsusiyyəti təsvirin öz sərhədlərindən kənardakı sahənin davranışını seçir. REPEAT təsviri üfüqi və şaquli istiqamətdə təkrarlayır; EXTEND kənar pikselləri uzadır; CLIP isə təsvir ölçüsündən kənarı şəffaf saxlayır. Sənədlərdə CLIP_CUBE və CHECKER də seçimlər arasında göstərilir.

repeat_x və repeat_y üfüqi və şaquli təkrar əmsallarını ayrı-ayrılıqda müəyyən edir. Alfa istifadəsi üçün use_alpha, alfa dəyərlərini tərsinə çevirmək üçün isə invert_alpha mövcuddur. use_interpolation interpolasiyaya, filter_size isə interpolasiyada istifadə olunan filtr ölçüsünə təsir edir. Bu parametrləri araşdırarkən mənbə təsvirin alfa kanalını və teksturanın istifadə formasını nəzərə alın.

Image API alfa göstərilməsi üçün STRAIGHT, PREMUL, CHANNEL_PACKED və NONE seçimlərini sadalayır. Sənədlərdə CHANNEL_PACKED müxtəlif təsvirlərin RGB və alfa kanallarına paketləndiyi, kanalların isə bir-birinə təsir etməməli olduğu istifadə forması kimi izah edilir. Mənbə faylın kanal düzümü məlum deyilsə, alfa parametrlərini dəyişməzdən əvvəl təsvirin necə hazırlandığını yoxlayın.

Tez-tez edilən səhvlər

• Buferin də surətləndiyini fərz etmək: Yadda saxlanmamış dəyişikliklər surətdə olmaya bilər. Surətin ölçüsünü və bufer dəyərlərini yoxlayın.

• Dəyişiklikdən sonra update() çağırışını unutmaq: Buferdə dəyişiklik etdikdən sonra təsviri yeniləyin.

• Tekstura sərhədlərindəki davranışı yoxlamamaq: REPEAT, EXTEND və CLIP fərqli nəticələr verir. Təsvirin kənarlarında hansı davranışın lazım olduğunu müəyyən edin.

• Alfa parametrlərini mənbə təsvirdən asılı olmayaraq dəyişmək: Alfa kanalının istifadə edilib-edilmədiyini və hansı alfa rejiminin uyğun olduğunu yoxlayın.

• Yadda saxlama və paketləməni eyni əməliyyat hesab etmək: save(), pack(), unpack() və reload() fərqli məqsədlərə xidmət edir. Layihə faylındakı və diskdəki təsvir vəziyyətlərini ayrı-ayrılıqda yoxlayın.

Növbəti addımlar

Əməliyyatları əvvəlcə kiçik bir test faylında tətbiq edin. Təsviri yaratdıqdan sonra ölçüsünü çap edin; miqyaslandırma və piksel dəyişikliyindən sonra buferi yeniləyib dəyərləri yenidən yoxlayın. Kopyalama davranışını sınaqdan keçirərkən mənbə və surət dəyərlərini müqayisə edin. Daha sonra ImageTexture üçün sərhəd davranışını və təkrar parametrlərini nəzarətli şəkildə sınayın. Memarlıq vizuallaşdırması səhnəsinə keçməzdən əvvəl mənbə təsvirin fayl yolunu, alfa istifadəsini və layihəyə paketlənib-paketlənməyəcəyini yoxlayın.

Mənbə və lisenziya

Bu bələdçi Blender-in rəsmi Python API sənədlərindəki bpy.types.Image və bpy.types.ImageTexture səhifələrinə əsaslanır. Hər iki mənbə CC BY-SA 4.0 lisenziyalıdır; məzmun Azərbaycan dilinə uyğunlaşdırılıb.