Og*oddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl Z ddl Z ddlmZddlmZmZmZmZmZmZmZddlmZmZmZmZmZddlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)dd l*m+Z+m,Z,dd l-m.Z.dd l/m0Z0dd l1m2Z2ddl3m4Z4m5Z5ddl6m7Z7m8Z8m9Z9m:Z:ddl;mZ>er$ddl1m?Z?ddl-m@Z@mAZAmBZBddlCmDZDmEZEddlFmGZGddlHmIZIdgZJe jdZLdZMededddedejed ej!ed"dded#ddeje$ed%ddeje$ed&ddeje$ed'dded(ddeje$ed)ddeje$ed*dded+dded,eje#deje-d. ZTeeTZUee:eUZVe.jGd/de<ZXy)0) annotations) TYPE_CHECKINGIterableIteratorcastUnionOptionalCallable)SelfN) validator)DXFAttr DXFAttributes DefSubclassXTypeRETURN_DEFAULTgroup_code_mappingmerge_group_code_mappings)DXF12SUBCLASS_MARKER DXFValueError DXFKeyErrorDXFStructureError)Vec3UVecX_AXISY_AXISZ_AXISMatrix44UCSNULLVEC)InsertTransformationErrorInsertCoordinateSystem)explode_block_reference virtual_block_reference_entities)factory) EntityQuery) AuditError) base_classSubclassProcessor) DXFGraphic acdb_entityelevation_to_z_axisacdb_entity_group_codes)LinkedEntities)Attrib)Auditor) DXFNamespaceAttDef DXFEntity) BaseLayout BlockLayout)AbstractTagWriter)xrefInsertezdxfg& .>AcDbBlockReferenceBT)defaultoptional )xtype&))r=r>r fixer*+2FG,-)rAr=r>r rD) attribs_follownameinsert elevationxscaleyscalezscalerotation column_count row_countcolumn_spacing row_spacing extrusionceZdZdZdZeeeeZ e d(dZ e d)dZ d* d+fd Z d,fd Zd-fd Zd.fd Zd/fd Ze d)d Ze d)d Zd0d Zd1dZd)dZ d2 d3dZ d4 d5dZ d6 d7dZ d8 d9dZd6d:dZ d; ddZd?dZd@dZ dAdZ!dZ"d>dZ# d*dd dBdZ$dCd Z%ddd! dDd"Z&e dEd#Z'dFd$Z(dGd%Z)dHfd& Z*dId'Z+xZ,S)Jr9aDDXF INSERT entity The INSERT entity is hard owner of its ATTRIB entities and the SEQEND entity: ATTRIB.dxf.owner == INSERT.dxf.handle SEQEND.dxf.owner == INSERT.dxf.handle Note: The ATTDEF entity in block definitions is owned by the BLOCK_RECORD like all graphical entities. INSERTc|jSN) _sub_entitiesselfs Z/var/www/html/public_html/myphp/venv/lib/python3.12/site-packages/ezdxf/entities/insert.pyattribszInsert.attribss!!!c>tt|jSr])boollenrbr_s rarMzInsert.attribs_followsC %&&rcNctt| |}|r.|j|t|j r t |d|S)z!Loading interface. (internal API))rO)superr+load_dxf_attribssimple_dxfattribs_loadermerged_insert_group_codesr12r-)r` processordxf __class__s rarizInsert.load_dxf_attribss@ J6yA   . .s4M N}}#C5 rcct|||jtkDr_|jj dkDs|jj dkDr|jtdn|jtd|jr|jdd|jj|gdy)z(Export entity specific data as DXF tags.r(AcDbMInsertBlockr;r<) rNrOrQrRrSrTrUrVrWrXrYN) rh export_entity dxfversionrrnrUrV write_tag2rrMexport_dxf_attribsr` tagwriterros rarrzInsert.export_entitys i(   % '%%)txx/A/AA/E$$_6HI$$_6JK     Q ' ##   rccht||jr|jfdyy)Nc&|jSr]) export_dxf)erws raz#Insert.export_dxf..s Y0Grc)rhrzrMprocess_sub_entitiesrvs `rarzzInsert.export_dxfs- 9%     % %&G H rccnt|||j|jjyr])rhregister_resourcesadd_block_namernrN)r`registryros rarzInsert.register_resourcess& "8, .rcct||||j|jj|j_yr])rh map_resourcesget_block_namernrN)r`clonemappingros rarzInsert.map_resourcess0 eW- // > rccB|jjdr|jjdk7ry|jjdr|jjdk7ry|jjdr|jjdk7ryy)z3Returns ``True`` if scaling is applied to any axis.rQr(TrRrSF)rnhasattrrQrRrSr_s ra has_scalingzInsert.has_scalingss 88  H %$((//Q*> 88  H %$((//Q*> 88  H %$((//Q*>rcct|jjt|jjcxk(xr"t|jjk(ScS)zReturns ``True`` if the scale factor is uniform for x-, y- and z-axis, ignoring reflections e.g. (1, 1, -1) is uniform scaling. )absrnrQrRrSr_s rahas_uniform_scalingzInsert.has_uniform_scalingsA 488??#s488??';Ss488???SSSSSrcc|dk(r td||j_||j_||j_|S)zSet a uniform scale factor.rzInvalid scale factor.) ValueErrorrnrQrRrS)r`factors ra set_scalezInsert.set_scale s; Q;45 5    rcc|jr9|jjj|jjSy)z;Returns the associated :class:`~ezdxf.layouts.BlockLayout`.N)docblocksgetrnrNr_s rablockz Insert.blocks- 8888??&&txx}}5 5rccT|j}||jjSy)zGReturn ``True`` if the INSERT entity represents a XREF or XREF_OVERLAY.F)r block_recordis_xrefr`rs rarzInsert.is_xrefs(   %%-- -rcc|||j_|Rt|dk7r td|\}}}||j_||j_||j_|||j_|S)a) Set the location, scaling and rotation attributes. Arguments which are ``None`` will be ignored. Args: insert: insert location as (x, y [,z]) tuple scale: (x-scale, y-scale, z-scale) tuple rotation : rotation angle in degrees z-Argument scale has to be a (x, y[, z]) tuple.)rnrOrfrrQrRrSrT)r`rOscalerTxyzs raplacez Insert.placesu  $DHHO  5zQ#$STTGAq!DHHODHHODHHO   (DHH  rcc |\}}||j_||j_ |\}}||j_||j_|S#t$r tdwxYw#t$r tdwxYw)aPPlace block reference in a grid layout, grid `size` defines the row- and column count, `spacing` defines the distance between two block references. Args: size: grid size as (row_count, column_count) tuple spacing: distance between placing as (row_spacing, column_spacing) tuple z1Size has to be a (row_count, column_count) tuple.z8Spacing has to be a (row_spacing, column_spacing) tuple.)rrrnrVrUrXrW)r`sizespacingrowscolsrX col_spacings ragridz Insert.grid<s UJD$" $ '. $K +"-  U ST T U  J  sAA+A(+BFc:|jD]}||jjk(s|cS|rk|j_|jj|jj }|j D]}||jjk(s|cSy)aGet an attached :class:`Attrib` entity with the given `tag`, returns ``None`` if not found. Some applications do not attach constant ATTRIB entities, set `search_const` to ``True``, to get at least the associated :class:`AttDef` entity. Args: tag: tag name of the ATTRIB entity search_const: search also const ATTDEF entities N)rbrntagrrrNget_const_attdefs)r`r search_constattribrattdefs ra get_attribzInsert.get_attribXsll Ffjjnn$   DHH0HHOODHHMM2E113 "&**..(!M "rccZ|j||}||S|jjS)aGet content text of an attached :class:`Attrib` entity with the given `tag`, returns the `default` value if not found. Some applications do not attach constant ATTRIB entities, set `search_const` to ``True``, to get content text of the associated :class:`AttDef` entity. Args: tag: tag name of the ATTRIB entity default: default value if ATTRIB `tag` is absent search_const: search also const ATTDEF entities )rrntext)r`rr=rrs raget_attrib_textzInsert.get_attrib_textos,l3 >Nzzrcc*|j||duS)aReturns ``True`` if the INSERT entity has an attached ATTRIB entity with the given `tag`. Some applications do not attach constant ATTRIB entities, set `search_const` to ``True``, to check for an associated :class:`AttDef` entity with constant content. Args: tag: tag name fo the ATTRIB entity search_const: search also const ATTDEF entities N)r)r`rrs ra has_attribzInsert.has_attribssL1==rcct|xsi}||d<||d<||d<td|jd|}|jj ||j |j |S)aAttach an :class:`Attrib` entity to the block reference. Example for appending an attribute to an INSERT entity:: e.add_attrib('EXAMPLETAG', 'example text').set_placement( (3, 7), align=TextEntityAlignment.MIDDLE_CENTER ) Args: tag: tag name of the ATTRIB entity text: content text as string insert: insert location as (x, y[, z]) tuple in :ref:`OCS` dxfattribs: additional DXF attributes for the ATTRIB entity rrrOr0ATTRIB)dictr_new_compound_entityrbappendseqend new_seqend)r`rrrO dxfattribsrs ra add_attribzInsert.add_attribsw$**+  5! 6% 8h 9 9(J OP F# ;;  OO  rcct|jD]=\}}|jj|k(s |j|=|j y|s t |y)aDelete an attached :class:`Attrib` entity from INSERT. Raises an :class:`DXFKeyError` exception, if no ATTRIB for the given `tag` exist if `ignore` is ``False``. Args: tag: tag name of the ATTRIB entity ignore: ``False`` for raising :class:`DXFKeyError` if ATTRIB `tag` does not exist. Raises: DXFKeyError: no ATTRIB for the given `tag` exist N) enumeraterbrnrdestroyr)r`rignoreindexrs ra delete_attribzInsert.delete_attribs^'t||4 ME6zz~~$LL'    c" "rccn|jsy|jD]}|jg|_y)zBDelete all :class:`Attrib` entities attached to the INSERT entity.N)is_aliverbrr^)r`rs radelete_all_attribszInsert.delete_all_attribss1}} ll F NN  rcc\|j}tt|j|j|j |j f|j|j} |j|t}|j|_|j|_|j|_|j|_|j|_|j|_|jD]}|j||j!||S#t$r tdwxYw)aTransform INSERT entity by transformation matrix `m` inplace. Unlike the transformation matrix `m`, the INSERT entity can not represent a non-orthogonal target coordinate system and an :class:`InsertTransformationError` will be raised in that case. )rOrrTrYzJINSERT entity can not represent a non-orthogonal target coordinate system.)rnr"rrOrQrRrSrTrY transformABS_TOLr!scale_factor_xscale_factor_yscale_factor_zrbpost_transform)r`mrn source_system target_systemrs rarzInsert.transformshh. #::szz3::6\\mm   )33Aw?M #)) $-- %// "11 "11 "11 ll F   Q   A ) +\  s %DD+c|j}|jt||||j|jj z|j_|j D]}|j||||S)zgOptimized INSERT translation about `dx` in x-axis, `dy` in y-axis and `dz` in z-axis. )ocsfrom_wcsrto_wcsrnrOrb translate)r`dxdydzrrs rarzInsert.translatesl hhj,,tBB'7#**TXX__:U'UVll )F   RR ( ) rcc|j}|j}|j}|j}|j }|j }t |jt}t |jt}tj||z||z||z} tj|j} | r| tj|| z} |j|j!dt"} |j%} | 2| | j'| j$jj(z} | j+d| j,| S)zReturns a transformation matrix to transform the block entities from the block reference coordinate system into the :ref:`WCS`. )uxuyuzrOr)rnrQrRrSrrrrrrrucsmathradiansrT axis_rotaterr rtransform_direction base_pointset_rowxyz) r`rnsxsyszrrYrrranglerO block_layouts ramatrix44zInsert.matrix44shh ZZ ZZ ZZhhjFF #**V$ % #**V$ % LLBGRIN C S\\*  %%i7 7ACGGHg67zz|  # a++L,>,>,B,B,M,MN NF !VZZ rccH|j}t}||_|S)zaReturns the block reference coordinate system as :class:`ezdxf.math.UCS` object. )rrmatrix)r`rrs rarz Insert.ucss" MMOe  rcct|j_|jjd|jjdy)zReset block reference attributes location, rotation angle and the extrusion vector but preserves the scale factors. rTrYN)r rnrOdiscardr_s rareset_transformationzInsert.reset_transformation#s3 " $ %rc) redraw_orderc\||j}| tdt|||S)a7Explodes the block reference entities into the target layout, if target layout is ``None``, the layout of the block reference will be used. This method destroys the source block reference entity. Transforms the block entities into the required :ref:`WCS` location by applying the block reference attributes `insert`, `extrusion`, `rotation` and the scale factors `xscale`, `yscale` and `zscale`. Attached ATTRIB entities are converted to TEXT entities, this is the behavior of the BURST command of the AutoCAD Express Tools. .. warning:: **Non-uniform scale factors** may lead to incorrect results some entities (TEXT, MTEXT, ATTRIB). Args: target_layout: target layout for exploded entities, ``None`` for same layout as source entity. redraw_order: create entities in ascending redraw order if ``True`` Returns: :class:`~ezdxf.query.EntityQuery` container referencing all exploded DXF entities. z7INSERT without layout assignment, specify target layout) target_layoutr) get_layoutrr#)r`rrs raexplodezInsert.explode,sB:   OO-M$'M'  L  rcc"|jS)zImplements the SupportsVirtualEntities protocol. This protocol is for consistent internal usage and does not replace the method :meth:`virtual_entities`! Ignores the redraw-order! )virtual_entitiesr_s ra__virtual_entities__zInsert.__virtual_entities__Ss $$&&rcskipped_entity_callbackrc#\Kt|||D]}|j||yw)a Yields the transformed referenced block content as virtual entities. This method is meant to examine the block reference entities at the target location without exploding the block reference. These entities are not stored in the entity database, have no handle and are not assigned to any layout. It is possible to convert these entities into regular drawing entities by adding the entities to the entities database and a layout of the same DXF document as the block reference:: doc.entitydb.add(entity) msp = doc.modelspace() msp.add_entity(entity) .. warning:: **Non-uniform scale factors** may return incorrect results for some entities (TEXT, MTEXT, ATTRIB). This method does not resolve the MINSERT attributes, only the sub-entities of the first INSERT will be returned. To resolve MINSERT entities check if multi insert processing is required, that's the case if the property :attr:`Insert.mcount` > 1, use the :meth:`Insert.multi_insert` method to resolve the MINSERT entity into multiple INSERT entities. This method does not apply the clipping path created by the XCLIP command. The method returns all entities and ignores the clipping path polygon and no entity is clipped. The `skipped_entity_callback()` will be called for all entities which are not processed, signature: :code:`skipped_entity_callback(entity: DXFEntity, reason: str)`, `entity` is the original (untransformed) DXF entity of the block definition, the `reason` string is an explanation why the entity was skipped. Args: skipped_entity_callback: called whenever the transformation of an entity is not supported and so was skipped redraw_order: yield entities in ascending redraw order if ``True`` rN)r$set_source_block_reference)r`rrr{s rarzInsert.virtual_entities[s;^2 $;%  A  ( ( .G  s*,c|jjr|jjnd|jjr|jjzSdzS)zvReturns the multi-insert count, MINSERT (multi-insert) processing is required if :attr:`mcount` > 1. r()rnrXrVrWrUr_s ramcountz Insert.mcountsO '+hh&:&:""%)XX%<%.transform_attached_attrib_entitiess* .. , !!V+! ,rcc|j}|xj|z c_|jd|jd|jd|jdy)NrVrUrXrW)rnrOr)rOrrns raadjust_dxf_attribsz/Insert.multi_insert..adjust_dxf_attribssJ**C JJ& J KK $ KK ' KK & KK( )rcN) setrnrXrWrTrangerVrUradd rotate_degcopy) r`rrdonerXrrTrowcolrrOs ra multi_insertzInsert.multi_inserts  , *uhh** hh-- 88$$++, !CTXX223 !cK/{1BC%HHV$!'!2!28!<!YY[F&vv66vvF L ! !s B-C?0AC?cdfd dfd }jj|S)a Attach 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 location of the block reference, which is identical to the block base point. This method avoids the wrapper block of the :meth:`~ezdxf.layouts.BaseLayout.add_auto_blockref` method, but the visual results may not match the results of CAD applications, especially for non-uniform scaling. If the visual result is very important to you, use the :meth:`add_auto_blockref` method. Args: values: :class:`~ezdxf.entities.Attrib` tag values as ``tag/value`` pairs c|jd}j|d}||jdd}|jd}|||fS)NrrrO)popr)rrrlocationvaluess raunpackz'Insert.add_auto_attribs..unpacksQ..'C::c4(D|!~~fb1!~~h/Hh& &rccjD]}|jddh}d|vr#tjdt |d>d|vr#tjdt |de |\}}} j ||||}|j r(|j}||_|j||jy) Nprompthandle)droprz Skipping z#: missing mandatory 'tag' attributerOz&: missing mandatory 'insert' attribute) attdefsrloggerwarningstrrhas_embedded_mtext_entityvirtual_mtext_entityr embed_mtextr) rrrrrrmtextrrr`rs raautofillz)Insert.add_auto_attribs..autofills&..0 $#..Xx4H.I  *NN#CK=0ST:-NN#CK=0VW&,Z&8#T8dHjI33"779E!%EJ&&u-  #1 $rc)returnztuple[str, str, UVec]r None)rr)r`rrrrrs`` @@@raadd_auto_attribszInsert.add_auto_attribss:( ' $ $6zz|  # A J rcct|||j}|r|jr|jj }|@|j tjdt|d|j|y||jvr@|j tjdt|d|j|yyyy)zValidity check.NzDeleted entity z without a BLOCK name)codemessagez# without required BLOCK definition.) rhauditrrrnrN fixed_errorr'UNDEFINED_BLOCK_NAMErtrashUNDEFINED_BLOCK)r`auditorrrNros rar'z Insert.audits  gkk 3::88==D|###88-c$i[8MN$ d#SZZ'###33-c$i[9#$$  d# (3rccT|j}| |jfStS)z,Support for the "ReferencedBlocks" protocol.)rblock_record_handletuplers ra__referenced_blocks__zInsert.__referenced_blocks__s)   --/ /wrc)r z list[Attrib])r rer])rmzOptional[SubclassProcessor]r r2)rwr7r r")rwr7)rz xref.Registryr r")rr rzxref.ResourceMapperr r")rfloat)r zOptional[BlockLayout])NNN)rOzOptional[UVec]rz$Optional[tuple[float, float, float]]rTzOptional[float]r r9)r(r(r2)rztuple[int, int]rztuple[float, float]r r9)F)rrrrer zOptional[Union[Attrib, AttDef]])rF)rrr=rrrer r)rrrrer re))rrN)rrrrrOrr r0)rrr r"r!)rrr r9)rr1rr1rr1r r9)r r)rzOptional[BaseLayout]r r&)r Iterator[DXFGraphic])rz+Optional[Callable[[DXFGraphic, str], None]]r r3)r int)r zIterator[Insert])rzdict[str, str]r r9)r,r1r r")r z Iterable[str])-__name__ __module__ __qualname____doc__DXFTYPErr)r,acdb_block_reference DXFATTRIBSpropertyrbrMrirrrzrrrrrrrrrrrrrrrrrrrrrrrrr r#r'r0 __classcell__)ros@rar9r9s  Gz;8LMJ ""''8< 4    6I / ? TT "&6:$( 4"   <NT#7J :.3&* (0AF!$9= ( >FJ!+/ >#, B >&59% JO% 1% % N'PT 5"M5  5n  "!H;z$(rc)Y __future__rtypingrrrrrr r typing_extensionsr rlogging ezdxf.lldxfr ezdxf.lldxf.attributesr rrrrrrezdxf.lldxf.constrrrrr ezdxf.mathrrrrrrrr ezdxf.math.transformtoolsr!r" ezdxf.exploder#r$ezdxf.entitiesr% ezdxf.queryr& ezdxf.auditr' dxfentityr)r*dxfgfxr+r,r-r. subentityr/rr0r1r2r3r4 ezdxf.layoutsr5r6ezdxf.lldxf.tagwriterr7r:r8__all__ getLoggerrris_valid_block_name any_point is_not_zerois_greater_zeropoint3dis_not_null_vectorr: acdb_block_reference_group_codesrkregister_entityr9rcrar[s!## !   ##"4 &#>>57 *   7 # #!"a$?Y%B%BC"EOO4RT: ++   ++   ++  BD9 //   //  ""a$?r1t< --22  ]69t$66J#K 5=$ r ^r r rc