hMrddlmZddlmZmZmZmZmZmZddl Z ddl m Z ddl m Z mZddlmZddlmZmZddlmZmZmZmZmZdd lmZmZmZmZmZm Z m!Z!dd l"m#Z#m$Z$m%Z%dd l&m'Z'er dd l(m)Z)dd lm*Z*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1e jddZ3ddZ4ddZ5ddZ6eZ7GddZ8y)) annotations) TYPE_CHECKINGIterableIteratorUnioncastOptionalN)ParseException)Auditor AuditError) BlockLayout)const validator)DXFBlockInUseError DXFKeyErrorDXFStructureErrorDXFTableEntryError DXFTypeError)AttribBlock BlockRecordEndBlk entity_linkerfactoryis_graphic_entity)UVecNULLVECVec3)ARROWS)Drawing) DXFEntity DXFTagStorage)EntityDB)AbstractTagWriter)Tableezdxfc|j}t|rytj|ry|j dr)tj tj |ryy)NT_F)upperis_anonymous_blockris_ezdxf_arrow startswith is_acad_arrow arrow_namenames 5lib/python3.12/site-packages/ezdxf/sections/blocks.pyis_special_blockr2.sX :: block_records r1recover_block_namerCJs 99== $D  IIMM'2 &E  ))C 3<<3||''. lK 0##''3 3 r3ceZdZdZ d ddZdZeddZeddZ eddZ d dZ d Z d!d Z d"d Zd#d Zd$d Zd%dZd&dZd'dZd(d%dZd)dZedf d*dZdef d+dZd,dZd-dZd.d/dZd0dZd1dZy)2 BlocksSectionzm Manages BLOCK definitions in a dict(), block names are case insensitive e.g. 'Test' == 'TEST'. Ncf||_||j||jd|_y)Nr)r>load#_reconstruct_orphaned_block_records_anonymous_block_counter)selfr>entitiess r1__init__zBlocksSection.__init__es1    IIh  002()%r3c,t|jSN)r8 block_recordsrJs r1__len__zBlocksSection.__len__ps4%%&&r3cZt|ts |j}|jSrN)r@strr0lower)entitys r1keyzBlocksSection.keyss!&#&[[F||~r3c.|jjSrN)r>rOrPs r1rOzBlocksSection.block_recordsysxx%%%r3c.|jjSrN)r>r?rPs r1r?zBlocksSection.entitydb}sxx   r3c d fd }dfd }|j tdd}|jdk7s|jddk7r t dd=g}t }|D]p}t |tr0|t urtjd |}|jDt |tr |t urtjd n|jjd d }|jjd d} |s:t|}|r-tjd|d| d||j_|rF||||} t | t"r|j%| n3tjd| dntjd| dt }|j`|j'|sy)z Load DXF entities into BlockLayouts. `entities` is a list of entity tags, separated by BLOCK and ENDBLK entities. c  tdj|jj}|j|||D]}|j||S#t$r6tdj |jjddi}Yjt $r#td|jjwxYw)Nrscaler) dxfattribsz"Invalid or missing name of BLOCK #) rr=r<r0rnewrrhandle set_block add_entity)rAendblkblock_entitiesrBrUrOs r1load_block_recordz-BlocksSection.load..load_block_records #M=3D3DUYY^^3TU   " "5& 1(''/) & #!!%%eiinn'1%N    '89I9I8JK s/A.link_entitiess&"_F"f~ L #s##r"rSECTIONr5)BLOCKSz+Critical structure error in BLOCKS section.z*Missing required ENDBLK, ignoring content.z9Found ENDBLK without a preceding BLOCK, ignoring content.r0r:r^z zRecovered block name "z " for block #.z#Ignoring invalid BLOCK definition #zIgnoring BLOCK without name #N)rArrarrblist[DXFEntity]returnzBlockRecord | None)rlzIterable['DXFEntity'])rOrdxftype base_classr_MISSING_BLOCK_r@rloggerwarningclearrr<r=rCinfor0raddappend) rJrKrcrf section_headcontentrArU block_namer^rBrOs ` @r1rGzBlocksSection.loads   ,   2 !** OXa[9    !Y .,2I2I!2LQ 3 $$QR R QK#%&#oF&%(/NN#OP FF+O+NNS"'vr!:J"YY]]8]CF%%7%> %"KK"8 MRXQYYZ [.8EIIN!'8'P %lK@ HH\2"NN"EfXQ O)Fvha'PQ+E v&I&r3c<|jD]}|jtjd|jj dd|j }tjdi|j }|j|||j|y)zFind BLOCK_RECORD entries without block definition in the blocks section and create block definitions for this orphaned block records. NBLOCK)rrr)r0 base_point)r\r>ENDBLK) rOrArcreate_db_entryr<r0r>r_rt)rJrBrAras r1rHz1BlocksSection._reconstruct_orphaned_block_recordss !..L!!)// , 0 0 5 5&/  !00! &&uf5&!/r3c|jd|jD]%}t|tsJ|j |'|j ddy)Nz 0 SECTION 2 BLOCKS rENDSEC) write_strrOr@rexport_block_definition write_tag2)rJ tagwriterrBs r1 export_dxfzBlocksSection.export_dxfsQ9: ..LlK8 88  0 0 ;/ Q)r3ct|}||_|jj|jj sJ|S)zaAdd or replace a block layout object defined by its block record. (internal API) )r block_layoutrO has_entryr<r0)rJrBrs r1rtzBlocksSection.addsB#<0 $0 !!!++L,<,<,A,ABBBr3c(d|jDS)zz)BlocksSection.__iter__..sQ>Pl ))>Ps)rOrPs r1__iter__zBlocksSection.__iter__sQd>P>PQQr3c8|jj|S)zVReturns ``True`` if :class:`~ezdxf.layouts.BlockLayout` `name` exist. )rOrrJr0s r1 __contains__zBlocksSection.__contains__s!!++D11r3c td|jj|}|jS#t$r t |wxYw)zuReturns :class:`~ezdxf.layouts.BlockLayout` `name`, raises :class:`DXFKeyError` if `name` not exist. r)rrOr=rrr)rJr0rBs r1 __getitem__zBlocksSection.__getitem__ sJ $ t/A/A/E/Ed/KLL,, ,! $d# # $s 03Ac`||vr|jj|ytd|d)zDeletes :class:`~ezdxf.layouts.BlockLayout` `name` and all of its content, raises :class:`DXFKeyError` if `name` not exist. Block "" does not exist.N)rOremoverrs r1 __delitem__zBlocksSection.__delitem__s4 4<    % %d +v->?@ @r3cpt|jjjj S)z"Returns a list of all block names.)listr>rOentrieskeysrPs r1 block_nameszBlocksSection.block_namess&DHH**22779::r3cH |j|S#t$r|cYSwxYw)zkReturns :class:`~ezdxf.layouts.BlockLayout` `name`, returns `default` if `name` not exist. )rr)rJr0defaults r1r=zBlocksSection.get#s, ##D) ) N s  !!cH|jj|jS)z=Returns a block layout by block record handle. (internal API))r>r?r)rJblock_record_handles r1get_block_layout_by_handlez(BlocksSection.get_block_layout_by_handle,sxx  !45BBBr3c|jJtt|jjj |}|xsi}|j j |d<||d<t||d<tjd||j}tjdd|j j i|j}|j|||j|S)zCreate and add a new :class:`~ezdxf.layouts.BlockLayout`, `name` is the BLOCK name, `base_point` is the insertion point of the BLOCK. r;r0r{rzr|)r>) r>rrrOr]r<r^rrr}r_rt)rJr0r{r\rBheadtails r1r]zBlocksSection.new0sxx###K)?)?)C)CD)IJ %2 *..55 7! 6#' #3 < &&w DHHE&& w 0 0 7 78dhh  tT*xx %%r3Ucn|j|}|j||dtji}|S)aCreate and add a new anonymous :class:`~ezdxf.layouts.BlockLayout`, `type_char` is the BLOCK type, `base_point` is the insertion point of the BLOCK. ========= ========== type_char Anonymous Block Type ========= ========== ``'U'`` ``'*U###'`` anonymous BLOCK ``'E'`` ``'*E###'`` anonymous non-uniformly scaled BLOCK ``'X'`` ``'*X###'`` anonymous HATCH graphic ``'D'`` ``'*D###'`` anonymous DIMENSION graphic ``'A'`` ``'*A###'`` anonymous GROUP ``'T'`` ``'*T###'`` anonymous block for ACAD_TABLE content ========= ========== flags)anonymous_block_namer]r BLK_ANONYMOUS)rJ type_charr{rxrAs r1new_anonymous_blockz!BlocksSection.new_anonymous_blockGs6&..y9 Z'5;N;N1OP r3c |xjdz c_d||j}|jj|s|SD)aCreate name for an anonymous block. (internal API) Args: type_char: letter U = *U### anonymous blocks E = *E### anonymous non-uniformly scaled blocks X = *X### anonymous hatches D = *D### anonymous dimensions A = *A### anonymous groups T = *T### anonymous ACAD_TABLE content r5r6)rIrOr)rJrrxs r1rz"BlocksSection.anonymous_block_name^sN  ) )Q . )YK(E(E'FGJ%%// ;!! r3ctt|jj|}|j ||jj |||j |y)a"Rename :class:`~ezdxf.layouts.BlockLayout` `old_name` to `new_name` .. warning:: This is a low-level tool and does not rename the block references, so all block references to `old_name` are pointing to a non-existing block definition! N)rrrOr=renamereplacert)rJold_namenew_namerBs r1 rename_blockzBlocksSection.rename_blockrsQK););)?)?)IJ H% ""8\: r3c|r|jJd|jjj|}|td|d|jsy|j rt d|dt|rt d|dd|d } |jj|}t|rt d|d |j|y#t$rtjd |d YywxYw) aDelete block. Applies some safety checks when `safe` is ``True``. A :class:`DXFBlockInUseError` will be raised for: - blocks with active references - blocks representing existing layouts - special blocks used internally Args: name: block name (case-insensitive) safe: apply safety checks Raises: DXFKeyError: if block not exists DXFBlockInUseError: when safe is ``True`` and block is in use Nzvalid DXF document requiredrrz " represents an existing layout.zSpecial block "z," maybe used without explicit INSERT entity.zINSERT[name=="z"]iz Parsing error in query string: ""z" is still in use.)r>blocksr=ris_alive is_any_layoutrr2queryr rperrorr8r)rJr0saferA query_string block_refss r1 delete_blockzBlocksSection.delete_blocks$ 88' F)F F'HHOO''-E}!GD61B"CDD>>""(dV#CD %(%dV+WX,D65L !XX^^L9 :(74&8J)KLL  "  ? ~QOP sC"DDcb|jJtd|jjdDdfd }t}|D]H}tj|j }|j r/||s8|j|J|D]}|j|y)aDelete all blocks without references except modelspace- or paperspace layout blocks, special arrow- and anonymous blocks (DIMENSION, ACAD_TABLE). .. warning:: There could exist references to blocks which are not documented in the DXF reference, hidden in extended data sections or application defined data, which could invalidate a DXF document if these blocks will be deleted. Nc3nK|]-}tj|jj/ywrN)rmake_table_keyr<r0)rrUs r1rz2BlocksSection.delete_all_blocks..s+ 2  $ $VZZ__ 52s35INSERTc$t|ry|vS)NF)r2)r0active_referencess r1is_safez0BlocksSection.delete_all_blocks..is_safes%00 0r3r0rSrlbool) r>setrrrr0rrtr)rJrtrashrAr0rs @r1delete_all_blockszBlocksSection.delete_all_blockssxx### ((..2    1 E++EJJ7D&&74= $ D   T "r3c|j|jusJd|jD]}t|tsJ|jj }g}|j }|D]b}t|sW|jtjdt|d|jjd|j|nft|trV|jtjdt|d|jjd|j||j s|jj"|k7s|jtj$dt|d |jj"d |d |jjd |j'|e|D]!}|j s |j)|#y #t*$rY3wxYw) aDAudit and repair BLOCKS section. .. important:: Do not delete entities during the auditing process as this will alter the entity database while iterating it, instead use:: auditor.trash(entity) to delete invalid entities after auditing automatically. z#Auditor for different DXF document.zRemoved invalid DXF entity z from BLOCK 'z'.)codemessagezRemoved standalone z entity from BLOCK 'zRemoved DXF entity z with invalid owner handle (#z != #z) from BLOCK 'N)r>rOr@rr<r^ entity_spacer fixed_errorr REMOVED_INVALID_GRAPHIC_ENTITYrSr0rr REMOVED_STANDALONE_ATTRIB_ENTITYrr;(REMOVED_ENTITY_WITH_INVALID_OWNER_HANDLErur ValueError)rJauditorrBrunlink_entitiesesrUs r1auditzBlocksSection.auditsxx7;;&M(MM& ..LlK8 88'3'7'7'>'> /1O**B(0'''FF"=c&k]K##/#3#3#8#8"9!=( MM&)/'''HH"5c&k]C##/#3#3#8#8"9!=( MM&)::##'::'''PP"5c&k]C$$*JJ$4$4#5U;N:OP''3'7'7'<'<&=R!A($**62;>*?? &)*K/R&s!G88 HH)NN)r>zOptional[Drawing]rKzOptional[list[DXFEntity]])rUzUnion[str, BlockLayout]rlrS)rlr%)rlr#)rKrkrlNone)rr$rlr)rBrrlr )rlzIterator[BlockLayout]r)r0rSrlr )r0rSrlr)rlz list[str]rN)rrSrlr )r0rSr{rrlr )rrSr{rrlr )rrSrlrS)rrSrrSrlr)T)r0rSrrrlr)rlr)rr rlr)__name__ __module__ __qualname____doc__rLrQ staticmethodrVpropertyrOr?rGrHrrtrrrrrr=rrr]rrrrrrr3r1rErE^s "&.2 *  *, *' &&!!X't'.*R2 $A;C# &&&  &0 #w04 ."( *X#@9r3rEr)rArrlrS)9 __future__rtypingrrrrrr logging pyparsingr ezdxf.auditr r ezdxf.layouts.blocklayoutr ezdxf.lldxfrrezdxf.lldxf.constrrrrrezdxf.entitiesrrrrrrr ezdxf.mathrrrezdxf.render.arrowsrezdxf.documentr r!r"ezdxf.entitydbr#ezdxf.lldxf.tagwriterr$ezdxf.sections.tabler% getLoggerrpr2r*rCrorErr3r1rs#$+1(+*&&7'7*   7 #$D"'hhr3