App GeoFeature/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "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 Widoku 3D.")
No edit summary
 
(19 intermediate revisions by 2 users not shown)
Line 18: Line 18:
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]].
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:
* The [[Part_Feature|Part Feature]] class, the parent of most objects with 2D and 3D [[Part_TopoShape|topological shapes]].
* Klasa [[Part_Feature/pl|Część: Cecha]], rodzic większości obiektów o kształtach [[Part_TopoShape/pl|topologicznych]] 2D i 3D.
* The [[Mesh_Feature|Mesh Feature]] class, the parent of most objects made from [[Mesh_MeshObject|meshes]], not solids.
* Klasa [[Mesh_Feature/pl|Siatka: Cecha]], rodzic większości obiektów wykonanych z [[Mesh_MeshObject/pl|Siatka]], a nie brył.
* The [[FEM_Mesh|Fem FemMeshObject]] class, the parent of finite element meshes created with the [[FEM_Workbench|FEM Workbench]].
* 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.
* The [[App_Part|App Part]] class, which defines [[Std_Part|Std Parts]] that can be used as containers of bodies to perform assemblies.
* 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ń.


When creating this object in [[Python|Python]], instead of sub-classing {{incode|App::GeoFeature}}, you should sub-class {{incode|App::GeometryPython}} because the latter includes a default view provider, and {{incode|Proxy}} attributes for the object itself, and its view provider. See [[App_GeoFeature#Scripting|Scripting]].
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>
== Properties App GeoFeature ==
==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.


The [[App_GeoFeature|App GeoFeature]] ({{incode|App::GeoFeature}} class) is derived from the basic [[App_DocumentObject|App DocumentObject]] ({{incode|App::DocumentObject}} class) and inherits all its properties. In addition it has a {{PropertyData|Placement}} property, which controls its position in the [[3D_view|3D view]].
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>
== Properties App GeometryPython ==
==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.


The [[App_GeoFeature|App GeometryPython]] ({{incode|App::GeometryPython}} class) is derived from the basic [[App_GeoFeature|App GeoFeature]] ({{incode|App::GeoFeature}} class) and inherits all its properties. It also has several additional properties.
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.


These are the properties available in the [[Property_editor|property editor]]. Hidden properties can be shown by using the {{MenuCommand|Show all}} command in the context menu of the [[Property_editor|property editor]].
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>
=== Data ===
===Dane===


{{TitleProperty|Base}}
{{TitleProperty|Podstawa}}


* {{PropertyData|Proxy|PythonObject|Hidden}}: a custom class associated with this object.
* {{PropertyData|Proxy|PythonObject|Ukryte}}: niestandardowa klasa powiązana z tym obiektem.
* {{PropertyData|Placement|Placement}}: the position of the object in the [[3D_view|3D view]]. The placement is defined by a {{incode|Base}} point (vector), and a {{incode|Rotation}} (axis and angle). See [[Placement|Placement]].
* {{PropertyData|Umiejscowienie|Placement}}: pozycja obiektu w [[3D_view/pl|widoku 3D]]. Umiejscowienie jest definiowane przez punkt {{incode|Bazowy}} ''(wektor)'' i {{incode|Obrót}} ''( i kąt)''. Zobacz informacje na stronie [[Placement/pl|Umiejscowienie]].
** {{PropertyData|Angle}}: the angle of rotation around the {{PropertyData|Axis}}. By default, it is {{value|0°}} (zero degrees).
** {{PropertyData|Kąt}}: kąt obrotu wokół {{PropertyData|Osi}}. Domyślnie jest to {{value|0°}} ''(zero stopni)''.
** {{PropertyData|Axis}}: the unit vector that defines the axis of rotation for the placement. Each component is a floating point value between {{value|0}} and {{value|1}}. If any value is above {{value|1}}, the vector is normalized so that the magnitude of the vector is {{value|1}}. By default, it is the positive Z axis, {{value|(0, 0, 1)}}.
** {{PropertyData|}}: wektor jednostkowy definiujący 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 Z, {{value|(0, 0, 1)}}.
** {{PropertyData|Position}}: a vector with the 3D coordinates of the base point. By default, it is the origin {{value|(0, 0, 0)}}.
** {{PropertyData|Pozycja}}: wektor ze współrzędnymi 3D punktu bazowego. Domyślnie jest to punkt odniesienia połażenia {{value|(0, 0, 0)}}.
* {{PropertyData|Label|String}}: the user editable name of this object, it is an arbitrary UTF8 string.
* {{PropertyData|Etykieta|String}}: edytowalna przez użytkownika nazwa tego obiektu, jest to dowolny ciąg UTF8.
* {{PropertyData|Label2|String|Hidden}}: a longer, user editable description of this object, it is an arbitrary UTF8 string that may include newlines. By default, it is an empty string {{value|""}}.
* {{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|Expression Engine|ExpressionEngine|Hidden}}: a list of expressions. By default, it is empty {{value|[]}}.
* {{PropertyData|SilnikWyrażeń|Ukryte}}: lista wyrażeń. Domyślnie jest pusta {{value|[]}}.
* {{PropertyData|Visibility|Bool|Hidden}}: whether to display the object or not.
* {{PropertyData|Widoczność|Bool|Ukryte}}: określa czy obiekt ma być wyświetlany czy nie.


<span id="View"></span>
=== View ===
===Widok===


{{TitleProperty|Base}}
{{TitleProperty|Baza}}
* {{PropertyView|Proxy|PythonObject|Hidden}}: a custom [[Viewprovider|viewprovider]] class associated with this object.
* {{PropertyView|Proxy|PythonObject|Ukryte}}: niestandardowa klasa [[Viewprovider/pl|dostawcy widoku]] powiązana z tym obiektem.


{{TitleProperty|Display Options}}
{{TitleProperty|Opcje wyświetlania}}.
* {{PropertyView|Bounding Box|Bool}}: if it is {{TRUE}}, the object will show the bounding box in the [[3D_view|3D view]].
* {{PropertyView|Ramka otaczająca|Bool}}: jeśli ma wartość {{TRUE/pl}}, obiekt wyświetli obwiednię w oknie [[3D_view/pl|widoku 3D]].
* {{PropertyView|Display Mode|Enumeration}}: see the information in [[App_FeaturePython|App FeaturePython]].
* {{PropertyView|Tryb wyświetlania|Enumeration}}: zobacz informacje w [[App_FeaturePython/pl|App: Właściwości Python]].
* {{PropertyView|Show In Tree|Bool}}: see the information in [[App_FeaturePython|App FeaturePython]].
* {{PropertyView|Pokaż w drzewie|Bool}}: zobacz informacje w [[App_FeaturePython/pl|App: Właściwości Python]].
* {{PropertyView|Visibility|Bool}}: see the information in [[App_FeaturePython|App FeaturePython]].
* {{PropertyView|Widoczność|Bool}}: zobacz informacje w [[App_FeaturePython/pl|App: Właściwości Python]].


{{TitleProperty|Object Style}}
{{TitleProperty|Styl obiektu}}
* {{PropertyView|Shape Color|Color}}: a tuple of three floating point RGB values {{value|(r,g,b)}} to define the color of the faces in the [[3D_view|3D view]]; by default it is {{value|(0.8, 0.8, 0.8)}}, which is displayed as {{value|[204, 204, 204]}} on base 255, a <span style="background-color:#ccc; width:3em; height:12pt; padding: 2px 1em 2px;"> light gray </span>.
* {{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|Shape Material|Material|Hidden}}: an [[App_Material|App Material]] associated with this object. By default it is empty.
* {{PropertyView|Materiał kształtu|Material|ukryte}}: powiązany z tym obiektem [[App_Material/pl|Materiał]]. Domyślnie włąściwość jest pusta.
* {{PropertyView|Transparency|Percent}}: an integer from {{value|0}} to {{value|100}} that determines the level of transparency of the faces in the [[3D_view|3D view]]. A value of {{value|100}} indicates completely invisible faces; the faces are invisible but they can still be picked as long as {{PropertyView|Selectable}} is {{TRUE}}.
* {{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 niewidoczne, ale nadal można je wybrać, o ile właściwość {{PropertyView|Wybieralny}} ma wartość {{TRUE/pl}}.


{{TitleProperty|Selection}}
{{TitleProperty|Wybór}}
* {{PropertyView|On Top When Selected|Enumeration}}: see the information in [[App_FeaturePython|App FeaturePython]].
* {{PropertyView|Na górze po wybraniu|Enumeration}}: zobacz informacje na stronie [[App_FeaturePython/pl|App: Właściwości Python]].
* {{PropertyView|Selectable|Bool}}: if it is {{TRUE}}, the object can be picked with the pointer in the [[3D_view|3D view]]. Otherwise, the object cannot be selected until this option is set to {{TRUE}}.
* {{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|Selection Style|Enumeration}}: see the information in [[App_FeaturePython|App FeaturePython]].
* {{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>
<span id="Scripting"></span>

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:

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 punkt Bazowy (wektor) i Obrót (oś i kąt). Zobacz informacje na stronie Umiejscowienie.
    • DANEKąt: kąt obrotu wokół DANEOsi. Domyślnie jest to (zero stopni).
    • DANE: wektor jednostkowy definiujący oś obrotu dla umiejscowienia. Każdy element jest wartością zmiennoprzecinkową pomiędzy 0 i 1. Jeśli jakakolwiek wartość znajduje się powyżej 1, wektor jest normalizowany tak, aby jego wielkość wynosiła 1. 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).
  • 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.

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 od 0 do 100, 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 na PRAWDA.
  • 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"