External References
autocad_entity: autocad_xref
External References are references to external files, they consist of two parts:
- External Reference
- External Reference definition
The External Reference is a feature with point geometry that represents the location where the contents of the external file should be placed. The External Reference definition is much like a block definition but instead of containing geometry, the External Reference definition contains information about the type of External Reference and the path to the external file.
There are two types of External Reference:
- Attached, which will include nested External References when viewed in an AutoCAD application;
- Overlaid, which will not include nested External References.
Attribute Name |
Content |
---|---|
autocad_xref_name |
The name of the External Reference definition. Range: char[50] |
autocad_xref_path |
The path of the external file that is referenced by the External Reference. Range: char[254] |
autocad_xref_status (used by the reader only) |
The status of the External Reference indicating the state of referenced external file. Range: resolved | unloaded | not_found | unresolved |
autocad_xref_type |
Indicates whether the External Reference is an attached or an overlaid External Reference. Range: overlay | attach Default: attach |
autocad_xscale |
The scale factor for the inserted External Reference in the x direction. Range: 64-bit floating point number Default: 1 |
autocad_yscale |
The scale factor for the inserted External Reference in the y direction. Range: 64-bit floating point number Default: 1 |
autocad_zscale |
The scale factor for the inserted External Reference in the z direction. Range: 64-bit floating point number Default: 1 |
autocad_rotation |
The rotation of the inserted External Reference, counterclockwise from horizontal. Range: -360.0 ..360.0 Default: 0 |