Property editor/pl

Wprowadzenie
Edytor property editor pojawia się, gdy aktywna jest zakładka 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).



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:

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:
 * właściwości związane z wizualnym wyglądem obiektu. Właściwości są związane z  (atrybut obiektu ) 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.
 * właściwości związane z parametrami "fizycznymi" obiektu. Właściwości 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 są uważane za bardziej realne, ponieważ naprawdę definiują geometrię kształtu. Z drugiej strony, właściwości są mniej ważne, ponieważ wpływają jedynie na wygląd powierzchni 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, a nie do Właściwości widoku.

Własności podstawowe
Najprostszy obiekt skryptowy nie pokaże żadnej właściwości w edytorze właściwości, z wyjątkiem atrybutu. jest edytowalnym łańcuchem użytkownika, który identyfikuje obiekt w widoku drzewa. Z drugiej strony, atrybut 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.



Większość obiektów geometrycznych, które mogą być tworzone i wyświetlane w widoku 3D pochodzi z. 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:
 * : 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 jest aktywna, a wybrana jest jedna właściwość, dostępnych jest więcej akcji za pomocą drugiego kliknięcia prawym przyciskiem myszy:
 * : dezaktywuje polecenie, ukrywając dodatkowe właściwości Dane i Widok.
 * dodaje dynamiczną właściwość do obiektu; działa to zarówno z obiektami zdefiniowanymi w C++ jak i Python objekty skryptowane.
 * : przywołuje edytor formuły, który umożliwia użycie wyrażenia w wartości właściwości.
 * : jeżeli opcja jest aktywna, ustawia właściwość jako ukrytą, co oznacza, że będzie wyświetlana tylko wtedy, gdy aktywna jest opcja.
 * : jeżeli opcja jest aktywna, ustawia właściwość jako wyjście.
 * : 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.
 * : 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.
 * : jeżeli opcja jest aktywna, ustawia właściwość jako przejściową.
 * jeżeli opcja jest aktywna, to obiekt zostanie oznaczony do ponownego przeliczenia.
 * jeżeli opcja jest aktywna, to obiekt jest przeliczany po przywróceniu dokumentu.

Przykładowe właściwości obiektu z PartDesign
W tej sekcji pokazujemy kilka wspólnych właściwości, które są widoczne dla PartDesign Body, oraz jedną cechę PartDesign Feature. Specyficzne właściwości obiektu można znaleźć na stronie poświęconej dokumentacji tego obiektu.

Widok
Większość z tych właściwości jest dziedziczona z obiektu podstawowego Part Feature.




 * : Wskazuje, czy ma być wyświetlana ramka pokazująca ogólną rozpiętość obiektu. Wartość False lub True (domyślnie, False).
 * : Wskazuje, czy mają być wyświetlane punkty sterowania funkcjami. Wartość False lub True (domyślnie, False).
 * : 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).
 * : Tryb wyświetlania funkcji, Linie płaskie, zacienione, Szkielet, Punkty. [[IMAGE:Vue_DisplayModePartDesign_fr_00.png|96px]]. (domyślnie, Flat lines).
 * : Oświetlenie "Z jednej strony, z dwóch stron". [[IMAGE:Vue_Lighting_fr_00.png|96px]]. (domyślnie, z dwóch stron).
 * : Nadaje kolor linii (krawędzi) (domyślnie, 25, 25, 25, 25).
 * : Podaje grubość linii (krawędzi) (wartość domyślna, 2).
 * : Nadaje kolor punktów (zakończenia elementu) (domyślnie, 25, 25, 25, 25).
 * : Podaje wielkość punktów (domyślnie 2).
 * : Umożliwia wybór funkcji. Wartość False, lub True (domyślnie, True).
 * : Nadaj kolor kształtowi (domyślnie 204, 204, 204, 204).
 * : Ustawia stopień przejrzystości obiektu od 0 do 100 (domyślnie 0).
 * : Określa widoczność funkcji (np. pasek ). Wartość False, lub True (domyślnie, True).

Dane
W tym przypadku obserwujemy właściwości PartDesign Wyciągnij przez obrót.




 * : Zdefiniowana przez użytkownika nazwa nadana obiektowi, którą można dowolnie zmieniać.


 * : Udoskonalenie procesu scalania z innymi przedmiotami.


 * : Punkt w przestrzeni, który określa, gdzie odbywa się wyciągnięcie przez obrót. Nie można go modyfikować bezpośrednio, tylko podczas edycji elementu.

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.

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.

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.

Scripting
FreeCAD Scripting Basics.

See scripted objects for the full information on adding properties to objects defined through Python.

Most properties that are visible in the property editor can be accessed from the Python console. These properties are just attributes of the class that defines the selected object. For example, if the property editor shows the property, this means that the object has the  attribute.

These attributes (properties) are added with the method of the base object. At least it is necessary to specify the type of property, and its name.

Properties follow the or  convention, meaning that each word starts with a capital letter, and there are no underscores. When the property editor displays such names, it leaves a space between each capital letter, making it easier to read.



In similar way the properties are added, not to the base object, but to its. Then, it follows that properties like, , , , , and others, can be examined and changed from the Python console.