Part Point: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:10-->
{{Docnav
|[[Part_Ellipse|Ellipse]]
|[[Part_Line|Line]]
|[[Part_Workbench|Part]]
|IconL=Part_Ellipse.svg
|IconR=Part_Line.svg
|IconC=Workbench_Part.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=Part Point|MenuLocation=Part → [[Part_CreatePrimitives|Create Primitives]] → Point|Workbenches=[[Part Module|Part]]|SeeAlso=}}
|Name=Part Point
|MenuLocation=Part → [[Part_Primitives|Create primitives]] → Point
|Workbenches=[[Part_Workbench|Part]], [[OpenSCAD_Workbench|OpenSCAD]]
|SeeAlso=[[Part_Primitives|Part Primitives]]
}}

== Description == <!--T:12-->

<!--T:2-->
A [[Image:Part_Point.svg|24px]] '''Part Point''' is a parametric point that can be created with the [[Image:Part_Primitives.svg|24px]] [[Part_Primitives|Part Primitives]] command. Its coordinates are relative to the coordinate system defined by its {{PropertyData|Placement}} property.

==Usage== <!--T:9-->

<!--T:13-->
See [[Part_Primitives#Usage|Part Primitives]].

== Properties == <!--T:14-->

<!--T:15-->
See also: [[Property_editor|Property editor]].

<!--T:16-->
A Part Point object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:

=== Data === <!--T:17-->

<!--T:18-->
{{TitleProperty|Attachment}}

<!--T:19-->
The object has the same attachment properties as a [[Part_Part2DObject#Data|Part Part2DObject]].

<!--T:20-->
{{TitleProperty|Base}}

<!--T:21-->
* {{PropertyData|X|Distance}}: The X coordinate of the point. The default is {{Value|0mm}}.
* {{PropertyData|Y|Distance}}: The Y coordinate of the point. The default is {{Value|0mm}}.
* {{PropertyData|Z|Distance}}: The Z coordinate of the point. The default is {{Value|0mm}}.

== Scripting == <!--T:22-->

<!--T:23-->
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation], [[Part_scripting|Part scripting]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

<!--T:24-->
A Part Point can be created with the {{Incode|addObject()}} method of the document:

</translate>
{{Code|code=
point = FreeCAD.ActiveDocument.addObject("Part::Vertex", "myPoint")
}}
<translate>

<!--T:25-->
* Where {{Incode|"myPoint"}} is the name for the object.
* The function returns the newly created object.

<!--T:26-->
Example:

</translate>
{{Code|code=
import FreeCAD as App

doc = App.activeDocument()

point = doc.addObject("Part::Vertex", "myPoint")
point.X = 1
point.Y = 2
point.Z = 3


doc.recompute()
== Description == <!--T:2-->
}}
A Point (vertex) geometric primitive is available from the Create Primitives dialogue in the Part workbench.
<translate>


<!--T:4-->
The Create Primitives dialogue can be accessed via the [[Part_CreatePrimitives|CreatePrimitives]] icon [[Image:Part_CreatePrimitives.png|32px]] located in the Part menu or the Part toolbar, in the Part Workbench.


===Geometric Primitives=== <!--T:5-->
<!--T:11-->
{{Docnav
{|
|[[Part_Ellipse|Ellipse]]
| [[File:PartVertexPrimitivesOptions_it.png]]
|[[Part_Line|Line]]
|
|[[Part_Workbench|Part]]
Point
|IconL=Part_Ellipse.svg
====Parameter====
|IconR=Part_Line.svg
* {{Parameter|X}}
|IconC=Workbench_Part.svg
* {{Parameter|Y}}
}}
* {{Parameter|Z}}
====Location====
*
*
*
|}
===Property===
{|
| [[File:PartVertexProperty_it.png|left]]
|
==== View ====
..
==== Data ====
{{KEY|Base}}<br />
* {{ProprietaDati|Label}}:
* {{ProprietaDati|Placement}}: [[Placement|placement]]
* {{ProprietaDati|X}} :
* {{ProprietaDati|Y}} :
* {{ProprietaDati|Z}} :
|}
{{clear}}


</translate>
</translate>
{{Part_Tools_navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 10:27, 3 March 2022

Part Point

Menu location
Part → Create primitives → Point
Workbenches
Part, OpenSCAD
Default shortcut
None
Introduced in version
-
See also
Part Primitives

Description

A Part Point is a parametric point that can be created with the Part Primitives command. Its coordinates are relative to the coordinate system defined by its DataPlacement property.

Usage

See Part Primitives.

Properties

See also: Property editor.

A Part Point object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data

Attachment

The object has the same attachment properties as a Part Part2DObject.

Base

  • DataX (Distance): The X coordinate of the point. The default is 0mm.
  • DataY (Distance): The Y coordinate of the point. The default is 0mm.
  • DataZ (Distance): The Z coordinate of the point. The default is 0mm.

Scripting

See also: Autogenerated API documentation, Part scripting and FreeCAD Scripting Basics.

A Part Point can be created with the addObject() method of the document:

point = FreeCAD.ActiveDocument.addObject("Part::Vertex", "myPoint")
  • Where "myPoint" is the name for the object.
  • The function returns the newly created object.

Example:

import FreeCAD as App

doc = App.activeDocument()

point = doc.addObject("Part::Vertex", "myPoint")
point.X = 1
point.Y = 2
point.Z = 3

doc.recompute()