3ds Max Scene Explorer bələdçisi: MAXScript ilə xüsusi sütunlar yaratmaq

Autodesk-in MAXScript sənədlərində Scene Explorer-ı skriptlərlə idarə etmək üçün SceneExplorerManager interfeysi və xüsusi sütun yaratmaq üsulları izah olunur. Bu bələdçi rəsmi sənədlərə əsaslanaraq 3ds Max səhnələrində Explorer yaratmaq, görünən sütunları seçmək, obyekt xüsusiyyətlərini sütun kimi göstərmək və konfiqurasiyalardan yenidən istifadə etmək addımlarını nəzərdən keçirir. SceneExplorerManager interfeysi 3ds Max 2008 və daha yeni versiyalarda mövcuddur, lakin bəzi üsullar üçün daha yeni versiyalar tələb olunur.

Aşağıdakı kod nümunələri Autodesk sənədlərində göstərilən MAXScript üsullarına əsaslanır. İstənilən skripti iş səhnəsində işlətməzdən əvvəl hədəf 3ds Max versiyasının müvafiq üsulu dəstəklədiyini və sütun adlarının səhnədəki xüsusiyyətlərə uyğun gəldiyini yoxlayın.

1. Versiya dəstəyini və ehtiyacı müəyyənləşdirin

Əvvəlcə hansı işi avtomatlaşdırmaq istədiyinizi müəyyənləşdirin: mövcud sütun düzülüşünü qurmaq, obyekt xüsusiyyətlərini görünən etmək, yoxsa Explorer konfiqurasiyasını yadda saxlayıb yenidən yükləmək? Üsulların versiya tələbləri eyni deyil. Məsələn, CreateExplorer və SetExplorerVisibleColumns 3ds Max 2010 və daha yeni versiyalar üçün sənədləşdirilib. GetExplorer isə 3ds Max 2015 və daha yeni versiyalarda istifadə edilə bilər.

SceneExplorerManager interfeysinin mövcud olması həmin interfeysdəki bütün üsulların köhnə versiyalarda da işləyəcəyi demək deyil. Sənəddə versiya məlumatı açıq şəkildə verilməyən üsul üçün burada əlavə versiya məhdudiyyəti nəzərdə tutulmamalıdır. Buna görə komanda skriptlərini müxtəlif 3ds Max quraşdırmalarında istifadə etməzdən əvvəl hədəf versiyalarda sınaqdan keçirmək vacibdir.

2. Explorer yaradın və görünən sütunları tənzimləyin

1. Standart parametrlərlə Explorer yaratmaq üçün CreateADefaultExplorer üsulundan istifadə edin. Əməliyyat uğurlu olduqda üsul True, uğursuz olduqda isə False qaytarır.

2. Sonra SetExplorerVisibleColumns ilə görünəcək sütunları adlar massivi kimi göstərin. Autodesk-in nümunəsində “Object Colors” adlı Explorer-da ad, növ və rəng sütunları görünən edilir.

3. Müəyyən sütunları olan yeni Explorer yaratmaq üçün CreateExplorer üsulundan istifadə edin. Bu üsul Explorer adını və sütun adlarından ibarət massivi qəbul edir; onun Explorer-ı standart parametrlərlə yaratdığını güman etmək olmaz.

SceneExplorerManager.CreateADefaultExplorer "Object Colors"
SceneExplorerManager.SetExplorerVisibleColumns "Object Colors" #("Name","Type","Color")

SceneExplorerManager.CreateExplorer "Geometry Counts" #("Name","Type","Faces")

Aşağıdakı dəyərlər Autodesk sənədlərindəki nümunələrdə yer alır. Bunlar hər səhnə üçün məcburi düzülüş deyil, üsullardan necə istifadə edilə biləcəyini göstərən nümunələrdir.

Sütunlar massivindəki ad mövcud sütun filtri ilə uyğun gəlmirsə, həmin sütun xəta verilmədən ötürülə bilər. Buna görə gözlənilən sütunların həqiqətən göründüyünü yoxlamaq lazımdır. Sənədlərdə filtr kimi müəyyənləşdirilibsə, “Bananas” kimi adın da istifadə oluna biləcəyi nümunə göstərilir; belə xüsusi filtr yoxdursa, sütun əlavə edilmir.

3. Xüsusi xüsusiyyətləri Scene Explorer sütununa çevirin

Səhnədəki obyektlərdə olan xüsusiyyəti görünən etmək üçün addProperty ilə sütun filtri təyin etmək olar. Bu üsula xüsusiyyətin adı, dəyəri oxuyan funksiya və dəyəri təyin edən funksiya verilir. Autodesk-in nümunəsində obyektin Radius xüsusiyyəti varsa, dəyər həm oxunur, həm də yenilənə bilir.

Xüsusiyyət hər obyektdə olmaya bilərsə, isProperty yoxlaması vacibdir. Aşağıdakı nümunədə Radius dəyərinə yalnız müvafiq xüsusiyyət obyekt üzərində varsa müraciət edilir:

fn getRad theNode = (
    if isProperty theNode "Radius" then theNode.Radius
)

