Sketcher SketchObject/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "Szkicownik: Obiekt szkicu")
 
(Created page with "* {{PropertyView|Środowisko edycji|String}}: nazwa środowiska roboczego, które ma zostać uaktywnione podczas edycji szkicu. Wartością domyślną jest {{value|SketcherWor...")
 
(31 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduction ==
==Wprowadzenie==


[[File:Sketcher_Sketch.svg|32px]]
[[File:Sketcher_Sketch.svg|32px]]


A [[Sketcher_SketchObject|Sketcher SketchObject]], or formally a {{incode|Sketcher::SketchObject}}, is the base element to create 2D objects with the [[Sketcher_Workbench|Sketcher Workbench]].
Obiekt [[Sketcher_SketchObject/pl|SketchObject]], lub formalnie {{incode|Sketcher::SketchObject}}, jest podstawowym elementem do tworzenia obiektów 2D za pomocą środowiska pracy [[Sketcher_Workbench/pl|Szkicownik]].


The {{incode|Sketcher::SketchObject}} is derived from [[Part_Part2DObject|Part Part2DObject]], which means it is a [[Part Feature|Part Feature]] object specialized for 2D geometry. Like Part2DObject, the SketchObject can be attached to planes and faces. In addition, the SketchObject can handle geometrical constraints of the lines and curves that are drawn within it.
Obiekt {{incode|Sketcher::SketchObject}} wywodzi się z obiektu [[Part_Part2DObject/pl|Part2DObject]], co oznacza, że jest to obiekt [[Part Feature/pl|Cecha]] wyspecjalizowany dla geometrii 2D. Podobnie jak obiekt Part2DObject, obiekt SketchObject może być dołączany do płaszczyzn i powierzchni. Ponadto obiekt SketchObject może obsługiwać wiązania geometryczne.


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]


{{Caption|Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.}}
{{Caption|Simplified diagram of the relationships between the core objects in FreeCAD. The {{incode|Sketcher::SketchObject}} class is specialized for 2D shapes, and additionally it includes an extension to handle geometrical constraints of its elements.}}


==Usage==
==Użycie==


# Switch to the [[Sketcher Workbench|Sketcher Workbench]].
# Przejdź do środowiska pracy [[Sketcher Workbench/pl|Szkicownik]].
# Press {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch|Sketcher NewSketch]]}}.
# Naciśnij przycisk {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch/pl|Utwórz szkic]]}}.
# Select a {{MenuCommand|Sketch orientation}}: XY-plane, XZ-plane, or YZ-plane. Optionally also choose {{MenuCommand|Reverse direction}}, and give an {{MenuCommand|Offset}} value.
# Wybierz {{MenuCommand|orientację szkicu}} jako: Płaszczyzna XY, Płaszczyzna XZ lub Płaszczyzna YZ. Opcjonalnie wybierz także opcję {{MenuCommand|Odwróć kierunek}} i podaj wartość {{MenuCommand|Odsunięcia}}.
# Press {{Button|OK}}.
# Naciśnij przycisk {{Button|OK}}.


Chociaż obiekt SketchObject może być używany samodzielnie do rysowania na płaszczyźnie, jest on najczęściej używany w połączeniu ze środowiskiem [[PartDesign_Workbench/pl|Projekt Części]] do tworzenia brył wyciąganych.
Although the SketchObject can be used by itself to draw on a plane, it is most commonly used in conjunction with the [[PartDesign Workbench|PartDesign Workbench]] to create extruded solids.


# Przejdź do środowiska [[PartDesign_Workbench|Projekt Części]].
# Switch to the [[PartDesign Workbench|PartDesign Workbench]].
# Press {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|PartDesign Body]]}}.
# Naciśnij przycisk {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|Zawartość]]}}.
# Press {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch|PartDesign NewSketch]]}}.
# Naciśnij przycisk {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch/pl|Utwórz szkic]]}}.
# {{MenuCommand|Select feature}}: XY_Plane (Base plane), XZ_Plane (Base plane), or YZ_Plane (Base plane).
# {{MenuCommand|Wybierz cechę}}: Płaszczyzna_XY ''(płaszczyzna bazowa)'', Płaszczyzna_XZ ''(płaszczyzna bazowa)'' lub Płaszczyzna_YZ ''(płaszczyzna bazowa)''.
# Press {{Button|OK}}.
# Naciśnij przycisk {{Button|OK}}.


