h*oSSKJr SSKJrJrJrJrJrJrJ r SSK J r SSK r SSK r SSKJr SSKJrJrJrJrJrJrJr SSKJrJrJrJrJr SSKJrJ r J!r!J"r"J#r#J$r$J%r%J&r& SS K'J(r(J)r) SS K*J+r+J,r, SS K-J.r. SS K/J0r0 SS K1J2r2 SSK3J4r4J5r5 SSK6J7r7J8r8J9r9J:r: SSK;Jr> \(a$SSK1J?r? SSK-J@r@JArAJBrB SSKCJDrDJErE SSKFJGrG SSKHJIrI S/rJ\ R"S5rLSrM\"S\"SSSS9\"S\RS9\"S \RS!9\"S"SSS9\"S#SS\R\S$9\"S%SS\R\S$9\"S&SS\R\S$9\"S'SSS9\"S(SS\R\S$9\"S)SS\R\S$9\"S*SSS9\"S+SSS9\"S,\R\#S\R\S-9S.. 5rT\"\T5rU\"\:\U5rV\.R"S/S\<55rXg)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 extrusioncl^\rSrSrSrSr\"\\\ 5r \ S*Sj5r \ S+Sj5r S,S-U4SjjjrS.U4SjjrS/U4S jjrS0U4S jjrS1U4S jjr\ S+S j5r\ S+S j5rS2SjrS3SjrS+SjrS4S5SjjrS6S7SjjrS8S9SjjrS:S;SjjrS8SSjjrS8S?SjjrS@SjrSASjr SBSjr!SCSjr"Sr#S@Sjr$S,SS.SDS jjjr%SES!jr&SSS".SFS#jjr'\ SGS$j5r(SHS%jr)SIS&jr*SJU4S'jjr+SKS(jr,S)r-U=r.$)Lr9a(DXF 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. INSERTcUR$N _sub_entitiesselfs G/var/www/html/env/lib/python3.13/site-packages/ezdxf/entities/insert.pyattribsInsert.attribss!!!c>[[UR55$r^)boollenrdras rcrMInsert.attribs_followsC %&&rfNc>[[U] U5nU(a3URU[5 UR (a [ US5 U$)z!Loading interface. (internal API))rO)superr+load_dxf_attribssimple_dxfattribs_loadermerged_insert_group_codesr12r-)rb processordxf __class__s rcrmInsert.load_dxf_attribss@ J6yA   . .s4M N}}#C5 rfc>[TU]U5 UR[:aaURR S:dURR S:aUR[S5 OUR[S5 UR(aURSS5 URRU/SQ5 g)z(Export entity specific data as DXF tags.r(AcDbMInsertBlockr;r<) rNrOrQrRrSrTrUrVrWrXrYN) rl export_entity dxfversionrrrrUrV write_tag2rrMexport_dxf_attribsrb tagwriterrss rcrwInsert.export_entitys i(   % '%%)txx/A/AA/E$$_6HI$$_6JK     Q ' ##   rfct>^[TU]T5 UR(aURU4Sj5 gg)Nc&>URT5$r^) export_dxf)er|s rc#Insert.export_dxf..s Y0Grf)rlrrMprocess_sub_entitiesr{s `rcrInsert.export_dxfs- 9%     % %&G H rfcn>[TU]U5 URURR5 gr^)rlregister_resourcesadd_block_namerrrN)rbregistryrss rcrInsert.register_resourcess& "8, .rfc>[TU]X5 URURR5URlgr^)rl map_resourcesget_block_namerrrN)rbclonemappingrss rcrInsert.map_resourcess. e- // > rfcfURRS5(aURRS:wagURRS5(aURRS:wagURRS5(aURRS:wagg)z3Returns ``True`` if scaling is applied to any axis.rQr(TrRrSF)rrhasattrrQrRrSras rc has_scalingInsert.has_scalings| 88  H % %$((//Q*> 88  H % %$((//Q*> 88  H % %$((//Q*>rfc[URR5[URR5s=:H=(a" [URR5:H$s $)zReturns ``True`` if the scale factor is uniform for x-, y- and z-axis, ignoring reflections e.g. (1, 1, -1) is uniform scaling. )absrrrQrRrSras rchas_uniform_scalingInsert.has_uniform_scalingsD 488??#s488??';SSs488???SSSSSrfcUS:Xa [S5eXRlXRlXRlU$)zSet a uniform scale factor.rzInvalid scale factor.) ValueErrorrrrQrRrS)rbfactors rc set_scaleInsert.set_scale s5 Q;45 5    rfcUR(a9URRRURR5$g)z;Returns the associated :class:`~ezdxf.layouts.BlockLayout`.N)docblocksgetrrrNras rcblock Insert.blocks- 8888??&&txx}}5 5rfcVUR5nUbURR$g)zGReturn ``True`` if the INSERT entity represents a XREF or XREF_OVERLAY.F)r block_recordis_xrefrbrs rcrInsert.is_xrefs(   %%-- -rfcUbXRlUbO[U5S:wa [S5eUupEnX@RlXPRlX`RlUbX0RlU$)z 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.)rrrOrirrQrRrSrT)rbrOscalerTxyzs rcplace Insert.placesi  $HHO  5zQ#$STTGA!HHOHHOHHO   (HH  rfcUup4X0RlX@RlUupVXPRlX`RlU$![a [S5ef=f![a [S5ef=f)a Place 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.)rrrrrVrUrXrW)rbsizespacingrowscolsrX col_spacings rcgrid Insert.grid<s UJD" $ '. $K +"-  U ST T U  J  sA A& A#&A<FcNURH nXRR:XdMUs $ U(anURbaURRURR nUR 5H nXRR:XdMUs $ g)aQGet 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)rdrrtagrrrNget_const_attdefs)rbr search_constattribrattdefs rc get_attribInsert.get_attribXsxllFjjnn$ # DHH0HHOODHHMM2E113**..(!M4rfcZURX5nUcU$URR$)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 )rrrtext)rbrr=rrs rcget_attrib_textInsert.get_attrib_textos*3 >Nzzrfc(URX5SL$)abReturns ``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)rbrrs rc has_attribInsert.has_attribss1==rfc[U=(d 05nXS'X$S'X4S'[SURSU55nURR U5 UR cUR 5 U$)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_entityrdappendseqend new_seqend)rbrrrO dxfattribsrs rc add_attribInsert.add_attribsq$**+ 5!6%8h 9 9(J OP F# ;;  OO  rfc[UR5H>up4URRU:XdM!URU UR 5 g U(d [ U5eg)anDelete 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) enumeraterdrrrdestroyr)rbrignoreindexrs rc delete_attribInsert.delete_attribsW't||4MEzz~~$LL'  5 c" "rfc|UR(dgURHnUR5 M /Ulg)zBDelete all :class:`Attrib` entities attached to the INSERT entity.N)is_aliverdrr`)rbrs rcdelete_all_attribsInsert.delete_all_attribss,}} llF NN #rfc\URn[[UR5URUR UR 4URURS9nURU[5nURUlURUlURUlURUlURUlURUlURHnURU5 M UR!U5 U$![a [S5ef=f)zTransform 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.)rrr"rrOrQrRrSrTrY transformABS_TOLr!scale_factor_xscale_factor_yscale_factor_zrdpost_transform)rbmrr source_system target_systemrs rcrInsert.transformshh. #::szz3::6\\mm   )33Aw?M #)) $-- %// "11 "11 "11 llF   Q # A ) +\  s "DD+cUR5nUR[XU5URURR 5-5URlUR HnURXU5 M U$)zWOptimized INSERT translation about `dx` in x-axis, `dy` in y-axis and `dz` in z-axis. )ocsfrom_wcsrto_wcsrrrOrd translate)rbdxdydzrrs rcrInsert.translatesc hhj,,tBB'7#**TXX__:U'UVllF   RR (# rfcURnURnURnURnUR 5nUR n[ UR[55n[ UR[55n[R"Xr-X-Xd-S9n [R"UR5n U (aU [R"Xj5-n URUR!S["55n UR%5n U b1XR'U R$RR(5-n U R+SU R,5 U $)zReturns a transformation matrix to transform the block entities from the block reference coordinate system into the :ref:`WCS`. )uxuyuzrOr)rrrQrRrSrrrrrrrucsmathradiansrT axis_rotaterr rtransform_direction base_pointset_rowxyz) rbrrsxsyszrrYrrranglerO block_layouts rcmatrix44Insert.matrix44shh ZZ ZZ ZZhhjFF #**V$ % #**V$ % LLBGIN C S\\*  %%i7 7ACGGHg67zz|  # ++L,>,>,B,B,M,MN NF !VZZ rfcFUR5n[5nXlU$)zQReturns the block reference coordinate system as :class:`ezdxf.math.UCS` object. )rrmatrix)rbrrs rcr Insert.ucss  MMOe  rfc[URlURRS5 URRS5 g)zuReset block reference attributes location, rotation angle and the extrusion vector but preserves the scale factors. rTrYN)r rrrOdiscardras rcreset_transformationInsert.reset_transformation#s3 " $ %rf) redraw_ordercXUcUR5nUc [S5e[XUS9$)aExplodes 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#)rbr r s rcexplodeInsert.explode,s@:   OO-M$'M' L  rfc"UR5$)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_entitiesras rc__virtual_entities__Insert.__virtual_entities__Ss $$&&rfskipped_entity_callbackr c#Z# [UUUS9HnURU5 Uv M g7f)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)rbrr rs rcrInsert.virtual_entities[s5^2 $;% A  ( ( .G  s)+cURR(aURROSURR(aURR-$S-$)zfReturns the multi-insert count, MINSERT (multi-insert) processing is required if :attr:`mcount` > 1. r()rrrXrVrWrUras rcmcount Insert.mcountsO '+hh&:&:""%)XX%<%.transform_attached_attrib_entitiess% .. !!V+!)rfcURnU=RU- slURS5 URS5 URS5 URS5 g)NrVrUrXrW)rrrOr)rOrrrs rcadjust_dxf_attribs/Insert.multi_insert..adjust_dxf_attribssJ**C JJ& J KK $ KK ' KK & KK( )rfN) setrrrXrWrTrangerVrUradd rotate_degcopy) rbr r#donerXrrTrowcolrrOs rc multi_insertInsert.multi_inserts  , *uhh** hh-- 88$$++,CTXX223c/1BC%HHV$!'!2!28!<!YY[F&v66vF L4-s B*D0ADc^^^^^SU4SjjmSUUUU4SjjnTR5mTbTR5mU"5 T$)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>URS5nTRUS5nUcURSS5nURS5nXU4$)NrrrO)popr)rrrlocationvaluess rcunpack'Insert.add_auto_attribs..unpacksO..'C::c4(D|!~~fb1!~~h/Hh& &rfc>TR5HnURSS1S9nSU;a$[RS[ U5S35 M>SU;a$[RS[ U5S35 MhT "U5up#nT R X#XA5nUR (a'UR5nX6lURU5 URT5 M g) Nprompthandle)droprz Skipping z#: missing mandatory 'tag' attributerOz&: missing mandatory 'insert' attribute) attdefsrloggerwarningstrrhas_embedded_mtext_entityvirtual_mtext_entityr embed_mtextr) rrrrr3rmtextrrrbr5s rcautofill)Insert.add_auto_attribs..autofills&..0#..Xx4H.I  *NN#CK=0ST:-NN#CK=0VW&,Z&8#8HI33"779E!%J&&u-  #11rf)returnztuple[str, str, UVec]rENone)rr)rbr4rCrrr5s`` @@@rcadd_auto_attribsInsert.add_auto_attribss:( ' $ $6zz|  # A J rfc>[TU]U5 URnU(aUR(aURR nUc=UR [RS[U5S3S9 URU5 gX2R;a=UR [RS[U5S3S9 URU5 gggg)zValidity check.NzDeleted entity z without a BLOCK name)codemessagez# without required BLOCK definition.) rlauditrrrrrN fixed_errorr'UNDEFINED_BLOCK_NAMEr>trashUNDEFINED_BLOCK)rbauditorrrNrss rcrM Insert.audits  gkk 3::88==D|###88-c$i[8MN$ d#ZZ'###33-c$i[9#$$  d# (3rfcVUR5nUb UR4$[5$)z,Support for the "ReferencedBlocks" protocol.)rblock_record_handletuplers rc__referenced_blocks__Insert.__referenced_blocks__s)   --/ /wrfr_)rEz list[Attrib])rErhr^)rqzOptional[SubclassProcessor]rEr2)r|r7rErG)r|r7)rz xref.RegistryrErG)rr rzxref.ResourceMapperrErG)rfloat)rEzOptional[BlockLayout])NNN)rOzOptional[UVec]rz$Optional[tuple[float, float, float]]rTzOptional[float]rEr9)r(r(rZ)rztuple[int, int]rztuple[float, float]rEr9)F)rr>rrhrEzOptional[Union[Attrib, AttDef]])r1F)rr>r=r>rrhrEr>)rr>rrhrErh))rrN)rr>rr>rOrrEr0)rr>rErGrF)rrrEr9)rrYrrYrrYrEr9)rEr)r zOptional[BaseLayout]rEr&)rEIterator[DXFGraphic])rz+Optional[Callable[[DXFGraphic, str], None]]rEr[)rEint)rEzIterator[Insert])r4zdict[str, str]rEr9)rRr1rErG)rEz Iterable[str])/__name__ __module__ __qualname____firstlineno____doc__DXFTYPErr)r,acdb_block_reference DXFATTRIBSpropertyrdrMrmrwrrrrrrrrrrrrrrrrrrrrr rrrrr-rHrMrW__static_attributes__ __classcell__)rss@rcr9r9s* 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$(rf)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__ getLoggerr<ris_valid_block_name any_point is_not_zerois_greater_zeropoint3dis_not_null_vectorrc acdb_block_reference_group_codesroregister_entityr9rfrcrs## !   ##"4 &#>>57 *   7 # #!"a$?Y%B%BC"EOO4RT: ++   ++   ++  BD9 //   //  ""a$?r1t< --22  ]69t$66J#K 5=$ r ^r r rf