Scripts/pl

Wprowadzenie
Przez tworzenie skryptów rozumiemy tworzenie obiektów topologicznych za pomocą interpretera Python dla FreeCAD. Program FreeCAD może być używany jako "bardzo dobry" zamiennik OpenSCAD, głównie dlatego, że ma prawdziwy interpreter środowiska Python, co oznacza, że ma na pokładzie prawdziwy język programowania, prawie wszystko, co można zrobić z GUI, można zrobić za pomocą skryptu Python.

Niestety informacje na temat skryptów w dokumentacji, a nawet na tej Wiki, są rozproszone i brakuje im jednolitości "pisania”, a większość z nich jest wyjaśniona w zbyt techniczny sposób.



Zaostrzenie apetytu
Pierwszą przeszkodą w łatwej drodze do tworzenia skryptów jest to, że nie ma bezpośredniego sposobu na dostęp do wewnętrznego edytora Python FreeCAD poprzez pozycję menu lub ikonę na pasku narzędzi, ale wiedząc, że FreeCAD otwiera plik z rozszerzeniem w wewnętrznym edytorze Python, najprostszą sztuczką jest utworzenie go w ulubionym edytorze tekstu, a następnie otwarcie go za pomocą zwykłego polecenia.

Aby zrobić to w uprzejmy sposób, plik musi być napisany w pewnym porządku, edytor FreeCAD Python ma dobre podświetlanie składni, którego brakuje w wielu prostych edytorach, takich jak Notatnik Windows lub niektóre podstawowe edytory Linuksa, więc wystarczy napisać te kilka linijek:

Zapisz je ze znaczącą nazwą z rozszerzeniem i załaduj wynikowy plik w FreeCAD, za pomocą wspomnianego polecenia.

Minimalny przykład tego, co jest niezbędne w skrypcie, jest pokazany w tym fragmencie kodu, który można wykorzystać jako szablon dla prawie każdego przyszłego skryptu:

Powyższy kod zawiera kilka sztuczek:


 * Ta linia importuje FreeCAD w interpreterze FreeCAD Python, może wydawać się zbędna, ale tak nie jest.
 * Base i Vector są szeroko stosowane w skryptach FreeCAD, importowanie ich w ten sposób pozwoli zaoszczędzić na wywoływaniu ich za pomocą lub  zamiast  lub, zaoszczędzi to wiele naciśnięć klawiszy i sprawi, że linie kodu będą znacznie krótsze.

Zacznijmy od małego skryptu, który wykonuje bardzo małą pracę, ale pokazuje moc tej metody.

Umieść te linie po kodzie "szablonu" i naciśnij zieloną strzałkę na pasku narzędzi "Makrodefinicje".

Zobaczysz kilka magicznych rzeczy, otworzy się nowy dokument o nazwie "Pippo" (włoska nazwa Goofy), a w widoku 3D zobaczysz Sześcian, taki jak na poniższym obrazku.





Coś więcej ...
Nie jest to zbyt niesamowite? Tak, ale musimy od czegoś zacząć, możemy zrobić to samo z walcem, dodając te linie kodu po metodzie i przed linią:.

Nawet tutaj nie ma nic zbyt ekscytującego. Warto jednak zwrócić uwagę na kilka osobliwości:


 * Brak zwykłego odniesienia do, obecnego w wielu fragmentach kodu Dokumentacji, jest zamierzony, kod ten może być użyty nawet do wywołania FreeCAD jako modułu w zewnętrznym interpreterze Pythona, nie jest to łatwe do zrobienia z AppImage, ale z pewną ostrożnością można to zrobić. Plus w standardowym motto Pythona, że "lepiej jawnie niż niejawnie" wyjaśnia w bardzo "kiepski" sposób, skąd pochodzą rzeczy.
 * Zwróć uwagę na użycie "stałej" nazwy przypisanej do aktywnego Dokumentu w = ; activeDocument nie jest "stałą" w ścisłym sensie, ale w sposób "semantyczny" jest naszym "aktywnym dokumentem", który dla naszego użytku jest właściwą "stałą", więc konwencja Pythona polega na używaniu nazwy "ALL CAPS" dla "stałych", nie wspominając o tym, że  jest znacznie krótszy niż.
 * Każda metoda zwraca geometrię, będzie to jasne w dalszej części strony.
 * Geometria nie miała właściwości, podczas używania prostych geometrii do tworzenia bardziej złożonych geometrii, zarządzanie jest kłopotliwe.

