RhinoArtisan Komut Dosyası API
RhinoArtisan içinde elle yapabileceğiniz her şeyi kod ile de yapabilirsiniz. Komut Dosyası API'si, tüm mücevher tasarım araç setini — taşlar, montürler, yüzük gövdeleri, ağırlıklar, fiyatlandırma, üretim çıktıları — temiz bir Python cepheleri (facades) setine dönüştürür (GemApi, BezelApi, PricingApi, …) ve tüm iş akışlarını diyalog kutusu veya fare kullanmadan çalıştırır.
from Rhino.Geometry import Plane
from ArtisanPlugin.Scripting import GemApi as gem, Transaction
with Transaction.Begin("Add a one-carat round diamond"):
gem.Create("ROUND", "Diamond", 1.0, Plane.WorldXY)
Beş satır, bir geri alma adımı ve arayüz üzerinden yerleştirilenle aynı bir taş.
Bununla neler inşa edebilirsiniz
- Boyut serileri ve varyantlar. Her dosyayı tek tek oluşturmak yerine, bir yüzüğü her boyutta, bir kolyeyi üç metal çeşidinde, bir koleksiyonu tek bir geçişte oluşturun.
- Parametrik tasarımlar. Taş sayılarını, boşlukları ve boyutları verilerden yönlendirin: siparişlerin CSV dosyası, bir formül veya bir müşteri yapılandırıcısı.
- Fiyatlandırma ve teklif verme. Metal ağırlıklarını ve taş listelerini doğrudan modelden çekin ve kendi teklif veya ERP akışınıza aktarın.
- Üretim hatları. Üretim dosyalarını her seferinde aynı şekilde otomatik olarak doğrulayın, adlandırın, dışa aktarın ve raporlayın.
Stüdyonuz bir şeyi birden fazla kez yapıyorsa, bir komut dosyasına değer.
Tasarım prensipleri
API her yerde aynı kuralları izler, bu nedenle bir cephede öğrendiğiniz şey hepsine uygulanır:
- Kararlı, mücevherat odaklı bir sözleşme. Komut dosyaları, RhinoArtisan geliştikçe uyumlu kalan net arayüzlerle çalışır
IGem ve IBezel .
- Dostça hata mesajları. Hatalı bir argüman (bilinmeyen bir taş şekli, negatif karat ağırlığı) gönderdiğinizde, yığın izlemesi yerine net ve anlaşılır bir mesaj alırsınız.
- Tek adımda geri alma. Değişiklikler bir
Transactioniçinde gruplanır, böylece tüm komut dosyası işlemi tek bir Ctrl+Z ile geri alınır.
- Ayırt edilemez sonuçlar. Komut dosyasıyla yerleştirilen bir taş, elle yerleştirilenle aynıdır — aynı geometri, aynı veri, aynı sonraki araçlar.
Lisanslama
Komut Dosyası API'si, RhinoArtisan lisansınızın bir parçasıdır — satın almanız gereken ekstra bir modül yoktur. Arayüz araçları gibi geçerli bir lisans gerektirir: belgede bir şey oluşturan, değiştiren veya silen her çağrı önce bunu doğrular ve geçerli değilse net, uygulanabilir bir hata verir. Komut dosyanızdan bunu yönetmeniz gerekmez; her cepheye entegre edilmiştir.
Lisansınız, bizzat çalıştırdığınız ve denetlediğiniz komut dosyalarını kapsar. Katılımsız hatlar (zamanlanmış veya sunucu tarafı işleri) ve üçüncü taraflara hizmet veren sistemler kendi lisanslarına sahiptir — bakınız EULA ve bizimle konuşun Otomasyon ve OEM anlaşmaları hakkında. Önemli olan komut dosyasının nerede değil, nasıl çalıştığıdır: Windows Server, Rhino.Compute veya sunucu gibi hareket eden bir iş istasyonu aynı kapsamdadır.
7.0.0.10 sürümündeki yenilikler
- Öğeler: kayıtlı bir ön ayardan oluşturun ve
element=: bir tane uygulayın, SetElement, bir nesneyi yeni bir ön ayar olarak kaydedin ve kitaplığı yönetin (yeniden adlandırın, çoğaltın, sık kullanılanlara ekleyin, silin, demetleri dışa ve içe aktarın).
- Varlıklar: bir profili referans alın,
"id:<n>": önizleyin, ExportAsCurve, ve yeniden adlandırın, çoğaltın, varsayılanı ayarlayın veya silin.
- Akıllı profil:
SmartProfileApi ve ISmartProfile kesit kesit düzenleyen tutamak.
- Akıllı bileşenleri düzenleme:
SmartComponentApi kolyeleri, bilezikleri, süsleri bulur… ve oluşturulduktan sonra düzenler.
- Kesiciler:
fitToGem fantezi kesimler için ve ICutter taş mıhlayıcılar.
- Askı: tel profiller, yan eğriler ve O-ring seçenekleri, metal katmanına yerleştirilir.
- Sepet rayları:
DEFAULT tarafindan CUSTOM modları.
- Komut panelleri:
PanelsApi.Active() ve Close().
Sırada ne var
- Başlangıç — adım adım ilk komut dosyanız.
- Temel Kavramlar — işlemler, tutamaklar, hata işleme, birimler.
- Kollar — her tutamak arayüzü, her biri bir sayfa.
- API Referansı — örneklerle alan bazlı kılavuzlar.
- .NET API — her cephe, yöntem, parametre ve varsayılan, eklentiden üretilmiştir (cephe başına bir sayfa).
- Python paketi — Rhino 8+:
import rhinoartisan as ra, saf Python 3 ile aynı API (üretilmiş referans, modül başına bir sayfa).
API'nin kasten yapmadığı şeyler
- Ham mesh veya brep yapılarını açığa çıkarmaz — serbest formlu geometri için
rhinoscriptsyntax tarafindan RhinoCommon kullanın.
- Henüz her parametrik alan düzenlenebilir değil. Çoğu yüzük gövdesi ve taş dizisi tutamağının ayarlayıcıları vardır ve akıllı bileşenler yol ile düzenlenir, ancak bazı tutamaklar hala modelin bir kısmı için salt okunurdur. Kapsam sürümden sürüme büyür ve API Referansı her cephenin ne oluşturabildiğini, düzenleyebildiğini ve sorgulayabildiğini gösterir.