Part Feature/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Emphasis|Zobacz również:}} Nazwa obiektu, aby uzyskać więcej informacji na temat właściwości Nazwy.")
(Created page with "Funkcja {{incode|addObject}} posiada dwa podstawowe argumenty typu string.")
Line 139: Line 139:
{{Emphasis|Zobacz również:}} [[Object_name/pl|Nazwa obiektu]], aby uzyskać więcej informacji na temat właściwości Nazwy.
{{Emphasis|Zobacz również:}} [[Object_name/pl|Nazwa obiektu]], aby uzyskać więcej informacji na temat właściwości Nazwy.


The {{incode|addObject}} function has two basic string arguments.
Funkcja {{incode|addObject}} posiada dwa podstawowe argumenty typu string.


* The first argument indicates the type of object, in this case, {{incode|"Part::FeaturePython"}}.
* The first argument indicates the type of object, in this case, {{incode|"Part::FeaturePython"}}.

Revision as of 18:34, 3 May 2021

Wprowadzenie

Obiekt Cecha Części, lub formalnie Part::Feature, jest prostym elementem z powiązanym z nim kształtem topologicznym, który może być wyświetlany w oknie widoku 3D.

Cecha części jest klasą nadrzędną dla większości obiektów 2D (Rysunek roboczy, Szkicownik) i 3D (Część, Projekt części), z wyjątkiem siatek, które są zwykle oparte na cechach siatek, lub obiektach FemMesh dla obiektów MES.

Każdy obiekt stworzony za pomocą środowiska Część jest w istocie cechą części.

Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie. Klasa Part::Feature jest źródłem większości obiektów 2D (Rysunek roboczy, Szkicownik) i 3D (Część, Projekt części), które posiadają kształt topologiczny.

Użycie

Obiekt cecha części jest obiektem wewnętrznym, więc nie można go utworzyć z poziomu interfejsu graficznego, tylko z poziomu konsoli Python jak opisano w sekcji tworzenie skryptów.

Klasa Part::Feature jest zdefiniowana w środowisku Część ale może być użyta jako klasa bazowa dla obiektów tworzonych skryptami we wszystkich środowiskach pracy które produkują kształty geometryczne 2D i 3D. Zasadniczo wszystkie obiekty produkowane w środowisku pracy Część są instancjami Part::Feature. Obiekty bryłowe importowane z plików STEP lub BREP będą importowane przy użyciu środowiska Część, więc będą również importowane jako elementy Part::Feature, aczkolwiek bez historii parametrycznej.

Part::Feature jest również klasą nadrzędną zawartości Projektu części, cechy Projektu części, oraz Part2DObject, która jest wyspecjalizowana dla kształtów 2D (planarnych).

Element Part::Feature posiada proste właściwości jak umiejscowienie, oraz właściwości wizualne określające wygląd jego wierzchołków, krawędzi i ścian. Środowisko pracy może dodać więcej właściwości do tego podstawowego elementu, aby stworzyć obiekt o złożonym wyglądzie.

Własności

Cecha części (klasa Part::Feature) wywodzi się z podstawowej App: GeoFeature (klasa App::GeoFeature), dlatego dzieli wszystkie właściwości tej ostatniej.

Oprócz właściwości opisanych w App: GeoFeature, Cecha części posiada właściwość DANEKształt, która przechowuje kształt topologiczny części tego obiektu. Jest to geometria, która jest wyświetlana w oknie widoku 3D.

Inne właściwości, które posiada ten obiekt, to te związane z wyglądem jego kształtu topologicznego, w tym WIDOKOdchylenie kątowe, WIDOKOdchylenie, WIDOKStyl rysowania, WIDOKOświetlenie, WIDOKKolor linii, WIDOKSzerokość linii, WIDOKKolor wierzchołka, WIDOKRozmiar wierzchołka, a także właściwości ukryte WIDOKKolor rozproszony, WIDOKTablica kolorów linii, WIDOKMateriał linii, WIDOKTablica kolorów wierzchołków i WIDOKMateriał punktu.

Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.

Są to właściwości dostępne w edytorze właściwości|. Ukryte właściwości można pokazać za pomocą polecenia Wyświetl wszystko w menu kontekstowym okna edycji właściwości.

Dane

Podstawowe

  • DANEUmieszczenie (Placement): pozycja obiektu w oknie widoku 3D. Umieszczenie jest określone przez punkt Base (wektor) i Rotation (oś i kąt). Zobacz stronę Umiejscowienie.
    • DANEKąt: kąt obrotu wokół osi DANE. Domyślnie jest to (zero stopni).
    • DANE: wektor jednostkowy określający oś obrotu dla położenia. Każda składowa jest wartością zmiennoprzecinkową pomiędzy 0 a 1. Jeśli jakakolwiek wartość jest 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 zawierający współrzędne 3D punktu bazowego. Domyślnie jest to początek (0, 0, 0).
  • DANEEtykieta (String): nazwa obiektu edytowalna przez użytkownika, jest to dowolny ciąg znaków w kodowaniu UTF8.