Co teraz zrobić z tą geometrią?

Wprowadźmy operacje logiczne. Jako przykład początkowy umieść te linie po, to utworzy metodę dla operacji Fusion znanej również jako Union:

Tutaj również nie ma nic wyjątkowego, należy jednak zwrócić uwagę na jednolitość kodowania metod; to podejście jest bardziej liniowe niż te spotykane w innych samouczkach dotyczących skryptów, ta "liniowość" znacznie pomaga w czytelności, a także w operacjach wycinania, kopiowania i wklejania.

Użyjmy geometrii, usuńmy linie poniżej sekcji kodu zaczynającej się od i wstawmy następujące linie:

Uruchom skrypt za pomocą zielonej strzałki, a w widoku 3D zobaczymy coś takiego:



Umiejscowienie
Koncepcja umiejscowienia jest stosunkowo złożona, zobacz poradnik samolotu, aby uzyskać bardziej dogłębne wyjaśnienie.

Zazwyczaj potrzebujemy umieścić geometrie względem siebie, podczas budowania złożonych obiektów jest to powtarzające się zadanie, najczęstszym sposobem jest użycie właściwości geometrii.

FreeCAD oferuje szeroki wybór sposobów ustawiania tej właściwości, jeden jest bardziej dostosowany do drugiego w zależności od wiedzy i doświadczenia użytkownika, ale bardziej proste pisanie jest wyjaśnione w cytowanym samouczku, używa osobliwej definicji części, dość łatwej do nauczenia.

Ale ponad innymi rozważaniami, jedna rzecz jest kluczowa, geometria punkt odniesienia. Innymi słowy punkt, z którego obiekt jest modelowany przez FreeCAD, jak opisano w tej tabeli, skopiowanej z umiejscowienia:

Informacje te należy mieć na uwadze, zwłaszcza gdy musimy zastosować rotację.

Kilka przykładów może pomóc, usuń całą linię po metodzie i wstaw poniższy fragment kodu:

Wyjaśnijmy coś w kodzie:


 * Zastosowaliśmy metodę definiowania sfery, używając najprostszej definicji, używając tylko promienia.
 * Wprowadziliśmy drugi zapis dla Union lub Fusion, używający wielu obiektów, nie bardziej odległy od zwykłego Part::Fuse, który używa Part:Multifuse. Używamy tylko jednej właściwości . Przekazaliśmy krotkę jako argumenty, ale akceptuje ona również listę.
 * Zdefiniowaliśmy złożony obiekt aeroplano (włoskie słowo oznaczające samolot), ale zrobiliśmy to w parametryczny sposób, definiując niektóre parametry i wyprowadzając inne parametry, poprzez pewne obliczenia, w oparciu o główne parametry.
 * Użyliśmy kilku właściwości w metodzie, a przed zwróceniem ostatecznych geometrii użyliśmy właściwości  z napisem Przechylenie-Pochylenie-Odchylenie. Zwróć uwagę na ostatni, który definiuje środek obrotu całej geometrii.

Można łatwo zauważyć, że geometria aeroplano obraca się wokół swojego "barycentrum" lub "środka ciężkości", który ustaliłem na środku skrzydła, miejscu, które jest stosunkowo "naturalne", ale można je umieścić gdziekolwiek chcesz.

Pierwszy jest wektorem translacji, nieużywanym tutaj, ale jeśli zastąpisz  tymi liniami:

W oknie raportu pojawi się ten tekst:

Co się stało?

FreeCAD przemieścił innymi słowy naszą definicję, która określa trzy komponenty, Przemieszczenie, Obrót i środek obrotu w "wewnętrznych" wartościach tylko dwóch komponentów, Przemieszczenie i Obrót.

można łatwo zwizualizować wartość za pomocą instrukcji print w metodzie  i zobaczyć, że tak jest:

Innymi słowy, środek obrotu geometrii znajduje się w, ale ten środek obrotu nie jest wyświetlany w GUI, można go wprowadzić jako wartość , nie można go łatwo wyszukać.

Jest to znaczenie słowa "niewygodny", którego użyłem do zdefiniowania właściwości.

This is the complete code example with a decent script docstring following Google docstrings convention: