Draft API/ro: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
Aceste funcții fac parte din modulul Draft-Desen 2D și pot fi utilizate în scripturi și macrocomenzi sau de la interpretorul python, odată ce modulul Draft a fost importat.
Aceste funcții fac parte din modulul Draft-Desen 2D și pot fi utilizate în scripturi și macrocomenzi sau de la interpretorul python, odată ce modulul Draft a fost importat.
</div>

These functions are part of the [[Draft Workbench|Draft Workbench]] and can be used in [[macros|macros]] and from the [[Python|Python]] console once the {{incode|Draft}} module has been imported.


Example:
Example:
{{Code|code=
{{Code|code=
import FreeCAD
import FreeCAD, Draft

from Draft import *
myrect = makeRectangle(4,3)
myrect = Draft.makeRectangle(4, 3)
mydistance = FreeCAD.Vector(2,2,0)
mydistance = FreeCAD.Vector(2, 2, 0)
move(myrect,mydistance)
Draft.move(myrect, mydistance)
}}
}}


{{APIFunction | cut | FreeCAD.Object, FreeCAD.Object | Returnează un obiect tăiat făcut din diferența dintre cele 2 obiecte date. Obiectele originale se ascund. | Un obiect nou creat}}


{{APIFunction | extrude | FreeCAD.Object, Vector | Extrudeaza obiectul dat in directia data de vector. Obiectul inițial devine ascuns | Un obiect nou creat}}


{{APIFunction | formatObject | FreeCAD.Object, [FreeCAD.Object] | Această funcție se aplică obiectului țintă dat, ținând cont de proprietăților curente setate pe bara de instrumente Draft (culoarea liniei și lățimea liniei) sau copiază proprietățile unui al doilea obiect dacă sunt furnizate. De asemenea, plasează obiectul în grupul de construcție dacă este apăsat butonul de construcție. | Nimic}}

{{APIFunction | fuse | FreeCAD.Object, FreeCAD.Object | Returnează un obiect făcut din unirea celor două obiecte date. În cazul în care obiectele sunt coplanare, se folosește o schemă specială, în caz contrar obiectul final este o siguranță standard a părții. | Un obiect nou creat}}

{{APIFunction | getDraftPath | [string] | Returnează calea de accesa a utilizatorului sau a sistemului de la care modulul Draft rulează. Dacă este furnizat o sub cale sau un nume de fișier, este furnizat returnează calea completă la sub-calea din modulul Schiță. | O cale de fișier}}



{{APIFunction | getGroupContents | list | Scanează recursiv lista dată pentru grupuri. În cazul în care grupurile sunt întâlnite, conținutul acestora este adăugat la listă. | O listă a obiectelor FreeCAD}}


{{APIFunction|getRealName|string|Separă numărul din numele unui obiect .| Numele obiectului astfel dezbrăcat}}

{{APIFunction|getSelection| |Returnează selecția curentă FreeCAD.| Secțiunea curentă FreeCAD }}

{{APIFunction|makeCircle|radius, [placement], [facemode], [startangle], [endangle]| Creează un obiect de cerc cu o rază dată. Dacă este oferită o destinație de plasare, este utilizată. Dacă facemodul este Fals, cercul este afișat ca un filament (polilinie), alfel ca o fațetă. În cazul în care '''startAngle''' și '''endAngle''' sunt date (în grade), ele sunt folosite și obiectul apare ca un arc de cerc. | Obiectul nou creat.}}


{{APIFunction | makeDimension | Vector, Vector, [Vector] sau FreeCAD.Object, int, [Vector] | Creează un obiect '''Cotă''' care măsoară distanța dintre primul și al doilea vector, cu linia de cotă care trece prin cel de-al treilea vector, dacă este prevăzută. Se va utiliza lățimea curentă a liniei și culoarea din bara de instrumente Draft. În loc de 2 vectori, puteți trece și un obiect FreeCAD și două numere întregi (și opțional un vector) unde trebuie să treacă linia de dimensiuni. În acest caz, dimensiunea va fi asociată cu obiectul și va măsura două dintre vârfurile sale, indicate de cele două numere de index date. | Un nou obiect va fi creat.}}

{{APIFunction | makeLine | Vector, Vector | Creează o linie între cei doi vectori dat. Se va utiliza lățimea curentă a liniei și culoarea din bara de instrumente Draft. | Un nou obiect va fi creat.}}

