Scripts/pl: Difference between revisions
(Created page with "{{Docnav/pl |Makrodefinicje |Wprowadzenie do środowiska Python }}") |
(Updating to match new version of source page) |
||
Line 22: | Line 22: | ||
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. |
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. |
||
<span id=" |
<span id="Getting_started"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
==Zaostrzenie apetytu== |
==Zaostrzenie apetytu== |
||
</div> |
|||
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 {{incode|.py}} w wewnętrznym edytorze Python, najprostszą sztuczką jest utworzenie go w ulubionym edytorze tekstu, a następnie otwarcie go za pomocą zwykłego polecenia {{MenuCommand|Plik → Otwórz}}. |
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 {{incode|.py}} w wewnętrznym edytorze Python, najprostszą sztuczką jest utworzenie go w ulubionym edytorze tekstu, a następnie otwarcie go za pomocą zwykłego polecenia {{MenuCommand|Plik → Otwórz}}. |
||
Line 30: | Line 32: | ||
{{Code|code= |
{{Code|code= |
||
""" |
"""filename.py |
||
A short description of what the script does |
|||
Primo script per FreeCAD |
|||
""" |
""" |
||
}} |
}} |
||
<div class="mw-translate-fuzzy"> |
|||
Zapisz je ze znaczącą nazwą z rozszerzeniem {{incode|.py}} i załaduj wynikowy plik w FreeCAD, za pomocą wspomnianego polecenia {{MenuCommand|Plik → Otwórz}}. |
Zapisz je ze znaczącą nazwą z rozszerzeniem {{incode|.py}} i załaduj wynikowy plik w FreeCAD, za pomocą wspomnianego polecenia {{MenuCommand|Plik → Otwórz}}. |
||
</div> |
|||
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: |
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: |
||
Line 44: | Line 48: | ||
"""filename.py |
"""filename.py |
||
First FreeCAD Script |
|||
Here a short but significant description of what the script do |
|||
""" |
""" |
||
import FreeCAD |
import FreeCAD |
||
from FreeCAD import |
from FreeCAD import Placement, Rotation, Vector |
||
import Part |
|||
from math import pi, sin, cos |
|||
DOC = FreeCAD.activeDocument() |
DOC = FreeCAD.activeDocument() |
||
DOC_NAME = " |
DOC_NAME = "Wiki_Example" |
||
# Helpers methods |
|||
def clear_doc(): |
def clear_doc(): |
||
"""Clear activeDocument deleting all the objects.""" |
|||
""" |
|||
Clear the active document deleting all the objects |
|||
""" |
|||
for obj in DOC.Objects: |
for obj in DOC.Objects: |
||
DOC.removeObject(obj.Name) |
DOC.removeObject(obj.Name) |
||
def setview(): |
def setview(): |
||
"""Rearrange View""" |
"""Rearrange View.""" |
||
FreeCAD.Gui.SendMsgToActiveView("ViewFit") |
FreeCAD.Gui.SendMsgToActiveView("ViewFit") |
||
FreeCAD.Gui.activeDocument().activeView().viewAxometric() |
FreeCAD.Gui.activeDocument().activeView().viewAxometric() |
||
Line 75: | Line 77: | ||
clear_doc() |
clear_doc() |
||
ROT0 = Rotation(0, 0, 0) |
|||
# EPS= tolerance to use to cut the parts |
|||
VEC0 = Vector(0, 0, 0) |
|||
EPS = 0.10 |
|||
EPS_C = EPS * -0.5 |
|||
}} |
}} |
||
Powyższy kod zawiera kilka sztuczek: |
Powyższy kod zawiera kilka sztuczek: |
||
<div class="mw-translate-fuzzy"> |
|||
* {{incode|import FreeCAD}} Ta linia importuje FreeCAD w interpreterze FreeCAD Python, może wydawać się zbędna, ale tak nie jest. |
* {{incode|import FreeCAD}} Ta linia importuje FreeCAD w interpreterze FreeCAD Python, może wydawać się zbędna, ale tak nie jest. |
||
* {{incode|from FreeCAD import Base, Vector}} Base i Vector są szeroko stosowane w skryptach FreeCAD, importowanie ich w ten sposób pozwoli zaoszczędzić na wywoływaniu ich za pomocą {{incode|FreeCAD.Vector}} lub {{incode|FreeCAD.Base}} zamiast {{incode|Base}} lub {{incode|Vector}}, zaoszczędzi to wiele naciśnięć klawiszy i sprawi, że linie kodu będą znacznie krótsze. |
* {{incode|from FreeCAD import Base, Vector}} Base i Vector są szeroko stosowane w skryptach FreeCAD, importowanie ich w ten sposób pozwoli zaoszczędzić na wywoływaniu ich za pomocą {{incode|FreeCAD.Vector}} lub {{incode|FreeCAD.Base}} zamiast {{incode|Base}} lub {{incode|Vector}}, zaoszczędzi to wiele naciśnięć klawiszy i sprawi, że linie kodu będą znacznie krótsze. |
||
</div> |
|||
Zacznijmy od małego skryptu, który wykonuje bardzo małą pracę, ale pokazuje moc tej metody. |
Zacznijmy od małego skryptu, który wykonuje bardzo małą pracę, ale pokazuje moc tej metody. |
||
{{Code|code= |
{{Code|code= |
||
# Script methods |
|||
def cubo(nome, lung, larg, alt): |
|||
obj_b = DOC.addObject("Part::Box", nome) |
|||
def my_box(name, len, wid, hei): |
|||
obj_b.Length = lung |
|||
"""Create a box.""" |
|||
obj_b |
obj_b = DOC.addObject("Part::Box", name) |
||
obj_b.Length = len |
|||
obj_b.Width = wid |
|||
obj_b.Height = hei |
|||
DOC.recompute() |
DOC.recompute() |
||
Line 100: | Line 106: | ||
# objects definition |
# objects definition |
||
obj = |
obj = my_box("test_cube", 5, 5, 5) |
||
setview() |
setview() |
||
}} |
}} |
||
<div class="mw-translate-fuzzy"> |
|||
Umieść te linie po kodzie "szablonu" i naciśnij zieloną strzałkę na pasku narzędzi "Makrodefinicje". |
Umieść te linie po kodzie "szablonu" i naciśnij zieloną strzałkę na pasku narzędzi "Makrodefinicje". |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Zobaczysz kilka magicznych rzeczy, otworzy się nowy dokument o nazwie "Pippo" ''(włoska nazwa '''Goofy''')'', a w widoku 3D zobaczysz [[Part_Box/pl|Sześcian]], taki jak na poniższym obrazku. |
Zobaczysz kilka magicznych rzeczy, otworzy się nowy dokument o nazwie "Pippo" ''(włoska nazwa '''Goofy''')'', a w widoku 3D zobaczysz [[Part_Box/pl|Sześcian]], taki jak na poniższym obrazku. |
||
</div> |
|||
[[File:Cubo.png|thumb|center|Test |
[[File:Cubo.png|thumb|center|Test cube]] |
||
<span id="Something_more |
<span id="Something_more"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
==Coś więcej ...== |
==Coś więcej ...== |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Nie jest to zbyt niesamowite? Tak, ale musimy od czegoś zacząć, możemy zrobić to samo z [[Part_Cylinder/pl|walcem]], dodając te linie kodu po metodzie {{incode|cubo()}} i przed linią: {{incode|# objects definition}}. |
Nie jest to zbyt niesamowite? Tak, ale musimy od czegoś zacząć, możemy zrobić to samo z [[Part_Cylinder/pl|walcem]], dodając te linie kodu po metodzie {{incode|cubo()}} i przed linią: {{incode|# objects definition}}. |
||
</div> |
|||
{{Code|code= |
{{Code|code= |
||
def |
def my_cyl(name, ang, rad, hei): |
||
"""Create a Cylinder.""" |
|||
obj = DOC.addObject("Part::Cylinder", nome) |
|||
obj = DOC.addObject("Part::Cylinder", name) |
|||
obj.Angle = ang |
obj.Angle = ang |
||
obj.Radius = rad |
obj.Radius = rad |
||
obj.Height = |
obj.Height = hei |
||
DOC.recompute() |
DOC.recompute() |
||
return obj |
return obj |
||
}} |
}} |
||
Nawet tutaj nie ma nic zbyt ekscytującego. Warto jednak zwrócić uwagę na kilka osobliwości: |
Nawet tutaj nie ma nic zbyt ekscytującego. Warto jednak zwrócić uwagę na kilka osobliwości: |
||
<div class="mw-translate-fuzzy"> |
|||
* Brak zwykłego odniesienia do {{incode|App.}}, 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" {{incode|App.}} wyjaśnia w bardzo "kiepski" sposób, skąd pochodzą rzeczy. |
* Brak zwykłego odniesienia do {{incode|App.}}, 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" {{incode|App.}} wyjaśnia w bardzo "kiepski" sposób, skąd pochodzą rzeczy. |
||
* Zwróć uwagę na użycie "stałej" nazwy przypisanej do aktywnego Dokumentu w {{incode|DOC}} = {{incode|FreeCAD. activeDocument()}}; 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 {{incode|DOC}} jest znacznie krótszy niż {{incode|FreeCAD.activeDocument()}}. |
* Zwróć uwagę na użycie "stałej" nazwy przypisanej do aktywnego Dokumentu w {{incode|DOC}} = {{incode|FreeCAD. activeDocument()}}; 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 {{incode|DOC}} jest znacznie krótszy niż {{incode|FreeCAD.activeDocument()}}. |
||
* Każda metoda zwraca geometrię, będzie to jasne w dalszej części strony. |
* Każda metoda zwraca geometrię, będzie to jasne w dalszej części strony. |
||
* Geometria nie miała właściwości {{incode|Placement}}, podczas używania prostych geometrii do tworzenia bardziej złożonych geometrii, zarządzanie {{incode|Placement}} jest kłopotliwe. |
* Geometria nie miała właściwości {{incode|Placement}}, podczas używania prostych geometrii do tworzenia bardziej złożonych geometrii, zarządzanie {{incode|Placement}} jest kłopotliwe. |
||
</div> |
|||
Co teraz zrobić z tą geometrią? |
Co teraz zrobić z tą geometrią? |
||
<div class="mw-translate-fuzzy"> |
|||
Wprowadźmy operacje logiczne. Jako przykład początkowy umieść te linie po {{incode|base_cyl(...}}, to utworzy metodę dla operacji '''Fusion''' znanej również jako '''Union''': |
Wprowadźmy operacje logiczne. Jako przykład początkowy umieść te linie po {{incode|base_cyl(...}}, to utworzy metodę dla operacji '''Fusion''' znanej również jako '''Union''': |
||
</div> |
|||
{{Code|code= |
{{Code|code= |
||
def fuse_obj( |
def fuse_obj(name, obj_0, obj_1): |
||
"""Fuse two objects.""" |
|||
obj = DOC.addObject("Part::Fuse", nome) |
|||
obj = DOC.addObject("Part::Fuse", name) |
|||
obj.Base = obj_0 |
obj.Base = obj_0 |
||
obj.Tool = obj_1 |
obj.Tool = obj_1 |
||
Line 158: | Line 177: | ||
# objects definition |
# objects definition |
||
obj = |
obj = my_box("test_cube", 5, 5, 5) |
||
obj1 = |
obj1 = my_cyl("test_cyl", 360, 2, 10) |
||
fuse_obj(" |
fuse_obj("Fusion", obj, obj1) |
||
setview() |
setview() |
||
}} |
}} |
||
<div class="mw-translate-fuzzy"> |
|||
Uruchom skrypt za pomocą zielonej strzałki, a w widoku 3D zobaczymy coś takiego: |
Uruchom skrypt za pomocą zielonej strzałki, a w widoku 3D zobaczymy coś takiego: |
||
</div> |
|||
[[File:Cucil.png|thumb|center| |
[[File:Cucil.png|thumb|center|Cube and cylinder]] |
||
<span id="Placement"></span> |
<span id="Placement"></span> |
||
Line 180: | Line 201: | ||
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 {{incode|Rotation}} {{incode|Placement}}, dość łatwej do nauczenia. |
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 {{incode|Rotation}} {{incode|Placement}}, dość łatwej do nauczenia. |
||
{{Code|code= |
{{Code|code= |
||
FreeCAD.Placement(Vector(0, 0, 0), FreeCAD.Rotation(10, 20, 30), Vector(0, 0, 0)) |
FreeCAD.Placement(Vector(0, 0, 0), FreeCAD.Rotation(10, 20, 30), Vector(0, 0, 0)) |
||
}} |
}} |
||
<div class="mw-translate-fuzzy"> |
|||
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 [[Placement/pl|umiejscowienia]]: |
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 [[Placement/pl|umiejscowienia]]: |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
{| class="wikitable" border="1" |
{| class="wikitable" border="1" |
||
!Object!!Punkt odniesienia |
!Object!!Punkt odniesienia |
||
Line 201: | Line 225: | ||
|Cechy wywodzące się ze szkiców||cecha dziedziczy pozycję bazowego szkicu. Szkice zawsze zaczynają się od Pozycja = (0, 0, 0). Pozycja ta odpowiada punktowi położenia odniesienia. |
|Cechy wywodzące się ze szkiców||cecha dziedziczy pozycję bazowego szkicu. Szkice zawsze zaczynają się od Pozycja = (0, 0, 0). Pozycja ta odpowiada punktowi położenia odniesienia. |
||
|} |
|} |
||
</div> |
|||
Informacje te należy mieć na uwadze, zwłaszcza gdy musimy zastosować rotację. |
Informacje te należy mieć na uwadze, zwłaszcza gdy musimy zastosować rotację. |
||
<div class="mw-translate-fuzzy"> |
|||
Kilka przykładów może pomóc, usuń całą linię po metodzie {{incode|base_cyl}} i wstaw poniższy fragment kodu: |
Kilka przykładów może pomóc, usuń całą linię po metodzie {{incode|base_cyl}} i wstaw poniższy fragment kodu: |
||
</div> |
|||
{{Code|code= |
{{Code|code= |
||
def |
def my_sphere(name, rad): |
||
"""Create a Sphere.""" |
|||
obj = DOC.addObject("Part::Sphere", nome) |
|||
obj = DOC.addObject("Part::Sphere", name) |
|||
obj.Radius = rad |
obj.Radius = rad |
||
DOC.recompute() |
DOC.recompute() |
||
return obj |
return obj |
||
def my_box2(name, len, wid, hei, cent=False, off_z=0): |
|||
"""Create a box with an optional z offset.""" |
|||
obj_b = DOC.addObject("Part::Box", name) |
|||
obj_b.Length = len |
|||
obj_b.Width = wid |
|||
obj_b.Height = hei |
|||
if cent is True: |
|||
pos = Vector(len * -0.5, wid * -0.5, off_z) |
|||
else: |
|||
pos = Vector(0, 0, off_z) |
|||
obj_b.Placement = Placement(pos, ROT0, VEC0) |
|||
DOC.recompute() |
|||
return obj_b |
|||
def mfuse_obj( |
def mfuse_obj(name, objs): |
||
"""Fuse multiple objects.""" |
|||
obj = DOC.addObject("Part::MultiFuse", nome) |
|||
obj = DOC.addObject("Part::MultiFuse", name) |
|||
obj.Shapes = objs |
obj.Shapes = objs |
||
obj.Refine = True |
obj.Refine = True |
||
Line 223: | Line 270: | ||
return obj |
return obj |
||
def |
def airplane(): |
||
"""Create an airplane shaped solid.""" |
|||
fuselage_length = 30 |
|||
fuselage_diameter = 5 |
|||
wing_span = fuselage_length * 1.75 |
|||
wing_width = 7.5 |
|||
wing_thickness = 1.5 |
|||
tail_height = fuselage_diameter * 3.0 |
|||
tail_position = fuselage_length * 0.70 |
|||
tail_offset = tail_position - (wing_width * 0.5) |
|||
obj1 = my_cyl("main_body", 360, fuselage_diameter, fuselage_length) |
|||
lung_fus = 30 |
|||
diam_fus = 5 |
|||
ap_alare = lung_fus * 1.75 |
|||
larg_ali = 7.5 |
|||
spess_ali = 1.5 |
|||
alt_imp = diam_fus * 3.0 |
|||
pos_ali = (lung_fus*0.70) |
|||
off_ali = (pos_ali - (larg_ali * 0.5)) |
|||
obj2 = my_box2("wings", wing_span, wing_thickness, wing_width, True, tail_offset) |
|||
obj1 = base_cyl('primo cilindro', 360, diam_fus, lung_fus) |
|||
obj3 = my_sphere("nose", fuselage_diameter) |
|||
obj2 = cubo('ali', ap_alare, spess_ali, larg_ali, True, off_ali) |
|||
obj3.Placement = Placement(Vector(0, 0, fuselage_length), ROT0, VEC0) |
|||
obj4 = my_box2("tail", wing_thickness, tail_height, wing_width, False, 0) |
|||
obj3 = sfera("naso", diam_fus) |
|||
obj4.Placement = Placement(Vector(0, tail_height * -1, 0), ROT0, VEC0) |
|||
obj4 = cubo('impennaggio', spess_ali, alt_imp, larg_ali, False, 0) |
|||
obj4.Placement = FreeCAD.Placement(Vector(0, alt_imp * -1, 0), FreeCAD.Rotation(0, 0, 0), Vector(0, 0, 0)) |
|||
objs = (obj1, obj2, obj3, obj4) |
objs = (obj1, obj2, obj3, obj4) |
||
obj = mfuse_obj(" |
obj = mfuse_obj("airplane", objs) |
||
obj.Placement = |
obj.Placement = Placement(VEC0, Rotation(0, 0, -90), Vector(0, 0, tail_position)) |
||
DOC.recompute() |
DOC.recompute() |
||
Line 255: | Line 302: | ||
# objects definition |
# objects definition |
||
airplane() |
|||
aeroplano() |
|||
setview() |
setview() |
||
}} |
}} |
||
Wyjaśnijmy coś w kodzie: |
Wyjaśnijmy coś w kodzie: |
||
<div class="mw-translate-fuzzy"> |
|||
* Zastosowaliśmy metodę definiowania sfery, używając najprostszej definicji, używając tylko promienia. |
* 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 {{incode|Shapes}}. Przekazaliśmy '''krotkę''' jako argumenty, ale akceptuje ona również '''listę'''. |
* 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 {{incode|Shapes}}. 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. |
* 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 {{incode|Umiejscowienie}} w metodzie, a przed zwróceniem ostatecznych geometrii użyliśmy właściwości {{incode|Obrót}} z napisem ''Przechylenie-Pochylenie-Odchylenie''. Zwróć uwagę na ostatni {{incode|Vector(0, 0, pos_ali)}}, który definiuje '''środek obrotu''' całej geometrii. |
* Użyliśmy kilku właściwości {{incode|Umiejscowienie}} w metodzie, a przed zwróceniem ostatecznych geometrii użyliśmy właściwości {{incode|Obrót}} z napisem ''Przechylenie-Pochylenie-Odchylenie''. Zwróć uwagę na ostatni {{incode|Vector(0, 0, pos_ali)}}, który definiuje '''środek obrotu''' całej geometrii. |
||
</div> |
|||
{| class="wikitable" |
{| class="wikitable" |
||
|- |
|- |
||
| [[File:Aereo.png|thumb|left| |
| [[File:Aereo.png|thumb|left|Airplane example]] || [[File:Aereo2.png|thumb|center|Airplane rotated]]|| |
||
[[File:Aereo-prop.png|thumb|center| |
[[File:Aereo-prop.png|thumb|center|Placement property]] |
||
|} |
|} |
||
<div class="mw-translate-fuzzy"> |
|||
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. |
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. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Pierwszy {{incode|Vector(0, 0, 0)}} jest wektorem translacji, nieużywanym tutaj, ale jeśli zastąpisz {{incode|aeroplano()}} tymi liniami: |
Pierwszy {{incode|Vector(0, 0, 0)}} jest wektorem translacji, nieużywanym tutaj, ale jeśli zastąpisz {{incode|aeroplano()}} tymi liniami: |
||
</div> |
|||
{{Code|code= |
{{Code|code= |
||
obj_f = |
obj_f = airplane() |
||
print(obj_F.Placement) |
print(obj_F.Placement) |
||
Line 291: | Line 345: | ||
Co się stało? |
Co się stało? |
||
<div class="mw-translate-fuzzy"> |
|||
FreeCAD przemieścił {{incode|Vector(0, 0, 0), FreeCAD.Rotation(0, 0, -90), Vector(0, 0, pos_ali)}} innymi słowy naszą definicję {{incode|Umiejscowienia}}, 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'''. |
FreeCAD przemieścił {{incode|Vector(0, 0, 0), FreeCAD.Rotation(0, 0, -90), Vector(0, 0, pos_ali)}} innymi słowy naszą definicję {{incode|Umiejscowienia}}, 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'''. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
można łatwo zwizualizować wartość {{incode|pos_ali}} za pomocą instrukcji print w metodzie {{incode|aeroplano(...}} i zobaczyć, że tak jest: |
można łatwo zwizualizować wartość {{incode|pos_ali}} za pomocą instrukcji print w metodzie {{incode|aeroplano(...}} i zobaczyć, że tak jest: |
||
</div> |
|||
{{Code|code= |
{{Code|code= |
||
tail_position = 21.0 |
|||
}} |
}} |
||
<div class="mw-translate-fuzzy"> |
|||
Innymi słowy, ''środek obrotu'' geometrii znajduje się w {{Incode|Vector(0, 0, 21)}}, ale ten środek obrotu nie jest wyświetlany w GUI, można go wprowadzić jako wartość {{Incode|Umiejscowienie}}, nie można go łatwo wyszukać. |
Innymi słowy, ''środek obrotu'' geometrii znajduje się w {{Incode|Vector(0, 0, 21)}}, ale ten środek obrotu nie jest wyświetlany w GUI, można go wprowadzić jako wartość {{Incode|Umiejscowienie}}, nie można go łatwo wyszukać. |
||
</div> |
|||
Jest to znaczenie słowa "niewygodny", którego użyłem do zdefiniowania właściwości {{incode|Umiejscowienie}}. |
Jest to znaczenie słowa "niewygodny", którego użyłem do zdefiniowania właściwości {{incode|Umiejscowienie}}. |
||
This is the complete code example with a decent script docstring following [https://www.sphinx-doc.org/en/master/usage/extensions/example_google.html#example-google Goggle docstrings convention]: |
|||
{{Code|code= |
|||
"""Sample code. |
|||
Filename: |
|||
airplane.py |
|||
Author: |
|||
Dormeletti Carlo (onekk) |
|||
Version: |
|||
1.0 |
|||
License: |
|||
Creative Commons Attribution 3.0 |
|||
Summary: |
|||
This code is a sample code written for FreeCAD Wiki page. |
|||
It create and airplane shaped solid made using standard "Part WB" built in shapes. |
|||
""" |
|||
import FreeCAD |
|||
from FreeCAD import Placement, Rotation, Vector |
|||
DOC = FreeCAD.activeDocument() |
|||
DOC_NAME = "Wiki_Example" |
|||
# Helpers methods |
|||
def clear_doc(): |
|||
"""Clear activeDocument deleting all the objects.""" |
|||
for obj in DOC.Objects: |
|||
DOC.removeObject(obj.Name) |
|||
def setview(): |
|||
"""Rearrange View.""" |
|||
FreeCAD.Gui.SendMsgToActiveView("ViewFit") |
|||
FreeCAD.Gui.activeDocument().activeView().viewAxometric() |
|||
if DOC is None: |
|||
FreeCAD.newDocument(DOC_NAME) |
|||
FreeCAD.setActiveDocument(DOC_NAME) |
|||
DOC = FreeCAD.activeDocument() |
|||
else: |
|||
clear_doc() |
|||
ROT0 = Rotation(0, 0, 0) |
|||
VEC0 = Vector(0, 0, 0) |
|||
# Script methods |
|||
def my_cyl(name, ang, rad, hei): |
|||
"""Create a Cylinder.""" |
|||
obj = DOC.addObject("Part::Cylinder", name) |
|||
obj.Angle = ang |
|||
obj.Radius = rad |
|||
obj.Height = hei |
|||
DOC.recompute() |
|||
return obj |
|||
def my_sphere(name, rad): |
|||
"""Create a Sphere.""" |
|||
obj = DOC.addObject("Part::Sphere", name) |
|||
obj.Radius = rad |
|||
DOC.recompute() |
|||
return obj |
|||
def my_box2(name, len, wid, hei, cent=False, off_z=0): |
|||
"""Create a box with an optional z offset.""" |
|||
obj_b = DOC.addObject("Part::Box", name) |
|||
obj_b.Length = len |
|||
obj_b.Width = wid |
|||
obj_b.Height = hei |
|||
if cent is True: |
|||
pos = Vector(len * -0.5, wid * -0.5, off_z) |
|||
else: |
|||
pos = Vector(0, 0, off_z) |
|||
obj_b.Placement = Placement(pos, ROT0, VEC0) |
|||
DOC.recompute() |
|||
return obj_b |
|||
def mfuse_obj(name, objs): |
|||
"""Fuse multiple objects.""" |
|||
obj = DOC.addObject("Part::MultiFuse", name) |
|||
obj.Shapes = objs |
|||
obj.Refine = True |
|||
DOC.recompute() |
|||
return obj |
|||
def airplane(): |
|||
"""Create an airplane shaped solid.""" |
|||
fuselage_length = 30 |
|||
fuselage_diameter = 5 |
|||
wing_span = fuselage_length * 1.75 |
|||
wing_width = 7.5 |
|||
wing_thickness = 1.5 |
|||
tail_height = fuselage_diameter * 3.0 |
|||
tail_position = fuselage_length * 0.70 |
|||
tail_offset = tail_position - (wing_width * 0.5) |
|||
obj1 = my_cyl("main_body", 360, fuselage_diameter, fuselage_length) |
|||
obj2 = my_box2("wings", wing_span, wing_thickness, wing_width, True, tail_offset) |
|||
obj3 = my_sphere("nose", fuselage_diameter) |
|||
obj3.Placement = Placement(Vector(0, 0, fuselage_length), ROT0, VEC0) |
|||
obj4 = my_box2("tail", wing_thickness, tail_height, wing_width, False, 0) |
|||
obj4.Placement = Placement(Vector(0, tail_height * -1, 0), ROT0, VEC0) |
|||
objs = (obj1, obj2, obj3, obj4) |
|||
obj = mfuse_obj("airplane", objs) |
|||
obj.Placement = Placement(VEC0, Rotation(0, 0, -90), Vector(0, 0, tail_position)) |
|||
DOC.recompute() |
|||
return obj |
|||
# objects definition |
|||
airplane() |
|||
setview() |
|||
}} |
|||
Revision as of 21:31, 6 November 2023
Ćwiczenie |
Temat |
---|
Tworzenie skryptów |
Poziom trudności |
Podstawowy |
Czas wykonania |
Autorzy |
onekk Carlo |
Wersja FreeCAD |
0.19 |
Pliki z przykładami |
Zobacz również |
- |
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 .py
w wewnętrznym edytorze Python, najprostszą sztuczką jest utworzenie go w ulubionym edytorze tekstu, a następnie otwarcie go za pomocą zwykłego polecenia Plik → Otwórz.
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:
"""filename.py
A short description of what the script does
"""
Zapisz je ze znaczącą nazwą z rozszerzeniem .py
i załaduj wynikowy plik w FreeCAD, za pomocą wspomnianego polecenia Plik → Otwórz.
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:
"""filename.py
First FreeCAD Script
"""
import FreeCAD
from FreeCAD import Placement, Rotation, Vector
DOC = FreeCAD.activeDocument()
DOC_NAME = "Wiki_Example"
# Helpers methods
def clear_doc():
"""Clear activeDocument deleting all the objects."""
for obj in DOC.Objects:
DOC.removeObject(obj.Name)
def setview():
"""Rearrange View."""
FreeCAD.Gui.SendMsgToActiveView("ViewFit")
FreeCAD.Gui.activeDocument().activeView().viewAxometric()
if DOC is None:
FreeCAD.newDocument(DOC_NAME)
FreeCAD.setActiveDocument(DOC_NAME)
DOC = FreeCAD.activeDocument()
else:
clear_doc()
ROT0 = Rotation(0, 0, 0)
VEC0 = Vector(0, 0, 0)
Powyższy kod zawiera kilka sztuczek:
import FreeCAD
Ta linia importuje FreeCAD w interpreterze FreeCAD Python, może wydawać się zbędna, ale tak nie jest.from FreeCAD import Base, Vector
Base i Vector są szeroko stosowane w skryptach FreeCAD, importowanie ich w ten sposób pozwoli zaoszczędzić na wywoływaniu ich za pomocąFreeCAD.Vector
lubFreeCAD.Base
zamiastBase
lubVector
, 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.
# Script methods
def my_box(name, len, wid, hei):
"""Create a box."""
obj_b = DOC.addObject("Part::Box", name)
obj_b.Length = len
obj_b.Width = wid
obj_b.Height = hei
DOC.recompute()
return obj_b
# objects definition
obj = my_box("test_cube", 5, 5, 5)
setview()
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 cubo()
i przed linią: # objects definition
.
def my_cyl(name, ang, rad, hei):
"""Create a Cylinder."""
obj = DOC.addObject("Part::Cylinder", name)
obj.Angle = ang
obj.Radius = rad
obj.Height = hei
DOC.recompute()
return obj
Nawet tutaj nie ma nic zbyt ekscytującego. Warto jednak zwrócić uwagę na kilka osobliwości:
- Brak zwykłego odniesienia do
App.
, 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"App.
wyjaśnia w bardzo "kiepski" sposób, skąd pochodzą rzeczy. - Zwróć uwagę na użycie "stałej" nazwy przypisanej do aktywnego Dokumentu w
DOC
=FreeCAD. activeDocument()
; 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, żeDOC
jest znacznie krótszy niżFreeCAD.activeDocument()
. - Każda metoda zwraca geometrię, będzie to jasne w dalszej części strony.
- Geometria nie miała właściwości
Placement
, podczas używania prostych geometrii do tworzenia bardziej złożonych geometrii, zarządzaniePlacement
jest kłopotliwe.
Co teraz zrobić z tą geometrią?
Wprowadźmy operacje logiczne. Jako przykład początkowy umieść te linie po base_cyl(...
, to utworzy metodę dla operacji Fusion znanej również jako Union:
def fuse_obj(name, obj_0, obj_1):
"""Fuse two objects."""
obj = DOC.addObject("Part::Fuse", name)
obj.Base = obj_0
obj.Tool = obj_1
obj.Refine = True
DOC.recompute()
return obj
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 # objects definition
i wstawmy następujące linie:
# objects definition
obj = my_box("test_cube", 5, 5, 5)
obj1 = my_cyl("test_cyl", 360, 2, 10)
fuse_obj("Fusion", obj, obj1)
setview()
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 Placement
.
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 Rotation
Placement
, dość łatwej do nauczenia.
FreeCAD.Placement(Vector(0, 0, 0), FreeCAD.Rotation(10, 20, 30), Vector(0, 0, 0))
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:
Object | Punkt odniesienia |
---|---|
Part.Box | lewy (minx), przedni (miny), dolny (minz) wierzchołek |
Part.Sphere | środek kuli (tj. środek obwiedni) |
Part.Cylinder | środek dolnej powierzchni |
Part.Cone | środek dolnej powierzchni (lub wierzchołek, jeśli dolny promień wynosi 0) |
Part.Torus | środek torusa |
Cechy wywodzące się ze szkiców | cecha dziedziczy pozycję bazowego szkicu. Szkice zawsze zaczynają się od Pozycja = (0, 0, 0). Pozycja ta odpowiada punktowi położenia odniesienia. |
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 base_cyl
i wstaw poniższy fragment kodu:
def my_sphere(name, rad):
"""Create a Sphere."""
obj = DOC.addObject("Part::Sphere", name)
obj.Radius = rad
DOC.recompute()
return obj
def my_box2(name, len, wid, hei, cent=False, off_z=0):
"""Create a box with an optional z offset."""
obj_b = DOC.addObject("Part::Box", name)
obj_b.Length = len
obj_b.Width = wid
obj_b.Height = hei
if cent is True:
pos = Vector(len * -0.5, wid * -0.5, off_z)
else:
pos = Vector(0, 0, off_z)
obj_b.Placement = Placement(pos, ROT0, VEC0)
DOC.recompute()
return obj_b
def mfuse_obj(name, objs):
"""Fuse multiple objects."""
obj = DOC.addObject("Part::MultiFuse", name)
obj.Shapes = objs
obj.Refine = True
DOC.recompute()
return obj
def airplane():
"""Create an airplane shaped solid."""
fuselage_length = 30
fuselage_diameter = 5
wing_span = fuselage_length * 1.75
wing_width = 7.5
wing_thickness = 1.5
tail_height = fuselage_diameter * 3.0
tail_position = fuselage_length * 0.70
tail_offset = tail_position - (wing_width * 0.5)
obj1 = my_cyl("main_body", 360, fuselage_diameter, fuselage_length)
obj2 = my_box2("wings", wing_span, wing_thickness, wing_width, True, tail_offset)
obj3 = my_sphere("nose", fuselage_diameter)
obj3.Placement = Placement(Vector(0, 0, fuselage_length), ROT0, VEC0)
obj4 = my_box2("tail", wing_thickness, tail_height, wing_width, False, 0)
obj4.Placement = Placement(Vector(0, tail_height * -1, 0), ROT0, VEC0)
objs = (obj1, obj2, obj3, obj4)
obj = mfuse_obj("airplane", objs)
obj.Placement = Placement(VEC0, Rotation(0, 0, -90), Vector(0, 0, tail_position))
DOC.recompute()
return obj
# objects definition
airplane()
setview()
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
Shapes
. 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
Umiejscowienie
w metodzie, a przed zwróceniem ostatecznych geometrii użyliśmy właściwościObrót
z napisem Przechylenie-Pochylenie-Odchylenie. Zwróć uwagę na ostatniVector(0, 0, pos_ali)
, 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 Vector(0, 0, 0)
jest wektorem translacji, nieużywanym tutaj, ale jeśli zastąpisz aeroplano()
tymi liniami:
obj_f = airplane()
print(obj_F.Placement)
W oknie raportu pojawi się ten tekst:
Placement [Pos=(0, -21, 21), Yaw-Pitch-Roll=(0, 0, -90)]
Co się stało?
FreeCAD przemieścił Vector(0, 0, 0), FreeCAD.Rotation(0, 0, -90), Vector(0, 0, pos_ali)
innymi słowy naszą definicję Umiejscowienia
, 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ść pos_ali
za pomocą instrukcji print w metodzie aeroplano(...
i zobaczyć, że tak jest:
tail_position = 21.0
Innymi słowy, środek obrotu geometrii znajduje się w Vector(0, 0, 21)
, ale ten środek obrotu nie jest wyświetlany w GUI, można go wprowadzić jako wartość Umiejscowienie
, nie można go łatwo wyszukać.
Jest to znaczenie słowa "niewygodny", którego użyłem do zdefiniowania właściwości Umiejscowienie
.
This is the complete code example with a decent script docstring following Goggle docstrings convention:
"""Sample code.
Filename:
airplane.py
Author:
Dormeletti Carlo (onekk)
Version:
1.0
License:
Creative Commons Attribution 3.0
Summary:
This code is a sample code written for FreeCAD Wiki page.
It create and airplane shaped solid made using standard "Part WB" built in shapes.
"""
import FreeCAD
from FreeCAD import Placement, Rotation, Vector
DOC = FreeCAD.activeDocument()
DOC_NAME = "Wiki_Example"
# Helpers methods
def clear_doc():
"""Clear activeDocument deleting all the objects."""
for obj in DOC.Objects:
DOC.removeObject(obj.Name)
def setview():
"""Rearrange View."""
FreeCAD.Gui.SendMsgToActiveView("ViewFit")
FreeCAD.Gui.activeDocument().activeView().viewAxometric()
if DOC is None:
FreeCAD.newDocument(DOC_NAME)
FreeCAD.setActiveDocument(DOC_NAME)
DOC = FreeCAD.activeDocument()
else:
clear_doc()
ROT0 = Rotation(0, 0, 0)
VEC0 = Vector(0, 0, 0)
# Script methods
def my_cyl(name, ang, rad, hei):
"""Create a Cylinder."""
obj = DOC.addObject("Part::Cylinder", name)
obj.Angle = ang
obj.Radius = rad
obj.Height = hei
DOC.recompute()
return obj
def my_sphere(name, rad):
"""Create a Sphere."""
obj = DOC.addObject("Part::Sphere", name)
obj.Radius = rad
DOC.recompute()
return obj
def my_box2(name, len, wid, hei, cent=False, off_z=0):
"""Create a box with an optional z offset."""
obj_b = DOC.addObject("Part::Box", name)
obj_b.Length = len
obj_b.Width = wid
obj_b.Height = hei
if cent is True:
pos = Vector(len * -0.5, wid * -0.5, off_z)
else:
pos = Vector(0, 0, off_z)
obj_b.Placement = Placement(pos, ROT0, VEC0)
DOC.recompute()
return obj_b
def mfuse_obj(name, objs):
"""Fuse multiple objects."""
obj = DOC.addObject("Part::MultiFuse", name)
obj.Shapes = objs
obj.Refine = True
DOC.recompute()
return obj
def airplane():
"""Create an airplane shaped solid."""
fuselage_length = 30
fuselage_diameter = 5
wing_span = fuselage_length * 1.75
wing_width = 7.5
wing_thickness = 1.5
tail_height = fuselage_diameter * 3.0
tail_position = fuselage_length * 0.70
tail_offset = tail_position - (wing_width * 0.5)
obj1 = my_cyl("main_body", 360, fuselage_diameter, fuselage_length)
obj2 = my_box2("wings", wing_span, wing_thickness, wing_width, True, tail_offset)
obj3 = my_sphere("nose", fuselage_diameter)
obj3.Placement = Placement(Vector(0, 0, fuselage_length), ROT0, VEC0)
obj4 = my_box2("tail", wing_thickness, tail_height, wing_width, False, 0)
obj4.Placement = Placement(Vector(0, tail_height * -1, 0), ROT0, VEC0)
objs = (obj1, obj2, obj3, obj4)
obj = mfuse_obj("airplane", objs)
obj.Placement = Placement(VEC0, Rotation(0, 0, -90), Vector(0, 0, tail_position))
DOC.recompute()
return obj
# objects definition
airplane()
setview()
- Tworzenie skryptów FreeCAD: Python, Wprowadzenie do środowiska Python, Poradnik: Tworzenie skryptów Python, Podstawy tworzenia skryptów FreeCAD
- Moduły: Moduły wbudowane, Jednostki miar, Ilość
- Środowiska pracy: Tworzenie Środowiska pracy, Polecenia Gui, Polecenia, Instalacja większej liczby Środowisk pracy
- Siatki i elementy: Skrytpy w Środowisku Siatek, v, Konwerska Mesh na Part, PythonOCC
- Obiekty parametryczne: Obiekty tworzone skryptami, Obsługa obrazu (Ikonka niestandardowa w widoku drzewa)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Interfejs graficzny: Stworzenie interfejsu, Kompletne stworzenie interfejsu w środowisku Python (1, 2, 3, 4, 5), PySide, PySide examples początkujący, średniozaawansowany, zaawansowany
- Makrodefinicje: Makrodefinicje, Instalacja makrodefinicji
- Osadzanie programu: Osadzanie programu FreeCAD, Osadzanie GUI FreeCAD
- Pozostałe: Wyrażenia, Wycinki kodu, Funkcja kreślenia linii, Biblioteka matematyczna FreeCAD dla wektorów (deprecated)
- Węzły użytkowników: Centrum użytkownika, Centrum Power użytkowników, Centrum programisty