fn setRad theNode theValue = (
    if isProperty theNode "Radius" then theNode.Radius = theValue
)

SceneExplorerManager.addProperty "Radius" getRad setRad

Yalnız məlumat göstəriləcəksə və dəyər Explorer vasitəsilə dəyişdirilməyəcəksə, addReadOnlyProperty istifadə etmək olar. Sənədlərdəki nümunə classof ilə obyektin sinfini qaytararaq “Class” adlı, yalnız oxumaq üçün filtr yaradır:

fn getClass theNode = (classof theNode)
SceneExplorerManager.addReadOnlyProperty "Class" getClass

Yeni filtr təyin edildikdən sonra müvafiq sütun Column Chooser siyahısının sonunda görünür. Sütunu Scene Explorer-a əlavə etmək üçün siyahıdan tutub Explorer-a sürükləyin. Xüsusi sütunu təyin etmək onun görünən sütun düzülüşünə avtomatik əlavə olunması demək deyil; buna görə filtri yaratmaq və Explorer-da göstərmək addımlarını ayrı-ayrılıqda tamamlayın.

4. Explorer konfiqurasiyasını yadda saxlayın və idarə edin

Explorer konfiqurasiyasını SaveExplorerConfiguration ilə göstərilən fayla yadda saxlamaq, əvvəllər yadda saxlanmış konfiqurasiyanı isə LoadExplorerConfiguration ilə yükləmək olar. Aşağıdakı nümunədə fayl yolunu müvafiq kompüterin iş mühitinə uyğun dəyişmək lazımdır:

SceneExplorerManager.SaveExplorerConfiguration "Geometry Counts" "C:\\SceneExplorerConfig"
SceneExplorerManager.LoadExplorerConfiguration "C:\\SceneExplorerConfig"

Explorer-ı açmaq və ya bağlamaq üçün OpenExplorer və CloseExplorer üsulları mövcuddur. ExplorerExists göstərilən adda Explorer-ın olub-olmadığını, ExplorerIsOpen isə onun açıq olub-olmadığını yoxlayır. GetExplorer adı verilmiş Explorer varsa, onun interfeysini qaytarır; belə Explorer yoxdursa nəticə undefined olur.

Xüsusi xüsusiyyət filtrlərindən sonrakı 3ds Max sessiyalarında da istifadə etmək üçün filtr təriflərini skript faylında saxlayıb Scripts\Startup qovluğuna yerləşdirmək mümkündür. Bir neçə Explorer-ı siyahılamaq üçün GetExplorerCount onların ümumi sayını qaytarır; GetExplorerName isə 1-dən həmin saya qədər olan indekslər üçün ad verir. ClearAllExplorers bütün Explorer-ları bağlayır və Tools>Saved Scene Explorers> menyu siyahısını təmizləyir. Buna görə bu üsul tək bir Explorer-la işləmək üçün istifadə edilməməlidir.

Memarlıq və archviz iş prosesində istifadə

Memarlıq və vizuallaşdırma səhnələrində obyekt məlumatlarını eyni pəncərədə araşdırmaq komandalara öz iş qaydalarına uyğun Explorer görünüşü qurmağa kömək edə bilər. Ad, növ, rəng və ya üz sayı kimi sənədlərdə nümunə göstərilən sütunlar başlanğıc nöqtəsidir. Səhnə obyektlərində olan xüsusi xüsusiyyət vacibdirsə, həmin məlumatı ayrıca sütun kimi təyin etmək də mümkündür. Bu yanaşmanın faydası istifadə olunan məlumat və filtrlərin səhnənin ehtiyaclarına uyğun olmasından asılıdır.

Ofisdə skriptləri paylaşmazdan əvvəl istifadə olunan 3ds Max versiyasını və xüsusi filtrlərin əsaslandığı obyekt xüsusiyyətlərini yoxlayın. Bir neçə obyekt növü olan səhnələrdə xüsusiyyət yoxlaması əlavə etmək, mövcud olmayan dəyərə müraciət etməməyə kömək edir. Autodesk-in bu sənədlərində avadanlıq, lisenziya və ya məhsulun qiyməti barədə məlumat verilmir; bu mövzularda əlavə tələb nəzərdə tutulmamalıdır.

Tez-tez rast gəlinən səhvlər

• Görünən sütunlar siyahısına mövcud olmayan filtr adını əlavə etmək: Müvafiq sütun xəta verilmədən ötürülə bilər.

• Xüsusi sütun təyin edildikdən sonra onun avtomatik görünəcəyini düşünmək: Column Chooser-dan Scene Explorer-a sürükləmək lazımdır.

• Hər obyektdə eyni xüsusiyyətin olduğunu güman etmək: Xüsusiyyətə müraciət etməzdən əvvəl isProperty yoxlaması aparmaq olar.

• GetExplorer çağırışının həmişə Explorer qaytaracağını gözləmək: Ad tapılmazsa, nəticə undefined olur.

• ClearAllExplorers üsulunu tək bir Explorer-ı bağlamaq üçün istifadə etmək: Üsul bütün Explorer-ları bağlayır və yadda saxlanmış menyu siyahısını təmizləyir.