Property editor/pl: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{docnav
{{docnav/pl
|[[Interface Customization|Interface Customization]]
|[[Interface Customization|Dostosowywanie interfejsu użytkownika do własnych potrzeb]]
|[[Workbenches|Workbenches]]
|[[Workbenches|Środowiska pracy]]
}}
}}


==Wprowadzenie==
==Wprowadzenie==


The [[property editor|property editor]] appears when the {{MenuCommand|Model}} tab of the combo view is active; it allows managing the publicly exposed properties of the objects in the document.
Edytor [[property editor|property editor]] pojawia się, gdy aktywna jest zakładka {{MenuCommand|Model}} widoku łączonego. Umożliwia zarządzanie publicznie eksponowanymi właściwościami obiektów w dokumencie.


Ogólnie rzecz biorąc, edytor właściwości jest przeznaczony do obsługi tylko jednego obiektu w tym samym czasie. Wartości wyświetlane w edytorze właściwości należą do wybranego obiektu aktywnego dokumentu. Mimo to, niektóre właściwości, takie jak kolory, mogą być ustawione dla wielu zaznaczonych obiektów. Jeśli nie ma zaznaczonych elementów, edytor właściwości będzie pusty.
Ogólnie rzecz biorąc, edytor właściwości jest przeznaczony do obsługi tylko jednego obiektu w tym samym czasie. Wartości wyświetlane w edytorze właściwości należą do wybranego obiektu aktywnego dokumentu. Mimo to, niektóre właściwości, takie jak kolory, mogą być ustawione dla wielu zaznaczonych obiektów. Jeśli nie ma zaznaczonych elementów, edytor właściwości będzie pusty.
Line 15: Line 15:
[[File:FreeCAD_Properties_empty.png]]
[[File:FreeCAD_Properties_empty.png]]


{{Caption|Empty property editor, when no object is selected.}}
{{Caption|Pusty edytor właściwości, gdy żaden obiekt nie jest zaznaczony.}}


==Typy właściwości==
==Typy właściwości==


Właściwość jest informacją taką jak numer lub ciąg znaków dołączony do dokumentu FreeCAD lub obiektu w dokumencie.
A property is a piece of information like a number or a text string that is attached to a FreeCAD document or an object in the document.


Custom [[scripted objects|scripted objects]] can use any of the property types defined in the base system. See the full list in [[Property|Property]].
Własny [[scripted objects|obiekt skryptowy]] może używać dowolnych typów właściwości zdefiniowanych w systemie bazowym. Zobacz pełną listę [[Property|Właściwości]].


