Qısaca
- Blender API-də Image datablock-u fayldan, paketlənmiş məlumatlardan və ya yaradılmış təsvirlərdən qaynaqlana bilər.
- Piksel buferindəki dəyişikliklərin görüntülənməsi üçün `update()` çağırışından istifadə etmək olar.
- Image Texture xüsusiyyətlərinə uzatma üsulu, alfa istifadəsi və təkrarlama kimi parametrlər daxildir.
- Mənbə sənədlər xəbərdarlıq edir ki, redaktə edilmiş bufer saxlanmadan təsvir datablock-unu kopyalamaq dəyişiklikləri kopyaya ötürməyə bilər.
Bu təlimatda nələri öyrənəcəksiniz?
Blender-in Python API-sində təsviri Image datablock-u vasitəsilə idarə etməyi, piksel buferində kiçik dəyişiklik etməyi və nəticəni yeniləməyi öyrənəcəksiniz. Həmçinin ImageTexture üçün sənədləşdirilmiş əsas parametrlərin nə demək olduğunu və memarlıq səhnələri üçün tekstura hazırlayarkən nələrə diqqət etməli olduğunuzu görəcəksiniz.
Bu təlimatda təsvirin materiala bağlanması və ya müəyyən menyu yolu ilə səhnəyə əlavə edilməsi izah olunmur. Mənbə sənədlər Image və ImageTexture məlumat növlərinin xüsusiyyətlərini izah edir; buna görə addımlar həmin xüsusiyyətlərlə məhdudlaşır.
Tələblər
Blender daxilində işlədilə bilən Python kodu və
bpyAPI-sinə giriş tələb olunur. Mənbə nümunəsibpy.data.imagesvasitəsilə təsvir yaradır.Mənbələr Blender-in cari API sənədləridir; sənədlərdə konkret Blender versiya nömrəsi göstərilmir. İstifadə etdiyiniz versiyada API xüsusiyyətlərinin uyğunluğunu ayrıca yoxlayın.
Sənədlərdə hesab, lisenziya və ya ödəniş şərtləri barədə məlumat yoxdur; bu təlimat belə bir tələb irəli sürmür.
Nümunədə təsvir kod daxilində yaradılır. Xarici fayl yolu və ya hazır tekstura faylından istifadə etmək lazım deyil.
Addım-addım: təsvir yaratmaq və piksel buferini yeniləmək
1. Yeni təsvir datablock-u yaradın
Image datablock-u təsvir və ya video faylına, paketlənmiş məlumatlara, yaxud yaradılmış məzmuna istinad edən wrapper-dir. Təsvirin piksel buferi və rezolyusiya kimi məlumatları isə görüntü buferində saxlanılır. Sənədlərdəki nümunə bpy.data.images.new() çağırışı ilə yeni təsvir yaradır.
Aşağıdakı kod nümunə təsvir yaradır, ölçüsünü konsola yazdırır, buferin ilk dörd dəyərini dəyişir və görünüşü yeniləyir:
import bpy
image = bpy.data.images.new("Facade_Test", 1024, 1024)
print(image.size)
print(image.pixels[0:4])
image.pixels[0:4] = (0.5, 0.5, 0.5, 0.5)
image.update()
print(image.pixels[0:4])pixels üzən nöqtəli dəyərlərdən ibarət piksel buferidir. Bu nümunədə yalnız ilk dörd dəyər təyin olunur; bu, bütün teksturanı və ya bütöv memarlıq səthini rəngləmək demək deyil. update() buferdəki dəyişikliyi görüntülənən təsvirə tətbiq edir. size xüsusiyyəti buferin enini və hündürlüyünü piksel ilə göstərir.
2. Təsvir buferini miqyaslayın
Təsvir datablock-unda scale(width, height) metodu var. Sənədlərdəki nümunə buferi 1024 × 720 ölçüsünə miqyaslayır. Öz işinizdə hədəf ölçünü kodda dəqiq göstərin, sonra size dəyərini yoxlayın. Miqyaslama təsvir buferini dəyişir; bu, öz-özlüyündə faylı saxlamaq demək deyil.
Xüsusilə fasad üzlüyü, döşəmə naxışı və ya interyer materialı üçün hazırlanan təsvirlərdə səhnədə istifadə olunacaq ölçünü əvvəlcədən müəyyənləşdirmək iş axınını daha aydın edir. Lakin sənədlərdə konkret render rezolyusiyası və ya memarlıq teksturaları üçün tövsiyə olunan piksel ölçüsü verilmədiyinə görə, bu dəyərlər layihəyə uyğun seçilməlidir.
3. Image Texture parametrlərini ehtiyacınıza uyğun qiymətləndirin
ImageTexture bir Image obyektinə istinad edə bilər və təsvir sərhədlərindən kənarda necə davranacağını müəyyənləşdirən extension xüsusiyyətinə malikdir. Sənədləşdirilmiş seçimlər bunlardır:
REPEAT: Təsviri üfüqi və şaquli istiqamətlərdə təkrarlayır.EXTEND: Təsvirin kənar piksellərini xaricə doğru uzadır.CLIP: Təsvir sərhədlərindən kənarı şəffaf edir.CLIP_CUBE: Təsvir xaricindəki sahəni kub formalı bölgə ilə məhdudlaşdırır və qalan hissəni şəffaf edir.CHECKER: Təsviri dama taxtası düzümündə təkrarlayır.
Texture xüsusiyyətlərinə repeat_x və repeat_y təkrarlama əmsalları, alfa məlumatının istifadəsi üçün use_alpha, alfa dəyərlərinin tərsinə çevrilməsi üçün invert_alpha və piksellərin seçilmiş filtrlə interpolasiyası üçün use_interpolation daxildir. Sənədlərdə repeat_x və repeat_y üçün diapazon 1–512 olaraq göstərilir. Bu parametrlərdən istifadə edərkən məqsədin təkrarlama, kənarları uzatma, yoxsa sərhəddə kəsmə olduğunu müəyyən edin.
Təsvirin alfa kanalı da müxtəlif üsullarla işlənə bilər. Image.alpha_mode seçimlərinə STRAIGHT, PREMUL, CHANNEL_PACKED və NONE daxildir. Mənbə sənədlər bunların fərqli alfa təqdimatlarını təsvir etdiyini bildirir; buna görə kanal-paketlənmiş faylın alfa məlumatını adi şəffaflıq kimi şərh etmək olmaz.
4. Kopyalama və saxlama davranışını yoxlayın
API sənədlərindəki vacib xəbərdarlıq budur: təsvir datablock-u kopyalansa belə, görüntü buferinin kopyalanmış təsvirə ötürüləcəyinə zəmanət verilmir. Buferdə etdiyiniz dəyişiklik hələ diskə yazılmayıbsa, copy() ilə yaradılan yeni datablock redaktə edilmiş bufer əvəzinə təsvirin ilkin vəziyyətini saxlaya bilər. Sənədlərdəki nümunədə kopya yeniləndikdə ölçü və rənglərin orijinal təsvirin yaradıldığı vaxtdakı vəziyyətinə qayıtdığı göstərilir.
Təsviri saxlamaq üçün save(), səhnənin render parametrlərindən istifadə edərək müəyyən yola saxlamaq üçün isə save_render() sənədləşdirilib. save() daxilindəki save_copy seçimi təsvirin cari fayl yolunu dəyişmədən onun nüsxəsini saxlamağa imkan verir. Buna görə redaktə edilmiş buferi çoxaltmaq lazımdırsa, əvvəlcə saxlama və kopyalama ardıcıllığını sınaqdan keçirin; yalnız datablock-un kopyalanmasına güvənməyin.
Tez-tez edilən səhvlər
update()çağırışını buraxmaq: Bufer dəyərləri dəyişdirilsə də, sənədlərdə görüntülənən təsvirin yenilənməsi üçünupdate()metodu göstərilir.Kopyanın redaktələri avtomatik mənimsədiyini düşünmək: Saxlanmamış bufer dəyişiklikləri kopyaya ötürülməyə bilər.
extensionseçimlərini bir-birinin əvəzinə istifadə etmək:REPEATtəkrarlayır,CLIPisə sərhəddən kənarı şəffaf edir; seçim nəzərdə tutulan davranışa uyğun edilməlidir.Alfa rejimini nəzərə almamaq:
CHANNEL_PACKEDmüxtəlif təsvirlərin RGB və alfa kanallarını paketləmək üçün nəzərdə tutulub; alfa hər zaman maska kimi istifadə olunmaya bilər.
Növbəti addımlar: memarlıq vizuallaşdırması iş axını
Bu əsas biliklər səhnədəki təsvir girişlərinin necə təqdim olunduğunu anlamaq istəyən Blender istifadəçilərinə, memarlıq və interyer memarlığı tələbələrinə, həmçinin vizuallaşdırma komandalarına kömək edir. Fasad, döşəmə və ya interyer üzlüyü üçün istifadə edilən təsvirin təkrarlanması, kənarlarının uzadılması və ya alfa məlumatının nəzərə alınması kimi qərarlar teksturanın davranışını araşdırmağı asanlaşdırır. Sənədlər bu parametrlərin konkret render mühərrikindəki nəticəsini və ya performansa təsirini izah etmir; buna görə bunları layihə faylında və istifadə etdiyiniz versiyada ayrıca sınaqdan keçirmək lazımdır.
İş axınını genişləndirməzdən əvvəl kiçik test təsviri ilə bufer dəyərlərini, ölçünü, uzatma üsulunu və alfa istifadəsini ayrı-ayrılıqda yoxlayın. Təsvirləri layihə faylı ilə birlikdə saxlamaq və ya kənarda idarə etmək kimi qərarlar pack() və unpack() metodları ilə də əlaqəlidir; sənədlərdə bildirilir ki, bunlar müvafiq olaraq təsviri .blend faylına yerləşdirir və paketlənmiş təsviri diskə çıxarır.
Mənbə və lisenziya
Bu təlimat Blender Python API-sinin Image və ImageTexture sənədləri əsasında hazırlanıb. Hər iki mənbə CC BY-SA 4.0 lisenziyası ilə təqdim olunur. Məzmun Azərbaycan dilinə uyğunlaşdırılıb, izahlar yenidən yazılıb; kod nümunəsi bu təlimat üçün hazırlanıb.
Mənbələr
2 mənbəMənbə mətnləri yenidən dərc edilmir; qısa sitatlar işarələnir, qalanı bizim xülasə və şərhimizdir.
Bu API yanaşması, xüsusilə eyni səhnədə çoxsaylı təsvir girişlərini ardıcıl şəkildə yoxlamaq və ya kiçik məlumat redaktələrini təkrarlana bilən etmək istəyən ofislər və tələbələr üçün faydalıdır. Tekstura sərhədləri, təkrarlama davranışı və alfa istifadəsi üzərində nəzarət imkanı yaradır; lakin mənbələr bunun material qurulması və ya render performansı üçün təkbaşına həll olduğunu göstərmir.
Türkiyədəki komandalar üçün ən praktik başlanğıc mövcud avadanlığı və ya lisenziya xərclərini dəyişmədən kiçik bir səhnə nüsxəsində bu xüsusiyyətləri sınamaqdır. Versiya uyğunluğu və buferi saxlamadan kopyalama davranışı xüsusilə yoxlanmalıdır; istehsal fayllarında xarici təsvir yolları və paketləmə qaydası komanda daxilində dəqiqləşdirilməlidir.
Tez-tez verilən suallar
Blender Python API-də təsvirin ölçüsü necə dəyişdirilir?
`Image.scale(width, height)` metodu təsvir buferini göstərilən en və hündürlüyə miqyaslayır. `size` xüsusiyyəti buferin piksel ölçülərini göstərir.
Blender-də Image Texture təsvir sərhədlərindən kənarda necə davranır?
`extension` xüsusiyyətini `REPEAT`, `EXTEND`, `CLIP`, `CLIP_CUBE` və ya `CHECKER` olaraq təyin etmək olar. Bu seçimlər təkrarlama, kənarları uzatma və ya sərhəddən kənarı şəffaf etmə kimi fərqli davranışlar təqdim edir.
Blender-də kopyalanan təsvirə piksel redaktələri ötürülürmü?
Saxlanmamış görüntü buferi dəyişiklikləri `Image` datablock-u kopyalanarkən kopyaya ötürülməyə bilər. Blender API sənədlərində kopyalamazdan əvvəl bu məqama diqqət yetirmək tövsiyə olunur.



