Siatka: Cecha

From FreeCAD Documentation
Revision as of 09:53, 18 December 2022 by Kaktus (talk | contribs)
Other languages:

Wprowadzenie

Obiekt Cecha siatki, lub formalnie Mesh::Feature, jest prostym elementem z powiązanym obiektem siatki, który może być wyświetlany w oknie widoku 3D.

Cecha siatki jest podobna koncepcyjnie do cechy Część: Cecha. Pierwsza jest obiektem bazowym dla elementów z informacją o "siatce", podczas gdy druga jest obiektem bazowym dla elementów z informacją o "kształcie geometrycznym".

Proszę zauważyć, że środowisko pracy MES również używa siatek, ale używa innego obiektu, zwanego MES: Siatka (klasa Fem::FemMeshObject). Obiekt ten nie jest pochodną cechy Siatka i ma inne właściwości.

Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.

Użycie

Prawie wszystkie obiekty siatkowe tworzone poleceniami dostępnymi w środowisku pracy Siatkacechami siatki. Wyjątek stanowią parametryczne obiekty siatkowe tworzone poleceniem Utwórz bryłę pierwotną. Obiekt cecha siatki można również utworzyć z poziomu konsoli Python, jak opisano w sekcji tworzenie skryptów.

Klasa Mesh::Feature jest zdefiniowana w środowisku pracy Siatka, ale może być użyta jako klasa bazowa dla obiektów tworzonych skryptami we wszystkich środowiskach pracy, które wytwarzają płaskie i przestrzenne siatki.

Obiekt Mesh::Feature posiada proste właściwości, takie jak umiejscowienie, oraz właściwości wizualne określające wygląd jego krawędzi i ścian.

Własności

Zapoznaj się z treścią na stronie Właściwości aby poznać wszystkie typy właściwości, które mogą mieć obiekty tworzone skryptami.

Klasa Siatka: Cecha (Mesh::Feature) wywodzi się z podstawowej Cechy geometrii (App::GeoFeature) i dziedziczy wszystkie jej właściwości. Posiada również kilka dodatkowych właściwości. Przede wszystkim właściwość DANESiatka, która przechowuje jej obiekt siatki. Jest to geometria, która jest wyświetlana w oknie widoku 3D.

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

Podstawowe

  • DANE (Hidden)Proxy (PythonObject): a custom class associated with this object. This only exists for the Python version. See Scripting.
  • DANEMesh (MeshKernel): a Mesh MeshObject class associated with this object. It lists the number of Points, Edges, and Faces of the mesh.
  • DANEPlacement (Placement): the position of the object in the 3D view. The placement is defined by a Base point (vector), and a Rotation (axis and angle). See Placement.
    • DANEAngle: the angle of rotation around the DANEAxis. By default, it is (zero degrees).
    • DANEAxis: the unit vector that defines the axis of rotation for the placement. Each component is a floating point value between 0 and 1. If any value is above 1, the vector is normalized so that the magnitude of the vector is 1. By default, it is the positive Z axis, (0, 0, 1).
    • DANEPosition: a vector with the 3D coordinates of the base point. By default, it is the origin (0, 0, 0).
  • DANELabel (String): the user editable name of this object, it is an arbitrary UTF8 string.
  • DANE (Hidden)Label2 (String): 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 "".
  • DANE (Hidden)Expression Engine (ExpressionEngine): a list of expressions. By default, it is empty [].
  • DANE (Hidden)Visibility (Bool): whether to display the object or not.

Widok

Podstawowe

Opcje wyświetlania

  • WIDOKBounding Box (Bool): if it is true, the object will show the bounding box in the 3D view.
  • WIDOKDisplay Mode (Enumeration): Shaded (no edges), Wireframe (no faces), Flat Lines (regular visualization), Points (only vertices).
  • WIDOKShow In Tree (Bool): if it is true, the object appears in the Tree view. Otherwise, it is set as invisible.
  • WIDOKVisibility (Bool): if it is true, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the Space bar.

Object Style

  • WIDOK (Hidden)Coloring (Bool): it defaults to false.
  • WIDOKCrease Angle (FloatConstraint):
  • WIDOKLighting (Enumeration): One side (default), Two side; the illumination comes from two sides or one side in the 3D view.
  • WIDOKLine Color (Color): a tuple of three floating point RGB values (r,g,b) to define the color of the edges in the 3D view; by default it is (0.0, 0.0, 0.0), which is displayed as [0,0,0] on base 255, completely black .
  • WIDOKLine Transparency (Percent): an integer from 0 to 100 (a percentage) that determines the level of transparency of the edges in the 3D view. A value of 100 indicates completely invisible edges; the edges are invisible but they can still be picked as long as WIDOKSelectable is true.
  • WIDOKLine Width (FloatConstraint): a float that determines the width in pixels of the edges in the 3D view. It defaults to 1.0.
  • WIDOKOpen Edges (Bool): it defaults to false.
  • WIDOKPoint Size (FloatConstraint): similar to WIDOKLine Width, defines the size of the vertices.
  • WIDOKShape Color (Color): similar to WIDOKLine Color, defines the color of the faces. It defaults to (0.8, 0.8, 0.8), which is displayed as [204,204,204] on base 255, a light gray.
  • WIDOK (Hidden)Shape Material (Material): an App Material associated with this object. By default it is empty.
  • WIDOKTransparency (Percent): an integer from 0 to 100 (a percentage) that determines the level of transparency of the faces in the 3D view. A value of 100 indicates completely invisible faces; the faces are invisible but they can still be picked as long as WIDOKSelectable is true.

Wybieranie

  • WIDOKOn Top When Selected (Enumeration): Disabled (default), Enabled, Object, Element.
  • WIDOKSelectable (Bool): if it is true, the object can be picked with the pointer in the 3D view. Otherwise, the object cannot be selected until this option is set to true.
  • WIDOKSelection Style (Enumeration): Shape (default), BoundBox. If the option is Shape, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it is BoundBox only the bounding box will be highlighted.

Tworzenie skryptów

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

Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć w Część: właściwość.

Cecha siatki jest tworzona za pomocą metody dokumentu addObject().

import FreeCAD as App

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

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

import FreeCAD as App

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