Rhino Python ilə ilk skript: ScriptEditor-da xətt çəkmə və avtomatlaşdırma

Bu bələdçidə nə öyrənəcəksiniz?

Bu bələdçi Rhino daxilində işləyən kiçik Python skriptinin hazırlanmasına həsr olunub. Əvvəlcə ScriptEditor-da yeni fayl açıb iki nöqtə seçərək onların arasına xətt əlavə edən nümunə yaradacağıq. Sonra skriptin işə salınmasına, sazlanmasına, Python iş mühitinin seçilməsinə və paket tələblərinin idarə olunmasına keçəcəyik.

Nümunədə Rhino-nun rhinoscriptsyntax funksiyalarından istifadə olunur. Məqsəd hərtərəfli alət yaratmaq deyil; istifadəçi girişini alıb Rhino-da həndəsə yaradan skriptin əsas iş axınını göstərməkdir. Bu başlanğıc təkrarlanan modelləşdirmə addımlarını sonradan avtomatlaşdırmaq üçün əsas yarada bilər.

Tələblər və versiya seçimi

İş axını Rhino və onun daxilindəki ScriptEditor vasitəsilə həyata keçirilir. Redaktoru açmaq üçün əmr sətrinə ScriptEditor yazın. Yeni skript yaradarkən File > New menyusundan Python 3 seçə bilərsiniz. Mənbələrdə bu iş üçün əlavə hesab, ödəniş və ya xüsusi avadanlıq tələbi göstərilmir.

Rhino-nun Python seçimləri eyni mühərrikin fərqli versiyaları deyil, ayrıca tətbiqlər kimi təqdim olunur. Bələdçidə Python 3 CPython, Python 2 isə IronPython kimi göstərilir. Python 3 PyPI paketlərindən istifadə edə bilir. RhinoCommon çağırışlarına diqqət yetirən və ya .NET-in çoxaxınlı imkanlarından yararlanmalı olan bəzi skriptlərdə Python 2 nəzərdən keçirilə bilər. Tərtibatçı sənədi əksər yeni skriptlər üçün Python 3-ü başlanğıc seçimi kimi tövsiyə edir.

Versiya nömrələrini nəzərdən keçirərkən mənbələrin tarixini də nəzərə alın. 2025-ci ildə yenilənmiş ümumi Rhino.Python bələdçisi Rhino 8 üçün Python 3.9.11, Rhino 7 üçün isə IronPython 2.7.12 məlumatını verir. 2026-cı ildə yenilənmiş ScriptEditor sənədi iş mühitlərini izah edir, lakin bu nömrələri göstərmir. Buna görə quraşdırılmış Rhino versiyasındakı seçimləri redaktorda yoxlamaq ən doğru başlanğıcdır.

İlk skriptin yaradılması

1. Rhino əmr sətrində ScriptEditor əmrini icra edin. Redaktor açıldıqdan sonra File > New yolunu izləyib Python 3 seçin. ScriptEditor redaktə etdiyiniz faylın hansı dil və iş mühitindən istifadə etdiyini göstərir.

2. Aşağıdakı kodu yeni skriptə əlavə edin:

import rhinoscriptsyntax as rs

first_point = rs.GetPoint("Çizginin başlangıç noktası")
if first_point:
    second_point = rs.GetPoint("Çizginin bitiş noktası")
    if second_point:
        rs.AddLine(first_point, second_point)

Kod əvvəlcə Rhino-da başlanğıc, sonra isə son nöqtəni seçməyinizi istəyir. Hər iki nöqtə seçildikdə aralarında xətt yaradır. Nöqtələrdən biri seçilməzsə, xətt əlavə etmə mərhələsinə keçilmir. Nümunədəki funksiya adları Rhino-nun rhinoscriptsyntax interfeysindən istifadə edir.

1. Run > Run vasitəsilə skripti işə salın və Rhino görünüşündə tələb olunan nöqtələri seçin. Faylı .py uzantısı ilə saxlaya bilərsiniz. Redaktordakı File > New From Template seçimi şablondan yeni fayl yaratmaq üçün başqa bir yol təqdim edir.

2. Hər addımın nəticəsini izləmək üçün işlək nümunəni kiçik saxlayın. Daha sonra eyni yanaşmanı təkrarlanan seçim və həndəsə yaratma işlərinə uyğunlaşdıra bilərsiniz. Rhino.Python interaktiv skriptlər, xüsusi əmrlər və alqoritmlərlə həndəsə yaratmaq kimi istifadə sahələrini dəstəkləyir. Buradakı nümunə isə yalnız nöqtə seçmə və xətt yaratma iş axınını göstərir.

İşə salma, sazlama və Python mühərriki