{{APIFunction | makeRectangle | lungime, lățime, [plasare], [facemode] | Creează un obiect Rectangular cu lungimea în direcția X și înălțime în direcția Y. Dacă este oferită o destinație de plasare, este utilizată. Dacă '''facemodul este Fals''', dreptunghiul este afișat ca un cadru de sârmă, altfel ca o față. Se va utiliza lățimea curentă a liniei și culoarea din bara de instrumente Draft. | Un obiect nou este creat.}}



{{APIFunction | makeText | șir sau listă, [Vector], [screenmode] | Creează un obiect Text, un vector este furnizat, care conține șirul sau șirurile date în listă, un șir după linie. Culoarea curentă din bara de instrumente Draft și înălțimea textului și fontul specificat în preferințe sunt utilizate. Dacă textul de ecran este True, textul se află întotdeauna în direcția vizualizării, altfel se află pe planul XY.| Un obiect nou este creat.}}

{{APIFunction | makeWire | list sau Part.Wire, [closed], [placement] [facemode] | Creează un obiect DWire din lista dată de vectori sau din sirul dat. Dacă obiectul este închis (True), sau dacă primul și ultimul punct sunt identice, firul este închis. Dacă '''facemode''' este adevărat (și firul este închis), firul va apărea umplut. Se va folosi lățimea curentă a liniei și culoarea currentă din bara de instrumente Draft .| Un nou obiect Draft DWire este creat (nu o Part Wire).}}
{{APIFunction | move | FreeCAD.Object sau listă, Vector, [copymode]|Mută obiectul dat sau obiectele conținute în lista dată în direcția și distanța indicată de vectorul dat. Dacă '''CopyMode''' este True, obiectele reale nu sunt mutate, spre deosebire de copiile lor care sunt create în schimb.|Obiectul (obiectele) (sau copiile lor dacă '''CopyMode''' a fost True)}}

{{APIFunction | precision | Returneaza valoarea de precizie din Proiectarea setarilor utilizatorului. | Un intreg.}}


{{APIFunction | rotate | FreeCAD.Object sau lista, unghiul, [center], [axis], [copymode] | Rotește obiectul/obeictele conținute în lista dată, cu unghiul dat, în jurul centrului dat, Dacă axa este omisă, rotația va fi în jurul axei '''Z''' verticale. În cazul în care '''CopyMode''' este True, obiectele reale nu sunt mutate, dar copiile sunt create în loc de obiecte. | Obiecte (sau copii ale acestora).}}

{{APIFunction | scale | FreeCAD.Object sau listă, vector, [center], [copymode] | REdimensionează/Scalează obiectul dat sau obiectele conținute în lista dată cu factorii de scalare definiți de vectorul dat (pe direcțiile ‚'''X, Y și Z''') în jurul centrului dat, dacă există. În cazul în care '''CopyMode''' este True, obiectele reale nu sunt mișcate, ci vor fi create în schimb copii .| Obiectele (sau copiile lor).}}



{{APIFunction | select | FreeCAD.Object | Deselectează totul și selectează numai obiectul trecut | Nimic.}}




{{APIFunction | shapify | FreeCAD.Object | Transformă un obiect de formă parametric în non-parametric. | Obiectul nou.}}


{{APIFunction | draftify | FreeCAD.Object sau listă | Transformă obiectul dat sau fiecare obiect în filamente parametric al.|Nimic }}