== Properties ==
==Właściwości==


Zobacz stronę [[Property/pl|Właściwości]] dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.
See [[Property|Property]] for all property types that scripted objects can have.


A [[Sketcher_SketchObject|Sketcher SketchObject]] ({{incode|Sketcher::SketchObject}} class) is derived from a [[Part_Part2DObject|Part Part2DObject]] ({{incode|Part::Part2DObject}} class), therefore it shares all the latter's properties.
Obiekt [[Sketcher_SketchObject/pl|SketchObject]] ''(klasa {{incode|Sketcher::SketchObject}})'' wywodzi się z obiektu [[Part_Part2DObject/pl|Part2DObject]] ''(klasa {{incode|Part::Part2DObject}})'' i dziedziczy wszystkie jego właściwości.


Obiekt SketchObject ma także następujące dodatkowe właściwości w obszarze [[Property_editor/pl|edytora właściwości]]. Ukryte właściwości można pokazać za pomocą polecenia {{MenuCommand|Wyświetl wszystko}} w menu kontekstowym okna [[Property_editor/pl|edycji właściwości]].
In addition to the properties described in [[Part_Part2DObject|Part Part2DObject]], the basic Sketcher SketchObject has the following properties in the [[property editor|property editor]]. Hidden properties can be shown by using the {{MenuCommand|Show all}} command in the context menu of the [[property editor|property editor]].


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


{{TitleProperty|Attachment}}
{{TitleProperty|Szkic}}
* {{PropertyData|Map Mode}}, {{PropertyData|Map Reversed}}, {{PropertyData|Attachment Offset}}: same as [[Part_Part2DObject|Part Part2DObject]]. See [[Part Attachment|Part Attachment]] for more information on all attachment mapping modes.


* {{PropertyData|Geometria|GeometryList|ukryty}}: lista geometrii części istniejących wewnątrz szkicu.
{{TitleProperty|Sketch}}
* {{PropertyData|Constraints|}}: named constraints, if they exist; otherwise it is an empty list {{incode|[]}}.
* {{PropertyData|Wiązania|}}: nazwane wiązania, jeśli istnieją. W przeciwnym razie jest to pusta lista {{incode|[]}}.
* {{PropertyData|Geometria zewnętrzna|LinkSubList}}: lista geometrii części spoza tego szkicu, które są używane jako odniesienie.
* {{PropertyData|W pełni związany|Bool|ukryty}}: ''(tylko do odczytu)'' jeśli parametr przyjmuje wartość {{TRUE/pl}} szkic jest w pełni związany.


===Widok===
==== Hidden properties Data ====


{{TitleProperty|Wiązania automatyczne}}
See [[Part_Part2DObject|Part Part2DObject]] for the rest of the hidden properties.


