SketchUp bileşenleri: Component Instance ve Definition kullanım rehberi

SketchUp Ruby API belgeleri, modeldeki bileşen örneklerinin nasıl temsil edildiğini ve bunların bağlı olduğu tanımların nasıl yönetilebileceğini açıklıyor. ComponentInstance, modelde yerleştirilmiş bir bileşen örneğini; ComponentDefinition ise bu örneğin dayandığı bileşen tanımını temsil ediyor. Örneğin model içindeki konumu da bir dönüşüm bilgisiyle belirleniyor. Bu ayrımı bilmek, tekrar kullanılan nesnelerde ortak değişiklik yapmakla yalnızca tek bir örneği farklılaştırmayı birbirinden ayırmaya yardımcı oluyor.

Bu rehber, SketchUp Ruby API’nin ComponentInstance, DefinitionList ve Model belgelerindeki yöntemleri temel alıyor. Yöntemlerin sürüm notları aynı değil; belirli bir sürüm bilgisi verilen özelliklerde ilgili sınır ayrıca belirtiliyor.

1. Örnek ile bileşen tanımının ilişkisini anlayın

1. Modeldeki bileşen örneğini tanımından ayrı düşünün. Bir ComponentInstance, ComponentDefinition nesnesine referans verir ve kendi konumunu dönüşüm bilgisiyle taşır. Bu yapı, aynı tanımın birden fazla yerleştirilmiş örnek tarafından kullanılabilmesine imkân verir. Dolayısıyla bir örneği düzenlemeden önce, hangi tanıma bağlı olduğunu kontrol etmek önemlidir.

2. Ruby API ile örneği inceleyip ayırın

Aşağıdaki örnek, etkin modeldeki düzenleme bağlamında bulunan ilk ComponentInstance nesnesini arar. Bir örnek bulursa bağlı olduğu tanımın adını yazdırır ve ardından make_unique çağrısıyla bu örnek için bağımsız bir tanım oluşturur. Kod, modelin tüm tanım listesini taramaz; tanım adını seçilen örneğin definition yöntemi üzerinden alır.

model = Sketchup.active_model
instance = model.active_entities.grep(Sketchup::ComponentInstance).first

if instance
  puts instance.definition.name
  instance.make_unique
end

1. Bu örneği kendi modelinizde çalıştırmadan önce hangi bileşenin seçildiğini veya etkin düzenleme bağlamında bulunduğunu doğrulayın. Kod, ilk ComponentInstance nesnesini alır; belirli bir bileşeni ada göre seçmez. Bu nedenle birden fazla bileşen varsa çıktıyı ve hedef örneği kontrol etmek önemlidir. make_unique çağrısı da yalnızca bilgi göstermez, modelde bağımsız bir tanım oluşturur.

2. Bağlı tanımı değiştirmek ile örneğin konumunu değiştirmek ayrı ihtiyaçlardır. ComponentInstance üzerinde definition= yöntemi farklı bir tanım atar ve belgelerde örneğin mevcut dönüşümünü koruduğu belirtilir. transformation ve transformation= dönüşümü okumak ya da ayarlamak için kullanılabilir. transform! bir Geom::Transformation uygular; move! ise dönüşümü benzer şekilde ayarlarken işlemi geri alma yığınına kaydetmez. Bu farkı, eklentideki düzenleme ve geri alma akışını tasarlarken göz önünde bulundurun.

3. Geometri ve tanım koleksiyonlarında dikkatli çalışın

1. explode yöntemi bileşen örneğini ayrı çizim öğelerine dönüştürür. Başarılı olduğunda bir öğe dizisi, başarısız olduğunda false döndürebilir. Bileşen yapısını korumak önemliyse, bu yöntemi kullanmadan önce işlemin modelde yaratacağı sonucu değerlendirin. Belgeler ayrıca intersect, outer_shell, split, subtract, trim ve union gibi geometrik işlemleri listeliyor; bunların bazıları manifold katı hacimler üzerinde çalışmak üzere tanımlanmış. Dolayısıyla her bileşen üzerinde aynı sonucu vereceklerini varsaymamak gerekir.

