Draft API/ro: Difference between revisions
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|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 | 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|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|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:}}}} |
|||
⚫ | |||
{{Userdocnavi{{#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)
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
Description: Extrudeaza obiectul dat in directia data de vector. Obiectul inițial devine ascuns
Returns: Un obiect nou creat
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
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
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
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
Description: Separă numărul din numele unui obiect .
Returns: Numele obiectului astfel dezbrăcat
Description: Returnează selecția curentă FreeCAD.
Returns: Secțiunea curentă FreeCAD
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.
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.
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.
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.
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.
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).
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)
Description: Un intreg.
Returns: {{{4}}}
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).
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).
Description: Deselectează totul și selectează numai obiectul trecut
Returns: Nimic.
Description: Transformă un obiect de formă parametric în non-parametric.
Returns: Obiectul nou.
Description: Transformă obiectul dat sau fiecare obiect în filamente parametric al.
Returns: Nimic
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.
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub