hjUddlmZddlmZmZmZmZddlmZm Z ddl m Z ddl m Z ddlmZddlmZmZmZmZmZddl mZdd lmZdd lmZmZmZmZmZmZm Z dd l!m"Z"m#Z#m$Z$dd l%m&Z&m'Z'd dl(m)Z)m*Z*m+Z+m,Z,er$ddl-m.Z.ddl/m0Z0ddl m1Z1ddl2m3Z3ddl4m5Z5ddl m6Z6gdZ7hdZ8ededdejredddejtedd dejve!ed"ddejxe!ed#d$edejzej|%ed&d'edej~e%ed(ded)ed*ed+ed,ed+ed-edej.ed/ed+ed0ed+ed1ed+ed2ed d3ed4ed+d5ZAd6eBd7<eeAZCdBd8ZDGd9d:e)ZEe jGd;dZIdEd?ZJdFd@ZKyA)G) annotations) TYPE_CHECKINGOptionalIterableAny)Self TypeGuard)factory)options) validator)DXFAttr DXFAttributes DefSubclassRETURN_DEFAULTgroup_code_mapping)colors)const)DXF12DXF2000DXF2004DXF2007DXF2013SUBCLASS_MARKERTRANSPARENCY_BYBLOCK)OCSMatrix44UVec)load_proxy_graphicexport_proxy_graphic) DXFEntity base_classSubclassProcessor DXFTagStorage)Auditor)Drawing) DXFNamespace) BaseLayout)AbstractTagWriter)xref) DXFGraphic acdb_entityacdb_entity_group_codesSeqEnd add_entityreplace_entityelevation_to_z_axisis_graphic_entity get_font_name>colorlayerltscalelinetype color_name lineweight true_color transparency AcDbEntity0)defaultr BYLAYERT)r?optionalr >)r?rBr fixerCir)r? dxfversionrBr rE0g?<)r?rHrBi)rHrBii)rHrBr ii[i\i|)rHr?rBi)r5r7r4 paperspacer9r6 invisibler:r8r; shadow_modematerial_handlevisualstyle_handleplotstyle_enumplotstyle_handlerr,c|jdrq|j}|jd|dk(ry|D]H}|j|}||jdk(s'|j ||j |Jyy)N elevationr)z)hasattrrSdiscardgetrTsetreplace)dxfnamesrSnamevs 5lib/python3.12/site-packages/ezdxf/entities/dxfgfx.pyr1r1su {{;MM  K > D A }aii)i45 c6eZdZUdZdZddiZded<eee Z d, d-fd Z d.dZ e d/d Zejd0d Zej d.d Ze d1d Zejd2d Ze d3dZe d3dZd4dZd5dZd6d7dZd8dZd9dZd9dZd:dZd.dZ d, d;dZddZd?dZ e d3dZ!d@dZ"dAdZ#dBd Z$dCd!Z%dDd"Z&dDd#Z'dDd$Z(d3d%Z) dE dFd&Z*dGd'Z+d,dHfd( Z,dId)Z-dJfd* Z.dKfd+ Z/xZ0S)Lr+zCommon base class for all graphic entities, a subclass of :class:`~ezdxf.entities.dxfentity.DXFEntity`. These entities resides in entity spaces like modelspace, paperspace or block. DXFGFXr5r>zdict[str, Any]DEFAULT_ATTRIBScBt||}||S|j}|jtj rG|j r|j tkrd}nd}t|j|rdnd||_ |j|td|S)zAdds subclass processing for 'AcDbEntity', requires previous base class processing by parent class. (internal API) \rr ) length_code) superload_dxf_attribsr12 append_base_class_to_acdb_entityr load_proxy_graphicsrHrr subclasses proxy_graphicfast_load_dxfattribsr-)self processorrZricode __class__s r^rhzDXFGraphic.load_dxf_attribssg&y1  Jmm224  & &## (<(B; r_c|jjdr.tj|jj dSy)zKReturns RGB true color as (r, g, b) tuple or None if true_color is not set.r:N)rZrUclrint2rgbrWrws r^rgbzDXFGraphic.rgbs5 88  L );;txx||L9: :r_cb|jjdtj|y)zSet RGB true color as (r, g , b) tuple e.g. (12, 34, 56). Raises: TypeError: input value `rgb` has invalid type r:N)rZrXrzrgb2int)ror|s r^r|zDXFGraphic.rgbs  \3;;s#34r_c:|jjdy)zDelete RGB true color value.r:N)rZrVrws r^r|zDXFGraphic.rgbs &r_c|jjdrO|jjd}tj|r|t zryt j|Sy)zGet transparency as float value between 0 and 1, 0 is opaque and 1 is 100% transparent (invisible). Transparency by block returns always 0. r;g)rZrUrWr is_transparencyrrztransparency2float)rovalues r^r;zDXFGraphic.transparencysV 88  N +HHLL0E((///--e44r_cb|jjdtj|y)ztSet transparency as float value between 0 and 1, 0 is opaque and 1 is 100% transparent (invisible). r;N)rZrXrzfloat2transparency)ror;s r^r;zDXFGraphic.transparencys!  ^S%;%;L%IJr_c:|jjd S)z|S)zReturns the important common properties layer, color, linetype, lineweight, ltscale, true_color and color_name as `dxfattribs` dict. )dictGRAPHIC_PROPERTIESrZrUrW)roattribskeys r^graphic_propertieszDXFGraphic.graphic_propertiessD&%Cxx$#xx||C0 &r_c|jjdr(|jjdd}t|StS)zReturns object coordinate system (:ref:`ocs`) for 2D entities like :class:`Text` or :class:`Circle`, returns a pass-through OCS for entities without OCS support. extrusion)rrr )r?)rZ is_supportedrWr)rors r^ocszDXFGraphic.ocs"s= 88  - [) DIy> !5Lr_c||j_|r||j_y|jjdy)z7Set owner attribute and paperspace flag. (internal API)rKN)rZownerrKrV)rorrKs r^ set_ownerzDXFGraphic.set_owner.s. ",DHH  HH  \ *r_cy)zStore linked or attached entities. Same API for both types of appended data, because entities with linked entities (POLYLINE, INSERT) have no attached entities and vice versa. (internal API) N)roentitys r^ link_entityzDXFGraphic.link_entity6s r_c&|j|y)z7Export entity specific data as DXF tags. (internal API)N)export_acdb_entity)ro tagwriters r^ export_entityzDXFGraphic.export_entity?s  *r_cN|jtkD}|r$|jttj |j j|gd|jrB|r?tjr.t|j||jtkrdndyyyy)z8Export subclass 'AcDbEntity' as DXF tags. (internal API))rKr5r7rNr4r9r6rLr:r8r;rPrQrMrOrdre)rrfN) rHr write_tag2rr,r\rZexport_dxf_attribsrmr store_proxy_graphicsrr)rornot_r12s r^rzDXFGraphic.export_acdb_entityEs&&.   +2B2B C ##   *   'g.J.J ""##,#7#7'#ARs /K' r_c|jj |jy |jjj |jjS#t j $rYnwxYw |jjj|jjS#t j$rYywxYw)zfReturns the owner layout or returns ``None`` if entity is not assigned to any layout. N) rZrrtlayoutsget_layout_by_keyr DXFKeyErrorblocksget_block_layout_by_handleDXFTableEntryErrorrws r^ get_layoutzDXFGraphic.get_layoutis 88>> !TXX%5 88##55dhhnnE E      88??==dhhnnM M''  s#8AA43A488B11CCc|js td|jd|j_y|j }|r|j |yy)a- Unlink entity from associated layout. Does nothing if entity is already unlinked. It is more efficient to call the :meth:`~ezdxf.layouts.BaseLayout.unlink_entity` method of the associated layout, especially if you have to unlink more than one entity. z Can not unlink destroyed entity.N)is_alive TypeErrorrtrZrr unlink_entity)rolayouts r^unlink_from_layoutzDXFGraphic.unlink_from_layoutxsQ}}>? ? 88 !DHHN "    & r_cz|'|j}|tjd|j||y)a Move entity from model space or a paper space layout to another layout. For block layout as source, the block layout has to be specified. Moving between different DXF drawings is not supported. Args: layout: any layout (model space, paper space, block) source: provide source layout, faster for DXF R12, if entity is in a block layout Raises: DXFStructureError: for moving between different DXF drawings Nz#Source layout for entity not found.)rr DXFValueErrormove_to_layout)rorsources r^rzDXFGraphic.move_to_layouts< >__&F~))*OPPdF+r_c|j|jk7rtjd|j}|j ||S)a_ Copy entity to another `layout`, returns new created entity as :class:`DXFEntity` object. Copying between different DXF drawings is not supported. Args: layout: any layout (model space, paper space, block) Raises: DXFStructureError: for copying between different DXF drawings z8Copying between different DXF drawings is not supported.)rtrDXFStructureErrorcopyr/)ror new_entitys r^copy_to_layoutzDXFGraphic.copy_to_layoutsK 88vzz !))J YY[ *%r_cP|j|jusJd|jsyt| ||j ||j }|j dr|j||j dr|j||j dr|j||j dr|j||j dr|j||j dr|j|yy) aJAudit and repair graphical DXF entities. .. important:: Do not delete entities while auditing process, because this would alter the entity database while iterating, instead use:: auditor.trash(entity) to delete invalid entities after auditing automatically. z#Auditor for different DXF document.Nr5r7r4r9rr;) rtrrgauditcheck_owner_existrZrUcheck_for_valid_layer_namecheck_entity_linetypecheck_entity_color_indexcheck_entity_lineweightcheck_extrusion_vectorcheck_transparency)roauditorrZrrs r^rzDXFGraphic.auditsxx7;;&M(MM&}}   g!!$'hh ;;w   . .t 4 ;;z "  ) )$ / ;;w   , ,T 2 ;;| $  + +D 1 ;;{ #  * *4 0 ;;~ &  & &t , 'r_ct)zInplace transformation interface, returns `self` (floating interface). Args: m: 4x4 transformation matrix (:class:`ezdxf.math.Matrix44`) )NotImplementedErrorroms r^ transformzDXFGraphic.transforms "##r_cT|j|jj|yy)zBShould be called if the main entity transformation was successful.N)xdatarrs r^post_transformzDXFGraphic.post_transforms# :: ! JJ  # "r_c|jduS)z)Check if post transform call is required.N)rrws r^is_post_transform_requiredz%DXFGraphic.is_post_transform_requiredszz%%r_cN|jtj|||S)zTranslate entity inplace about `dx` in x-axis, `dy` in y-axis and `dz` in z-axis, returns `self` (floating interface). Basic implementation uses the :meth:`transform` interface, subclasses may have faster implementations. )rr translate)rodxdydzs r^rzDXFGraphic.translates"~~h00R<==r_cN|jtj|||S)zScale entity inplace about `dx` in x-axis, `dy` in y-axis and `dz` in z-axis, returns `self` (floating interface). rrscale)rosxsyszs r^rzDXFGraphic.scales ~~hnnRR899r_cJ|jtj|S)zzScale entity inplace uniform about `s` in x-axis, y-axis and z-axis, returns `self` (floating interface). r)ross r^ scale_uniformzDXFGraphic.scale_uniforms~~hnnQ/00r_cL|jtj||S)zRotate entity inplace about vector `axis`, returns `self` (floating interface). Args: axis: rotation axis as tuple or :class:`Vec3` angle: rotation angle in radians )rr axis_rotate)roaxisangles r^ rotate_axiszDXFGraphic.rotate_axiss ~~h224?@@r_cJ|jtj|S)zRotate entity inplace about x-axis, returns `self` (floating interface). Args: angle: rotation angle in radians )rrx_rotaterors r^rotate_xzDXFGraphic.rotate_x ~~h//677r_cJ|jtj|S)zRotate entity inplace about y-axis, returns `self` (floating interface). Args: angle: rotation angle in radians )rry_rotaters r^rotate_yzDXFGraphic.rotate_yrr_cJ|jtj|S)zRotate entity inplace about z-axis, returns `self` (floating interface). Args: angle: rotation angle in radians )rrz_rotaters r^rotate_zzDXFGraphic.rotate_zrr_cLt|jxrd|jvS)z5Returns ``True`` if entity has an attached hyperlink.PE_URL)boolrrws r^ has_hyperlinkzDXFGraphic.has_hyperlink$sDJJ>  $ 3 3  r_ct|||j}|j|j|j |j |j|jdy)z5Register required resources to the resource registry.rNN) rgregister_resourcesrZ add_layerr5 add_linetyper7 add_handlerW)roregistryrZrrs r^rzDXFGraphic.register_resourceswsU "8,hh399%cll+CGG$567r_ct||||j|jj|j_|jj }|dr4|j |jj|j_|dr4|j|jj|j_ |jjd|jjdy)z3Translate resources from self to the copied entity.r7rNrOrQN) rg map_resources get_layerrZr5rU get_linetyper7 get_handlerNrV)roclonemapping attrib_existrrs r^rzDXFGraphic.map_resourcess eW-!++DHHNN; xx''  #!(!5!5dhh6G6G!HEII  ) *(/(:(:488;S;S(TEII %  ./ ,-r_NrpzOptional[SubclassProcessor]returnr')r None)r ztuple[int, int, int] | None)r|zclr.RGB | tuple[int, int, int]r r!)r float)r;r"r r!)r r)r r)r r)r)r Optional[str]rKintr r!)rr!r r!)rr)r r!)r Optional[BaseLayout])rr(rr%r r!)rr(r r)rr%r r!)rrr r)rrr r!)rr"rr"rr"r r)rr"rr"rr"r r)rr"r r)rrrr"r r)rr"r r)NN)rrrr#rr#)r ztuple[str, str, str])r zOptional[Drawing]r r!)r rr r)rz xref.Registryr r!)rrrzxref.ResourceMapperr r!)1__name__ __module__ __qualname____doc__DXFTYPErb__annotations__rr"r, DXFATTRIBSrhrxpropertyr|setterdeleterr;rrrrrrrrrrrrrrrrrrrrrrrrrrrrrr __classcell__rrs@r^r+r+s G'.nO^4z;7J8<4 <   ZZ55 [[''  KK 44GG + + "H ',BF, ,*>, ,,*-@$$ &&>: 1 A888=&*"& # * +-(.8 . .r_r+c.eZdZdZ d dfd ZxZS)r.SEQENDc^tt| |}|r|j|t|S)z!Loading interface. (internal API))rgr+rhsimple_dxfattribs_loaderr-)rorprZrrs r^rhzSeqEnd.load_dxf_attribss/ J6yA   . .s4K L r_rr)r&r'r(r*rhr0r1s@r^r.r.s'G8<4 r_r.c|jjJ|J|jr tj||j|j |y)zEAdd `entity` entity to the entity database and to the given `layout`.N)rZhandlertr bindr/)rrs r^r/r/sK ::   $$ $    zz VVZZ( fr_cL|jjJ|J|jj|j_||vrO|j||jr t j ||j|j |y|jy)zAdd `target` entity to the entity database and to the given `layout` and replace the `source` entity by the `target` entity. N)rZr7 delete_entityrtr r8r/destroy)rtargetrs r^r0r0s ::   $$ $    ))FJJ V$ :: LL ,&!r_c`t|tryt|tr |jryy)zReturns ``True`` if the `entity` has a graphical representations and can reside in the model space, a paper space or a block layout, otherwise the entity is a table or class entry or a DXF object from the OBJECTS section. TF) isinstancer+r$r2)rs r^r2r2s) &*%&-(V-E-E r_chtj}|j}||S |jj dtj } |jj |}|jjS#tj $r|cYSwxYw#tj$r|cYSwxYw)zReturns the font name of any DXF entity. This function always returns a font name even if the entity doesn't support text styles. The default font name is "txt". style) rDEFAULT_TEXT_FONTrtrZrWDEFAULT_TEXT_STYLEDXFAttributeErrorstylesfontr)r font_namert style_namer@s r^r3r3s ''I **C {ZZ^^GU-E-EF  z*yy~~  " "  # #s#*A> 0B>BBB10B1N)rZr'r[z Iterable[str])rr+rr(r r!)rr+r<r+rr(r r!)rr!r zTypeGuard[DXFGraphic])rr!r r)L __future__rtypingrrrrtyping_extensionsrr ezdxf.entitiesr ezdxfr ezdxf.lldxfr ezdxf.lldxf.attributesr rrrrrrzrezdxf.lldxf.constrrrrrrr ezdxf.mathrrrezdxf.proxygraphicrr dxfentityr!r"r#r$ ezdxf.auditr%ezdxf.documentr&r' ezdxf.layoutsr(ezdxf.lldxf.tagwriterr)r*__all__ris_valid_layer_nameis_valid_table_nameis_valid_aci_coloris_integer_boolis_valid_lineweightfix_lineweight is_positiverr,r+r-r1r+register_entityr.r/r0r2r3rr_r^r`s(#99-"! +*GNN#&+(7  'C93P3PQ 33   22   //   33**   ++  RwNcgEcgE //  swF"37TJ%cgM"#'1tT$CGdKWPS [Sh-[968\.\.~  Z    r_