Qısaca
- Sketchup.active_model açıq model üçün API əməliyyatlarında istifadə ediləcək Model obyektini qaytarır.
- Model.entities kök çəkmə kontekstini, Model.active_entities isə açıq qrupun və ya komponentin məzmununu qaytarır.
- Seçimdə dolaşarkən Selection#each istifadə etmək elementləri indekslə bir-bir götürməkdən daha səmərəlidir.
- Komponent nüsxələri eyni tərifi paylaşa bilər; yalnız bir nüsxəni fərdiləşdirmək üçün make_unique istifadə edilə bilər.
SketchUp Ruby API açıq SketchUp modelindəki çəkmə elementlərini nəzərdən keçirmək və dəyişdirmək üçün başlanğıc nöqtəsi təqdim edir. Rəsmi API sənədlərində Model, Entities, Selection və ComponentInstance sinifləri model, həndəsə, seçim və komponentlərlə işləməyin əsas yollarını izah edir. Bu bələdçi sənədlərdə göstərilən metodlardan istifadə etməklə kiçik və yoxlanıla bilən avtomatlaşdırma addımları qurmağa yönəlib. Siniflərin əsas versiyası SketchUp 6.0 olaraq göstərilir, bəzi metodlar isə daha yeni versiyalarda əlavə edilib; buna görə istifadə olunan metodun versiya qeydini ayrıca yoxlamaq lazımdır.
1. Aktiv modeldən başlayın
API ilə işləyərkən əvvəlcə açıq modelin obyektini əldə edin. Sketchup.active_model istifadəçinin hazırda işlədiyi modeli qaytarır. Model obyekti vasitəsilə çəkmə elementlərinə, materiallara, komponent təriflərinə və seçimə çıxış əldə etmək mümkündür. Bu yanaşma müxtəlif əməliyyatlarda modeli təkrar axtarmaq əvəzinə, lazım olan kolleksiyalara əvvəlcədən istinad götürməyə imkan verir.
model = Sketchup.active_model
entities = model.entities
materials = model.materials
definitions = model.definitions
selection = model.selectionBurada mühüm fərq model.entities ilə model.active_entities arasındadır. Birincisi modelin kök səviyyəsindəki elementləri ehtiva edir. İstifadəçi qrupu və ya komponenti redaktə etmək üçün açıbsa, active_entities həmin anda işlənən kontekstin elementlərini qaytarır; açıq redaktə konteksti yoxdursa, entities ilə eyni nəticəni verir. Buna görə məqsəd modelin ən üst səviyyəsini deyil, istifadəçinin hazırda redaktə etdiyi məzmunu işləməkdirsə, düzgün kolleksiyanı seçmək lazımdır.
2. Seçimi səmərəli və təhlükəsiz şəkildə nəzərdən keçirin
model.selection hazırda seçilmiş çəkmə elementlərini təmsil edir. Seçimdəki hər elementə çıxış üçün each ilə dolaşmaq indeksləri ardıcıl çağırmaqdan daha səmərəlidir. Həmçinin seçim sırasının istifadəçinin elementləri seçdiyi ardıcıllığı əks etdirəcəyi güman edilməməlidir: sənədlərdə elementlərin sırasının müəyyən olmadığı açıq şəkildə bildirilir.
selection = Sketchup.active_model.selection
puts "Seçilmiş elementlərin sayı: #{selection.length}"
selection.each do |element|
puts element.typename
endƏməliyyat yalnız bir elementə aiddirsə, first istifadə edilə bilər; seçim boş olduqda bu metod nil qaytarır. empty? seçim olub-olmadığını, single_object? isə seçimin tək obyekt kimi qiymətləndirilib-qiymətləndirilə bilməyəcəyini yoxlamağa yarayır. Elementin seçilib-seçilmədiyini yoxlamaq üçün include? istifadə edilə bilər.
Seçimdə dolaşarkən eyni kolleksiyadan element silmək kolleksiyanın ölçüsünü və indekslərini dəyişə bilər; nəticədə bəzi elementlər ötürülə bilər. Sənədlərdə tövsiyə olunan təhlükəsiz yanaşma silinəcək elementləri əvvəlcə massivə köçürmək, sonra isə həmin surət üzərində işləməkdir. Həmçinin selection[0] kimi indekslə müraciət hər elementi nəzərdən keçirmək üçün səmərəli seçim deyil. Seçimdən element silmək və ya seçim çoxluğunu təmizləmək üçün remove və clear metodlarından istifadə edilə bilər.
3. Həndəsəni düzgün çəkmə kontekstində yaradın
Xətt və ya üz kimi yeni elementlər seçilmiş Entities kolleksiyasına əlavə edilir. Məsələn, add_line iki nöqtə arasında kənar yaradır; add_face üz əlavə edir, add_group isə yeni qrup yaradır. Kök səviyyədə işləmək üçün model.entities, açıq qrup və ya komponent kontekstində işləmək üçün isə model.active_entities seçilməlidir. Beləliklə, yaradılan həndəsə modelin nəzərdə tutulan hissəsinə əlavə olunur.
Əməliyyat bir neçə model dəyişikliyindən ibarətdirsə, SketchUp-ın əməliyyat mexanizmi dəyişiklikləri geri qaytarıla bilən əməliyyat kimi qeydə almağa kömək edir. start_operation yeni əməliyyat başladır, commit_operation onu tamamlayır; xəta olduqda abort_operation başlanmış əməliyyatı ləğv edə bilər. Bu metodlardan bir-birindən asılı olmayan kiçik dəyişiklikləri vahid avtomatlaşdırma axınında ardıcıl idarə etmək üçün istifadə edin.
model = Sketchup.active_model
model.start_operation("Xətt əlavə et")
begin
model.active_entities.add_line([0, 0, 0], [500, 500, 0])
model.commit_operation
rescue
model.abort_operation
raise
endSənədlərdə abort_operation metodunun adətən xətanı tutan bölmədə çağırıldığı bildirilir. Şəffaf (transparent) əməliyyatlarda isə bu metoddan istifadə etməmək barədə xəbərdarlıq edilir; belə əməliyyatı ləğv etmək onun bağlı olduğu əvvəlki əməliyyatı da ləğv edə bilər. Buna görə avtomatlaşdırma şəffaf əməliyyatlarla işləyirsə, xəta idarəetməsi ayrıca nəzərdən keçirilməlidir.
Çoxlu həndəsə elementi yaradılacaqsa, Entities#build də nəzərdən keçirilə bilər. API sənədi bu metodu performansı nəzərə alaraq toplu həndəsə yaratmaq üçün nəzərdə tutulmuş EntitiesBuilder yaratma üsulu kimi təsvir edir. Bununla belə, sənədlərdə verilən məlumatdan kənara çıxaraq konkret sürət artımı və ya hər iş üçün uyğunluq nəticəsi çıxarmaq olmaz.
4. Komponent nüsxələrini tərifdən ayırın
ComponentInstance komponent tərifinə və onun modeldəki mövqeyini müəyyən edən çevrilməyə istinad edir. Bu quruluş eyni tərifin modeldə bir neçə nüsxə kimi istifadə olunmasına imkan verir. Məsələn, nüsxənin tərifini definition ilə əldə etmək, mövqe çevrilməsini transformation ilə nəzərdən keçirmək və ya definition= ilə onu başqa tərifə bağlamaq mümkündür.
Nüsxələrdən yalnız birini digərlərindən asılı olmadan redaktə etmək lazım gəldikdə make_unique istifadə edilə bilər: bu metod həmin nüsxə üçün başqa nüsxələrin istifadə etmədiyi komponent tərifi yaradır. Redaktənin bütün paylaşılan nüsxələrə, yoxsa yalnız seçilmiş nüsxəyə tətbiq ediləcəyi əvvəlcədən müəyyənləşdirilməlidir. Əks halda nəzərdə tutulan dəyişiklik dairəsi ilə modeldəki nəticə fərqlənə bilər. Komponenti ayrı çəkmə elementlərinə çevirən explode metodu da sənədlərdə yer alır; lakin komponent nüsxəsi kimi qalmalı olduğu iş axınlarında bu metoddan istifadə edilməməlidir.
Memarlıq və vizuallaşdırma iş axınında istifadə
Bu metodlar təkrarlanan model yoxlamalarını və ya həndəsi redaktələri avtomatlaşdırmaq istəyən memarlar, interyer dizaynerləri və SketchUp plaginləri hazırlayanlar üçün əsas yaradır. Məsələn, aktiv redaktə kontekstindəki elementləri nəzərdən keçirmək, seçilmiş obyektləri toplu qiymətləndirmək və ya təkrarlanan həndəsəni bir əməliyyat kimi yaratmaq mümkündür. Bu yanaşmanın faydası avtomatlaşdırmanın modelin hansı hissəsində işlədiyinin və komponent dəyişikliyinin hansı nüsxələrə təsir etdiyinin aydın müəyyənləşdirilməsindən asılıdır.
Sənədlərdə bu API metodları üçün xüsusi avadanlıq tələbi və ya lisenziya şərti göstərilmir; buna görə bu mövzularda hər hansı tələb fərz edilməməlidir. Tətbiq etməzdən əvvəl istifadə olunan SketchUp versiyasına aid metod qeydləri, xüsusilə daha yeni versiya etiketi daşıyan funksiyalar üçün yoxlanmalıdır. Böyük modellərdə toplu həndəsə yaradılması nəzərdə tutulursa, Entities#build nəzərdən keçirilərkən mövcud iş axınının geri qaytarıla bilən əməliyyatlarla necə idarə ediləcəyi də planlaşdırılmalıdır.
Tez-tez edilən səhvlər
Hər vəziyyətdə
model.entitiesistifadə etmək: Açıq qrup və ya komponent redaktə edilirsə, düzgün kontekstactive_entitiesola bilər.Seçim sırasını istifadəçinin klikləmə ardıcıllığı hesab etmək: API sənədlərində bu sıraya zəmanət verilmədiyi bildirilir.
eachzamanı eyni kolleksiyadan element silmək: Əvvəlcəto_ailə surət götürmək elementlərin ötürülməsi riskini aradan qaldırır.Komponent nüsxəsini redaktə edərkən tərifin paylaşıldığını nəzərə almamaq: Yalnız bir nüsxənin ayrılması lazımdırsa,
make_uniqueistifadə etmək nəzərdən keçirilməlidir.Şəffaf əməliyyatı
abort_operationilə ləğv etmək: Sənədlər bunun bağlı olduğu əvvəlki əməliyyatı da ləğv edə biləcəyi barədə xəbərdarlıq edir.
Mənbələr
3 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.
Türkiyədəki kiçik memarlıq və vizuallaşdırma ofisləri üçün bu API-nin praktiki dəyəri tez-tez təkrarlanan model yoxlamalarını və redaktələri avtomatlaşdırma axınına çevirə bilməsindədir. Xüsusilə seçimi, aktiv redaktə kontekstini və komponent təriflərini düzgün idarə etmək əl ilə görülən addımları azalda, modeldə gözlənilməz dəyişiklik riskini də aşağı sala bilər.
İlkin xərci müəyyən edən amil yeni avadanlıqdan daha çox Ruby API bilikləri və mövcud plagin iş axınına uyğunlaşma olacaq; mənbələr konkret avadanlıq və ya lisenziya şərti göstərmir. Ofislərin əvvəlcə kiçik modeldə əməliyyatların geri qaytarılmasını, komponent nüsxələrinin paylaşılmasını və istifadə etdikləri SketchUp versiyasındakı metodların uyğunluğunu sınaması məqsədəuyğundur.
Tez-tez verilən suallar
SketchUp Ruby API-də aktiv modelə necə çıxış əldə edilir?
`Sketchup.active_model` açıq modelə çıxış verir. Model obyekti vasitəsilə həndəsə, seçim, materiallar və komponent tərifləri kimi kolleksiyalara çatmaq mümkündür.
SketchUp Ruby API-də entities ilə active_entities arasındakı fərq nədir?
`entities` modelin kök səviyyəsindəki elementləri qaytarır. `active_entities` açıq qrupun və ya komponentin redaktə kontekstindəki elementləri verir; belə kontekst yoxdursa, `entities` ilə eyni nəticəni qaytarır.
SketchUp komponent nüsxəsini digərlərindən necə ayırmaq olar?
`ComponentInstance#make_unique` həmin nüsxə üçün digər nüsxələrin paylaşmadığı komponent tərifi yaradır. Beləliklə, dəyişiklik yalnız ayrılmış nüsxəyə tətbiq oluna bilər.