{{APIFunction|cut|FreeCAD.Object, FreeCAD.Object|Returns a cut object made from the difference of the 2 given objects. The original objects get hidden.|The newly created object}}
{{APIFunction|extrude|FreeCAD.Object, Vector|Extrudes the given object in the direction given by the vector. The original object gets hidden.|The newly created object}}
{{APIFunction|formatObject|FreeCAD.Object, [FreeCAD.Object]|This function applies to the given target object the current properties set on the Draft toolbar (line color and line width), or copies the properties of a second object if provided. It also places the object in construction group if the construction button is pressed.|Nothing}}
{{APIFunction|fuse|FreeCAD.Object, FreeCAD.Object|Returns an object made from the union of the 2 given objects. If the objects are coplanar, a special Draft Wire is used, otherwise the final object is a standard Part fuse.|The newly created object}}
{{APIFunction|getDraftPath|[string]|Returns the user or system path where the Draft module is running from. If a subpath or a filename is supplied, the full path to the subpath inside the Draft module is returned.|A file path}}
{{APIFunction|getGroupContents|list|Scans recursively the given list for groups. If groups are encountered, their contents are appended to the list.|A list of FreeCAD Objects}}
{{APIFunction|getRealName|string|Strips the trailing numbers from an object name.|The stripped object name}}
{{APIFunction|getSelection| |Returns the current FreeCAD selection.|The current FreeCAD selection.}}
{{APIFunction|makeCircle|radius, [placement], [facemode], [startangle], [endangle]|Creates a circle object with given radius. If a placement is given, it is used. If facemode is False, the circle is shown as a wireframe, otherwise as a face. If startangle AND endangle are given (in degrees), they are used and the object appears as an arc.|The newly created object.}}
{{APIFunction|makeDimension|Vector, Vector, [Vector] or FreeCAD.Object, int, int, [Vector]|Creates a Dimension object measuring distance between first and second vectors, with the dimension line passign through the third vector if provided. The current line width and color from the Draft toolbar will be used. Instead of 2 vectors, you can also pass a FreeCAD object, and two integers (and optionally a vector where the dimension line must pass). In that case, the dimension will be associated with the object, and measure two of its vertices, indicated by the two given indice numbers.|The newly created object.}}
{{APIFunction|makeLine|Vector, Vector|Creates a line between the two given vectors. The current line width and color from the Draft toolbar will be used.|The newly created object.}}
{{APIFunction|makeRectangle|length, width, [placement], [facemode]|Creates a Rectangle object with length in X direction and height in Y direction. If a placement is given, it is used. If facemode is False, the rectangle is shown as a wireframe, otherwise as a face. The current line width and color from the Draft toolbar will be used.|The newly created object.}}
{{APIFunction|makeText|string or list, [Vector], [screenmode]|Creates a Text object, at the given point if a vector is provided, containing the string or the strings given in the list, one string by line. The current color from the Draft toolbar and the text height and font specified in preferences are used. If screenmode is True, the text always faces the view direction, otherwise it lies on the XY plane.|The newly created object.}}
{{APIFunction|makeWire|list or Part.Wire, [closed], [placement], [facemode]|Creates a DWire object from the given list of vectors or from the given Wire. If closed is True or if first and last points are identical, the wire is closed. If facemode is True (and wire is closed), the wire will appear filled. The current line width and color from the Draft toolbar will be used.|A new Draft DWire (not a Part Wire).}}
{{APIFunction|move|FreeCAD.Object or list, Vector, [copymode]|Moves the given object or the objects contained in the given list in the direction and distance indicated by the given vector. If copymode is True, the actual objects are not moved, but copies are created instead.|The object(s) (or their copies if copymode was True).}}
{{APIFunction|precision| |Returns the precision value from Draft user settings.|An integer.}}
{{APIFunction|rotate|FreeCAD.Object or list, angle, [center], [axis] ,[copymode]|Rotates the given object or the objects contained in the given list with the given angle around the given center if provided, using axis as a rotation axis. If axis is omitted, the rotation will be around the vertical Z axis. If copymode is True, the actual objects are not moved, but copies are created instead.|The objects (or their copies).}}
{{APIFunction|scale|FreeCAD.Object or list, vector, [center], [copymode]|Scales the given object or the objects contained in the given list with a scale factors defined by the given vector (in X, Y and Z directions) around the given center if provided. If copymode is True, the actual objects are not moved, but copies are created instead.|The objects (or their copies).}}
{{APIFunction|select|FreeCAD.Object|Deselects everything and selects only the passed object|Nothing.}}
{{APIFunction|shapify|FreeCAD.Object|Transforms a parametric shape object into non-parametric.|The new object.}}
{{APIFunction|draftify|FreeCAD.Object or list|Turns the given object or each object of the given list into Draft parametric wires.|Nothing.}}
{{APIFunction|getSVG|FreeCAD.Object, [linemodifier], [textmodifier], [(u,v)]|Creates a SVG representation of the given object. The linemodifier attribute is a scale factor (in percents) for line width, and textmodifier for text size. You can also optionally provide a tuple of vectors to define a projection plane, otherwise the geometry will be projected on the XY plane.|a string containing a SVG representation of the given object.}}