2. trim, iki manifold katı hacim arasındaki farkı tahribatsız biçimde hesaplar; subtract ise fark işlemi için listelenen diğer yöntemdir. intersect yönteminin SketchUp Make’te bulunmadığı da API belgesinde not ediliyor. ComponentInstance üzerindeki manifold? yöntemi kullanımdan kaldırılmış olarak işaretli; belgelere göre tanımın manifold durumunu kontrol etmek için ComponentDefinition#manifold? tercih edilmeli. Bu notlar, geometrik işlemlerden önce yöntem açıklamasına ve nesnenin türüne bakılması gerektiğini gösteriyor.

3. DefinitionList, tanımları dizin, ad veya GUID ile bulmayı; yeni tanım eklemeyi, dosyadan bileşen yüklemeyi ve kullanılmayan tanımları temizlemeyi sağlayan yöntemler içeriyor. purge_unused kullanılmayan tanımları kaldırır. Koleksiyon üzerinde each ile gezinirken aynı koleksiyondan öğe silmekten kaçının: belge, öğe sayısı ve dizinler değişebileceği için bazı tanımların atlanabileceği uyarısını yapıyor. Silme işlemi gerekiyorsa, önce koleksiyonu bir diziye kopyalayıp bu kopya üzerinde ilerlemek belgede önerilen yaklaşımdır.

4. Sürüm uyumunu ve dosya güvenliğini kontrol edin

1. DefinitionList içindeki load yöntemi, SketchUp bileşen dosyasını yüklemek için kullanılıyor. Belgelere göre SketchUp 2021.0’dan itibaren daha yeni sürümde kaydedilmiş modellerin yüklenmesine izin veren allow_newer seçeneği bulunuyor. Ancak yükleme sırasında bazı bilgilerin atlanma olasılığı var; API belgesi, daha yeni modelden yüklenen dosyanın üzerine kaydedilmemesi konusunda uyarıyor. Kaynak modeli korumak bu nedenle iş akışının parçası olmalı.

2. Aynı dosya yolundaki bileşeni yeniden yükleme davranışı için de sürüm notu var. SketchUp 2023.0 öncesinde, aynı yolla ilişkilendirilmiş farklı bir bileşen modelde bulunuyorsa yükleme çağrısı yeni içeriği almak yerine mevcut bileşeni döndürebiliyordu. Dosya güncellenmiş görünmüyorsa kullanılan SketchUp sürümünü ve dosya yolunu kontrol edin; kaynak belgede belirtilen sürüm sınırlarını eklenti kodunun uyumluluğuna yansıtın.

Mimarlık, iç mimarlık ve görselleştirme iş akışına etkisi

Tekrarlanan mobilya, kapı ve donatı öğeleri kullanan mimarlık ve iç mimarlık ekipleri için örnek-tanım ayrımı, modeldeki değişikliklerin kapsamını anlamayı kolaylaştırır. Paylaşılan tanım üzerinden ortak değişiklik yapılması gerekiyorsa bileşen ilişkisi kullanışlıdır; yalnızca tek bir örnek farklılaştırılacaksa make_unique bunun için API’de sunulan yöntemdir. Bu ayrım, model üzerinde çalışan ekiplerin hangi öğelerin birlikte değiştiğini takip etmesine yardımcı olabilir.

Görselleştirme ekipleri ve eklenti geliştiricileri için de önemli nokta, doğru örneğin ve doğru tanımın seçildiğini doğrulamaktır. Kaynaklarda belirli donanım gereksinimi, performans ölçümü veya lisans koşulu belirtilmiyor. Takip edilmesi gereken somut konular, kullanılan SketchUp sürümünün ilgili yöntemi desteklemesi ve daha yeni sürüm dosyaları yüklenirken kaynak dosyanın korunmasıdır.

Sık yapılan hatalar

• Bir örneğin paylaşılan tanımını, diğer örneklerin de değişebileceğini hesaba katmadan düzenlemek.

• Kodun ilk ComponentInstance nesnesini bulduğunu unutup belirli bir nesneyi seçtiğini varsaymak.

• Tanım atamasıyla konum dönüşümünü değiştirmeyi aynı işlem sanmak.

• Manifold koşulu bulunan geometrik yöntemleri her bileşende çalışacakmış gibi kullanmak.

• DefinitionList üzerinde gezinirken aynı koleksiyondan öğe silmek.

• Daha yeni bir model yüklendikten sonra kaynak dosyanın üzerine kaydetme uyarısını göz ardı etmek.