App: Cechy geometrii

From FreeCAD Documentation
This page is a translated version of the page App GeoFeature and the translation is 100% complete.

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"