* {{PropertyView|Wiązania automatyczne|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} to podczas rysowania geometrii automatycznie dodawane są wiązania.
{{TitleProperty|Base}}
* {{PropertyView|Unikaj wiązań nadmiarowych|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} unika się zbędnych automatycznych wiązań.


{{TitleProperty|Siatka}}
* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Sketcher_SketchObject#Scripting|Scripting]].


* {{PropertyView|Automatyczny rozmiar siatki|Bool|ukryty}}: jeśli parametr ma wartość {{TRUE/pl}} rozmiar siatki jest zmieniany na podstawie ramki otaczającej geometrii szkicu.
{{TitleProperty|Sketch}}
* {{PropertyView|Rozmiar siatki|Length}}: wielkość odstępu między liniami siatki lokalnej w oknie [[3D_view/pl|widoku 3D]]. Wartość domyślna to {{value|10 mm}}.
* {{PropertyView|Przyciąganie do siatki|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} siatkę można wykorzystać do przyciągania punktów.
* {{PropertyView|Styl siatki|Enumeration}}: styl linii siatki {{value|Przerywana}} ''(domyślnie)'' lub {{value|Cienka}}.
* {{PropertyView|Pokaż siatkę|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} w oknie [[3D_view/pl|widoku 3D]] zostanie wyświetlona siatka lokalna obiektu. Siatka ta jest niezależna od [[Draft_ToggleGrid/pl|siatki projektu]].
* {{PropertyView|Pokaż tylko w trybie edycji|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} siatka jest wyświetlana tylko podczas edycji szkicu.
* {{PropertyView|Ciasna siatka|Bool}}: jeśli parametr ma wartość {{TRUE}} lokalna siatka zostanie umieszczona wokół punktu położenia odniesienia kształtu, w przeciwnym razie będzie bardziej rozciągnięta.
* {{PropertyView|maksymalna liczba linii|Integer}}: maksymalna liczba wierszy w siatce.


{{TitleProperty|Widoczność automatyczna}}
* {{PropertyData|Geometry|GeometryList}}: a list of Part geometries that exist inside the sketch.
* {{PropertyData|External Geometry|LinkSubList}}: a list of Part geometries outside this Sketch that are used for reference.


* {{PropertyView|Środowisko edycji|String}}: nazwa środowiska roboczego, które ma zostać uaktywnione podczas edycji szkicu. Wartością domyślną jest {{value|SketcherWorkbench}}.
=== View ===
* {{PropertyView|Wymuś Ortho|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} po otwarciu szkicu ujęcie widoku zostanie ustawione w trybie [[Std_OrthographicCamera/pl|ortogonicznym]].
* {{PropertyView|Ukryj zależne|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} wszystkie obiekty zależne od szkicu są ukrywane po otwarciu szkicu.
* {{PropertyView|Restore Camera|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} pozycja ujęcia widoku jest zapisywana przed otwarciem szkicu i przywracana po jego zamknięciu.
* {{PropertyView|Widok Przekroju|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} podczas edycji szkicu widoczne są tylko obiekty ''(ich części)'' znajdujące się za płaszczyzną szkicu.
* {{PropertyView|Wyświetl odnośniki|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} wszystkie obiekty używane w łączach do geometrii zewnętrznej są wyświetlane po otwarciu szkicu.
* {{PropertyView|Wyświetl podparcie|Bool}}: jeśli parametr ma wartość {{TRUE/pl}} po otwarciu szkicu są wyświetlane wszystkie obiekty, do których jest dołączony ten szkic.
* {{PropertyView|Tempo Vis|PythonObject|ukryty}}: klasa niestandardowa powiązana z tym obiektem, która obsługuje ukrywanie i pokazywanie innych obiektów podczas otwierania i zamykania szkicu.


==Tworzenie skryptów==
{{TitleProperty|Auto Constraints}}
* {{PropertyView|Autoconstraints|Bool}}: if {{TRUE}} it will try setting constraints when the geometry is drawn.


{{Emphasis|Zobacz również:}} [[FreeCAD_Scripting_Basics/pl|Podstawy tworzenia skryptów FreeCAD]], oraz [[Scripted_objects/pl|Obiekty skryptowe]].
{{TitleProperty|Visibility automation}}
* {{PropertyView|Editing Workbench|String}}: name of the workbench to activate when editing the sketch; it defaults to {{value|SketcherWorkbench}}.
* {{PropertyView|Hide Dependent|Bool}}: if {{TRUE}} all objects that depend on the sketch are hidden when opening the sketch.
* {{PropertyView|Restore Camera|Bool}}: if {{TRUE}} the camera position is saved before opening the sketch, and is restored after closing it.
* {{PropertyView|Show Links|Bool}}: if {{TRUE}} all objects used in links to external geometry are shown when opening the sketch.
* {{PropertyView|Show Support|Bool}}: if {{TRUE}} all objects this sketch is attached to are shown when opening the sketch.


Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie [[Part_Feature/pl|Część: właściwość]].
==== Hidden properties View ====


Obiekt ''SketchObject'' jest tworzony za pomocą metody dokumentu {{incode|addObject()}}.
{{TitleProperty|Base}}


* {{PropertyView|Proxy|PythonObject}}: a custom view provider class associated with this object. This only exists for the [[Python|Python]] version. See [[Sketcher_SketchObject#Scripting|Scripting]].

{{TitleProperty|Visibility automation}}

* {{PropertyView|Tempo Vis|PythonObject}}: a custom class associated with this object, that handles hiding and showing other objects when opening and closing the sketch.

All other view properties, including hidden properties, are those of the base [[Part_Feature|Part Feature]] object.

== Scripting ==

{{Emphasis|See also:}} [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]], and [[scripted objects|scripted objects]].

See [[Part_Feature|Part Feature]] for the general information on adding objects to the document.

A SketchObject is created with the {{incode|addObject()}} method of the document.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
Line 96: Line 91:
}}
}}


Dlatego też, dla klasy podrzędnej [[Python/pl|Python]], powinieneś stworzyć obiekt {{incode|Sketcher::SketchObjectPython}}.
This basic {{incode|Sketcher::SketchObject}} doesn't have a Proxy object so it can't be fully used for sub-classing.

Therefore, for [[Python|Python]] subclassing, you should create the {{incode|Sketcher::SketchObjectPython}} object.


{{Code|code=
{{Code|code=
Line 109: Line 102:




{{Sketcher Tools navi{{#translation:}}}}
{{Sketcher_Tools_navi{{#translation:}}}}
{{Document_objects_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Document objects navi{{#translation:}}}}
{{clear}}

Latest revision as of 07:17, 2 June 2022

Wprowadzenie

Obiekt SketchObject, lub formalnie Sketcher::SketchObject, jest podstawowym elementem do tworzenia obiektów 2D za pomocą środowiska pracy Szkicownik.

Obiekt Sketcher::SketchObject wywodzi się z obiektu Part2DObject, co oznacza, że jest to obiekt Cecha wyspecjalizowany dla geometrii 2D. Podobnie jak obiekt Part2DObject, obiekt SketchObject może być dołączany do płaszczyzn i powierzchni. Ponadto obiekt SketchObject może obsługiwać wiązania geometryczne.

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

Użycie

  1. Przejdź do środowiska pracy Szkicownik.
  2. Naciśnij przycisk Utwórz szkic.
  3. Wybierz orientację szkicu jako: Płaszczyzna XY, Płaszczyzna XZ lub Płaszczyzna YZ. Opcjonalnie wybierz także opcję Odwróć kierunek i podaj wartość Odsunięcia.
  4. Naciśnij przycisk OK.

Chociaż obiekt SketchObject może być używany samodzielnie do rysowania na płaszczyźnie, jest on najczęściej używany w połączeniu ze środowiskiem Projekt Części do tworzenia brył wyciąganych.

  1. Przejdź do środowiska Projekt Części.
  2. Naciśnij przycisk Zawartość.
  3. Naciśnij przycisk Utwórz szkic.
  4. Wybierz cechę: Płaszczyzna_XY (płaszczyzna bazowa), Płaszczyzna_XZ (płaszczyzna bazowa) lub Płaszczyzna_YZ (płaszczyzna bazowa).
  5. Naciśnij przycisk OK.

Właściwości

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

Obiekt SketchObject (klasa Sketcher::SketchObject) wywodzi się z obiektu Part2DObject (klasa Part::Part2DObject) i dziedziczy wszystkie jego właściwości.

Obiekt SketchObject ma także następujące dodatkowe właściwości w obszarze edytora 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

Szkic

  • DANE (ukryty)Geometria (GeometryList): lista geometrii części istniejących wewnątrz szkicu.
  • DANEWiązania: nazwane wiązania, jeśli istnieją. W przeciwnym razie jest to pusta lista [].
  • DANEGeometria zewnętrzna (LinkSubList): lista geometrii części spoza tego szkicu, które są używane jako odniesienie.
  • DANE (ukryty)W pełni związany (Bool): (tylko do odczytu) jeśli parametr przyjmuje wartość PRAWDA szkic jest w pełni związany.

Widok

Wiązania automatyczne

  • WIDOKWiązania automatyczne (Bool): jeśli parametr ma wartość PRAWDA to podczas rysowania geometrii automatycznie dodawane są wiązania.
  • WIDOKUnikaj wiązań nadmiarowych (Bool): jeśli parametr ma wartość PRAWDA unika się zbędnych automatycznych wiązań.

Siatka

  • WIDOK (ukryty)Automatyczny rozmiar siatki (Bool): jeśli parametr ma wartość PRAWDA rozmiar siatki jest zmieniany na podstawie ramki otaczającej geometrii szkicu.
  • WIDOKRozmiar siatki (Length): wielkość odstępu między liniami siatki lokalnej w oknie widoku 3D. Wartość domyślna to 10 mm.
  • WIDOKPrzyciąganie do siatki (Bool): jeśli parametr ma wartość PRAWDA siatkę można wykorzystać do przyciągania punktów.
  • WIDOKStyl siatki (Enumeration): styl linii siatki Przerywana (domyślnie) lub Cienka.
  • WIDOKPokaż siatkę (Bool): jeśli parametr ma wartość PRAWDA w oknie widoku 3D zostanie wyświetlona siatka lokalna obiektu. Siatka ta jest niezależna od siatki projektu.
  • WIDOKPokaż tylko w trybie edycji (Bool): jeśli parametr ma wartość PRAWDA siatka jest wyświetlana tylko podczas edycji szkicu.
  • WIDOKCiasna siatka (Bool): jeśli parametr ma wartość true lokalna siatka zostanie umieszczona wokół punktu położenia odniesienia kształtu, w przeciwnym razie będzie bardziej rozciągnięta.
  • WIDOKmaksymalna liczba linii (Integer): maksymalna liczba wierszy w siatce.

Widoczność automatyczna

  • WIDOKŚrodowisko edycji (String): nazwa środowiska roboczego, które ma zostać uaktywnione podczas edycji szkicu. Wartością domyślną jest SketcherWorkbench.
  • WIDOKWymuś Ortho (Bool): jeśli parametr ma wartość PRAWDA po otwarciu szkicu ujęcie widoku zostanie ustawione w trybie ortogonicznym.
  • WIDOKUkryj zależne (Bool): jeśli parametr ma wartość PRAWDA wszystkie obiekty zależne od szkicu są ukrywane po otwarciu szkicu.
  • WIDOKRestore Camera (Bool): jeśli parametr ma wartość PRAWDA pozycja ujęcia widoku jest zapisywana przed otwarciem szkicu i przywracana po jego zamknięciu.
  • WIDOKWidok Przekroju (Bool): jeśli parametr ma wartość PRAWDA podczas edycji szkicu widoczne są tylko obiekty (ich części) znajdujące się za płaszczyzną szkicu.
  • WIDOKWyświetl odnośniki (Bool): jeśli parametr ma wartość PRAWDA wszystkie obiekty używane w łączach do geometrii zewnętrznej są wyświetlane po otwarciu szkicu.
  • WIDOKWyświetl podparcie (Bool): jeśli parametr ma wartość PRAWDA po otwarciu szkicu są wyświetlane wszystkie obiekty, do których jest dołączony ten szkic.
  • WIDOK (ukryty)Tempo Vis (PythonObject): klasa niestandardowa powiązana z tym obiektem, która obsługuje ukrywanie i pokazywanie innych obiektów podczas otwierania i zamykania szkicu.

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 SketchObject jest tworzony za pomocą metody dokumentu addObject().

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObject", "Sketch")
obj.Label = "Custom label"

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

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObjectPython", "CustomSketch")
obj.Label = "Custom label"