Skripti hər dəfə redaktorun içindən başlatmaq vacib deyil. Rhino tərtibatçı bələdçisinə görə, ScriptEditor saxlanmış faylları Rhino əmr sətrindən, makrodan, alətlər panelindəki düymədən və ya ləqəbdən işə sala bilir. Beləliklə, skript istifadə qaydasından asılı olaraq Rhino-da müxtəlif başlatma nöqtələrinə bağlana bilər. Kodu birbaşa makroya yazdıqda Rhino-nun düzgün mühərriki seçə bilməsi üçün dil göstəricisi əlavə etməyi unutmayın.

Faylın hansı Python mühitində açılacağı uzantı və skriptdəki göstərici ilə əlaqəlidir. #! python 3 və ya #! python 2 ifadəsi müvafiq mühərriki göstərir; .py3 və .py2 uzantıları da konkret mühitə işarə edir. Adi .py fayllarında skriptin tələb etdiyi mühit nəzərə alınır. Fayl gözlənilməz şəkildə işlədikdə bu fərqi yoxlanmalı məqamlardan biri hesab edin.

Skriptin müəyyən sətirdə dayanıb dəyişənləri yoxlamasını istəyirsinizsə, redaktorda həmin sətrin yanındakı boş sahəyə klikləyərək kəsilmə nöqtəsi əlavə edin. Sonra Run > Debug vasitəsilə sazlamanı başladın. Skript dayandırıldıqda addım-addım irəliləyib dəyişənləri müvafiq panellərdə nəzərdən keçirə bilərsiniz. Kəsilmə nöqtəsi əlavə edilməyibsə, Debug seçimi əlçatan olmur.

Paketlər və yoxlanıla biləcək problemlər

Python 3 skriptlərinə PyPI paketləri əlavə etmək üçün ScriptEditor panelindəki Install Package seçimindən istifadə edə bilərsiniz. Paket axtarmaq, yaxud adını və versiyasını daxil etmək mümkündür. Paket məlumatını skript daxilində saxlamaq lazımdırsa, Add Package Reference to Script seçiminin işarələnib-işarələnmədiyini yoxlayın; tərtibatçı bələdçisində bildirilir ki, bu seçim lazımi paketləri skript mətnində göstərməyə imkan verir.

Paket tələblərini bir neçə adla da yazmaq mümkündür. Məsələn, aşağıdakı sətirdə numpy və requests paketləri sadalanır:

#requirements: numpy, requests

Paket quraşdırıldıqdan sonra və ya idxal edilən modullar dəyişdikdə müvafiq Python mühərrikini yenidən yükləmək lazım gələ bilər. Bu məqsədlə ScriptEditor-da Tools > Reload Python 3 (CPython) Engine və ya Tools > Reload Python 2 (IronPython) Engine seçimlərindən istifadə etmək olar; bələdçiyə əsasən bunun üçün Rhino-nu yenidən başlatmaq tələb olunmur.

Skript işləmədikdə əvvəlcə faylın seçdiyiniz Python mühərriki ilə uyğunluğunu, uzantı və ya dil göstəricisinin nəyi göstərdiyini yoxlayın. Paketlərdən istifadə edən faylda tələblərin skriptə əlavə edilib-edilmədiyinə baxın. Mənbələr bunların xüsusilə tez-tez rast gəlinən problemlər olduğunu bildirmir; bunlar problemin səbəbini araşdırarkən nəzərdən keçirilə biləcək ehtimallardır. Sazlama zamanı əvvəlcə kəsilmə nöqtəsi əlavə edib, sonra Debug seçimini sınayın.

Növbəti addımlar

Bir neçə skriptdə istifadə edəcəyiniz kodu ayrıca modula köçürüb başqa fayllardan idxal edə bilərsiniz. Rhino-nun bu modulu tapa bilməsi üçün modul qovluğu axtarış yollarında olmalıdır; həmin qovluqlar Options daxilindəki Module Search Paths bölməsində sadalanır. Tərtibatçı bələdçisi .pth faylı vasitəsilə yol əlavə etmək seçiminə də toxunur.

Daha irəli səviyyədə skriptlər RhinoCommon-a çıxış əldə edə bilər. Python 3 bu imkanı Python.NET vasitəsilə, Python 2 isə .NET üzərində işləyərək təmin edir. Grasshopper daxilində Python-dan istifadə də mümkündür; lakin komponentlər və redaktə iş axını üçün ayrıca Grasshopper Python bələdçisi var. Buna görə növbəti mərhələni seçərkən məqsədin Rhino daxilində müstəqil skript, yoxsa Grasshopper tərifində işləyən xüsusi komponent olduğunu müəyyənləşdirin.

Mənbə və lisenziya

Məzmun McNeel-in “Scripting: Python” (K1) və “What is Rhino.Python?” (K2) tərtibatçı bələdçiləri əsasında orijinal türk dilində hazırlanmış mətn kimi uyğunlaşdırılıb. Mənbə qeydlərində lisenziya təsnifatı “sərbəst” göstərilir; səhifələrdə müəllif hüququ və “All Rights Reserved” ifadəsi yer alır, açıq lisenziyanın adı isə göstərilmir.