{{APIFunction | getSVG | FreeCAD.Object, [linemodifier], [textmodifier], [(u, v)] | Creează o reprezentare SVG a obiectului dat. Atributul linemodifier este un factor de scalare (în procente) pentru lățimea liniei și textmodifier pentru dimensiunea textului. De asemenea, puteți furniza opțional o tuplă de vectori pentru a defini un plan de proiecție, altfel geometria va fi proiectată pe planul XY. | Un șir care conține o reprezentare SVG a obiectului dat.}}


{{Draft Tools navi{{#translation:}}}}
[[Category:API]]
{{Userdocnavi{{#translation:}}}}
[[Category:Poweruser Documentation]]
[[Category:API{{#translation:}}]]
[[Category:Poweruser Documentation{{#translation:}}]]


{{clear}}
{{clear}}

Latest revision as of 22:25, 20 February 2020

Aceste funcții fac parte din modulul Draft-Desen 2D și pot fi utilizate în scripturi și macrocomenzi sau de la interpretorul python, odată ce modulul Draft a fost importat.

These functions are part of the Draft Workbench and can be used in macros and from the Python console once the Draft module has been imported.

Example:

import FreeCAD, Draft

myrect = Draft.makeRectangle(4, 3)
mydistance = FreeCAD.Vector(2, 2, 0)
Draft.move(myrect, mydistance)
cut ( FreeCAD.Object, FreeCAD.Object )

Description: Returnează un obiect tăiat făcut din diferența dintre cele 2 obiecte date. Obiectele originale se ascund.

Returns: Un obiect nou creat


extrude ( FreeCAD.Object, Vector )

Description: Extrudeaza obiectul dat in directia data de vector. Obiectul inițial devine ascuns

Returns: Un obiect nou creat


formatObject ( FreeCAD.Object, [FreeCAD.Object] )

Description: Această funcție se aplică obiectului țintă dat, ținând cont de proprietăților curente setate pe bara de instrumente Draft (culoarea liniei și lățimea liniei) sau copiază proprietățile unui al doilea obiect dacă sunt furnizate. De asemenea, plasează obiectul în grupul de construcție dacă este apăsat butonul de construcție.

Returns: Nimic

fuse ( FreeCAD.Object, FreeCAD.Object )

Description: Returnează un obiect făcut din unirea celor două obiecte date. În cazul în care obiectele sunt coplanare, se folosește o schemă specială, în caz contrar obiectul final este o siguranță standard a părții.

Returns: Un obiect nou creat

getDraftPath ( [string] )

Description: Returnează calea de accesa a utilizatorului sau a sistemului de la care modulul Draft rulează. Dacă este furnizat o sub cale sau un nume de fișier, este furnizat returnează calea completă la sub-calea din modulul Schiță.

Returns: O cale de fișier


getGroupContents ( list )

Description: Scanează recursiv lista dată pentru grupuri. În cazul în care grupurile sunt întâlnite, conținutul acestora este adăugat la listă.

Returns: O listă a obiectelor FreeCAD


getRealName(string)

Description: Separă numărul din numele unui obiect .

Returns: Numele obiectului astfel dezbrăcat

getSelection( )

Description: Returnează selecția curentă FreeCAD.

Returns: Secțiunea curentă FreeCAD

makeCircle(radius, [placement], [facemode], [startangle], [endangle])

Description: Creează un obiect de cerc cu o rază dată. Dacă este oferită o destinație de plasare, este utilizată. Dacă facemodul este Fals, cercul este afișat ca un filament (polilinie), alfel ca o fațetă. În cazul în care startAngle și endAngle sunt date (în grade), ele sunt folosite și obiectul apare ca un arc de cerc.

Returns: Obiectul nou creat.


makeDimension ( Vector, Vector, [Vector] sau FreeCAD.Object, int, [Vector] )

Description: Creează un obiect Cotă care măsoară distanța dintre primul și al doilea vector, cu linia de cotă care trece prin cel de-al treilea vector, dacă este prevăzută. Se va utiliza lățimea curentă a liniei și culoarea din bara de instrumente Draft. În loc de 2 vectori, puteți trece și un obiect FreeCAD și două numere întregi (și opțional un vector) unde trebuie să treacă linia de dimensiuni. În acest caz, dimensiunea va fi asociată cu obiectul și va măsura două dintre vârfurile sale, indicate de cele două numere de index date.

Returns: Un nou obiect va fi creat.

makeLine ( Vector, Vector )

Description: Creează o linie între cei doi vectori dat. Se va utiliza lățimea curentă a liniei și culoarea din bara de instrumente Draft.

Returns: Un nou obiect va fi creat.

makeRectangle ( lungime, lățime, [plasare], [facemode] )

Description: Creează un obiect Rectangular cu lungimea în direcția X și înălțime în direcția Y. Dacă este oferită o destinație de plasare, este utilizată. Dacă facemodul este Fals, dreptunghiul este afișat ca un cadru de sârmă, altfel ca o față. Se va utiliza lățimea curentă a liniei și culoarea din bara de instrumente Draft.

Returns: Un obiect nou este creat.


makeText ( șir sau listă, [Vector], [screenmode] )

Description: Creează un obiect Text, un vector este furnizat, care conține șirul sau șirurile date în listă, un șir după linie. Culoarea curentă din bara de instrumente Draft și înălțimea textului și fontul specificat în preferințe sunt utilizate. Dacă textul de ecran este True, textul se află întotdeauna în direcția vizualizării, altfel se află pe planul XY.

Returns: Un obiect nou este creat.

makeWire ( list sau Part.Wire, [closed], [placement] [facemode] )

Description: Creează un obiect DWire din lista dată de vectori sau din sirul dat. Dacă obiectul este închis (True), sau dacă primul și ultimul punct sunt identice, firul este închis. Dacă facemode este adevărat (și firul este închis), firul va apărea umplut. Se va folosi lățimea curentă a liniei și culoarea currentă din bara de instrumente Draft .

Returns: Un nou obiect Draft DWire este creat (nu o Part Wire).

move ( FreeCAD.Object sau listă, Vector, [copymode])

Description: Mută obiectul dat sau obiectele conținute în lista dată în direcția și distanța indicată de vectorul dat. Dacă CopyMode este True, obiectele reale nu sunt mutate, spre deosebire de copiile lor care sunt create în schimb.

Returns: Obiectul (obiectele) (sau copiile lor dacă CopyMode a fost True)

precision ( Returneaza valoarea de precizie din Proiectarea setarilor utilizatorului. )

Description: Un intreg.

Returns: {{{4}}}


rotate ( FreeCAD.Object sau lista, unghiul, [center], [axis], [copymode] )

Description: Rotește obiectul/obeictele conținute în lista dată, cu unghiul dat, în jurul centrului dat, Dacă axa este omisă, rotația va fi în jurul axei Z verticale. În cazul în care CopyMode este True, obiectele reale nu sunt mutate, dar copiile sunt create în loc de obiecte.

Returns: Obiecte (sau copii ale acestora).

scale ( FreeCAD.Object sau listă, vector, [center], [copymode] )

Description: REdimensionează/Scalează obiectul dat sau obiectele conținute în lista dată cu factorii de scalare definiți de vectorul dat (pe direcțiile ‚X, Y și Z) în jurul centrului dat, dacă există. În cazul în care CopyMode este True, obiectele reale nu sunt mișcate, ci vor fi create în schimb copii .

Returns: Obiectele (sau copiile lor).


select ( FreeCAD.Object )

Description: Deselectează totul și selectează numai obiectul trecut

Returns: Nimic.



shapify ( FreeCAD.Object )

Description: Transformă un obiect de formă parametric în non-parametric.

Returns: Obiectul nou.


draftify ( FreeCAD.Object sau listă )

Description: Transformă obiectul dat sau fiecare obiect în filamente parametric al.

Returns: Nimic


getSVG ( FreeCAD.Object, [linemodifier], [textmodifier], [(u, v)] )

Description: Creează o reprezentare SVG a obiectului dat. Atributul linemodifier este un factor de scalare (în procente) pentru lățimea liniei și textmodifier pentru dimensiunea textului. De asemenea, puteți furniza opțional o tuplă de vectori pentru a defini un plan de proiecție, altfel geometria va fi proiectată pe planul XY.

Returns: Un șir care conține o reprezentare SVG a obiectului dat.