BlockRecord¶

BLOCK_RECORD (DXF Reference) is the core management structure for BlockLayout and Layout. This is an internal DXF structure managed by ezdxf, package users don’t have to care about it.

Subclass of	`ezdxf.entities.DXFEntity`
DXF type	`'BLOCK_RECORD'`
Factory function	`Drawing.block_records.new()`

class ezdxf.entities.BlockRecord¶

dxf.owner¶: Handle to owner (Table).

dxf.name¶: Name of associated BLOCK.

dxf.layout¶: Handle to associated DXFLayout, if paperspace layout or modelspace else “0”

dxf.explode¶: 1 for BLOCK references can be exploded else 0

dxf.scale¶: 1 for BLOCK references can be scaled else 0

dxf.units¶

BLOCK insert units

0	Unitless
1	Inches
2	Feet
3	Miles
4	Millimeters
5	Centimeters
6	Meters
7	Kilometers
8	Microinches
9	Mils
10	Yards
11	Angstroms
12	Nanometers
13	Microns
14	Decimeters
15	Decameters
16	Hectometers
17	Gigameters
18	Astronomical units
19	Light years
20	Parsecs
21	US Survey Feet
22	US Survey Inch
23	US Survey Yard
24	US Survey Mile

property is_active_paperspace: bool¶: True if is “active” paperspace layout.

property is_any_paperspace: bool¶: True if is any kind of paperspace layout.

property is_any_layout: bool¶: True if is any kind of modelspace or paperspace layout.

property is_block_layout: bool¶: True if not any kind of modelspace or paperspace layout, just a regular block definition.

property is_modelspace: bool¶: True if is the modelspace layout.

property is_xref: bool¶: True if represents an XREF (external reference) or XREF_OVERLAY.

Internal Structure¶

Do not change this structures, this is just an information for experienced developers!

The BLOCK_RECORD is the owner of all the entities in a layout and stores them in an EntitySpace object (BlockRecord.entity_space). For each layout exist a BLOCK definition in the BLOCKS section, a reference to the Block entity is stored in BlockRecord.block.

Modelspace and Paperspace layouts require an additional DXFLayout object in the OBJECTS section.