hpddlmZddlmZmZmZmZmZmZm Z m Z m Z m Z m Z ddlZddlZddlZddlZddlZddlZddlmZmZddlmZddlZddlmZddlmZddlmZdd lm Z dd l!m"Z"dd l#m$Z$dd l%m&Z&dd l'm(Z(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6ddl,m7Z7ddl8m9Z9m:Z:m;Z;mZ>ddl?m@Z@ddlAmBZBmCZCddlDmEZEddlFmGZGddlHmIZImJZJddlKmLZLddlMmNZNddlOmPZPddlQmRZRddlSmTZTmUZUddlVmWZWddlXmYZYmZZZdd lm[Z[m\Z\ejd!Z^er:dd"l_m`Z`maZambZbmcZcdd#ldmeZedd$l'mfZfdd%lgmhZhdd&limjZjdd'lOmkZkmlZlmmZmmnZnmoZompZpmqZqmrZrmsZsd(Ztd)Zud*Zvd+Zwd,Zxdd7Zd?d8Zd@d9ZdAdBd:ZdCd;Zy)D) annotations) TYPE_CHECKINGTextIOBinaryIOIterableIteratorUnionCallablecastOptionalSequenceAnyN)datetimetimezone)chain)Auditor)GroupCollection)MaterialCollection)MLeaderStyleCollection)MLineStyleCollection)EntityDB)groupby) Modelspace Paperspace)Layouts)const)BLK_XREF BLK_EXTERNALDXF13DXF14DXF2000DXF2007DXF12DXF2013)loader)AbstractTagWriter TagWriterBinaryTagWriter JSONTagWriter) EntityQuery)DimensionRenderer)AcDsDataSectionnew_acds_data_section) BlocksSection)ClassesSection) EntitySection StoredSection) HeaderSection)ObjectsSection) TablesSection)guid) tocodepage toencoding) juliandate) safe_string MAX_STR_LEN) messengermsgtypesezdxf) DXFEntityLayerVPort Dictionary)GenericLayoutType)Layout)Tags)DXFTag) LayerTable LinetypeTableTextstyleTable DimStyleTable AppIDTableUCSTable ViewTable ViewportTableBlockRecordTablez&{00000000-0000-0000-0000-000000000000}z&0.0 @ 2000-01-01T00:00:00.000000+00:00CREATED_BY_EZDXFWRITTEN_BY_EZDXF EZDXF_METAcfddlm}||} t|d}|dkr|}|S#t$r|}Y|SwxYw)Nr) START_HANDLE)ezdxf.tools.handlerSint ValueError)seedrSvs .lib/python3.12/site-packages/ezdxf/document.py_validate_handle_seedr\asM/ | bM q5D K  Ks ! 00c6eZdZefdZdZeefd[dZdZdZdZ dZ dZ dZ d Z d Zd Zd Zd ZdZed\dZej*d]dZed^dZedZed_dZej*d`dZdadZdbdZedcdZedddZededZdfdZdgdZdZ dZ!dZ" dh did Z#dhdjd!Z$dkd"Z%dldmd#Z&dnd$Z'dod%Z(dZd&Z)dZd'Z*d(Z+d)Z,d*Z-d+Z.dpd,Z/d-Z0d.Z1dqdrd/Z2d0Z3ed\d1Z4edsd2Z5edtd3Z6edud4Z7edvd5Z8edwd6Z9edxd7Z:edyd8Z;edzd9Zed}d<Z?e?j*d~d=Z?dd>Z@ddd?ZAddd@ZBddAZCddBZDddCZEdDZFdEZGeddFZHeddGZIddHZJdddIZKdddJZLddKZMddLZNddMZOdddNZP d ddOZQddPZRdddQZSdddRZTdqdSZU d ddTZVeWeXzf ddUZYddVZZdddWZ[dddXddYZ\y)Drawingct|_tj||_|j }t j j|||_|jt jvr#t jd|jdd|_ d|_ d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_g|_d|_d|_d|_d|_d|_d|_t?|_ tC|_"g|_#tI|jdk(sJy)NUnsupported DXF version "".Fcp1252Tr)%rentitydbr; Messengerupperracad_release_to_dxf_versionget _dxfversionversions_supported_by_newDXFVersionError dxfversion_loaded_dxfversion is_loadingencodingfilenamerootdictheaderclassestablesblocksentitiesobjectsacdsdatastored_sectionslayoutsgroups materialsmleader_styles mline_styles_acad_compatibleset_acad_incompatibility_reasonr+_dimension_renderer_post_init_commandslen)selfrktarget_dxfversions r[__init__zDrawing.__init__psR  ",,T2&,,. % A A E E 0!    5#B#B B''*CDOOCTTV(WX X26 % '+ %) &* '+ %) %) '+ '+ *. 46 $ '+ -16:26!%69e)$5#6 46 4==!Q&&&cV||}|j|j|S)ztCreate new drawing. Package users should use the factory function :func:`ezdxf.new`. (internal API) )_setup_create_ezdxf_metadata)clsrkdocs r[newz Drawing.news' *o  ""$ rctj|_t||_t ||_t||_t||_ t||_ t||_|jj|_|jj!|jt#j$||_|j)yN)r2rrqr/rrr4rsr.rtr0rur3rvr-rwrpsetup_object_management_tablesrsetupry_finalize_setuprs r[rzDrawing._setups#'') %d+ #D) #D) %d+ %d+ -d3  --  33DMMB}}T*  rct||_t||_t ||_|j t||_|j|j|jy)z3Common setup tasks for new and loaded DXF drawings.N) rrzrr{rr}_create_required_table_entriesrr|_set_required_layer_attributes_setup_metadata_execute_post_init_commandsrs r[rzDrawing._finalize_setupsh%d+ +D106 ++-5T: ++-  ((*rc8|jD] }| |`yr)r)rcmds r[rz#Drawing._execute_post_init_commandss++C E,  $rc|j|j|j|j|j |j yr)_create_required_vports_create_required_linetypes_create_required_layers_create_required_styles_create_required_appids_create_required_dimstylesrs r[rz&Drawing._create_required_table_entriessJ $$& '') $$& $$& $$& '')rcF|jD]}|jyr)layersset_required_attributes)rlayers r[rz&Drawing._set_required_layer_attributess[[E  ) ) +!rcXd|jvr|jjdyy)N*Active) viewportsrrs r[rzDrawing._create_required_vportss% DNN * NN  y ) +rcXd|jvr|jjdyy)NACADappidsrrs r[rzDrawing._create_required_appidss#  $ KKOOF # %rcV|j}dD]}||vs|j|y)N)ByBlockByLayer Continuous) linetypesr)rrnames r[rz"Drawing._create_required_linetypess)NN 8D9$ d#9rcXd|jvr|jjdyyNStandard) dimstylesrrs r[rz"Drawing._create_required_dimstyless% T^^ + NN  z * ,rcXd|jvr|jjdyyr)stylesrrs r[rzDrawing._create_required_styless# T[[ ( KKOOJ ' )rc|j}d|vr|jdd|vr|jdddiyd|jdj_y)N0 Defpointsplotr dxfattribs)rrrgdxfr)rrs r[rzDrawing._create_required_layerssS f  JJsO f $ JJ{{J ;01FJJ{ # ' ' ,rch|j|jd<ttj|jd<|jj dt t k(r|j|jj dt t k(r|jyy)N$ACADVER $TDCREATE$FINGERPRINTGUID $VERSIONGUID) rkrqr8rnowrg CONST_GUIDreset_fingerprint_guidreset_version_guidrs r[rzDrawing._setup_metadatasz"&// J#-hlln#= K ;;??-z :j H  ' ' ) ;;??>: 6* D  # # % Erc|jS)zGet current DXF version.)rhrs r[rkzDrawing.dxfversionsrcN|j||_||jd<y)zSet current DXF version.rN)_validate_dxf_versionrhrqrversions r[rkzDrawing.dxfversions% 55g>") Jrc|jSr)rlrs r[loaded_dxfversionzDrawing.loaded_dxfversions&&&rcD|jtk\rdS|jS)zYReturns required output encoding for writing document to a text streams. zutf-8)rkr"rnrs r[output_encodingzDrawing.output_encodings //W4wG$--Grc:|jjddS)zGet and set the document/modelspace base units as enum, for more information read this: :ref:`dxf units`. Requires DXF R2000 or newer. $INSUNITSr)rqrgrs r[unitsz Drawing.units$s {{{A..rcd|cxkrdkr;nn8|jtkrtjd||jd<yt d|)Nrz7Drawing units ($INSUNITS) are not exported for DXF R12.rzInvalid units enum: )rkr!loggerwarningrqrX)r unit_enums r[rz Drawing.units,sM B (M(1DKK $3I;?@ @rc|j}tjj||}|tjvrtj d|d|t k(r8|jt kDr#tjd|jd|S||jkr7tjd|jdtj|d|S)Nr`razDowngrade from DXF z' to R12 may create an invalid DXF file.z to z can cause lost of features.) rerrfrgversions_supported_by_saverjr#rhrr acad_releaseinfors r[rzDrawing._validate_dxf_version7s--/3377I %:: :''*CG9B(OP P e %')$*;*;)<=+, t'' ' KK%d&7&7%8%%g.//KM rc|jstjdStj|jjS)z.Returns the absolute filepath of the document..)ropathlibPathresolvers r[get_abs_filepathzDrawing.get_abs_filepathJs4}}<<$ $||DMM*2244rc@ddlm}||}|j|S)a]Open an existing drawing. Package users should use the factory function :func:`ezdxf.read`. To preserve possible binary data in XRECORD entities use :code:`errors='surrogateescape'` as error handler for the import stream. Args: stream: text stream yielding text (unicode) strings by readline() rU)ascii_tags_loader) lldxf.taggerrload)rstreamr tag_loaders r[readz Drawing.readPs  4&v. xx ##rcRddlm}||}|}|j||S)zLoad DXF document from a DXF tag loader, in general an external untrusted source. Args: tag_loader: DXF tag loader rU) tag_compiler)rr_load)rrrrs r[rz Drawing.load`s) /!*- e * rc8|}|j||S)z5Create new drawing from compiled tags. (internal API))tagger)r)r compiled_tagsrs r[ from_tagszDrawing.from_tagspse  ' rcld|_tj|}d|vr|d=|j|y)NTTHUMBNAILIMAGE)rmr%load_dxf_structure_load_section_dict)rrsectionss r[rz Drawing._loadws8,,V4 x ')* )rcpd|_|jdg}|rtj|d|_ntj t |_|jjdt |_|j|_t|jjdd|_ |jjdt|jj}|jjjt|t!j"||t%||jd d |_t)||jd d |_|j-t/||jd d |_t3||jd d |_t7||jdd |_t;||jdd |_|j?D]<\}}|t@jBvs|jDjGtI|>|jK|jLt kr tNjQdt |_&|jLt k(r|j*jS|jLtTtVfvr0tNjQdtX|_&|j[|j8j\}|j^dk7r"tAj`dt|d||_.|j8jc|j\tej||_3d|_|jiy )z8Internal API to load a DXF document from a section dict.THEADERr)rkr $DWGCODEPAGE ANSI_1252 $HANDSEEDCLASSESNTABLESBLOCKSENTITIESOBJECTSACDSDATAzDXF version upgrade to DXF R12.z!DXF version upgrade to DXF R2000. DICTIONARYzinvalid root dictionary entity  F)5rmrgr2rrqrr#rhrlr7rnstrrchandlesresetr\r%load_and_bind_dxf_contentr/rrr4rs_create_required_block_recordsr.rtr0rur3rvr,rwitemsrMANAGED_SECTIONSrxappendr1_2nd_loading_stagerkrrcreate_table_handlesrr r!create_all_arrow_blocksrpDXFTYPEDXFStructureErrorrrryr)rrheader_entitiesrYrdatarps r[rzDrawing._load_section_dicts&.ll8R&@ ',,_Q-?@DK(++u=DK;;??:u=#'"2"2#4;;??>;#OP KKOOKT]]5J5J1KL ##$9$$?@ ((48 & (,,y$/  $D(,,x*FG  ++-$D(,,x*FG % (,,z40  & (,,y$/  ( (,,z40  #..*JD$5111$$++M$,?@+ ! ??U " KK9 :#DO ??e # KK , , . ??uen , KK; <%DO  ( ( *<<((   | +))1#h-B !  33DMMB||D)   rc|j}|jD]1}|j|}||jj |3y)zLoad additional resources from entity database into DXF entities. e.g. convert handles into DXFEntity() objects N)rcvaluespost_load_hookrr )rdbentityrs r[r zDrawing._2nd_loading_stagesH ]]iikF''-C((//4 "rcjddlm}|jD]}|j|j| y)aFor upgrading DXF R12/13/14 files to R2000, it is necessary to create all used arrow blocks before saving the DXF file, else $HANDSEED is not the next available handle, which is a problem for AutoCAD. Create all known AutoCAD arrows to be on the safe side, because references to arrow blocks can be in DIMSTYLE, DIMENSION override, LEADER override and maybe other locations. rARROWSN)ezdxf.render.arrowsr__acad__ create_blockrt)rr arrow_names r[rzDrawing.create_all_arrow_blockss) / //J    Z 8*rcd|jvr|jjdd|jvr|jjdyy)Nz *Model_Spacez *Paper_Space) block_recordsrrs r[rz&Drawing._create_required_block_recordssK !3!3 3    " "> 2 !3!3 3    " "> 2 4rNcJt||_|j||y)a$Set :class:`Drawing` attribute :attr:`filename` to `filename` and write drawing to the file system. Override file encoding by argument `encoding`, handle with care, but this option allows you to create DXF files for applications that handles file encoding different than AutoCAD. Args: filename: file name as string encoding: override default encoding as Python encoding string like ``'utf-8'`` fmt: ``'asc'`` for ASCII DXF (default) or ``'bin'`` for Binary DXF )rnfmtN)rrosave)rrornr"s r[saveaszDrawing.saveass$H   8 -rcp| |j}n|}|jdr$tj|jd|d}n7|jdrt|jd}nt d|d  |j || |jy#|jwxYw) aWrite drawing to file-system by using the :attr:`filename` attribute as filename. Override file encoding by argument `encoding`, handle with care, but this option allows you to create DXF files for applications that handle file encoding different from AutoCAD. Args: encoding: override default encoding as Python encoding string like ``'utf-8'`` fmt: ``'asc'`` for ASCII DXF (default) or ``'bin'`` for Binary DXF Nascwt dxfreplace)modernerrorsbinwbUnknown output format: ''.)r")r startswithioopenrorXwriteclose)rrnr"encfps r[r#z Drawing.saves  &&CC >>%  D3|B^^E "dmmT*B7uB?@ @  JJrsJ # HHJBHHJs ?B##B5c<|j|jdS)z:Encode string `s` with correct encoding and error handler.r()rnr*)encoder)rss r[r7zDrawing.encode7sxx!5!5lxKKrc|j|j}|tk(r&t|jj dd}nd}|tkDr|j j||j|jdrt|||}nJ|jdr*t||||j}|jntd|d |j|y ) aKWrite drawing as ASCII DXF to a text stream or as Binary DXF to a binary stream. For DXF R2004 (AC1018) and prior open stream with drawing :attr:`encoding` and :code:`mode='wt'`. For DXF R2007 (AC1021) and later use :code:`encoding='utf-8'`, or better use the later added :class:`Drawing` property :attr:`output_encoding` which returns the correct encoding automatically. The correct and required error handler is :code:`errors='dxfreplace'`! If writing to a :class:`StringIO` stream, use :meth:`Drawing.encode` to encode the result string from :meth:`StringIO.get_value`:: binary = doc.encode(stream.get_value()) Args: stream: output text stream or binary stream fmt: "asc" for ASCII DXF (default) or "bin" for binary DXF z $HANDLINGrTr&) write_handlesrkr+)r:rkrnr-r.N)commit_pending_changesrkr#boolrqrgrradd_required_classes update_allr/r'r(rwrite_signaturerXexport_sections)rrr"rkr tagwriters r[r2z Drawing.write;s, ##%__  4;;??;:;GG   LL - -j 9  >>% !%%I ^^E "'%%-- I  % % '7uB?@ @ Y'rctj}|j||j|j }t j |jddS)z3Returns DXF document as base64 encoded binary data. s )r0StringIOr2r7getvaluebase64 encodebytesreplace)rr binary_datas r[ encode_base64zDrawing.encode_base64osL 6kk&//"34 !!+"5"5eW"EFFrcN|j}|jj||tkDr|jj||j j||j j||jj||tkDr|jj||jjr|jj||jD]}|j||jddy)z#DXF export sections. (internal API)rEOFN) rkrq export_dxfr#rrrsrtrurvrwis_validrx write_tag2)rrArksections r[r@zDrawing.export_sectionsxs))  y)   LL # #I . y) y)   +   LL # #I . == ! ! MM $ $Y /++G   y ), Q&rcV|jjtjyr)r; broadcastr<COMMIT_PENDING_CHANGESrs r[r;zDrawing.commit_pending_changess   !@!@Arc|jtkDr%|jj|j|j |j |j |j|jyr) rkr#rrr=_create_appids_update_header_varsupdate_extents update_limits_update_metadatars r[r>zDrawing.update_alls` ??U " LL - -doo >    "   rc|j}|jj}|jj}t |r)t |r||j d<||j d<|j }|jj|j d<|jj|j d<y)Nz$EXTMINz$EXTMAXz$PEXTMINz$PEXTMAX) modelspacerextminextmaxr<rq active_layout)rmspr\r]r^s r[rWzDrawing.update_extentssoo ?J'1DKK $(2DKK %'1DKK $(2DKK %*4DKK '.8DKK* +,,.C'1#DKK $  # # %#&t}}'<'<#= K &0&? N#rcT|jtkr t|St|S)zReturns the *ezdxf* :class:`ezdxf.document.MetaData` object, which manages *ezdxf* and custom metadata in DXF files. For more information see: :ref:`ezdxf_metadata`. )rkr# R12MetaData R2000MetaDatars r[ezdxf_metadatazDrawing.ezdxf_metadatas% %)OOu$<{4 U-PTBUUrcF|j}t|t<yr)rtezdxf_marker_stringrOr ezdxf_metas r[rzDrawing._create_ezdxf_metadata((* ':'< #$rcF|j}t|t<yr)rtrvrPrws r[rmzDrawing._update_ezdxf_metadataryrc^||jvr|jj|d|iyy)Nflagsr)rrr|s r[_create_appid_if_not_existz"Drawing._create_appid_if_not_exists* t{{ " KKOOD7E"2 3 #rcL|jdd|jddy)NHATCHBACKGROUNDCOLORrEZDXF)r}rs r[rUzDrawing._create_appidss# ''(>B ''3rcVtjj|jdS)z?Returns the AutoCAD release abbreviation like "R12" or "R2000".unknown)rrrgrkrs r[rzDrawing.acad_releases!!!%%dooyAArc.|jjSr)rsrrs r[rzDrawing.layers{{!!!rc.|jjSr)rsrrs r[rzDrawing.linetypes{{$$$rc.|jjSr)rsrrs r[rzDrawing.stylesrrc.|jjSr)rsrrs r[rzDrawing.dimstylesrrc.|jjSr)rsucsrs r[rz Drawing.ucss{{rc.|jjSr)rsrrs r[rzDrawing.appidsrrc.|jjSr)rsviewsrs r[rz Drawing.viewss{{   rc.|jjSr)rsr rs r[r zDrawing.block_recordss{{(((rc.|jjSr)rsrrs r[rzDrawing.viewportsrrc |jdS)NACAD_PLOTSTYLENAME)rprs r[ plotstyleszDrawing.plotstyles s}}122rc|jSrrrs r[dimension_rendererzDrawing.dimension_renderers'''rc||_y)zl Set your own dimension line renderer if needed. see also: ezdxf.render.dimension Nr)rrenderers r[rzDrawing.dimension_renderers $, rc6|jjS)zReturns the modelspace layout, displayed as "Model" tab in CAD applications, defined by block record named "\*Model_Space". )ryr[rs r[r[zDrawing.modelspaces||&&((rc8|jj|S)a#Returns paperspace layout `name` or the first layout in tab-order if no name is given. Args: name: paperspace name or empty string for the first paperspace in tab-order Raises: KeyError: layout `name` does not exist )ryrgrrs r[layoutzDrawing.layout#s||%%rc|r8|jj|}t|tr|St d|j S)a!Returns paperspace layout `name` or the active paperspace if no name is given. Args: name: paperspace name or empty string for the active paperspace Raises: KeyError: if the modelspace was acquired or layout `name` does not exist z2use method modelspace() to acquire the modelspace.)ryrg isinstancerKeyErrorr^)rrpsps r[ paperspacezDrawing.paperspace1sE ,,""4(C#z* OP P%%' 'rc6|jjS)zdReturns the active paperspace layout, defined by block record name "\*Paper_Space". )ryr^rs r[r^zDrawing.active_layoutDs||))++rcHt|jjS)z,Returns all layout names in arbitrary order.)listrynamesrs r[ layout_nameszDrawing.layout_namesJsDLL&&())rcHt|jjS)zHReturns all layout names in tab-order, "Model" is always the first name.)rrynames_in_taborderrs r[layout_names_in_taborderz Drawing.layout_names_in_taborderNsDLL22455rc2t|jd<y)zReset fingerprint GUID.rNr5rqrs r[rzDrawing.reset_fingerprint_guidRs*.& &'rc2t|jd<y)zReset version GUID.rNrrs r[rzDrawing.reset_version_guidVs&*f N#rc|jS)z`Returns ``True`` if the current state of the document is compatible to AutoCAD. )r~rs r[is_acad_compatiblezDrawing.is_acad_compatibleZs $$$rc,t|jS)zIReturns a list of reasons why this document is not compatible to AutoCAD.)rrrs r[acad_incompatibility_reasonsz$Drawing.acad_incompatibility_reasonsasD5566rcd|_||jvr5|jj|tj d|dyy)z\Add a reason why this document is not compatible to AutoCAD. (internal API) Fz+DXF document is not compatible to AutoCAD! rN)r~raddrr)rmsgs r[ add_acad_incompatibility_messagez(Drawing.add_acad_incompatibility_messagefsI!& d77 7  - - 1 1# 6 NNHQO P 8rc6t|j|S)aEntity query over all layouts and blocks, excluding the OBJECTS section and the resource tables of the TABLES section. Args: query: query string .. seealso:: :ref:`entity query string` and :ref:`entity queries` )r*chain_layouts_and_blocks)rquerys r[rz Drawing.queryos488:EBBrc8t|j||S)aGroups DXF entities of all layouts and blocks (excluding the OBJECTS section) by a DXF attribute or a key function. Args: dxfattrib: grouping DXF attribute like "layer" key: key function, which accepts a :class:`DXFEntity` as argument and returns a hashable grouping key or ``None`` to ignore this entity. .. seealso:: :func:`~ezdxf.groupby.groupby` documentation )rr)r dxfattribkeys r[rzDrawing.groupby}st446 3GGrc^t|j}tj|S)z~Chain entity spaces of all layouts and blocks. Yields an iterator for all entities in all layouts and blocks. )rlayouts_and_blocksr from_iterable)rrys r[rz Drawing.chain_layouts_and_blockss(t..01""7++rc,t|jS)zOIterate over all layouts (modelspace and paperspace) and all block definitions.)iterrtrs r[rzDrawing.layouts_and_blockssDKK  rc||jvrtjd|d|jj|y)zDelete paper space layout `name` and all entities owned by this layout. Available only for DXF R2000 or later, DXF R12 supports only one paperspace, and it can't be deleted. Layout 'z' does not exist.N)ryr DXFValueErrordeleters r[ delete_layoutzDrawing.delete_layouts= t|| #%%6G&HI I LL   %rc||jvrtjd|d|jj||S)aCreate a new paperspace layout `name`. Returns a :class:`~ezdxf.layouts.Paperspace` object. DXF R12 (AC1009) supports only one paperspace layout, only the active paperspace layout is saved, other layouts are dismissed. Args: name: unique layout name dxfattribs: additional DXF attributes for the :class:`~ezdxf.entities.layout.DXFLayout` entity Raises: DXFValueError: paperspace layout `name` already exist rz' already exists.)ryrrr)rrrs r[ new_layoutzDrawing.new_layoutsB 4<< %%6G&HI I<<##D*5 5rc@ddlm}|jdk(rtjd ||\}}}|s||}} |j|}|j||fd||S#t $rt d|wxYw#t $r|j|}YOwxYw)aCreates a new paperspace layout if `name` does not exist or reset the existing layout. This method requires DXF R2000 or newer. The paper format name `fmt` defines one of the following paper sizes, measures in landscape orientation: =========== ======= ======= ======= Name Units Width Height =========== ======= ======= ======= ISO A0 mm 1189 841 ISO A1 mm 841 594 ISO A2 mm 594 420 ISO A3 mm 420 297 ISO A4 mm 297 210 ANSI A inch 11 8.5 ANSI B inch 17 11 ANSI C inch 22 17 ANSI D inch 34 22 ANSI E inch 44 34 ARCH C inch 24 18 ARCH D inch 36 24 ARCH E inch 48 36 ARCH E1 inch 42 30 Letter inch 11 8.5 Legal inch 14 8.5 =========== ======= ======= ======= The layout uses the associated units of the paper format as drawing units, has no margins or offset defined and the scale of the paperspace layout is 1:1. Args: name: paperspace layout name fmt: paper format landscape: ``True`` for landscape orientation, ``False`` for portrait orientation r) PAGE_SIZESR12z$method call no supported for DXF R12zunknown paper format: )rrrr)sizemarginsr) ezdxf.tools.standardsrrrrjrrXrr page_setup) rrr" landscaperrwidthheightrs r[rzDrawing.page_setupsV 5    %''(NO O =#-c? E5&"E6E (//$'C UFO\O  =5cU;< < =  (//$'C (s A%B%A=BBcddlm}|j|s|j|r|j |j |y||j vrt jd|dy)zFor standard AutoCAD and ezdxf arrows create block definitions if required, otherwise check if block `name` exist. (internal API) rrz Arrow block "z" does not exist.N)rr is_acad_arrowis_ezdxf_arrowrrtrr)rrrs r[ acquire_arrowzDrawing.acquire_arrowsb /    %)>)>t)D    T 2  $%% dV;L&MN N%rcd|jvr|jjddd||}|jj|||S)aAdd an image definition to the objects section. Add an :class:`~ezdxf.entities.image.ImageDef` entity to the drawing (objects section). `filename` is the image file name as relative or absolute path and `size_in_pixel` is the image size in pixel as (x, y) tuple. To avoid dependencies to external packages, `ezdxf` can not determine the image size by itself. Returns a :class:`~ezdxf.entities.image.ImageDef` entity which is needed to create an image reference. `name` is the internal image name, if set to ``None``, name is auto-generated. Absolute image paths works best for AutoCAD but not perfect, you have to update external references manually in AutoCAD, which is not possible in TrueView. If the drawing units differ from 1 meter, you also have to use: :meth:`set_raster_variables`. Args: filename: image file name (absolute path works best for AutoCAD) size_in_pixel: image size in pixel as (x, y) tuple name: image name for internal use, None for using filename as name (best for AutoCAD) .. seealso:: :ref:`tut_image` ACAD_IMAGE_VARSrrUmframequalityr)rprvset_raster_variables add_image_def)rro size_in_pixelrs r[rzDrawing.add_image_defsL8 DMM 1 LL - -Aq - L <D||))(M4HHrc@|jj|||y)aSet raster variables. Args: frame: 0 = do not show image frame; 1 = show image frame quality: 0 = draft; 1 = high units: units for inserting images. This defines the real world unit for one drawing unit for the purpose of inserting and scaling images with an associated resolution. ===== =========================== mm Millimeter cm Centimeter m Meter (ezdxf default) km Kilometer in Inch ft Foot yd Yard mi Mile ===== =========================== rN)rvr)rrrrs r[rzDrawing.set_raster_variables#s, ))we)Trc|jj||jjd}|j dt |y)ztSet wipeout variables. Args: frame: 0 = do not show image frame; 1 = show image frame )rAcDbVariableDictionary WIPEOUTFRAMEN)rvset_wipeout_variablesrpget_required_dictset_or_add_dict_varr)rrvar_dicts r[rzDrawing.set_wipeout_variables;sB ***7==223KL$$^SZ@rcP|dk(r|dd}|jj|||S)ayAdd an :class:`~ezdxf.entities.underlay.UnderlayDef` entity to the drawing (OBJECTS section). The `filename` is the underlay file name as relative or absolute path and `fmt` as string (pdf, dwf, dgn). The underlay definition is required to create an underlay reference. Args: filename: underlay file name fmt: file format as string "pdf"|"dwf"|"dgn" or "ext" for getting file format from filename extension name: pdf format = page number to display; dgn format = "default"; dwf: ???? .. seealso:: :ref:`tut_underlay` extN)rvadd_underlay_def)rror"rs r[rzDrawing.add_underlay_defFs/& %<23-C||,,XsDAArcD|jj|||dy)zAdd an external reference (xref) definition to the blocks section. Args: filename: external reference filename name: name of the xref block flags: block flags )r| xref_path)rrN)rtr)rrorr|s r[ add_xref_defzDrawing.add_xref_def]s TH.UVrc<t|}|j|S)aFChecks document integrity and fixes all fixable problems, not fixable problems are stored in :attr:`Auditor.errors`. If you are messing around with internal structures, call this method before saving to be sure to export valid DXF documents, but be aware this is a long-running task. )rrun)rauditors r[auditz Drawing.auditjs$- rc|j}|rS|j|j|js't d|j D] }t |t |jdk(S)aFSimple way to run an audit process. Fixes all fixable problems, return ``False`` if not fixable errors occurs. Prints a report of resolved and unrecoverable errors, if requested. Args: print_report: print report to stdout Returns: ``False`` if unrecoverable errors exist z'DXF document is not AutoCAD compatible:r)rprint_fixed_errorsprint_error_reportrprintrrr*)r print_reportrrs r[validatezDrawing.validatewsg**,   & & (  & & (**?@<>"a''rrc@|jjdt|xsi}td|jj d|}||j _||j _|j|jj|S)aSet initial view/zoom location for the modelspace, this replaces the current "\*Active" viewport configuration (:class:`~ezdxf.entities.VPort`) and reset the coordinate system to the :ref:`WCS`. Args: height: modelspace area to view center: modelspace location to view in the center of the CAD application window. dxfattribs: additional DXF attributes for the VPORT entity rr@r) r delete_configdictr rrcenterr reset_wcsrq)rrrrvports r[set_modelspace_vportzDrawing.set_modelspace_vports| $$Y/**+ Wdnn00z0RS! !    rreturnNone)rkrrr^)rr)rrrr)r Optional[str])rrW)rrWrr)rrrr)rz pathlib.Path)rrrr^)rIterable[DXFTag]rr^)rrrr^)rrrr)rzloader.SectionDictrr)Nr&)rozUnion[os.PathLike, str]rnrr"rrr)rnrr"rrr)r8rrbytes)r&)rzUnion[TextIO, BinaryIO]r"rrr)rr)rAr&rr)rMetaData)r)rrr|rWrr)rrF)rrG)rrH)rrI)rrK)rrJ)rrL)rrN)rrM)rrA)rr+)rr+rr)rr)rrrrC)rrrr)rr)rz Iterable[str])rr<)r list[str])rr)*)rrrr*)rNrr)rzIterator[DXFEntity])rzIterator[GenericLayoutType])rrrrr)Layout1zISO A3T)rrr"rrrrr)rorrztuple[int, int])rrUr)rrWrrWrr)rN)rorr"rrr)rorrrr|rW)rrT))rr)rr@)]__name__ __module__ __qualname__r$r classmethodrrrrrrrrrrrrrpropertyrksetterrrrrrrrrrrr rrr$r#r7r2rJr@r;r>rWrXrVrYrtrrmr}rUrrrrrrrrr rrrr[rrr^rrrrrrrrrrrrrrrrrrrrrrrrrrr[r^r^os");'z#* + % *,*$$ +(1&  ** ''HH // \\AA&5  $ $   *Zx 5 93#' .). . .  .*"HL2(hG'$B  ;; N@"V==44BB""%%""%%""!!))%%33((,,) &(&, *61-%% 77Q CH",!&6* ===  =~ O IDU0 AFJBB"%B5BB06> 5L W W#& W/2 W (*rr^ceZdZdZej d dZd d dZej d dZej d dZ ej ddZ d dZ y)rz~Manage ezdxf meta-data by dict-like interface. Values are limited to strings with a maximum length of 254 characters. cy)zhReturns the value for self[`key`]. Raises: KeyError: `key` does not exist Nrrrs r[ __getitem__zMetaData.__getitem__ rcd |j|S#t$rt|tcYSwxYw)zBReturns the value for `key`. Returns `default` if `key` not exist.)rrr9r:)rrdefaults r[rgz MetaData.gets4 5##C( ( 5w 4 4 5s //cy)zSet self[`key`] to `value`.Nrrrvalues r[ __setitem__zMetaData.__setitem__ rcy)zYDelete self[`key`]. Raises: KeyError: `key` does not exist Nrrs r[ __delitem__zMetaData.__delitem__rrcy)zReturns `key` ``in`` self.Nrrs r[ __contains__zMetaData.__contains__rrcF |j|y#t$rYywxYw)zARemove `key`, does **not** raise an exception if `key` not exist.N)r rrs r[discardzMetaData.discards'    S !   s   Nrrrrr)rrrrrrrrrrrrrrrrrrrr<) r r r__doc__abcabstractmethodrrgrr r"r$rrr[rrsy   5         rrctjjrtSt j t j}tjdz|jzS)N)tzz @ ) r=rnroCONST_MARKER_STRINGrrrutc __version__ isoformat)rs r[rvrvsC }}66""llhll+  5(3==?::rcHeZdZdZd dZd dZd dZd dZddZddZ ddZ y )rrz{Manage ezdxf meta data for DXF version R12 as XDATA of layer "0". Layer "0" is mandatory and can not be deleted. c|jjj|_|j |_yr)r[ block_recordblock _msp_blockr_datarrs r[rzR12MetaData.__init__s)..*77==ZZ\ rc:t|t|jvSrr9r:r7rs r[r"zR12MetaData.__contains__3 , ::rc<|jt|tSr)r7r9r:rs r[rzR12MetaData.__getitem__szz+c;788rcpt|t|jt|<|jyr)r9r:r7_commitrs r[rzR12MetaData.__setitem__s%'25+'F ;s#$ rcZ|jt|t=|jyr)r7r9r:r>rs r[r zR12MetaData.__delitem__s JJ{3 4 5 rcg}|jjD]=\}}|jdt|f|jdt|f?|jj d|y)Nir)r7r r rr6 set_xdata)rtagsrrs r[r>zR12MetaData._commitsb****,JC KKs3x( ) KKs5z* +- !!'40rct}|jjdr_|jjd}d}t |dz }||kr/||j }||dzj ||<|dz }||kr/|S)NrrrU)rr6 has_xdata get_xdatarr)rrxdataindexcountrs r[rzR12MetaData._loadsv ?? $ $W -OO--g6EEJNE%-U|))"519-33T  %- rNrr^r(r%r&r'rr) r r rr)rr"rrr r>rrrr[rrrrs* " ;91 rrrc8eZdZdZddZd dZd dZd dZd dZy) rsz[Manage ezdxf metadata for DXF version R2000+ as DICTIONARY object in the rootdict. cP|jjtd|_y)NT) hard_owned)rprrQr7r8s r[rzR2000MetaData.__init__s#!$!?!? 4"@"  rc:t|t|jvSrr:rs r[r"zR2000MetaData.__contains__r;rct|jt|t}|jj ddS)Nrr)r7r9r:rrg)rrrZs r[rzR2000MetaData.__getitem__s, JJ{3 4 5uuyy"%%rct|jjt|tt|tyr)r7rr9r:rs r[rzR2000MetaData.__setitem__s' && [ );uk+J rcV|jjt|tyr)r7remover9r:rs r[r zR2000MetaData.__delitem__ s +c;78rNrJr(r%r&r') r r rr)rr"rrr rrr[rsrs s  ;& 9rrsc ddlm}ddlmd=d>fd }d?d@fd }dAdBfd }dAd@fd }|j|j } | |j } gjd |jd jd || |j k7rAd | } tjj| d} | r | d | dz } j| jd|jjd|j r$jdjddjdjddjd|jjdj|jD cgc]} d| d c} jddrdnd} rjd| jd||j|d |d!|d"|d#j|d$%j|d&%j D]\} }jd'| d(|d |j#}t$|vr(jd)|jt$nrjd*t&|vr(jd+|jt&nrjd,|rՉjd-||j(d.||j*d/||j,d0||j.d1||j0d2||j2d3||j4d4||j6d5||j8d6|j t:kDr|t=|j>d7d89jd:tA|jCr%j||jCjd;tA|jDr!j||jDtG|}tA|r6jd.count(s^"9A AIIK A % 7<<>*DHTF"WT]O15 5+sAAc d}j|d|dt|r|dk(rfg}|D]^}|jj}|dk(r,|j|d|jjdJ|j||`n'|Dcgc]}||jj}}|j j |yycc}w)N rz entries: STYLErz*shape-file: "")r rrrfontsortextend)tabler containerr[rentryrverboses r[append_containerzinfo..append_container/s tfAi[ 3u:,?@ w#%"E 99>>Drz x~eiinn=MQ%OP xv%67 #CHH%F8EIINN#34%H JJL KK  Is!Crc3fKtdD]}||dz}|vs||d| yw)NrU=)range)kindr[irrqs r[ user_varszinfo..user_vars@sFqAVAaC5>Dv~at ~66s11c rj||dj|djy)Nz: )r rgstrip)rr[rrqs r[append_header_varzinfo..append_header_varFs3 vhtfBvzz$ 'F'L'L'N&OPQrz Filename: "razFormat: z-Loaded content was upgraded from DXF Version rWrXz Release: z DXF Version: zMaintenance Version: rgrrz Codepage: rrz Encoding: zLayouts:z ''z $MEASUREMENTMetricImperialz Unit system: zModelspace units: z $LASTSAVEDBYrrrz$USERI)rnz$USERRzCustom property "z": "zCreated by ezdxf: z'File was not created by ezdxf >= 0.16.4zWritten by ezdxf: z'File was not written by ezdxf >= 0.16.4zContent stats:LAYERLTYPEr`DIMSTYLEAPPIDUCSVIEWVPORT BLOCK_RECORDCLASSrP)rfzEntities in modelspace: zEntities in OBJECTS section: zUnknown/unsupported entities: )r_)r Iterator[str])rer r)rnrrr)$ ezdxf.unitsrT collectionsrUrqrrkr rorrrgrrdrr custom_varsrtrOrPrrrrrrrrr r#rrrrr[rv_get_unknown_entities)rrhcontentr"rTrIrirprtloaded_dxf_versionrreleaser measurementrrtunknown_entitiesrUrrqs ` @@@r[rr$sF%#6"7 RZZF..! ^^DKK+cll^1-.KK(3% !S^^+=>P=QR$$(();R@  Ry? "C CKK)C,,-./KK-/01 #FJJ $N#O P  KK*VZZ DEFGKK*S00123KK KK3+G+G+IJ+I43tfA+IJK$jj;(K mK=12 (399)=(>?@.)+&,-.) I8,- I8,-!--KD% KK+D6eWA> ?.'')N>) (););>) ();); $%W-0W- 3W-%(F+0**N; >>E ! T#++.9 M .s3>>3C/D.EFG  KKcnn./ 0 3C 4D3EFG  KKckk* +05  KK8=M9N8OP Q E"234 KeKs, S<cddlm}m}m}g}|jj D]#}t ||||fs|j|%|S)Nr) DXFTagStorageACADProxyEntity OLE2Frame)ezdxf.entitiesrrrrcrrr )rrrrrrs r[rrsHHHD,,%%' f}oyI J KK ( Krc~|j}|tk7rd|_|j|j |y)z.Export a DXF document via a custom tag writer.TN)rkr#r:r>r@)rrArks r[ custom_exportrs3JU"& NN "rctj}t||j|}t |||j S)aExport a DXF document as JSON formatted tags. The `compact` format is a list of ``[group-code, value]`` pairs where each pair is a DXF tag. The group-code has to be an integer and the value has to be a string, integer, float or list of floats for vertices. The `verbose` format (`compact` is ``False``) is a list of ``[group-code, value]`` pairs where each pair is a 1:1 representation of a DXF tag. The group-code has to be an integer and the value has to be a string. )rkcompact)r0rDr)rkrrE)rrr json_writers r[export_json_tagsrs8[[]F3>>7SK#{# ?? rcDddlm}tj||S)a%Load DXF document from JSON formatted tags. The expected JSON format is a list of [group-code, value] pairs where each pair is a DXF tag. The `compact` and the `verbose` format is supported. Args: data: JSON data structure as a sequence of [group-code, value] pairs r)json_tag_loader)ezdxf.lldxf.taggerrr^r)rrs r[load_json_tagsrs3 <<- ..r)rYrrr)FFASCII)rr^rr)rr^rzlist[DXFEntity])rr^rAr&r )rr^rr)rz Sequence[Any]rr^) __future__rtypingrrrrrr r r r r rr*rFr0loggingosrrr itertoolsrr= ezdxf.auditrezdxf.entities.dxfgroupsrezdxf.entities.materialrezdxf.entities.mleaderrezdxf.entities.mlinerezdxf.entitydbr ezdxf.groupbyr ezdxf.layoutsrrezdxf.layouts.layoutsr ezdxf.lldxfrrhrrrr r!r"r#r$r%ezdxf.lldxf.tagwriterr&r'r(r) ezdxf.queryr*ezdxf.render.dimensionr+ezdxf.sections.acdsdatar,r-ezdxf.sections.blocksr.ezdxf.sections.classesr/ezdxf.sections.entitiesr0r1ezdxf.sections.headerr2ezdxf.sections.objectsr3ezdxf.sections.tablesr4 ezdxf.toolsr5ezdxf.tools.codepager6r7ezdxf.tools.juliandater8ezdxf.tools.textr9r:r;r< getLoggerrrr>r?r@rA ezdxf.eztypesrBrCezdxf.lldxf.tagsrDezdxf.lldxf.typesrErFrGrHrIrJrKrLrMrNrr.rOrPrQr\r^ABCrrvrrrsrrrrrrrr[rsU#      ' 4695#!0)    $4J/1@/1/7-5%   7 #BB/$%(   6 >%%   qqh!-sww-`;,(,^9H94m`#$ /r