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.
Note  External References can be created with absolute or relative paths. The Autodesk AutoCAD DWG/DXF (ACAD) writer can create External Reference elements whether or not the files being referenced actually exist in the location specified; however, the AutoCAD RealDWG (REALDWG) writer requires that referenced files exist before creating the references.

Attribute Name

Content

autocad_rotation

The rotation of the inserted External Reference, counterclockwise from horizontal.

Range: -360.0 ..360.0

Default: 0

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