hSSKJr SSKJrJrJrJrJr SSKrSSK r SSK r SSK J r SSK JrJrJrJr SSKJrJrJrJrJrJrJrJr SSKJr SSKJrJrJ r J!r!J"r"J#r#J$r$ SS K%7 SS K&J'r' SS K(J)r) SS K*J+r+ \ RX"S 5r-\(abSSK.J/r/ SSK0J1r1 SSKJ2r2J3r3J4r4J5r5J6r6J7r7J8r8J9r9J:r:J;r;Jr>J?r?J@r@JArAJBrBJCrCJDrDJErEJFrFJGrGJHrHJIrIJJrJJKrKJLrLJMrMJNrNJOrOJPrPJQrQJRrRJSrSJTrTJUrUJVrV SSKWJXrXJYrY "SS5rZ1Skr[g)) annotations) TYPE_CHECKINGIterableSequencecastOptionalN)const) DXFValueErrorDXFVersionErrorDXF2000DXF2013)Vec3UVecUCSglobal_bspline_interpolationfit_points_to_cad_cvarc_angle_span_degConstructionArcNULLVEC)ARROWS)factoryPointSplineBodySurfaceLineCircle)*)DimStyleOverride)multi_point_linear_dimension)guidezdxf)Drawing)GenericLayoutType)%ArcAttDef Dimension ArcDimension DXFGraphicEllipseExtrudedSurfaceFace3dHatchImageImageDefInsert LWPolylineLeader LoftedSurfaceMLineMTextMPolygonMeshPolyfacePolylinePolymeshRayRegionRevolvedSurfaceShapeSolidSolid3d SweptSurfaceTextTraceUnderlayUnderlayDefinitionWipeoutXLine MultiLeaderHelix)MultiLeaderMTextBuilderMultiLeaderBlockBuilderc" \rSrSrSaSjr\SbSj5r\S5rScSjrSdSjr SeSfSjjr SeSgS jjr SeShS jjr S S S \ RS4SiSjjrSjSkSjjrSeSlSjjrSeSmSjjrSeSnSjjrSSSS.SoSjjrSeSpSjjrSeSqSjjrSrSSSS.SsSjjjrSeSSS.StSjjjrSSS.SuSjjrSvSwSjjrSeSxSjjrSeSySjjr\SzSj5rS{S|S jjrS}SSS.S~S!jjjr SeSS"jjr!SeSS#jjr"SeSS$jjr#SeSS%jjr$SeSS&jjr%SeSS'jjr&SSS(jjr'SSS)jjr(SSS*jjr)SSS+jjr*SSS,jjr+SeSS-jjr,SeSS.jjr-SeSS/jjr.SeSS0jjr/SeSS1jjr0SeSS2jjr1SeSS3jjr2SeSS4jjr3SS5jr4SSS6jjr5\6RnSS4SS7jjr8SeSS8jjr9SSS:jjr:SeSS;jjr;SSS<jjrSSSAjjr?SSSBjjr@SS>SSCSSSD.SSEjjrASS>SSCSSSD.SSFjjrBSS>SSCSSSD.SSGjjrCSS>SSCSSSD.SSHjjrDSS>SSCSSSD.SSIjjrESS>SSCSSSD.SSJjjrFSS>SSCSSSD.SSKjjrGSSS>SLSSSM.SSNjjjrHSSSOjjrISSS>SLSSSM.SSPjjjrJS>SLSSSQ.SSRjjrKS>SLSSSQ.SSSjjrL\MS9S>S?SSST.SSUjjrN\MS9S>S?SSST.SSVjjrO\MS9S>S?SSST.SSWjjrPSSSXjjrQSSSYjjrRSSSZjjrSSSS[jjrTSSS\jjrUSeSS]jjrVSeSSS.SS^jjjrWSjSS_jjrXS`rYg)CreatorInterfaceScXlgNdoc)selfrRs G/var/www/html/env/lib/python3.13/site-packages/ezdxf/graphicsfactory.py__init__CreatorInterface.__init__Tsc.URR$rP)rR dxfversionrSs rTrYCreatorInterface.dxfversionWsxx"""rWcg)NFrZs rTis_active_paperspace%CreatorInterface.is_active_paperspace[srWcj[R"XUR5nURU5 U$)z Create entity in drawing database and add entity to the entity space. Args: type_ : DXF type string, like "LINE", "CIRCLE" or "LWPOLYLINE" dxfattribs: DXF attributes for the new entity )rcreate_db_entryrR add_entity)rStype_ dxfattribsentitys rT new_entityCreatorInterface.new_entity_s+((DHHE  rWcgrPr])rSres rTrbCreatorInterface.add_entityls rWNcj[U=(d 05n[U5US'URSU5$)z Add a :class:`~ezdxf.entities.Point` entity at `location`. Args: location: 2D/3D point in :ref:`WCS` dxfattribs: additional DXF attributes locationPOINTdictrrf)rSrkrds rT add_pointCreatorInterface.add_pointos2**+ !%h :w 33rWc[U=(d 05n[U5US'[U5US'URSU5$)z Add a :class:`~ezdxf.entities.Line` entity from `start` to `end`. Args: start: 2D/3D point in :ref:`WCS` end: 2D/3D point in :ref:`WCS` dxfattribs: additional DXF attributes startendLINErm)rSrrrsrds rTadd_lineCreatorInterface.add_line|s@**+ "5k 7 I 5vz22rWc[U=(d 05n[U5US'[U5US'URSU5$)z Add a :class:`~ezdxf.entities.Circle` entity. This is an 2D element, which can be placed in space by using :ref:`OCS`. Args: center: 2D/3D point in :ref:`WCS` radius: circle radius dxfattribs: additional DXF attributes centerradiusCIRCLErnrfloatrf)rSrxryrds rT add_circleCreatorInterface.add_circles@**+ #F| 8$V} 8x44rW)rrrrcUR[:a [S5e[U5n[ U5S:a [ S5e[ U5nUR(a [ S5e[U=(d 05n[ U5US'XvS'X6S'[U5US'[U5US 'URS U5$) uN Add an :class:`~ezdxf.entities.Ellipse` entity, `ratio` is the ratio of minor axis to major axis, `start_param` and `end_param` defines start and end point of the ellipse, a full ellipse goes from 0 to 2π. The ellipse goes from start to end param in `counter-clockwise` direction. Args: center: center of ellipse as 2D/3D point in :ref:`WCS` major_axis: major axis as vector (x, y, z) ratio: ratio of minor axis to major axis in range +/-[1e-6, 1.0] start_param: start of ellipse curve end_param: end param of ellipse curve dxfattribs: additional DXF attributes zELLIPSE requires DXF R2000?zinvalid axis ratio > 1.0zinvalid major axis: (0, 0, 0)rx major_axisratio start_param end_paramELLIPSE) rYr r r|absr ris_nullrnrf)rSrxrrrrrd _major_axiss rT add_ellipseCreatorInterface.add_ellipses2 ??W $!">? ?e  u:  :; ;:&    ?@ @**+ #F| 8#.< #7$)+$6 =!"' "2 ;y*55rWc[U=(d 05n[U5US'[U5US'U(a[U5US'[U5US'O[U5US'[U5US'URSU5$)a Add an :class:`~ezdxf.entities.Arc` entity. The arc goes from `start_angle` to `end_angle` in counter-clockwise direction by default, set parameter `is_counter_clockwise` to ``False`` for clockwise orientation. Args: center: center of arc as 2D/3D point in :ref:`WCS` radius: arc radius start_angle: start angle in degrees end_angle: end angle in degrees is_counter_clockwise: ``False`` for clockwise orientation dxfattribs: additional DXF attributes rxry start_angle end_angleARCr{)rSrxryrris_counter_clockwiserds rTadd_arcCreatorInterface.add_arcs0**+ #F| 8$V} 8 (-k(:J} %&+I&6J{ #(-i(8J} %&+K&8J{ #uj11rWc&URSX5$)a2Add a :class:`~ezdxf.entities.Solid` entity, `points` is an iterable of 3 or 4 points. .. hint:: The last two vertices are in reversed order: a square has the vertex order 0-1-3-2 Args: points: iterable of 3 or 4 2D/3D points in :ref:`WCS` dxfattribs: additional DXF attributes SOLID_add_quadrilateralrSpointsrds rT add_solidCreatorInterface.add_solid&&wCCrWc&URSX5$)a2Add a :class:`~ezdxf.entities.Trace` entity, `points` is an iterable of 3 or 4 points. .. hint:: The last two vertices are in reversed order: a square has the vertex order 0-1-3-2 Args: points: iterable of 3 or 4 2D/3D points in :ref:`WCS` dxfattribs: additional DXF attributes TRACErrs rT add_traceCreatorInterface.add_tracerrWc&URSX5$)aV Add a :class:`~ezdxf.entities.3DFace` entity, `points` is an iterable 3 or 4 2D/3D points. .. hint:: In contrast to SOLID and TRACE, the last two vertices are in regular order: a square has the vertex order 0-1-2-3 Args: points: iterable of 3 or 4 2D/3D points in :ref:`WCS` dxfattribs: additional DXF attributes 3DFACErrs rT add_3dfaceCreatorInterface.add_3dface s&&xDDrW)heightrotationrdc[U=(d 05n[U5US'Ub[U5US'Ub[U5US'URS[ 55 UR SU5$)z Add a :class:`~ezdxf.entities.Text` entity, see also :class:`~ezdxf.entities.Textstyle`. Args: text: content string height: text height in drawing units rotation: text rotation in degrees dxfattribs: additional DXF attributes textrrinsertTEXT)rnstrr| setdefaultrrf)rSrrrrds rTadd_textCreatorInterface.add_textsl&**+  Y 6  #(=Jx  %*8_Jz "h/vz22rWc[U[5(d [S5e[U=(d 05nXS'[ U5US'UR SU5$)a Add an :class:`~ezdxf.entities.Insert` entity. When inserting a block reference into the modelspace or another block layout with different units, the scaling factor between these units should be applied as scaling attributes (:attr:`xscale`, ...) e.g. modelspace in meters and block in centimeters, :attr:`xscale` has to be 0.01. Args: name: block name as str insert: insert location as 2D/3D point in :ref:`WCS` dxfattribs: additional DXF attributes Block name as string required.namerINSERT) isinstancerr rnrrf)rSrrrds rT add_blockrefCreatorInterface.add_blockref6sS $$$ @A A**+ !6#F| 8x44rWcz^^^^ [U[5(d [S5eSU4Sjjm SUUU 4Sjjn[U=(d 05nURR R 5nURUS5mURR UmU"5 URURX$5$)a; Add an :class:`~ezdxf.entities.Insert` entity. This method adds for each :class:`~ezdxf.entities.Attdef` entity, defined in the block definition, automatically an :class:`Attrib` entity to the block reference and set (tag, value) DXF attributes of the ATTRIB entities by the (key, value) pairs (both as strings) of the `values` dict. The Attrib entities are placed relative to the insert point, which is equal to the block base point. This method wraps the INSERT and all the ATTRIB entities into an anonymous block, which produces the best visual results, especially for non-uniform scaled block references, because the transformation and scaling is done by the CAD application. But this makes evaluation of block references with attributes more complicated, if you prefer INSERT and ATTRIB entities without a wrapper block use the :meth:`add_blockref_with_attribs` method. Args: name: block name insert: insert location as 2D/3D point in :ref:`WCS` values: :class:`~ezdxf.entities.Attrib` tag values as (tag, value) pairs dxfattribs: additional DXF attributes rct>URS5nTRUS5nURS5nXU4$)Ntagr)popget)rdrrrkvaluess rTunpack2CreatorInterface.add_auto_blockref..unpackqs:..'C::c2&D!~~h/Hh& &rWc>TR5H1nURSS1S9nT"U5up#nTRX#XA5 M3 g)Nprompthandle)drop)attdefsrd add_attrib)attdefrdrrrkblockdefblockrefrs rTautofill4CreatorInterface.add_auto_blockref..autofillwsM"**,#..Xx4H.I &,Z&8#8##CxD-rWrr)returnztuple[str, str, UVec])rNone) rrr rnrRblocksnew_anonymous_blockrr) rSrrrrdr autoblockrrrs ` @@@rTadd_auto_blockref"CreatorInterface.add_auto_blockrefNs@$$$ @A A '  E E**+ HHOO779 ))$788??4(   DDrWc[U=(d 05n[U5US'[U5US'[U5US'Ub[U5US'Ub[U5US'UR SU5$)a Add an :class:`~ezdxf.entities.AttDef` as stand alone DXF entity. Set position and alignment by the idiom:: layout.add_attdef("NAME").set_placement( (2, 3), align=TextEntityAlignment.MIDDLE_CENTER ) Args: tag: tag name as string insert: insert location as 2D/3D point in :ref:`WCS` text: tag value as string height: text height in drawing units rotation: text rotation in degrees dxfattribs: additional DXF attributes rrrrrATTDEFrnrrr|rf)rSrrrrrrds rT add_attdefCreatorInterface.add_attdefsv8**+ H 5#F| 8 Y 6  #(=Jx  %*8_Jz "x44rWFcloserdc[U=(d 05nSU;a[R"S[5 UR SU5nUR SU5nUR U5 UbURXS9 OURU5 UR(a%URURR5 U$)a Add a 2D :class:`~ezdxf.entities.Polyline` entity. Args: points: iterable of 2D points in :ref:`WCS` close: ``True`` for a closed polyline format: user defined point format like :meth:`add_lwpolyline`, default is ``None`` dxfattribs: additional DXF attributes closedCdxfattribs key "closed" is deprecated, use keyword argument "close"POLYLINEformat) rnwarningswarnDeprecationWarningrrfrappend_formatted_verticesappend_verticesrRadd_sub_entities_to_entitydbentitydb)rSrrrrdpolylines rTadd_polyline2dCreatorInterface.add_polyline2ds&**+ z ! MM/"  x/!__ZDu    . .v . E  $ $V , 88  1 1$((2C2C DrWc[U=(d 05nURSS5[R-US'UR XUS9$)zAdd a 3D :class:`~ezdxf.entities.Polyline` entity. Args: points: iterable of 3D points in :ref:`WCS` close: ``True`` for a closed polyline dxfattribs: additional DXF attributes flagsrr)rnrr POLYLINE_3D_POLYLINEr)rSrrrds rTadd_polyline3dCreatorInterface.add_polyline3dsN**+ NN7A &)C)C C 7""6:"NNrWc[U=(d 05nURSS5[R-US'[ USS5n[ USS5nX2S'XBS'UR SS5nUR S S5nUR S U5nS /X4--nURU5 URXV5 UR(a%URURR5 U$) a% Add a :class:`~ezdxf.entities.Polymesh` entity, which is a wrapper class for the POLYLINE entity. A polymesh is a grid of `mcount` x `ncount` vertices and every vertex has its own (x, y, z)-coordinates. Args: size: 2-tuple (`mcount`, `ncount`) dxfattribs: additional DXF attributes rrrm_countn_countm_closeFn_closerrrr) rnrr POLYLINE_3D_POLYMESHmaxrrfrrrRrr) rSsizerdm_sizen_sizerrpolymeshrs rT add_polymeshCreatorInterface.add_polymeshs**+ NN7A &)C)C C 7T!WaT!Wa &9 &9..E2..E2!__ZD0  (w( 88  1 1$((2C2C DrWct[U=(d 05nURSS5[R-US'UR SS5nUR SS5nUR SU5nUR X#5 UR(a%URURR5 U$)zAdd a :class:`~ezdxf.entities.Polyface` entity, which is a wrapper class for the POLYLINE entity. Args: dxfattribs: additional DXF attributes for :class:`~ezdxf.entities.Polyline` entity rrrFrr) rnrr POLYLINE_POLYFACErrfrrRrr)rSrdrrpolyfaces rT add_polyfaceCreatorInterface.add_polyfaces**+ NN7A &)@)@ @ 7..E2..E2!__ZDw( 88  1 1$((2C2C DrWc[U=(d 05nURX5n[URU55HupV[ U5XE'M U$rP)rnrf enumerate _four_pointsr)rSrcrrdrexpoints rTr#CreatorInterface._add_quadrilateralsM**+ 3!$"3"3F"; >**+ "6{ 8:>  ! $ j 9F  rWc~[XUS9nURURURUR 5US9$)aAdd a :class:`~ezdxf.entities.Spline` entity passing through the given `fit_points`, the control points are calculated by a global curve interpolation without start- and end tangent constrains. The new SPLINE entity is defined by control points and not by the fit points, therefore the SPLINE looks always the same, no matter which CAD application renders the SPLINE. - "uniform": creates a uniform t vector, from 0 to 1 evenly spaced, see `uniform`_ method - "distance", "chord": creates a t vector with values proportional to the fit point distances, see `chord length`_ method - "centripetal", "sqrt_chord": creates a t vector with values proportional to the fit point sqrt(distances), see `centripetal`_ method - "arc": creates a t vector with values proportional to the arc length between fit points. Use function :meth:`add_cad_spline_control_frame` to create SPLINE entities from fit points similar to CAD application including start- and end tangent constraints. Args: fit_points: iterable of fit points as (x, y[, z]) in :ref:`WCS` degree: degree of B-spline, max. degree supported by AutoCAD is 11 method: calculation method for parameter vector t dxfattribs: additional DXF attributes )rCmethod)control_pointsrCknotsrd)radd_open_splinerMrCrN)rSrGrCrLrdbsplines rTadd_spline_control_frame)CreatorInterface.add_spline_control_framesJF/ f ##"11>>--/! $  rWcX[XS9nURUS9nURU5 U$)aHAdd a :class:`~ezdxf.entities.Spline` entity passing through the given fit points. This method creates the same control points as CAD applications. Args: fit_points: iterable of fit points as (x, y[, z]) in :ref:`WCS` tangents: start- and end tangent, default is autodetect dxfattribs: additional DXF attributes )tangentsrd)rrIapply_construction_tool)rSrGrTrdsrHs rTadd_cad_spline_control_frame-CreatorInterface.add_cad_spline_control_frames1 ! ?J7&&q) rWclURUS9nUR[U5U5 UbX5lU$)a Add an open uniform :class:`~ezdxf.entities.Spline` defined by `control_points`. (requires DXF R2000) Open uniform B-splines start and end at your first and last control point. Args: control_points: iterable of 3D points in :ref:`WCS` degree: degree of B-spline, max. degree supported by AutoCAD is 11 knots: knot values as iterable of floats dxfattribs: additional DXF attributes rU)rIset_open_uniformr rN)rSrMrCrNrdrHs rTrO CreatorInterface.add_open_splines9(J7^ 4f=   L rWclURUS9nUR[U5X#5 UbXFlU$)a Add an open rational uniform :class:`~ezdxf.entities.Spline` defined by `control_points`. (requires DXF R2000) `weights` has to be an iterable of floats, which defines the influence of the associated control point to the shape of the B-spline, therefore for each control point is one weight value required. Open rational uniform B-splines start and end at the first and last control point. Args: control_points: iterable of 3D points in :ref:`WCS` weights: weight values as iterable of floats degree: degree of B-spline, max. degree supported by AutoCAD is 11 knots: knot values as iterable of floats dxfattribs: additional DXF attributes rU)rIset_open_rationalr rN)rSrMweightsrCrNrdrHs rTadd_rational_spline$CreatorInterface.add_rational_splines96J7  n!5wG   L rWc&URSU5$)zAdd a :class:`~ezdxf.entities.Body` entity. (requires DXF R2000 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. BODY_add_acis_entityrSrds rTadd_bodyCreatorInterface.add_body s$$VZ88rWc&URSU5$)zAdd a :class:`~ezdxf.entities.Region` entity. (requires DXF R2000 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. REGIONrdrfs rT add_regionCreatorInterface.add_regions$$Xz::rWc&URSU5$)zAdd a 3DSOLID entity (:class:`~ezdxf.entities.Solid3d`). (requires DXF R2000 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. 3DSOLIDrdrfs rT add_3dsolidCreatorInterface.add_3dsolids$$Y ;;rWcxUR[R:a [S5eUR SU5$)zAdd a :class:`~ezdxf.entities.Surface` entity. (requires DXF R2007 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. z#SURFACE requires DXF R2007 or laterSURFACErYr DXF2007r rerfs rT add_surfaceCreatorInterface.add_surface$s3 ??U]] *!"GH H$$Y ;;rWcxUR[R:a [S5eUR SU5$)zAdd a :class:`~ezdxf.entities.ExtrudedSurface` entity. (requires DXF R2007 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. z+EXTRUDEDSURFACE requires DXF R2007 or laterEXTRUDEDSURFACErsrfs rTadd_extruded_surface%CreatorInterface.add_extruded_surface/s4 ??U]] *!"OP P$$%6 CCrWcxUR[R:a [S5eUR SU5$)zAdd a :class:`~ezdxf.entities.LoftedSurface` entity. (requires DXF R2007 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. z)LOFTEDSURFACE requires DXF R2007 or later LOFTEDSURFACErsrfs rTadd_lofted_surface#CreatorInterface.add_lofted_surface:s3 ??U]] *!"MN N$$_jAArWcxUR[R:a [S5eUR SU5$)z Add a :class:`~ezdxf.entities.RevolvedSurface` entity. (requires DXF R2007 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. z+REVOLVEDSURFACE requires DXF R2007 or laterREVOLVEDSURFACErsrfs rTadd_revolved_surface%CreatorInterface.add_revolved_surfaceEs4 ??U]] *!"OP P$$%6 CCrWcxUR[R:a [S5eUR SU5$)z Add a :class:`~ezdxf.entities.SweptSurface` entity. (requires DXF R2007 or later) The ACIS data has to be set as :term:`SAT` or :term:`SAB`. z(SWEPTSURFACE requires DXF R2007 or later SWEPTSURFACErsrfs rTadd_swept_surface"CreatorInterface.add_swept_surfaceQs3 ??U]] *!"LM M$$^Z@@rWc$UR[R:a[US35e[ U=(d 05nUR[ :a,UR SS5 UR S[55 URX5$)Nz requires DXF R2000 or laterrruid) rYr r r rnr rr!rf)rSrrds rTre!CreatorInterface._add_acis_entity]sq ??U]] *!TF*F"GH H**+ ??g %  ! !'1 -  ! !% 0t00rWcUR[:a [S5e[U=(d 05nSUS'[ U5US'SUS'UR SU5$)zAdd a :class:`~ezdxf.entities.Hatch` entity. (requires DXF R2000) Args: color: fill color as :ref`ACI`, default is 7 (black/white). dxfattribs: additional DXF attributes zHATCH requires DXF R2000r solid_fillcolorr pattern_nameHATCH)rYr r rnrErf)rSrrds rT add_hatchCreatorInterface.add_hatchfs^ ??W $!"<= =**+ #$ < !%j 7%, >"w 33rWcUR[:a [S5e[U=(d 05nUcSUS'O SUS'X#S'SUS'[R US'[ U5US 'URS U5$) a Add a :class:`~ezdxf.entities.MPolygon` entity. (requires DXF R2000) The MPOLYGON entity is not a core DXF entity and is not supported by every CAD application or DXF library. DXF version R2004+ is required to use a fill color different from BYLAYER. For R2000 the fill color is always BYLAYER, set any ACI value to create a filled MPOLYGON entity. Args: color: boundary color as :ref:`ACI`, default is BYLAYER. fill_color: fill color as :ref:`ACI`, default is ``None`` dxfattribs: additional DXF attributes zMPOLYGON requires DXF R2000rrr fill_colorrr pattern_typerMPOLYGON)rYr r rnr HATCH_TYPE_PREDEFINEDrErf)rSrrrds rT add_mpolygonCreatorInterface.add_mpolygonvs* ??W $!"?@ @**+  '(J| $'(J| $'1| $%, >"%*%@%@ >"!%j 7z:66rWcUR[:a [S5e[U=(d 05nUR SU5$)zt Add a :class:`~ezdxf.entities.Mesh` entity. (requires DXF R2007) Args: dxfattribs: additional DXF attributes zMESH requires DXF R2000MESH)rYr r rnrfrfs rTadd_meshCreatorInterface.add_meshs< ??W $!";< <**+ vz22rWcUR[:a [S5e[U=(d 05nURR R upgUupX- n X- n [R"U5n U [RS- -n [U5US'[R"X5US'[R"X5US'XS'URSU5$)a Add an :class:`~ezdxf.entities.Image` entity, requires a :class:`~ezdxf.entities.ImageDef` entity, see :ref:`tut_image`. (requires DXF R2000) Args: image_def: required image definition as :class:`~ezdxf.entities.ImageDef` insert: insertion point as 3D point in :ref:`WCS` size_in_units: size as (x, y) tuple in drawing units rotation: rotation angle around the extrusion axis, default is the z-axis, in degrees dxfattribs: additional DXF attributes zIMAGE requires DXF R2000@ru_pixelv_pixel image_defIMAGE) rYr r rndxf image_sizevec2mathradianspir from_anglerf)rSrr size_in_unitsrrdx_pixelsy_pixelsx_unitsy_unitsx_units_per_pixely_units_per_pixel x_angle_rad y_angle_rads rT add_imageCreatorInterface.add_images, ??W $!"<= =**+ &]]55::(#.#.ll8, !TWWs]3 #F| 8 $ O 9 $ O 9"+;w 33rWc[U=(d 05nURSUS9nURU5 URnU(aSUR;aUR SS9 U$)zAdd a :class:`ezdxf.entities.Wipeout` entity, the masking area is defined by WCS `vertices`. This method creates only a 2D entity in the xy-plane of the layout, the z-axis of the input vertices are ignored. WIPEOUTrUACAD_WIPEOUT_VARSr)frame)rnrfset_masking_arearRrootdictset_wipeout_variables)rSr rdwipeoutrRs rT add_wipeoutCreatorInterface.add_wipeoutsa**+ ??9?L  *hh 's||;  % %A % .rWc<UR[:a [S5e[U=(d 05n[ U5US'UR R US'[U5US'URURU5nX6l URU5 U$)a= Add an :class:`~ezdxf.entities.Underlay` entity, requires a :class:`~ezdxf.entities.UnderlayDefinition` entity, see :ref:`tut_underlay`. (requires DXF R2000) Args: underlay_def: required underlay definition as :class:`~ezdxf.entities.UnderlayDefinition` insert: insertion point as 3D point in :ref:`WCS` scale: underlay scaling factor as (x, y, z) tuple or as single value for uniform scaling for x, y and z rotation: rotation angle around the extrusion axis, default is the z-axis, in degrees dxfattribs: additional DXF attributes zUNDERLAY requires DXF R2000runderlay_def_handler) rYr r rnrrrr|rf entity_namescalingset_underlay_def)rS underlay_defrscalerrdunderlays rT add_underlayCreatorInterface.add_underlays. ??W $!"?@ @**+ #F| 8,8,<,<,C,C ()!&x :!__  $ $j !!!,/rWcUR(a,URRRU5(aU$[R SUS35 g)NzReplacing undefined DIMSTYLE "z" by "Standard" DIMSTYLE.Standard)rR dimstyles has_entryloggerdebug)rSrs rT_safe_dimstyleCreatorInterface._safe_dimstylesF 88**44T::K ,TF2K L rW<>EZDXFc S[R[R-0n URSU S9n [ U =(d 05n UR U5U S'[ U5U S'[U5U S'[ U5U S'[ U5U S'[U5U S 'Ub[U5U S 'U RU 5 [XS 9n UbU RUS S S 9 U $)a Add horizontal, vertical and rotated :class:`~ezdxf.entities.Dimension` line. If an :class:`~ezdxf.math.UCS` is used for dimension line rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. See also: :ref:`tut_linear_dimension` This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: base: location of dimension line, any point on the dimension line or its extension will do (in UCS) p1: measurement point 1 and start point of extension line 1 (in UCS) p2: measurement point 2 and start point of extension line 2 (in UCS) location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZDXF" angle: angle from ucs/wcs x-axis to dimension line in degrees text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` dimtype DIMENSIONrUdimstyledefpointr defpoint2 defpoint3angle text_rotationoverrideF)leaderrelative) r DIM_LINEARDIM_BLOCK_EXCLUSIVErfrnrrrr|update_dxf_attribsr set_location)rSbasep1p2rkrrrrrrdrcdimlinestyles rTadd_linear_dimCreatorInterface.add_linear_dim sjE,,u/H/HHI!__[U_K**+ !%!4!4X!> :!%d : Y 6"&r( ;"&r( ;#El 7  $*/ *>J '"":. <     x  F rWc d[U=(d 05n[[SU5UUUUUUUUU S9 g)a  Add multiple linear dimensions for iterable `points`. If an :class:`~ezdxf.math.UCS` is used for dimension line rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. See also: :ref:`tut_linear_dimension` This method sets many design decisions by itself, the necessary geometry will be generated automatically, no required nor possible :meth:`~ezdxf.entities.DimStyleOverride.render` call. This method is easy to use, but you get what you get. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: base: location of dimension line, any point on the dimension line or its extension will do (in UCS) points: iterable of measurement points (in UCS) angle: angle from ucs/wcs x-axis to dimension line in degrees (0 = horizontal, 90 = vertical) ucs: user defined coordinate system avoid_double_rendering: suppresses the first extension line and the first arrow if possible for continued dimension entities dimstyle: dimension style name (DimStyle table entry), default is "EZDXF" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity discard: discard rendering result for friendly CAD applications like BricsCAD to get a native and likely better rendering result. (does not work with AutoCAD) r$) rrrucsavoid_double_renderingrrrddiscardN)rnr r) rSrrrrrrrrdrs rTadd_multi_point_linear_dim+CreatorInterface.add_multi_point_linear_dimTsB`**+ $ $d +#9! rWc [U5n[U5n X- n U Rn U R5RU5U-n UR U UU UUU UUS9$)a Add linear dimension aligned with measurement points `p1` and `p2`. If an :class:`~ezdxf.math.UCS` is used for dimension line rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. See also: :ref:`tut_linear_dimension` This method returns a :class:`~ezdxf.entities.DimStyleOverride` object, to create the necessary dimension geometry, you have to call :meth:`DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: p1: measurement point 1 and start point of extension line 1 (in UCS) p2: measurement point 2 and start point of extension line 2 (in UCS) distance: distance of dimension line from measurement points text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZDXF" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` )rrrrrrrrd)r angle_deg orthogonalr:r) rSrrdistancerrrrd_p1_p2 directionrrs rTadd_aligned_dim CreatorInterface.add_aligned_dimswX2h2hI ####%//9C?""!#  rW EZ_CURVED)rkrrrrrdcS[R[R-0n URSU S9n [ U =(d 05n UR U5U S'[ U5U S'[US5U S'[US5U S '[US5U S '[US5U S '[U5U S 'Ub[U5U S 'U RU 5 [XS9n UbU RU5 U $)a Add angular :class:`~ezdxf.entities.Dimension` from two lines. The measurement is always done from `line1` to `line2` in counter-clockwise orientation. This does not always match the result in CAD applications! If an :class:`~ezdxf.math.UCS` is used for angular dimension rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: base: location of dimension line, any point on the dimension line or its extension is valid (in UCS) line1: specifies start leg of the angle (start point, end point) and determines extension line 1 (in UCS) line2: specifies end leg of the angle (start point, end point) and determines extension line 2 (in UCS) location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rrrUrrrrrr defpoint4r defpoint5rr) r DIM_ANGULARrrfrnrrrr|rruser_location_override) rSrline1line2rkrrrrrdrcrrs rTadd_angular_dim_2l#CreatorInterface.add_angular_dim_2lsnE--0I0IIJ!__[U_K**+ !%!4!4X!> : Y 6"&uQx. ;"&uQx. ;"&uQx. ;!%eAh :"&t* ;  $*/ *>J '"":. <    ( ( 2 rWcS[R[R-0n [SUR SU S95n [ U =(d 05n UR U5U S'[U5U S'[U5U S'[U5U S'[U5U S '[U5U S 'Ub[U5U S 'U RU 5 [XS 9n UbU RU5 U $) a Add angular :class:`~ezdxf.entities.Dimension` from three points (center, p1, p2). The measurement is always done from `p1` to `p2` in counter-clockwise orientation. This does not always match the result in CAD applications! If an :class:`~ezdxf.math.UCS` is used for angular dimension rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: base: location of dimension line, any point on the dimension line or its extension is valid (in UCS) center: specifies the vertex of the angle p1: specifies start leg of the angle (center -> p1) and end-point of extension line 1 (in UCS) p2: specifies end leg of the angle (center -> p2) and end-point of extension line 2 (in UCS) location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rr'rrUrrrrrrrr) r DIM_ANGULAR_3Prrrfrnrrrr|rrrrSrrxrrrkrrrrrdrcrrs rTadd_angular_dim_3p#CreatorInterface.add_angular_dim_3pstE0053L3LLM G **+ !%!4!4X!> : Y 6!%d :"&r( ;"&r( ;"&v, ;  $*/ *>J '"":. <    ( ( 2 rWc n[U5n [U5n [U5n[U5n[U5nU [X5S- -nU[R"U5X---nU[R"U 5U--nU[R"U 5U--nUR UUUUUUUU U U S9 $)a Shortcut method to create an angular dimension by (c)enter point, (r)adius and start- and end (a)ngles, the measurement text is placed at the default location defined by the associated `dimstyle`. The measurement is always done from `start_angle` to `end_angle` in counter-clockwise orientation. This does not always match the result in CAD applications! For further information see the more generic factory method :func:`add_angular_dim_3p`. Args: center: center point of the angle (in UCS) radius: the distance from `center` to the start of the extension lines in drawing units start_angle: start angle in degrees (in UCS) end_angle: end angle in degrees (in UCS) distance: distance from start of the extension lines to the dimension line in drawing units location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` r rrxrrrkrrrrrd)r|rrfrom_deg_anglerrSrxryrrrrkrrrrrdsaeaext_line_startdim_line_offsetcenter_ center_anglerrrs rTadd_angular_dim_cra$CreatorInterface.add_angular_dim_crams^;  9 v/v,.r6<< ,,\:  ,  t**2.? ? t**2.? ?&&'!'  rWcURURURURURUUUUUUUS9 $)ai Shortcut method to create an angular dimension from a :class:`~ezdxf.math.ConstructionArc`. This construction tool can be created from ARC entities and the tool itself provides various construction class methods. The measurement text is placed at the default location defined by the associated `dimstyle`. The measurement is always done from `start_angle` to `end_angle` of the arc in counter-clockwise orientation. This does not always match the result in CAD applications! For further information see the more generic factory method :func:`add_angular_dim_3p`. Args: arc: :class:`~ezdxf.math.ConstructionArc` distance: distance from start of the extension lines to the dimension line in drawing units location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rxryrrrrkrrrrrd)rrxryrr rSarcrrkrrrrrds rTadd_angular_dim_arc$CreatorInterface.add_angular_dim_arcsNV''::::mm'!(  rWcS[R[R-0n URSU S9n [ U =(d 05n UR U5U S'[ U5U S'[U5U S'[U5U S'[U5U S'[U5U S 'S U S 'S U S 'S U S'S U S'[U S'[U S'Ub[U5U S'U RU 5 [XS9n UbU RU5 U $)a4 Add :class:`~ezdxf.entities.ArcDimension` from three points (center, p1, p2). Point `p1` defines the radius and the start-angle of the arc, point `p2` only defines the end-angle of the arc. If an :class:`~ezdxf.math.UCS` is used for arc dimension rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.ArcDimension` entity between creation and rendering. .. note:: `Ezdxf` does not render the arc dimension like CAD applications and does not consider all DIMSTYLE variables, so the rendering results are **very** different from CAD applications. Args: base: location of dimension line, any point on the dimension line or its extension is valid (in UCS) center: specifies the vertex of the angle p1: specifies the radius (center -> p1) and the star angle of the arc, this is also the start point for the 1st extension line (in UCS) p2: specifies the end angle of the arc. The start 2nd extension line is defined by this angle and the radius defined by p1 (in UCS) location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` r ARC_DIMENSIONrUrrrrrrrrrr is_partial has_leader leader_point1 leader_point2rr) r DIM_ARCrrfrnrrrrr|rrrrs rTadd_arc_dim_3pCreatorInterface.add_arc_dim_3ps&zEMME,E,EEF $ !0! **+ !%!4!4X!> : Y 6!%d :"&r( ;"&r( ;"&v, ;$' =!"% ;#$ < #$ < &- ?#&- ?#  $*/ *>J '"":. <    ( ( 2 rWc n[U5n [U5n [U5n[U5n[U5nU [X5S- -nU[R"U5X---nU[R"U 5U--nU[R"U 5U--nUR UUUUUUUU U U S9 $)a Shortcut method to create an arc dimension by (c)enter point, (r)adius and start- and end (a)ngles, the measurement text is placed at the default location defined by the associated `dimstyle`. .. note:: `Ezdxf` does not render the arc dimension like CAD applications and does not consider all DIMSTYLE variables, so the rendering results are **very** different from CAD applications. Args: center: center point of the angle (in UCS) radius: the distance from `center` to the start of the extension lines in drawing units start_angle: start-angle in degrees (in UCS) end_angle: end-angle in degrees (in UCS) distance: distance from start of the extension lines to the dimension line in drawing units location: user defined location for text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rr )r|rrr r"r s rTadd_arc_dim_cra CreatorInterface.add_arc_dim_craJs`;  9 v/v,.r6<< ,,\:  ,  t**2.? ? t**2.? ?""'!#  rWcURURURURURUUUUUUUS9 $)a0 Shortcut method to create an arc dimension from a :class:`~ezdxf.math.ConstructionArc`. This construction tool can be created from ARC entities and the tool itself provides various construction class methods. The measurement text is placed at the default location defined by the associated `dimstyle`. .. note:: `Ezdxf` does not render the arc dimension like CAD applications and does not consider all DIMSTYLE variables, so the rendering results are **very** different from CAD applications. Args: arc: :class:`~ezdxf.math.ConstructionArc` distance: distance from start of the extension lines to the dimension line in drawing units location: user defined location for the text midpoint (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text text_rotation: rotation angle of the dimension text as absolute angle (x-axis=0, y-axis=90) in degrees dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_CURVED" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` r)r%rxryrrrs rTadd_arc_dim_arc CreatorInterface.add_arc_dim_arcsNX##::::mm'!$  rW EZ_RADIUS)rkrrrrdcS[R[R-0n [SUR SU S95n [ U5nUb+Uc [ S5e[ U5nX- RUS9n ODUc3Uc [ S5eUc [ S5e[ R"XC5n O[ U5U- n X-n X- n[U =(d 05n URU5U S '[ U 5U S '[ U5U S '[U5U S 'U RU 5 [XS 9nUbURU5 U$)a Add a diameter :class:`~ezdxf.entities.Dimension` line. The diameter dimension line requires a `center` point and a point `mpoint` on the circle or as an alternative a `radius` and a dimension line `angle` in degrees. If an :class:`~ezdxf.math.UCS` is used for dimension line rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: center: specifies the center of the circle (in UCS) mpoint: specifies the measurement point on the circle (in UCS) radius: specify radius, requires argument `angle`, overrides `p1` argument angle: specify angle of dimension line in degrees, requires argument `radius`, overrides `p1` argument location: user defined location for the text midpoint (in UCS) text: ``None`` or ``"<>"`` the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_RADIUS" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rr'rrUArgument radius is required.length"Argument angle or mpoint required.#Argument radius or mpoint required.rrrrr)r DIM_DIAMETERrrrfr ValueErrorr:r rnrrrrr)rSrxmpointryrrkrrrrdrcr radius_vecrrrs rTadd_diameter_dim!CreatorInterface.add_diameter_dimsSjE..1J1JJK G f  ~ !?@@H~H!+66f6EJ~=$%IJJ>$%JKK!00? !&\F2    **+ !%!4!4X!> :!%b :"&r( ; Y 6"":. <    ( ( 2 rWc b[U5nURU5nURUUUUUUS9$)a Shortcut method to create a diameter dimension by two points on the circle and the measurement text at the default location defined by the associated `dimstyle`, for further information see general method :func:`add_diameter_dim`. Center point of the virtual circle is the midpoint between `p1` and `p2`. - dimstyle "EZ_RADIUS": places the dimension text outside - dimstyle "EZ_RADIUS_INSIDE": places the dimension text inside Args: p1: first point of the circle (in UCS) p2: second point on the opposite side of the center point of the circle (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_RADIUS" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rrrrd)rlerpr5) rSrrrrrrdr3rxs rTadd_diameter_dim_2p$CreatorInterface.add_diameter_dim_2p*sEDbR$$  ! %  rWcjS[R[R-0n [SUR SU S95n [ U5nUb/Uc [ S5e[ U5nXQ- RUS9n X-nO8Uc5Uc [ S5eUc [ S5eU[ R"XC5-n[U =(d 05n URU5U S '[ U5U S '[ U5U S '[U5U S 'U RU 5 [XS 9n UbU RU5 U $)a Add a radius :class:`~ezdxf.entities.Dimension` line. The radius dimension line requires a `center` point and a point `mpoint` on the circle or as an alternative a `radius` and a dimension line `angle` in degrees. See also: :ref:`tut_radius_dimension` If a :class:`~ezdxf.math.UCS` is used for dimension line rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. Following render types are supported: - Default text location outside: text aligned with dimension line; dimension style: "EZ_RADIUS" - Default text location outside horizontal: "EZ_RADIUS" + dimtoh=1 - Default text location inside: text aligned with dimension line; dimension style: "EZ_RADIUS_INSIDE" - Default text location inside horizontal: "EZ_RADIUS_INSIDE" + dimtih=1 - User defined text location: argument `location` != ``None``, text aligned with dimension line; dimension style: "EZ_RADIUS" - User defined text location horizontal: argument `location` != ``None``, "EZ_RADIUS" + dimtoh=1 for text outside horizontal, "EZ_RADIUS" + dimtih=1 for text inside horizontal Placing the dimension text at a user defined `location`, overrides the `mpoint` and the `angle` argument, but requires a given `radius` argument. The `location` argument does not define the exact text location, instead it defines the dimension line starting at `center` and the measurement text midpoint projected on this dimension line going through `location`, if text is aligned to the dimension line. If text is horizontal, `location` is the kink point of the dimension line from radial to horizontal direction. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: center: center point of the circle (in UCS) mpoint: measurement point on the circle, overrides `angle` and `radius` (in UCS) radius: radius in drawing units, requires argument `angle` angle: specify angle of dimension line in degrees, requires argument `radius` location: user defined dimension text location, overrides `mpoint` and `angle`, but requires `radius` (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_RADIUS" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` rr'rrUr,r-r/r0rrrrr)r DIM_RADIUSrrrfrr2r:r rnrrrrr)rSrxr3ryrrkrrrrdrcrr4rs rTadd_radius_dimCreatorInterface.add_radius_dimWs@\E,,u/H/HHI G f  ~ !?@@H~H"+66f6EJ(F~=$%IJJ>$%JKK$"5"5e"DD**+ !%!4!4X!> :"&v, ;!%f : Y 6"":. <    ( ( 2 rWr8c *URUUUUUUS9$)a Shortcut method to create a radius dimension by center point, measurement point on the circle and the measurement text at the default location defined by the associated `dimstyle`, for further information see general method :func:`add_radius_dim`. - dimstyle "EZ_RADIUS": places the dimension text outside - dimstyle "EZ_RADIUS_INSIDE": places the dimension text inside Args: center: center point of the circle (in UCS) mpoint: measurement point on the circle (in UCS) text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_RADIUS" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` r8r>)rSrxr3rrrrds rTadd_radius_dim_2p"CreatorInterface.add_radius_dim_2ps/B""  ! #  rWc ,URUUUUUUUS9$)a Shortcut method to create a radius dimension by (c)enter point, (r)adius and (a)ngle, the measurement text is placed at the default location defined by the associated `dimstyle`, for further information see general method :func:`add_radius_dim`. - dimstyle "EZ_RADIUS": places the dimension text outside - dimstyle "EZ_RADIUS_INSIDE": places the dimension text inside Args: center: center point of the circle (in UCS) radius: radius in drawing units angle: angle of dimension line in degrees text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZ_RADIUS" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` )ryrrrrrdrA)rSrxryrrrrrds rTadd_radius_dim_cra#CreatorInterface.add_radius_dim_cras2F"" !#  rW)originrrrrrdc\[U5nUS;a [S5eS[R[R-[R U--0n [ SURSU S95n [U5n [U5n U [U5-n[U =(d 05n URU5U S'XS'[U5nU(aU*U S 'X- nXRU5-U S 'URU5U S '[U5U S 'U RU 5 [XS 9nU$)a Add an ordinate type :class:`~ezdxf.entities.Dimension` line. The feature location is defined in the global coordinate system, which is set as render UCS, which is the :ref:`WCS` by default. If an :class:`~ezdxf.math.UCS` is used for dimension line rendering, all point definitions in UCS coordinates, translation into :ref:`WCS` and :ref:`OCS` is done by the rendering function. Extrusion vector is defined by UCS or (0, 0, 1) by default. This method returns a :class:`~ezdxf.entities.DimStyleOverride` object - to create the necessary dimension geometry, you have to call :meth:`~ezdxf.entities.DimStyleOverride.render` manually, this two-step process allows additional processing steps on the :class:`~ezdxf.entities.Dimension` entity between creation and rendering. .. note:: `Ezdxf` does not consider all DIMSTYLE variables, so the rendering results are different from CAD applications. Args: feature_location: feature location in the global coordinate system (UCS) offset: offset vector of leader end point from the feature location in the local coordinate system dtype: 1 = x-type, 0 = y-type origin: specifies the origin (0, 0) of the local coordinate system in UCS rotation: rotation angle of the local coordinate system in degrees text: ``None`` or "<>" the measurement is drawn as text, " " (a single space) suppresses the dimension text, everything else `text` is drawn as dimension text dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZDXF" override: :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes for the DIMENSION entity Returns: :class:`~ezdxf.entities.DimStyleOverride` )rrzinvalid dtype (0, 1)rr'rrUrrhorizontal_directionrrrr)rEr r DIM_ORDINATErDIM_ORDINATE_TYPErrfrrnrr| rotate_degrrr)rSfeature_locationoffsetdtyperGrrrrrdrcrorigin_feature_location_ end_point_relative_feature_locationrs rTadd_ordinate_dim!CreatorInterface.add_ordinate_dim sLjE    67 7 u))''(&&.0   G v, !12&f5 **+ !%!4!4X!> :!(:? 3;J- .$5$?! ::8D D   #-"7"7"A ; Y 6"":. < rWc 0URUUSUUUUUUS9 $)zjShortcut to add an x-type feature ordinate DIMENSION, for more information see :meth:`add_ordinate_dim`. r rMrNrOrGrrrrrdrT rSrMrNrGrrrrrds rTadd_ordinate_x_dim#CreatorInterface.add_ordinate_x_dimv 7 $$-!%  rWc 0URUUSUUUUUUS9 $)ziShortcut to add a y-type feature ordinate DIMENSION, for more information see :meth:`add_ordinate_dim`. rrWrXrYs rTadd_ordinate_y_dim#CreatorInterface.add_ordinate_y_dim r\rWc H[R"UUUUUUS9R$N)rrrrrd)r render_arrowvec3rSrrrrrds rT add_arrowCreatorInterface.add_arrow 0"" !   $ rWc H[R"UUUUUUS9R$ra)r insert_arrowrcrds rTadd_arrow_blockref#CreatorInterface.add_arrow_blockref rgrWcS SjnUR[:a [S5e[U=(d 05nUR U5US'UR SS5 [ SURSU55nURU5 U(aNU"U5nSU;aURRUS5 [[ S U5US 9R5 U$) a The :class:`~ezdxf.entities.Leader` entity represents an arrow, made up of one or more vertices (or spline fit points) and an arrowhead. The label or other content to which the :class:`~ezdxf.entities.Leader` is attached is stored as a separate entity, and is not part of the :class:`~ezdxf.entities.Leader` itself. (requires DXF R2000) :class:`~ezdxf.entities.Leader` shares its styling infrastructure with :class:`~ezdxf.entities.Dimension`. By default a :class:`~ezdxf.entities.Leader` without any annotation is created. For creating more fancy leaders and annotations see documentation provided by Autodesk or `Demystifying DXF: LEADER and MULTILEADER implementation notes `_ . Args: vertices: leader vertices (in :ref:`WCS`) dimstyle: dimension style name (:class:`~ezdxf.entities.DimStyle` table entry), default is "EZDXF" override: override :class:`~ezdxf.entities.DimStyleOverride` attributes dxfattribs: additional DXF attributes cpUR5VVs0sHupU[;dMX_M snn$s snnfrP)items#LEADER_UNSUPPORTED_DIMSTYLE_ATTRIBS)attribskvs rT&filter_unsupported_dimstyle_attributesKCreatorInterface.add_leader..filter_unsupported_dimstyle_attributes s>$MMO+DA??+ s22zLEADER requires DXF R2000rannotation_typerr2LEADER dimldrblkr'r)rprnrrn) rYr r rnrrrrf set_verticesrR acquire_arrowrcommit)rSr rrrdrsrs rT add_leaderCreatorInterface.add_leader s@  ??W $!"=> >**+ !%!4!4X!> :/3h* EFH% =hGHh&&&x '<= [&)H fh rWc@SSKJn URX5nU"U5$)zqAdd a :class:`~ezdxf.entities.MultiLeader` entity but returns a :class:`~ezdxf.render.MultiLeaderMTextBuilder`. r)rJ)ezdxf.render.mleaderrJ_make_multileader)rSrrdrJ multileaders rTadd_multileader_mtext&CreatorInterface.add_multileader_mtext # A,,U? &{33rWc@SSKJn URX5nU"U5$)zqAdd a :class:`~ezdxf.entities.MultiLeader` entity but returns a :class:`~ezdxf.render.MultiLeaderBlockBuilder`. r)rK)r~rKr)rSrrdrKrs rTadd_multileader_block&CreatorInterface.add_multileader_block rrWc(UR[:a [S5e[U=(d 05nURR R U5nUc[SUS35eURRUS'URSUS9$)NzMULTILEADER requires DXF R2000zMLEADERSTYLE 'z' does not exist style_handle MULTILEADERrU) rYr r rnrRmleader_stylesrr rrrf)rSrrd mleader_styles rTr"CreatorInterface._make_multileader% s ??W $!"BC C**+ //33E:  .7G HI I%2%6%6%=%= >"}DDrWc>UR[:a [S5e[U=(d 05nUR SS5nUR SU5nUR URU5 URU5 U(aURU5 U$)zAdd a :class:`~ezdxf.entities.MLine` entity Args: vertices: MLINE vertices (in :ref:`WCS`) close: ``True`` to add a closed MLINE dxfattribs: additional DXF attributes zMLine requires DXF R2000 style_namerMLINE) rYr r rnrrfset_flag_stateCLOSED set_styleextend)rSr rrdrmlines rT add_mlineCreatorInterface.add_mline3 s ??W $!"<= =**+ ^^L*= w ; U\\51  #  LL " rWcSSKJn UR[:a [ S5e[ U=(d 05nUR SU5n[SSS5nXRl [U5URl XSS4-URl [SSUS:aSOS5URl X7RlX'Rl[!U5URlSURlUR'XX45n [)UR+U 55n U (aUR-U S5 U$)a Add a :class:`~ezdxf.entities.Helix` entity. The center of the helix is always (0, 0, 0) and the helix axis direction is the +z-axis. Transform the new HELIX by the :meth:`~ezdxf.entities.DXFGraphic.transform` method to your needs. Args: radius: helix radius pitch: the height of one complete helix turn turns: count of turns ccw: creates a counter-clockwise turning (right-handed) helix if ``True`` dxfattribs: additional DXF attributes r)pathzHelix requires DXF R2000HELIXrr )r"rrYr r rnrfrraxis_base_pointr|ry start_point axis_vectorturns turn_heightrE handedness constrainhelixr to_bsplines_and_verticesrV) rSrypitchrccwrdrrrpspliness rT add_helixCreatorInterface.add_helixN s2  ??W $!"<= =**+ w ;Aq!}$( ! =  $1~ 5  $Q 1r B   % "3x   JJve 1t44Q78   ) )'!* 5 rWrQ)rRr#)rr)rcrrdrnrr))rer)rrrP)rkrrr)rrrrsrrr)rxrryr|rr) rxrrrrr|rr|rr|rr*)TN) rxrryr|rr|rr|rboolrr%)rIterable[UVec]rr?)rrrrC)rrrr,)rrrOptional[float]rrrrB)rrrrrr0)rrrrrzdict[str, str]rr0)rr) rrrrrrrrrrrr&)rrrz Optional[str]rrrr9)rrrrrr9))rrN)rztuple[int, int]rr:)rr8)rcrrrrr))rrrr)rrN)rrrrrr|rr>)xyseb)rrrrrrrr1)rrrr5) r%z Iterable[str]r&r|r'r|rr|rr5) r%rr&r|r'r|rr|r-rErr5) r%rr&r|r'r|r3Sequence[float]rr5)rrrr7rrr;)rrrr7rrrG)NrN)rGOptional[Iterable[UVec]]rCrErr)rchordN)rGrrCrErLrrr)NN)rGrrTrrr)rNN)rMrrCrErNOptional[Iterable[float]]rr) rMrr_rrCrErNrrr)rr)rr<)rr@)rr)rr+)rr3)rr=)rrA)N)rrErr-)rrErz Optional[int]rr6)rr7)rN) rr/rrrztuple[float, float]rr|rr.)r rrrF)r)rrrrN)rrErrrr|rrD)rrrr)NrrNrNN)rrrrrrrkOptional[UVec]rrrr|rrrrrOptional[dict]rr)rNTrNNF)rrrrrr|rz Optional[UCS]rrrrrrrr)rrNN)rrrrrr|rrrrrrrr)rrrtuple[UVec, UVec]rrrkrrrrrrrrrrr)rrrxrrrrrrkrrrrrrrrrrr)rxrryr|rr|rr|rr|rkrrrrrrrrrrr)rrrr|rkrrrrrrrrrrr)NNN)rxrr3rryrrrrkrrrrrrrrr)rr*NN) rrrrrrrrrrrr) rxrr3rrrrrrrrr)rxrryr|rr|rrrrrrrr)rMrrNrrOrErGrrr|rrrrrrrr)rMrrNrrGrrr|rrrrrrrr)rrN) rrrrrr|rr|rr)rNN)r rrrrrrr2)rN)rrrrJ)rrrrK)rrrrH)r rrrrr4)ryr|rr|rr|rrI)Z__name__ __module__ __qualname____firstlineno__rUpropertyrYr^rfrbrorur}rtaurrrrrrrrrrrrrr staticmethodrrrrr(r.r4r<r@rIrQrXrOr`rgrkroruryr}rrrerr BYLAYERrrrrrrrrrrrrrr"r%r(r5r:r>rBrErrTrZr^rerjr{rrrrr__static_attributes__r]rWrTrMrMSs##   4 3 7;55$)5 5*%88'6'6'6 '6  '6  '6 '6^&*!2!2!2 !2  !2 # !2 !2FD D E*#'$( 33 3 " 3 385: 5E5E5E 5E  5Et $5 #'$($5 $5$5 $5  $5"$5 $5R!%$  $$$  $ $T OO O  O,:># B.>B"0  444 4  480  000  0 0d0 ... .  . .n888 8  8  8 8@ DDD D ! D DL2&:>44(,4 4*04 (,((  (Z + "+ +  +  + `.2 "+  0+/ &)   <+/ &!  )  B9;< < D B D A14$]]$( !7!7"!7  !7F 3$ $4$4$4+ $4  $4 $4L&! #(##  # #J$()-#'II I  I ! I  II'II!I I^!'+#'< < <  <  < !% < < !<  < F#': :  :  :  :  : !:  : D$()-##'LL!L! L ! LL'LL!L Lj$()-##'OOO  O  O!OO'OO!O Or$()-##'H H H  H  H  H !H H 'H H !H  H ^$()-##'7 7 7 ! 7  7 '7 7 !7  7 @$()-##'XXX  X  X!XX'XX!X XD$()-##'I I I  I  I  I !I I 'I I !I  I `$()-##'8 8 8 ! 8  8 '8 8 !8  8 z"&"&!% Y$(##'YYY Y  Y!YYY!Y Y~##'+ +  +  +  + ! +  + `"&"&!% m$(##'mmm m  m!mmm!m mh##'( ( (  (  ( !(  ( `##'+ + +  +  + + !+  + f#'WWW W  WWWW!W W|#'         !   B#'         !   @     *     ( #' 7 77! 7  7v  4 4 ! 4   4 4 ! 4" E E  E .2 *   @  ,,, , ,,rWrM>dimblkdimblk1dimblk2)\ __future__rtypingrrrrrrloggingr ezdxf.lldxfr ezdxf.lldxf.constr r r r ezdxf.mathrrrrrrrrezdxf.render.arrowsrezdxf.entitiesrrrrrrrezdxf.entities.mtext_columnsezdxf.entities.dimstyleoverriderezdxf.render.dim_linearr ezdxf.toolsr! getLoggerrezdxf.documentr# ezdxf.eztypesr$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIr~rJrKrMror]rWrTrs# NN   'NNN*<@   7 #&/&&&&&&&&&&N g(g(TQ'G#rW