Ukryte Dane właściwości

  • DANE (hidden)Pośrednik (PythonObject): klasa własna związana z tym obiektem. Istnieje wyłącznie dla wersji środowiska Python. Zobacz sekcję tworzenie skryptów.
  • DANE (hidden)Kształt (PartShape): klasa kształt topologiczny części związana z tym obiektem.
  • DANE (hidden)Etykieta2 (String): dłuższy, edytowalny przez użytkownika opis tego obiektu, jest to dowolny łańcuch UTF8, który może zawierać znaki nowej linii. Domyślnie jest to pusty łańcuch "".
  • DANE (hidden)Mechanizm wyrażeń (ExpressionEngine): lista wyrażeń. Domyślnie jest ona pusta [].
  • DANE (hidden)Widoczność (Bool): decyduje o tym, czy obiekt ma być wyświetlany, czy nie.

Widok

Większość obiektów we FreeCAD ma coś, co nazywa się „dostawca widoku”, jest to klasa definiująca wygląd obiektu w oknie widoku 3D oraz w drzewie widoku. Domyślny dostawca widoku obiektów elementu części definiuje właściwości prezentowane poniżej. Obiekty skryptowe, które pochodzą z elementu cecha części, również będą miały dostęp do tych właściwości.

Podstawowe

Opcje wyświetlania

  • WIDOKRamka otaczająca (Bool): jeśli wartość to true, obiekt wyświetli ramkę ograniczającą w widoku 3D.
  • WIDOKTryb wyświetlania (Enumeration): Linie główne (regularna wizualizacja), Zacieniony (bez krawędzi), Model krawędziowy (bez ścian), Punkty (tylko wierzchołki).
  • WIDOKPokaż na drzewie (Bool): wartość domyślna to true, w którym to przypadku obiekt pojawi się w widoku widoku drzewa. W przeciwnym razie obiekt zostanie ukryty w widoku drzewa. Gdy obiekt w drzewie jest niewidoczny, można go ponownie wyświetlić, otwierając menu kontekstowe nad nazwą dokumentu (prawy przycisk myszy) i wybrać Pokaż ukryte elementy. Następnie można wybrać ukryty element i wartość WIDOKPokaż na drzewie przełączyć z powrotem na true.
  • WIDOKWidoczność (Bool): jeśli ma wartość true, obiekt pojawia się w widoku 3D. W przeciwnym razie jest niewidoczny. Standardowo właściwość ta może być przełączana przez naciśnięcie klawisza Spacja na klawiaturze.

Wygląd obiektu

  • WIDOKOdchylenie kątowe (Angle): jest to towarzysz WIDOKOdchylenia. Jest to kolejny sposób na określenie, jak precyzyjnie wygenerować siatkę do renderowania na ekranie lub podczas eksportu. Domyślną wartością jest 28.5 stopni, lub 0.5 radiana. Jest to wartość maksymalna, im mniejsza wartość tym gładszy będzie wygląd w widoku 3D, i tym drobniejsza będzie siatka, która zostanie wyeksportowana.
  • WIDOKOdchylenie (FloatConstraint): jest to towarzysz WIDOKOdchylenia kątowego. Jest to kolejny sposób na określenie, jak drobna ma być generowana siatka do renderowania na ekranie lub podczas eksportu. Domyślną wartością jest 0.5%. Jest to wartość maksymalna, im mniejsza wartość tym gładszy będzie wygląd w widoku 3D i tym drobniejsza będzie siatka, która zostanie wyeksportowana.
  • WIDOK (hidden)Kolor rozproszenia (ColorList): jest to lista krotek RGB definiujących kolory, podobna do WIDOKKolor kształtu. Domyślnie jest to lista zawierająca jeden ciąg [(0,8, 0,8, 0,8)].

Odchylenie jest wartością w procentach, która jest związana z wymiarami w milimetrach ramki otaczającej obiekt. Odchylenie w milimetrach można obliczyć w następujący sposób:

deviation_in_mm = (w + h + d)/3 * deviation/100

gdzie w, h, d są wymiarami ramki otaczającej.

  • WIDOKStyl rysowania (Enumeration): Bryła (domyślnie), Kreskowana, Kropkowana, Kropka-kreska, określa styl krawędzi w widoku 3D.
  • WIDOKOświetlenie (Enumeration): Dwie strony (domyślnie), Jedna strona; oświetlenie pochodzi z dwóch lub jednej strony w widoku 3D.
  • WIDOKKolor linii (Color): krotka trzech zmiennoprzecinkowych wartości RGB (r,g,b) do określenia koloru krawędzi w widoku widoku 3D. Domyślnie jest to (0.09, 0.09, 0.09), co jest wyświetlane jako [25,25,25] przy podstawie 255, niemal czarny .
  • WIDOK (hidden)Tablica kolorów linii (ColorList): jest to lista krotek RGB określających kolory, podobna do WIDOKKolor linii. Domyślnie jest to lista [(0.09, 0.09, 0.09)].
  • WIDOK (hidden)Materiał linii (Material): App: Materiał związany z krawędziami w tym obiekcie. Domyślnie jest on pusty.
  • WIDOKSzerokość linii (FloatConstraint): wartość typu float określająca szerokość krawędzi w pikselach w widoku 3D. Domyślnie przyjmuje wartość 2.0.
  • WIDOKKolor wierzchołka (Color): podobnie jak WIDOKKolor linii, definiuje kolor wierzchołków.
  • WIDOK (hidden)Tablica kolorów wierzchołków (ColorList): jest to lista krotek RGB określających kolory, podobna do WIDOKKolor wierzchołka. Domyślnie jest to lista [(0.09, 0.09, 0.09)].
  • WIDOK (hidden)Materiał wierzchołka (Material): Materiał powiązany z wierzchołkami w tym obiekcie. Domyślnie wartość jest pusta.
  • WIDOKRozmiar wierzchołka (FloatConstraint): podobnie jak WIDOKSzerokość linii, definiuje rozmiar wierzchołków.
  • WIDOKKolor kształtu (Color): podobnie jak WIDOKKolor linii, określa kolor powierzchni. Domyślnie jest to (0.8, 0.8, 0.8), co jest wyświetlane jako [204, 204, 204] na podstawie 255, a zatem jasny szary.
  • WIDOK (hidden)Materiał kształtu (Material): Materiał związany z tym obiektem. Domyślnie wartość jest pusta.
  • WIDOKPrzejrzystość (Percent): liczba całkowita z zakresu 0 do 100. (wartość procentowa) określająca poziom przezroczystości ścian w widoku 3D. Wartość 100 oznacza całkowicie niewidoczne ściany Ściany są niewidoczne, ale nadal można je wybierać tak długo, jak wartość WIDOKDo wyboru wynosi true.

Wybieranie

  • WIDOKNa wierzchu po zaznaczeniu (Enumeration): kontroluje sposób, w jaki zaznaczenie pojawia się w oknie widoku 3D, jeśli obiekt ma kształt i jest wiele obiektów częściowo zakrytych przez inne. Domyślna wartość to Disabled, co oznacza, że nie pojawi się żadne specjalne podświetlenie. Wartość Enabled oznacza, że obiekt pojawi się na wierzchu każdego innego obiektu, gdy zostanie wybrany, Object oznacza, że obiekt pojawi się na wierzchu tylko jeśli cały obiekt jest zaznaczony w widoku drzewa. Wartość Element oznacza, że obiekt pojawi się na wierzchu tylko jeśli element podrzędny (wierzchołek, krawędź, ściana) jest zaznaczony w widoku 3D.
  • WIDOKDo wyboru (Bool): jeśli parametr ma wartość true, obiekt może być wybrany kursorem myszki w widoku 3D. W przeciwnym razie, obiekt nie może być wybrany dopóki ta opcja nie zostanie ustawiona na true.
  • WIDOKStyl wyboru (Enumeration): kontroluje sposób podświetlania obiektu. Jeśli wybrano Kształt, cały kształt (wierzchołki, krawędzie i ściany) będzie podświetlony w widoku 3D; jeśli jest to Ramka otaczająca, pole ograniczające pojawi się wokół obiektu i zostanie podświetlone.

Wartość odchylenia

Parametry ugięcia algorytmu BRepMesh_IncrementalMesh; d < ugięcie liniowe, α < ugięcie kątowe.

Zobacz wątek na forum, Odchylenie i odchylenie kątowe.

Tworzenie skryptów

Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.

Cecha części jest tworzona za pomocą metody dokumentu addObject().

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::Feature", "Name")
obj.Label = "Custom label"

Ta podstawowa Part::Feature nie posiada obiektu Proxy, więc nie może być w pełni wykorzystana do tworzenia klas podrzędnych.

Dlatego też, dla klasy podrzędnej Python, powinieneś stworzyć obiekt Part::FeaturePython.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::FeaturePython", "Name")
obj.Label = "Custom label"

Nazwa

Zobacz również: Nazwa obiektu, aby uzyskać więcej informacji na temat właściwości Nazwy.

Funkcja addObject posiada dwa podstawowe argumenty typu string.

  • The first argument indicates the type of object, in this case, "Part::FeaturePython".
  • The second argument is a string that defines the Name attribute. If it is not provided, it defaults to the same name as the class, that is, "Part__FeaturePython". The Name can only include simple alphanumeric characters, and the underscore, [_0-9a-zA-Z]. If other symbols are given, these will be converted to underscores; for example, "A+B:C*" is converted to "A_B_C_".

Label

If desired, the Label attribute can be changed to a more meaningful text.

  • The Label can accept any UTF8 string, including accents and spaces. Since the tree view displays the Label, it is a good practice to change the Label to a more descriptive string.
  • By default the Label is unique, just like the Name. However, this behavior can be changed in the preferences editor, Edit → Preferences → General → Document → Allow duplicate object labels in one document. This means that in general the Label may be repeated in the same document; when testing for a specific element the user should rely on the Name rather than on the Label.