Niektóre z najczęściej używanych typów właściwości to właśnie:
Some of the most commonly used property types are:
{{Code|code=
{{Code|code=
App::PropertyBool
App::PropertyBool
Line 38: Line 38:
Różne obiekty mogą mieć różne typy właściwości. Jednak wiele obiektów ma te same typy, ponieważ pochodzą one z tej samej klasy wewnętrznej. Na przykład, większość obiektów opisujących kształty geometryczne ''(linie, okręgi, prostokąty, bryły, importowane części itp.)'' ma właściwość '''Położenie''', która określa ich położenie w widoku [[3D view|3D]].
Różne obiekty mogą mieć różne typy właściwości. Jednak wiele obiektów ma te same typy, ponieważ pochodzą one z tej samej klasy wewnętrznej. Na przykład, większość obiektów opisujących kształty geometryczne ''(linie, okręgi, prostokąty, bryły, importowane części itp.)'' ma właściwość '''Położenie''', która określa ich położenie w widoku [[3D view|3D]].


==Właściwości widoku i danych==
== View and Data properties ==


Istnieją dwie klasy właściwości obiektu dostępne poprzez zakładki w edytorze właściwości:
Istnieją dwie klasy właściwości obiektu dostępne poprzez zakładki w edytorze właściwości:
*{{MenuCommand|View}} właściwości związane z '''wizualnym''' wyglądem obiektu. Właściwości {{MenuCommand|View}} są związane z {{Emphasis|ViewProvider}} (atrybut obiektu {{incode|ViewObject}}) i są dostępne tylko wtedy, gdy załadowany jest graficzny interfejs użytkownika ''(GUI)''. Nie są one dostępne przy korzystaniu z FreeCAD w trybie konsolowym lub jako biblioteka zasobów własnych.
*{{MenuCommand|View}} właściwości związane z '''wizualnym''' wyglądem obiektu. Właściwości {{MenuCommand|View}} są związane z {{Emphasis|ViewProvider}} (atrybut obiektu {{incode|ViewObject}}) i są dostępne tylko wtedy, gdy załadowany jest graficzny interfejs użytkownika ''(GUI)''. Nie są one dostępne przy korzystaniu z FreeCAD w trybie konsolowym lub jako biblioteka zasobów własnych.
*{{MenuCommand|Data}} właściwości związane z parametrami "fizycznymi" obiektu. Właściwości {{MenuCommand|Data}} definiują podstawowe właściwości obiektu. Istnieją przez cały czas, nawet gdy FreeCAD jest używany w trybie konsolowym lub jako biblioteka. Oznacza to, że jeśli załadujesz dokument w trybie konsolowym, możesz edytować promień okręgu lub długość linii, nawet jeśli nie widzisz wyniku na ekranie.


Z tego powodu właściwości {{MenuCommand|Data}} są uważane za bardziej '''realne''', ponieważ naprawdę definiują geometrię kształtu. Z drugiej strony, właściwości {{MenuCommand|View}} są mniej ważne, ponieważ wpływają jedynie na wygląd geometrii. Na przykład okrąg o promieniu 10mm różni się od okręgu o promieniu 5mm. Kolor okręgu ''(właściwość widoku)'' nie ma wpływu na jego kształt, ale promień ma ''(właściwość danych)''. W wielu przypadkach w niniejszej dokumentacji słowo '''właściwość''' jest rozumiane jako odnoszące się do '''Właściwości danych'''.
For this reason, {{MenuCommand|Data}} properties are considered to be more "real", as they truly define the geometry of a shape. On the other hand, {{MenuCommand|View}} properties are less important because they only affect the appearance of the geometry. For example, a circle of 10 mm radius is different from a circle of 5 mm radius; the color of the circle (view property) doesn't affect its shape, but the radius does (data property). In many instances in this documentation, the word "property" is understood to refer to a "Data property".


===Własności podstawowe===
=== Basic properties ===


The most basic [[scripted objects|scripted object]] won't show any {{MenuCommand|Data}} property in the property editor, except for its {{incode|Label}} attribute. The {{incode|Label}} is a user editable string that identifies the object in the [[tree view|tree view]]. On the other hand, the {{incode|Name}} attribute of an object is assigned at the moment of its creation and cannot be changed; this attribute is read-only, and is not displayed in the property editor either.
Najprostszy [[scripted objects|obiekt skryptowy]] nie pokaże żadnej właściwości {{MenuCommand|Data}} w edytorze właściwości, z wyjątkiem atrybutu {{incode|Label}}. {{incode|Label}} jest edytowalnym łańcuchem użytkownika, który identyfikuje obiekt w [[tree view|widoku drzewa]]. Z drugiej strony, atrybut {{incode|Name}} obiektu jest przypisany w momencie jego utworzenia i nie może być zmieniony. Atrybut ten jest tylko do odczytu i również nie jest wyświetlany w edytorze właściwości.


Podstawowy obiekt parametryczny jest tworzony w następujący sposób.
A basic parametric object is created as follow


{{Code|code=
{{Code|code=
Line 59: Line 60:
[[File:FreeCAD_Properties_View_basic.png|x264px]] [[File:FreeCAD_Properties_Data_basic.png|x264px]]
[[File:FreeCAD_Properties_View_basic.png|x264px]] [[File:FreeCAD_Properties_Data_basic.png|x264px]]


{{Caption|View and Data tabs of the property editor, for a basic "App::FeaturePython" scripted object.}}
{{Caption|Zakładki Widok i Dane edytora właściwości, dla podstawowego obiektu skryptowego '''App::FeaturePython'''.}}


Most geometrical objects that can be created and displayed in the [[3D view|3D view]] are derived from a [[Part Feature|{{incode|Part::Feature}}]]. See [[Part Feature|Part Feature]] for the most basic properties that these objects have.
Większość obiektów geometrycznych, które mogą być tworzone i wyświetlane w [[3D view|widoku 3D]] pochodzi z [[Part Feature|{{incode|Part::Feature}}]]. Zobacz [[Part Feature|Właściwości części]], aby dowiedzieć się, jakie podstawowe właściwości mają te obiekty.


For 2D geometry, most objects are derived from [[Part Part2DObject|{{incode|Part::Part2DObject}}]] (itself derived from [[Part Feature|{{incode|Part::Feature}}]]) which is the base of [[Sketcher Workbench|Sketches]], and most [[Draft Workbench|Draft elements]]. See [[Part Part2DObject|Part Part2DObject]] for the most basic properties that these objects have.
Dla geometrii 2D większość obiektów pochodzi z [[Part Part2DObject|{{incode|Part::Part2DObject}}]] (wywodzi się z [[Part Feature|{{incode|Part::Feature}}]]), która jest podstawą Środowiska pracy [[Sketcher Workbench|Sketches]], i większości [[Draft Workbench|Elementy Draft]]. Zobacz [[Part Part2DObject|Część2DObject]], aby zapoznać się z najbardziej podstawowymi właściwościami tych obiektów.


==Actions ==
==Działania==


Działania w zakresie widoku właściwości zostały wdrożone w wersji '''0.19'''.
Actions in the property view were implemented in 0.19.


Kliknięcie prawym przyciskiem myszy w pustym miejscu widoku lub z wybraną właściwością powoduje wyświetlenie tylko jednego polecenia:
Right clicking in an empty space of the view, or with a property selected, shows only one command:
* {{MenuCommand|Show all}}: if active, in addition to the standard properties that appear already, it shows all the hidden Data and View properties in their respective tabs.
* {{MenuCommand|Show all}}: jeśli jest aktywny, oprócz standardowych właściwości, które już się pojawiają, pokazuje wszystkie ukryte właściwości danych i widoku w odpowiednich zakładkach.
** Data: "Proxy", "Label2", "Expression Engine", and "Visibility".
** Dane: "Proxy", "Label2", "Expression Engine", oraz "Visibility".
** View: "Proxy".
** Widok: "Proxy".


When the {{MenuCommand|Show all}} option is active, and one property is selected, more actions are available with a second right click:
Gdy opcja {{MenuCommand|Show all}} jest aktywna, a wybrana jest jedna właściwość, dostępnych jest więcej akcji za pomocą drugiego kliknięcia prawym przyciskiem myszy:
* {{MenuCommand|Show all}}: deactivates the {{MenuCommand|Show all}} command, hiding the additional Data and View properties.
* {{MenuCommand|Show all}}: dezaktywuje polecenie {{MenuCommand|Show all}}, ukrywając dodatkowe właściwości Dane i Widok.
* {{MenuCommand|Add Property}}: adds a dynamic property to the object; this works with both C++ and Python [[scripted objects|scripted objects]].
*{{MenuCommand|Add Property}}: dodaje dynamiczną właściwość do obiektu; działa to zarówno z obiektami C+++ jak i Python [[scripted objects|objekty skryptowane]].
* {{MenuCommand|Expression}}: brings up the formula editor, which allows using [[Expressions|expressions]] in the property value.
* {{MenuCommand|Expression}}: przywołuje edytor formuły, który umożliwia użycie [[Expressions|wyrażenia]] w wartości właściwości.
* {{MenuCommand|Hidden}}: if active, sets the property as hidden, meaning that it will only be displayed if {{MenuCommand|Show all}} is active.
* {{MenuCommand|Hidden}}: jeżeli opcja jest aktywna, ustawia właściwość jako ukrytą, co oznacza, że będzie wyświetlana tylko wtedy, gdy aktywna jest opcja {{MenuCommand|Show all}}.
* {{MenuCommand|Output}}: if active, sets the property as output.
* {{MenuCommand|Output}}: jeżeli opcja jest aktywna, ustawia właściwość jako wyjście.
* {{MenuCommand|NoRecompute}}: if active, sets the property as not recomputed when the document is recomputed; this is useful when a property should be kept unaffected by other updates.
* {{MenuCommand|NoRecompute}}: jeżeli opcja jest aktywna, ustawia właściwość jako nieprzeliczaną, gdy dokument jest ponownie obliczany. Jest to przydatne, gdy właściwość powinna być utrzymywana bez wpływu innych aktualizacji.
* {{MenuCommand|ReadOnly}}: if active, sets the property to be read-only; it won't be editable any more until this switch is turned off.
* {{MenuCommand|ReadOnly}}: jeżeli opcja jest aktywna, ustawia właściwość jako tylko do odczytu; nie będzie już edytowalna, dopóki ten przełącznik nie zostanie wyłączony.
* {{MenuCommand|Transient}}: if active, sets the property as transient.
* {{MenuCommand|Transient}}: jeżeli opcja jest aktywna, ustawia właściwość jako przejściową.
* {{MenuCommand|Touched}}: if active, it becomes touched, and ready for recompute.
*{{MenuCommand|Touched}}: jeżeli opcja jest aktywna, to obiekt zostanie oznaczony do ponownego przeliczenia.
* {{MenuCommand|EvalOnRestore}}: if active, it is evaluated when the document is restored.
*{{MenuCommand|EvalOnRestore}}: jeżeli opcja jest aktywna, to obiekt jest przeliczany po przywróceniu dokumentu.


==Przykładowe właściwości obiektu z PartDesign==
==Przykładowe właściwości obiektu z PartDesign==


===View===
===Widok===


[[File:FreeCAD_Properties_View.png|490px|left]]
[[File:FreeCAD_Properties_View.png|490px|left]]
{{TitleProperty|Base}}
{{TitleProperty|Base}}


* {{PropertyView|Bounding Box}}: Indicates if a box showing the overall extent of the object is to be displayed. Value False, or True (Default, False).
* {{PropertyView|Bounding Box}}: Wskazuje, czy ma być wyświetlana ramka pokazująca ogólną rozpiętość obiektu. Wartość False lub True ''(domyślnie, False)''.
* {{PropertyView|Control Point}}: Indicates if the feature control points are to be displayed. Value False, or True (Default, False).
* {{PropertyView|Control Point}}: Wskazuje, czy mają być wyświetlane punkty sterowania funkcjami. Wartość False lub True ''(domyślnie, False)''.
* {{PropertyView|Deviation}}: Sets the accuracy of the polygonal representation of the model in the 3d view (tessellation). Lower values = better quality. The value is in percent of object's size (deviation in mm = (w+h+d)/3*valueInPercent/100, where w,h,d are the bounding box dimensions).
* {{PropertyView|Deviation}}: Ustawia dokładność wielobocznych reprezentacji modelu w widoku 3d (teselacja). Niższe wartości = lepsza jakość. Wartość jest wyrażona w procentach wielkości obiektu (odchylenie w mm = (w+h+d)/3*valueInPercent/100, gdzie ''w'', ''h'', ''d'' wymiarami obwiedni).
* {{PropertyView|Display Mode}}: Display mode of the feature, '''Flat lines, Shaded, Wireframe, Points''' [[IMAGE:Vue_DisplayModePartDesign_fr_00.png|96px]]. (Default, '''Flat lines''').
* {{PropertyView|Display Mode}}: Tryb wyświetlania funkcji, '''Linie płaskie, zacienione, Szkielet, Punkty'''. [[IMAGE:Vue_DisplayModePartDesign_fr_00.png|96px]]. (domyślnie, '''Flat lines''').
* {{PropertyView|Lighting}}: Lighting '''One side, Two side''' [[IMAGE:Vue_Lighting_fr_00.png|96px]]. (Default, '''Two side''').
* {{PropertyView|Lighting}}: Oświetlenie "Z jednej strony, z dwóch stron". [[IMAGE:Vue_Lighting_fr_00.png|96px]]. (domyślnie, '''z dwóch stron''').
* {{PropertyView|Line Color}}: Gives the color of the line (edges) (Default, '''25, 25, 25''').
* {{PropertyView|Line Color}}: Nadaje kolor linii ''(krawędzi)'' ''(domyślnie, '''25, 25, 25, 25''')''.
* {{PropertyView|Line Width}}: Gives the thickness of the line (edges) (Default, '''2''').
* {{PropertyView|Line Width}}: Podaje grubość linii ''(krawędzi)'' ''(wartość domyślna, '''2''')''.
* {{PropertyView|Point Color}}: Gives the color of the points (ends of the feature) (Default, '''25, 25, 25''').
* {{PropertyView|Point Color}}: Nadaje kolor punktów ''(zakończenia elementu)'' ''(domyślnie, '''25, 25, 25, 25''')''.
* {{PropertyView|Point Size}}: Gives the size of the points (Default, '''2''').
* {{PropertyView|Point Size}}: Podaje wielkość punktów ''(domyślnie '''2''')''.
* {{PropertyView|Selectable}}: Allows selection of the feature. Value False, ou True (Default, True).
* {{PropertyView|Selectable}}: Umożliwia wybór funkcji. Wartość False, lub True ''(domyślnie, True)''.
* {{PropertyView|Shape Color}}: Give the color shape (default, '''204, 204, 204''').
* {{PropertyView|Shape Color}}: Nadaj kolor kształtowi ''(domyślnie '''204, 204, 204, 204''')''.
* {{PropertyView|Transparency}}: Sets the degree of transparency in the feature of '''0''' to '''100''' (Default, '''0''').
* {{PropertyView|Transparency}}: Ustawia stopień przejrzystości obiektu od '''0''' do '''100''' ''(domyślnie '''0''')''.
* {{PropertyView|Visibility}}: Determines the visibility of the feature (like the bar {{KEY|SPACE}}). Value False, or True (Default, True).
* {{PropertyView|Visibility}}: Określa widoczność funkcji ''(np. pasek {{KEY|SPACJA}})''. Wartość False, lub True ''(domyślnie, True)''.
{{clear}}
{{clear}}


===Data===
===Dane===


[[File:FreeCAD_Properties_Data.png|490px|left]]
[[File:FreeCAD_Properties_Data.png|490px|left]]
{{TitleProperty|Base}}
{{TitleProperty|Base}}


* {{PropertyData|Placement}}:
* {{propertyData|Placement}}:
Podsumowanie danych poniżej.
Summary of the data below.
Every feature has a placement that can be controlled through the Data Properties table. It controls the placement of the part with respect to the coordinate system. NOTE: The placement properties do not affect the physical dimensions of the feature, but merely its position in space!<br>If you select the title '''Placement''' [[Image:Tache_Placement_01_fr_00.png|256px|Options Placement]], a button with {{KEY|three small points}} appears to the right. Clicking this button {{KEY| '''...'''}}, opens the '''[[Tasks_Placement|Tasks_Placement]]''' options window.
Każda funkcja ma miejsce, które może być kontrolowane przez tabelę właściwości danych. Kontroluje położenie elementów w stosunku do układu współrzędnych. UWAGA: Właściwości rozmieszczenia nie mają wpływu na fizyczne wymiary elementu, a jedynie jego położenie w przestrzeni! <br>Jeśli wybierzesz tytuł '''Pozycja''' [[Image:Tache_Placement_01_fr_00.png|256px|Options Placement]], po prawej stronie pojawi się przycisk z {{KEY|trzy małe punkty}}. Kliknięcie tego przycisku {{KEY| '''...'''}} otwiera okno opcji '''[[Tasks_Placement|Tasks_Placement]]'''.


* {{PropertyData|Angle}}:
* {{propertyData|Angle}}:
Specifies the angle to be used with the [[#Axis|axis]] property (below). An angle is set here, and the axis that the angle acts upon is set with the axis property.
Określa kąt, który ma być użyty z właściwością [[#Axis|axis]] ''(poniżej)''. Tutaj ustawiany jest kąt, a oś, na którą działa kąt, jest ustawiana z właściwością osi.
Właściwość jest obracana o określony kąt wokół zadanej osi.
The feature is rotated by the specified angle, about the specified axis.
Przykładem użycia może być sytuacja, gdy utworzyłeś element wyciągniemy przez obrót zgodnie z wymaganiami, ale potem musiałeś obrócić cały element o pewną wartość, aby umożliwić mu połączenie z innym wcześniej istniejącym elementem.
A usage example might be if you created a revolution feature as required, but then needed to rotate the whole feature by some amount, in order to allow it to line-up with another pre-existing feature.


* {{PropertyData|Axis}}:
* {{propertyData|Axis}}:
Ta właściwość określa oś/osie, wokół których ma być obracany element. Dokładna wartość obrotu pochodzi z właściwości kąta ''(powyżej)''.
This property specifies the axis/axes about which the feature is to be rotated. The exact value of rotation comes from the angle property (above).
Właściwość ta przyjmuje trzy argumenty, które są przekazywane jako liczby w polach x, y i z w narzędziu. Ustawienie wartości dla więcej niż jednej osi spowoduje obrócenie części w każdej osi o wartość kąta pomnożoną przez wartość dla osi.
This property takes three arguments, which are passed as numbers in the x, y, and z boxes in the tool. Setting a value for more than one of the axes will cause the part to be rotated in each axis, by the angle value multiplied by the value for the axis.
For example, with an angle of 15° set, specifying a value of 1.0 for x, and 2.0 for y will cause the finished part to be rotated 15° in the x-axis AND 30° in the y-axis.
Na przykład, przy ustawionym kącie 15°, określenie wartości 1,0 dla x i 2,0 dla y spowoduje obrócenie gotowej części o 15° w osi x i 30° w osi y.


* {{PropertyData|Position}}:
* {{propertyData|Position}}:
Ta właściwość określa punkt bazowy, do którego odnoszą się wszystkie wymiary. Wymaga to podania trzech argumentów, które są przekazywane jako liczby do pól x, y i z w narzędziu. Ustawienie wartości dla więcej niż jednego pola spowoduje, że część zostanie przetłumaczona przez liczbę jednostek wzdłuż odpowiedniej osi.
This property specifies the base point to which all dimensions refer. This takes three arguments, which are passed as numbers to the x, y, and z boxes in the tool. Setting a value for more than one of the boxes will cause the part to be translated by the number of units along the corresponding axis.


* {{PropertyData|Label}}:
* {{propertyData|Label}}:
Etykieta jest nazwą nadawaną obiektowi ''(cecha)'', nazwę tę można dowolnie zmieniać.
The Label is the name given to the object (feature), this name can be changed as desired.


{{docnav/pl
{{docnav/pl
|[[Interface Customization|Interface Customization]]
|[[Interface Customization|Dostosowywanie interfejsu użytkownika do własnych potrzeb]]
|[[Workbenches|Workbenches]]
|[[Workbenches|Środowiska pracy]]
}}
}}



Revision as of 20:34, 9 December 2019

Wprowadzenie

Edytor property editor pojawia się, gdy aktywna jest zakładka Model widoku łączonego. Umożliwia zarządzanie publicznie eksponowanymi właściwościami obiektów w dokumencie.

Ogólnie rzecz biorąc, edytor właściwości jest przeznaczony do obsługi tylko jednego obiektu w tym samym czasie. Wartości wyświetlane w edytorze właściwości należą do wybranego obiektu aktywnego dokumentu. Mimo to, niektóre właściwości, takie jak kolory, mogą być ustawione dla wielu zaznaczonych obiektów. Jeśli nie ma zaznaczonych elementów, edytor właściwości będzie pusty.

Nie wszystkie właściwości mogą być zawsze modyfikowane. W zależności od określonego statusu właściwości, niektóre z nich będą niewidoczne (nie wymienione) lub będą tylko do odczytu (nie edytowalne).

File:FreeCAD Properties empty.png

Pusty edytor właściwości, gdy żaden obiekt nie jest zaznaczony.

Typy właściwości

Właściwość jest informacją taką jak numer lub ciąg znaków dołączony do dokumentu FreeCAD lub obiektu w dokumencie.

Własny obiekt skryptowy może używać dowolnych typów właściwości zdefiniowanych w systemie bazowym. Zobacz pełną listę Właściwości.

Niektóre z najczęściej używanych typów właściwości to właśnie:

App::PropertyBool
App::PropertyFloat
App::PropertyAngle
App::PropertyDistance
App::PropertyInteger
App::PropertyString
App::PropertyMatrix
App::PropertyVector
App::PropertyPlacement

Różne obiekty mogą mieć różne typy właściwości. Jednak wiele obiektów ma te same typy, ponieważ pochodzą one z tej samej klasy wewnętrznej. Na przykład, większość obiektów opisujących kształty geometryczne (linie, okręgi, prostokąty, bryły, importowane części itp.) ma właściwość Położenie, która określa ich położenie w widoku 3D.

Właściwości widoku i danych

Istnieją dwie klasy właściwości obiektu dostępne poprzez zakładki w edytorze właściwości:

  • View właściwości związane z wizualnym wyglądem obiektu. Właściwości View są związane z ViewProvider (atrybut obiektu ViewObject) i są dostępne tylko wtedy, gdy załadowany jest graficzny interfejs użytkownika (GUI). Nie są one dostępne przy korzystaniu z FreeCAD w trybie konsolowym lub jako biblioteka zasobów własnych.
  • Data właściwości związane z parametrami "fizycznymi" obiektu. Właściwości Data definiują podstawowe właściwości obiektu. Istnieją przez cały czas, nawet gdy FreeCAD jest używany w trybie konsolowym lub jako biblioteka. Oznacza to, że jeśli załadujesz dokument w trybie konsolowym, możesz edytować promień okręgu lub długość linii, nawet jeśli nie widzisz wyniku na ekranie.

Z tego powodu właściwości Data są uważane za bardziej realne, ponieważ naprawdę definiują geometrię kształtu. Z drugiej strony, właściwości View są mniej ważne, ponieważ wpływają jedynie na wygląd geometrii. Na przykład okrąg o promieniu 10mm różni się od okręgu o promieniu 5mm. Kolor okręgu (właściwość widoku) nie ma wpływu na jego kształt, ale promień ma (właściwość danych). W wielu przypadkach w niniejszej dokumentacji słowo właściwość jest rozumiane jako odnoszące się do Właściwości danych.

Własności podstawowe

Najprostszy obiekt skryptowy nie pokaże żadnej właściwości Data w edytorze właściwości, z wyjątkiem atrybutu Label. Label jest edytowalnym łańcuchem użytkownika, który identyfikuje obiekt w widoku drzewa. Z drugiej strony, atrybut Name obiektu jest przypisany w momencie jego utworzenia i nie może być zmieniony. Atrybut ten jest tylko do odczytu i również nie jest wyświetlany w edytorze właściwości.

Podstawowy obiekt parametryczny jest tworzony w następujący sposób.

obj = App.ActiveDocument.addObject("App::FeaturePython")
obj.Label = "Plain_object"
print(obj.Name)

File:FreeCAD Properties View basic.png File:FreeCAD Properties Data basic.png

Zakładki Widok i Dane edytora właściwości, dla podstawowego obiektu skryptowego App::FeaturePython.

Większość obiektów geometrycznych, które mogą być tworzone i wyświetlane w widoku 3D pochodzi z Part::Feature. Zobacz Właściwości części, aby dowiedzieć się, jakie podstawowe właściwości mają te obiekty.

Dla geometrii 2D większość obiektów pochodzi z Part::Part2DObject (wywodzi się z Part::Feature), która jest podstawą Środowiska pracy Sketches, i większości Elementy Draft. Zobacz Część2DObject, aby zapoznać się z najbardziej podstawowymi właściwościami tych obiektów.

Działania

Działania w zakresie widoku właściwości zostały wdrożone w wersji 0.19.

Kliknięcie prawym przyciskiem myszy w pustym miejscu widoku lub z wybraną właściwością powoduje wyświetlenie tylko jednego polecenia:

  • Show all: jeśli jest aktywny, oprócz standardowych właściwości, które już się pojawiają, pokazuje wszystkie ukryte właściwości danych i widoku w odpowiednich zakładkach.
    • Dane: "Proxy", "Label2", "Expression Engine", oraz "Visibility".
    • Widok: "Proxy".

Gdy opcja Show all jest aktywna, a wybrana jest jedna właściwość, dostępnych jest więcej akcji za pomocą drugiego kliknięcia prawym przyciskiem myszy:

  • Show all: dezaktywuje polecenie Show all, ukrywając dodatkowe właściwości Dane i Widok.
  • Add Property: dodaje dynamiczną właściwość do obiektu; działa to zarówno z obiektami C+++ jak i Python objekty skryptowane.
  • Expression: przywołuje edytor formuły, który umożliwia użycie wyrażenia w wartości właściwości.
  • Hidden: jeżeli opcja jest aktywna, ustawia właściwość jako ukrytą, co oznacza, że będzie wyświetlana tylko wtedy, gdy aktywna jest opcja Show all.
  • Output: jeżeli opcja jest aktywna, ustawia właściwość jako wyjście.
  • NoRecompute: jeżeli opcja jest aktywna, ustawia właściwość jako nieprzeliczaną, gdy dokument jest ponownie obliczany. Jest to przydatne, gdy właściwość powinna być utrzymywana bez wpływu innych aktualizacji.
  • ReadOnly: jeżeli opcja jest aktywna, ustawia właściwość jako tylko do odczytu; nie będzie już edytowalna, dopóki ten przełącznik nie zostanie wyłączony.
  • Transient: jeżeli opcja jest aktywna, ustawia właściwość jako przejściową.
  • Touched: jeżeli opcja jest aktywna, to obiekt zostanie oznaczony do ponownego przeliczenia.
  • EvalOnRestore: jeżeli opcja jest aktywna, to obiekt jest przeliczany po przywróceniu dokumentu.

Przykładowe właściwości obiektu z PartDesign

Widok

Base

  • WIDOKBounding Box: Wskazuje, czy ma być wyświetlana ramka pokazująca ogólną rozpiętość obiektu. Wartość False lub True (domyślnie, False).
  • WIDOKControl Point: Wskazuje, czy mają być wyświetlane punkty sterowania funkcjami. Wartość False lub True (domyślnie, False).
  • WIDOKDeviation: Ustawia dokładność wielobocznych reprezentacji modelu w widoku 3d (teselacja). Niższe wartości = lepsza jakość. Wartość jest wyrażona w procentach wielkości obiektu (odchylenie w mm = (w+h+d)/3*valueInPercent/100, gdzie w, h, d są wymiarami obwiedni).
  • WIDOKDisplay Mode: Tryb wyświetlania funkcji, Linie płaskie, zacienione, Szkielet, Punkty. . (domyślnie, Flat lines).
  • WIDOKLighting: Oświetlenie "Z jednej strony, z dwóch stron". . (domyślnie, z dwóch stron).
  • WIDOKLine Color: Nadaje kolor linii (krawędzi) (domyślnie, 25, 25, 25, 25).
  • WIDOKLine Width: Podaje grubość linii (krawędzi) (wartość domyślna, 2).
  • WIDOKPoint Color: Nadaje kolor punktów (zakończenia elementu) (domyślnie, 25, 25, 25, 25).
  • WIDOKPoint Size: Podaje wielkość punktów (domyślnie 2).
  • WIDOKSelectable: Umożliwia wybór funkcji. Wartość False, lub True (domyślnie, True).
  • WIDOKShape Color: Nadaj kolor kształtowi (domyślnie 204, 204, 204, 204).
  • WIDOKTransparency: Ustawia stopień przejrzystości obiektu od 0 do 100 (domyślnie 0).
  • WIDOKVisibility: Określa widoczność funkcji (np. pasek SPACJA). Wartość False, lub True (domyślnie, True).

Dane

Base

  • DANEPlacement:

Podsumowanie danych poniżej. Każda funkcja ma miejsce, które może być kontrolowane przez tabelę właściwości danych. Kontroluje położenie elementów w stosunku do układu współrzędnych. UWAGA: Właściwości rozmieszczenia nie mają wpływu na fizyczne wymiary elementu, a jedynie jego położenie w przestrzeni!
Jeśli wybierzesz tytuł Pozycja Options Placement, po prawej stronie pojawi się przycisk z trzy małe punkty. Kliknięcie tego przycisku ... otwiera okno opcji Tasks_Placement.

  • DANEAngle:

Określa kąt, który ma być użyty z właściwością axis (poniżej). Tutaj ustawiany jest kąt, a oś, na którą działa kąt, jest ustawiana z właściwością osi. Właściwość jest obracana o określony kąt wokół zadanej osi. Przykładem użycia może być sytuacja, gdy utworzyłeś element wyciągniemy przez obrót zgodnie z wymaganiami, ale potem musiałeś obrócić cały element o pewną wartość, aby umożliwić mu połączenie z innym wcześniej istniejącym elementem.

  • DANEAxis:

Ta właściwość określa oś/osie, wokół których ma być obracany element. Dokładna wartość obrotu pochodzi z właściwości kąta (powyżej). Właściwość ta przyjmuje trzy argumenty, które są przekazywane jako liczby w polach x, y i z w narzędziu. Ustawienie wartości dla więcej niż jednej osi spowoduje obrócenie części w każdej osi o wartość kąta pomnożoną przez wartość dla osi. Na przykład, przy ustawionym kącie 15°, określenie wartości 1,0 dla x i 2,0 dla y spowoduje obrócenie gotowej części o 15° w osi x i 30° w osi y.

  • DANEPosition:

Ta właściwość określa punkt bazowy, do którego odnoszą się wszystkie wymiary. Wymaga to podania trzech argumentów, które są przekazywane jako liczby do pól x, y i z w narzędziu. Ustawienie wartości dla więcej niż jednego pola spowoduje, że część zostanie przetłumaczona przez liczbę jednostek wzdłuż odpowiedniej osi.

  • DANELabel:

Etykieta jest nazwą nadawaną obiektowi (cecha), nazwę tę można dowolnie zmieniać.


Template:Interface