App GeoFeature/pl: Difference between revisions
(Updating to match new version of source page) |
No edit summary |
||
(28 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
{{TOCright}} |
{{TOCright}} |
||
= |
<span id="Introduction"></span> |
||
==Wprowadzenie== |
|||
[[File:Feature.svg|32px]] |
[[File:Feature.svg|32px]] |
||
Obiekt '''App: Cechy geometrii''', lub formalnie {{incode|App::GeoFeature}}, jest klasą bazową większości obiektów wyświetlających elementy geometryczne w oknie [[3D_view/pl|widoku 3D]], ponieważ zawiera właściwość {{PropertyData|Umiejscowienie}}. |
|||
[[File:FreeCAD_core_objects.svg|800px]] |
[[File:FreeCAD_core_objects.svg|800px]] |
||
{{Caption| |
{{Caption|Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.}} |
||
= |
<span id="Usage"></span> |
||
==Użycie== |
|||
App: Cechy geometrii jest obiektem wewnętrznym, więc nie można go utworzyć z poziomu interfejsu graficznego. Zasadniczo nie jest on przeznaczony do bezpośredniego użycia, a raczej może być podklasowany, aby uzyskać obiekt typu bare-bones, który ma tylko podstawową właściwość {{PropertyData|Umiejscowienie}} do zdefiniowania jego pozycji w oknie [[3D_view/pl|Widoku 3D]]. |
|||
Niektóre z najważniejszych obiektów pochodnych są następujące: |
|||
Some of the most important derived objects are the following: |
|||
* |
* Klasa [[Part_Feature/pl|Część: Cecha]], rodzic większości obiektów o kształtach [[Part_TopoShape/pl|topologicznych]] 2D i 3D. |
||
* |
* Klasa [[Mesh_Feature/pl|Siatka: Cecha]], rodzic większości obiektów wykonanych z [[Mesh_MeshObject/pl|Siatka]], a nie brył. |
||
* |
* Klasa [[FEM_Mesh/pl|MES: FemMeshObject]], rodzic siatek elementów skończonych utworzonych za pomocą [[FEM_Workbench/pl|środowiska pracy MES]]. |
||
* Klasa [[CAM_Feature/pl|CAM: Cecha]], rodzic ścieżek utworzonych za pomocą [[CAM_Workbench/pl|środowiska pracy CAM]] do użytku w obróbce CNC. |
|||
* The [[Path_Feature|Path Feature]] class, the parent of paths created with the [[Path_Workbench|Path Workbench]] for use in CNC machining. |
|||
* |
* Klasa [[App_Part/pl|App: Część]], która definiuje [[Std_Part/pl|Std: Część]], które mogą być używane jako kontenery korpusów do wykonywania złożeń. |
||
Podczas tworzenia tego obiektu w środowisku [[Python/pl|Python]], zamiast klasy podrzędnej {{incode|App::GeoFeature}}, należy utworzyć klasę podrzędną {{incode|App::GeometryPython}}, ponieważ ta ostatnia zawiera domyślnego dostawcę widoku oraz atrybuty {{incode|Proxy}} dla samego obiektu i jego dostawcy widoku. Zobacz także sekcję [[App_GeoFeature/pl#Tworzenie_skryptów|tworzenie skryptów]]. |
|||
<span id="Properties_App_GeoFeature"></span> |
|||
== |
==Właściwości App GeoFeature== |
||
Zobacz stronę [[Property/pl|Właściwości]] dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami. |
|||
See [[Property|Property]] for all property types that scripted objects can have. |
|||
App: Cechy geometrii ''(klasa{{incode|App::GeoFeature}})'' jest pochodną podstawowego obiektu [[App_DocumentObject/pl|App DocumentObject]] ''(klasa {{incode|App::DocumentObject}})'' i dziedziczy wszystkie jego właściwości. Dodatkowo posiada właściwość {{PropertyData|Umiejscowienie}}, która kontroluje jego pozycję w oknie [[3D_view/pl|Widoku 3D]]. |
|||
<span id="Properties_App_GeometryPython"></span> |
|||
== |
==Właściwości App GeometryPython== |
||
Zobacz stronę [[Property/pl|Właściwości]] dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami. |
|||
See [[Property|Property]] for all property types that scripted objects can have. |
|||
Obiekt '''App: Cechy geometrii Python''' ''(klasa {{incode|App::GeometryPython}})'' jest pochodną podstawowego obiektu [[App_GeoFeature/pl|App: Cechy geometrii]] ''(klasa {{incode|App::GeoFeature}})'' i dziedziczy wszystkie jego właściwości. Posiada również kilka dodatkowych właściwości. |
|||
Są to właściwości dostępne w [[Property_editor/pl|edytorze właściwości]]. Ukryte właściwości można wyświetlić za pomocą polecenia {{MenuCommand|Wyświetl wszystko}} w menu kontekstowym [[Property_editor/pl|edytora właściwości]]. |
|||
<span id="Data"></span> |
|||
=== |
===Dane=== |
||
{{TitleProperty| |
{{TitleProperty|Podstawa}} |
||
* {{PropertyData|Proxy|PythonObject| |
* {{PropertyData|Proxy|PythonObject|Ukryte}}: niestandardowa klasa powiązana z tym obiektem. |
||
* {{PropertyData| |
* {{PropertyData|Umiejscowienie|Placement}}: pozycja obiektu w [[3D_view/pl|widoku 3D]]. Umiejscowienie jest definiowane przez punkt {{incode|Bazowy}} ''(wektor)'' i {{incode|Obrót}} ''(oś i kąt)''. Zobacz informacje na stronie [[Placement/pl|Umiejscowienie]]. |
||
** {{PropertyData| |
** {{PropertyData|Kąt}}: kąt obrotu wokół {{PropertyData|Osi}}. Domyślnie jest to {{value|0°}} ''(zero stopni)''. |
||
** {{PropertyData| |
** {{PropertyData|Oś}}: wektor jednostkowy definiujący oś obrotu dla umiejscowienia. Każdy element jest wartością zmiennoprzecinkową pomiędzy {{value|0}} i {{value|1}}. Jeśli jakakolwiek wartość znajduje się powyżej {{value|1}}, wektor jest normalizowany tak, aby jego wielkość wynosiła {{value|1}}. Domyślnie jest to dodatnia oś Z, {{value|(0, 0, 1)}}. |
||
** {{PropertyData| |
** {{PropertyData|Pozycja}}: wektor ze współrzędnymi 3D punktu bazowego. Domyślnie jest to punkt odniesienia połażenia {{value|(0, 0, 0)}}. |
||
* {{PropertyData| |
* {{PropertyData|Etykieta|String}}: edytowalna przez użytkownika nazwa tego obiektu, jest to dowolny ciąg UTF8. |
||
* {{PropertyData| |
* {{PropertyData|Etykieta2|String|Ukryte}}: dłuższy, edytowalny przez użytkownika opis tego obiektu, jest to dowolny ciąg UTF8, który może zawierać nowe linie. Domyślnie jest to pusty ciąg {{value|""}}. |
||
* {{PropertyData| |
* {{PropertyData|SilnikWyrażeń|Ukryte}}: lista wyrażeń. Domyślnie jest pusta {{value|[]}}. |
||
* {{PropertyData| |
* {{PropertyData|Widoczność|Bool|Ukryte}}: określa czy obiekt ma być wyświetlany czy nie. |
||
<span id="View"></span> |
|||
=== |
===Widok=== |
||
{{TitleProperty| |
{{TitleProperty|Baza}} |
||
* {{PropertyView|Proxy|PythonObject| |
* {{PropertyView|Proxy|PythonObject|Ukryte}}: niestandardowa klasa [[Viewprovider/pl|dostawcy widoku]] powiązana z tym obiektem. |
||
{{TitleProperty| |
{{TitleProperty|Opcje wyświetlania}}. |
||
* {{PropertyView| |
* {{PropertyView|Ramka otaczająca|Bool}}: jeśli ma wartość {{TRUE/pl}}, obiekt wyświetli obwiednię w oknie [[3D_view/pl|widoku 3D]]. |
||
* {{PropertyView| |
* {{PropertyView|Tryb wyświetlania|Enumeration}}: zobacz informacje w [[App_FeaturePython/pl|App: Właściwości Python]]. |
||
* {{PropertyView| |
* {{PropertyView|Pokaż w drzewie|Bool}}: zobacz informacje w [[App_FeaturePython/pl|App: Właściwości Python]]. |
||
* {{PropertyView| |
* {{PropertyView|Widoczność|Bool}}: zobacz informacje w [[App_FeaturePython/pl|App: Właściwości Python]]. |
||
{{TitleProperty| |
{{TitleProperty|Styl obiektu}} |
||
* {{PropertyView| |
* {{PropertyView|Kolor kształtu|Color}}: krotka trzech zmiennoprzecinkowych wartości RGB {{value|(r,g,b)}} do definiowania koloru ścian w [[3D_view/pl|widoku 3D]]. Domyślnie jest to {{value|(0. 8, 0.8, 0.8)}}, co jest wyświetlane jako {{value|[204, 204, 204]}} na podstawie 255, a <span style="background-color:#ccc; width:3em; height:12pt; padding: 2px 1em 2px;"> jasnoszary </span>. |
||
* {{PropertyView| |
* {{PropertyView|Materiał kształtu|Material|ukryte}}: powiązany z tym obiektem [[App_Material/pl|Materiał]]. Domyślnie włąściwość jest pusta. |
||
* {{PropertyView| |
* {{PropertyView|Przeźroczystość|Percent}}: wartość całkowita od {{value|0}} do {{value|100}}, która określa poziom przeźroczystości ścian w [[3D_view|widoku 3D]]. Wartość {{value|100}} oznacza całkowicie niewidoczne ściany, ściany są niewidoczne, ale nadal można je wybrać, o ile właściwość {{PropertyView|Wybieralny}} ma wartość {{TRUE/pl}}. |
||
{{TitleProperty| |
{{TitleProperty|Wybór}} |
||
* {{PropertyView| |
* {{PropertyView|Na górze po wybraniu|Enumeration}}: zobacz informacje na stronie [[App_FeaturePython/pl|App: Właściwości Python]]. |
||
* {{PropertyView| |
* {{PropertyView|Wybieralny|Bool}}: jeśli ma wartość {{TRUE/pl}}, obiekt może zostać wybrany za pomocą kursora w oknie [[3D_view/pl|widoku 3D]]. W przeciwnym razie obiekt nie może zostać wybrany, dopóki ta właściwość nie zostanie ustawiona na {{TRUE/pl}}. |
||
* {{PropertyView| |
* {{PropertyView|Styl wyboru|Enumeration}}: zobacz informacje na ten temat zawarte na stronie [[App_FeaturePython/pl|App: Właściwości Python]]. |
||
= |
<span id="Scripting"></span> |
||
==Tworzenie skryptów== |
|||
{{Emphasis| |
{{Emphasis|Zobacz również:}} [[FreeCAD_Scripting_Basics/pl|Podstawy tworzenia skryptów FreeCAD]], oraz [[Scripted_objects/pl|Obiekty skryptowe]]. |
||
Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie [[Part_Feature/pl|Część: właściwość]]. |
|||
See [[Part_Feature|Part Feature]] for the general information on adding objects to the document. |
|||
Obiekt Cechy geometrii jest tworzony za pomocą metody {{incode|addObject()}} dokumentu. Jeśli chcesz utworzyć obiekt o kształcie 2D lub 3D [[Part_TopoShape/pl|kształt topologiczny]], lepszym rozwiązaniem może być utworzenie jednej z klas podrzędnych wyspecjalizowanych do obsługi kształtów, na przykład [[Part_Feature/pl|Część: Cecha]] lub [[Part_Part2DObject/pl|Część: Część na obiekt 2D]]. |
|||
{{Code|code= |
{{Code|code= |
||
Line 90: | Line 97: | ||
}} |
}} |
||
Dlatego też, dla klasy podrzędnej [[Python/pl|Python]], powinieneś stworzyć obiekt {{incode|App::GeometryPython}}. |
|||
{{Code|code= |
{{Code|code= |
Latest revision as of 07:12, 19 April 2024
Wprowadzenie
Obiekt App: Cechy geometrii, lub formalnie App::GeoFeature
, jest klasą bazową większości obiektów wyświetlających elementy geometryczne w oknie widoku 3D, ponieważ zawiera właściwość DANEUmiejscowienie.
Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.
Użycie
App: Cechy geometrii jest obiektem wewnętrznym, więc nie można go utworzyć z poziomu interfejsu graficznego. Zasadniczo nie jest on przeznaczony do bezpośredniego użycia, a raczej może być podklasowany, aby uzyskać obiekt typu bare-bones, który ma tylko podstawową właściwość DANEUmiejscowienie do zdefiniowania jego pozycji w oknie Widoku 3D.
Niektóre z najważniejszych obiektów pochodnych są następujące:
- Klasa Część: Cecha, rodzic większości obiektów o kształtach topologicznych 2D i 3D.
- Klasa Siatka: Cecha, rodzic większości obiektów wykonanych z Siatka, a nie brył.
- Klasa MES: FemMeshObject, rodzic siatek elementów skończonych utworzonych za pomocą środowiska pracy MES.
- Klasa CAM: Cecha, rodzic ścieżek utworzonych za pomocą środowiska pracy CAM do użytku w obróbce CNC.
- Klasa App: Część, która definiuje Std: Część, które mogą być używane jako kontenery korpusów do wykonywania złożeń.
Podczas tworzenia tego obiektu w środowisku Python, zamiast klasy podrzędnej App::GeoFeature
, należy utworzyć klasę podrzędną App::GeometryPython
, ponieważ ta ostatnia zawiera domyślnego dostawcę widoku oraz atrybuty Proxy
dla samego obiektu i jego dostawcy widoku. Zobacz także sekcję tworzenie skryptów.
Właściwości App GeoFeature
Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.
App: Cechy geometrii (klasaApp::GeoFeature
) jest pochodną podstawowego obiektu App DocumentObject (klasa App::DocumentObject
) i dziedziczy wszystkie jego właściwości. Dodatkowo posiada właściwość DANEUmiejscowienie, która kontroluje jego pozycję w oknie Widoku 3D.
Właściwości App GeometryPython
Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.
Obiekt App: Cechy geometrii Python (klasa App::GeometryPython
) jest pochodną podstawowego obiektu App: Cechy geometrii (klasa App::GeoFeature
) i dziedziczy wszystkie jego właściwości. Posiada również kilka dodatkowych właściwości.
Są to właściwości dostępne w edytorze właściwości. Ukryte właściwości można wyświetlić za pomocą polecenia Wyświetl wszystko w menu kontekstowym edytora właściwości.
Dane
Podstawa
- DANE (Ukryte)Proxy (
PythonObject
): niestandardowa klasa powiązana z tym obiektem. - DANEUmiejscowienie (
Placement
): pozycja obiektu w widoku 3D. Umiejscowienie jest definiowane przez punktBazowy
(wektor) iObrót
(oś i kąt). Zobacz informacje na stronie Umiejscowienie.- DANEKąt: kąt obrotu wokół DANEOsi. Domyślnie jest to
0°
(zero stopni). - DANEOś: wektor jednostkowy definiujący oś obrotu dla umiejscowienia. Każdy element jest wartością zmiennoprzecinkową pomiędzy
0
i1
. Jeśli jakakolwiek wartość znajduje się powyżej1
, wektor jest normalizowany tak, aby jego wielkość wynosiła1
. Domyślnie jest to dodatnia oś Z,(0, 0, 1)
. - DANEPozycja: wektor ze współrzędnymi 3D punktu bazowego. Domyślnie jest to punkt odniesienia połażenia
(0, 0, 0)
.
- DANEKąt: kąt obrotu wokół DANEOsi. Domyślnie jest to
- DANEEtykieta (
String
): edytowalna przez użytkownika nazwa tego obiektu, jest to dowolny ciąg UTF8. - DANE (Ukryte)Etykieta2 (
String
): dłuższy, edytowalny przez użytkownika opis tego obiektu, jest to dowolny ciąg UTF8, który może zawierać nowe linie. Domyślnie jest to pusty ciąg""
. - DANESilnikWyrażeń (
Ukryte
): lista wyrażeń. Domyślnie jest pusta[]
. - DANE (Ukryte)Widoczność (
Bool
): określa czy obiekt ma być wyświetlany czy nie.
Widok
Baza
- WIDOK (Ukryte)Proxy (
PythonObject
): niestandardowa klasa dostawcy widoku powiązana z tym obiektem.
Opcje wyświetlania.
- WIDOKRamka otaczająca (
Bool
): jeśli ma wartośćPRAWDA
, obiekt wyświetli obwiednię w oknie widoku 3D. - WIDOKTryb wyświetlania (
Enumeration
): zobacz informacje w App: Właściwości Python. - WIDOKPokaż w drzewie (
Bool
): zobacz informacje w App: Właściwości Python. - WIDOKWidoczność (
Bool
): zobacz informacje w App: Właściwości Python.
Styl obiektu
- WIDOKKolor kształtu (
Color
): krotka trzech zmiennoprzecinkowych wartości RGB(r,g,b)
do definiowania koloru ścian w widoku 3D. Domyślnie jest to(0. 8, 0.8, 0.8)
, co jest wyświetlane jako[204, 204, 204]
na podstawie 255, a jasnoszary . - WIDOK (ukryte)Materiał kształtu (
Material
): powiązany z tym obiektem Materiał. Domyślnie włąściwość jest pusta. - WIDOKPrzeźroczystość (
Percent
): wartość całkowita od0
do100
, która określa poziom przeźroczystości ścian w widoku 3D. Wartość100
oznacza całkowicie niewidoczne ściany, ściany są niewidoczne, ale nadal można je wybrać, o ile właściwość WIDOKWybieralny ma wartośćPRAWDA
.
Wybór
- WIDOKNa górze po wybraniu (
Enumeration
): zobacz informacje na stronie App: Właściwości Python. - WIDOKWybieralny (
Bool
): jeśli ma wartośćPRAWDA
, obiekt może zostać wybrany za pomocą kursora w oknie widoku 3D. W przeciwnym razie obiekt nie może zostać wybrany, dopóki ta właściwość nie zostanie ustawiona naPRAWDA
. - WIDOKStyl wyboru (
Enumeration
): zobacz informacje na ten temat zawarte na stronie App: Właściwości Python.
Tworzenie skryptów
Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.
Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie Część: właściwość.
Obiekt Cechy geometrii jest tworzony za pomocą metody addObject()
dokumentu. Jeśli chcesz utworzyć obiekt o kształcie 2D lub 3D kształt topologiczny, lepszym rozwiązaniem może być utworzenie jednej z klas podrzędnych wyspecjalizowanych do obsługi kształtów, na przykład Część: Cecha lub Część: Część na obiekt 2D.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeoFeature", "Name")
obj.Label = "Custom label"
Dlatego też, dla klasy podrzędnej Python, powinieneś stworzyć obiekt App::GeometryPython
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeometryPython", "Name")
obj.Label = "Custom label"
- Rdzenne: App: Obiekt dokumentu
- Podstawowe: : Właściwości Python, App: Cechy geometrii, Część: Cecha, Siatka: Cecha, MES: Siatka
- Kształty wewnętrzne: Część: Kształt topologiczny, Siatka: Obiekt siatki, MES: Siatka
- Struktura: App: Obiekt grupy dokumentu (Std: Grupa), App: Część (Std: Część), App: Link
- Pochodne: Część: Part2DObject, Szkicownik: Obiekt szkicu, Projekt części: Zawartość, Projekt części: Cecha
- Jak zacząć
- Instalacja: Pobieranie programu, Windows, Linux, Mac, Dodatkowych komponentów, Docker, AppImage, Ubuntu Snap
- Podstawy: Informacje na temat FreeCAD, Interfejs użytkownika, Profil nawigacji myszką, Metody wyboru, Nazwa obiektu, Edytor ustawień, Środowiska pracy, Struktura dokumentu, Właściwości, Pomóż w rozwoju FreeCAD, Dotacje
- Pomoc: Poradniki, Wideo poradniki
- Środowiska pracy: Strona Startowa, Architektura, Assembly, CAM, Rysunek Roboczy, MES, Inspekcja, Siatka, OpenSCAD, Część, Projekt Części, Punkty, Inżynieria Wsteczna, Robot, Szkicownik, Arkusz Kalkulacyjny, Powierzchnia 3D, Rysunek Techniczny, Test Framework