autocad_entity: autocad_shape

Features with autocad_entity set to autocad_shape are point features that identify where to place an AutoCAD shape object. The reader and writer modules process all attributes needed to fully specify the shape object reference. Depending on the output file (.dxf or .dwg), different information will be required to write shape entity. If a template file is specified using the writer parameter Template File, then information about shape entity is extracted from the template file, which requires access to the shape file.

When writing to a DXF file, a shape name and a shape file name is all that is required. The presence of a shape file during translation is not required since there is no information lookup.

When writing to a DWG file and a shape name is given, then a lookup is performed to determine the shape index or shape number from the shape file, which is what DWG stores. For the lookup to be successful, the writer needs access to the shape file, and the specified shape name should be in the shape file. Similarly when writing to DWG, a shape number and shape file is all that is required. If there is no shape index or shape number, then the writer has to perform a lookup from the shape name to the shape index, and for this, access to the shape file is required.

When specifying a shape file, either the full path or just the filename can be specified. If only the shape filename is given, the writer will first look for that shape file in the folder specified by the writer parameter AutoCAD Shape File Folder, and if not found then it will look in the folder where the output dataset is being written.

Finally, when writing a shape, if the conditions above with shape names, shape numbers, shape file names, and file type, are met, then an existing shape definition will be used. However, if there is not enough information to find an existing definition (or one cannot be found), then one can be made, using the other shape-related format attributes below. These attributes represent the shape information when reading. When writing, these attributes are only used to make new shape definitions, and are not used when an existing definition is found.

Note   When an AutoCAD file is output, any shape files that it references must be shipped together with the file.

Attribute Name



The scale of the shape object for this point.

Range: 64-bit floating point number.

Default: 1


This identifies the index of the particular shape within the shape file. A single shape file may contain many different shapes.

Range: 64-bit floating point number > 0

Default: No default


The rotation of the shape for this entity.

Range: -360.0..360.0

Default: 0


The width factor for the shape.

Range: 64-bit floating point number > 0

Default: 0


The oblique angle of the shape, which causes the entity to lean to the right or left of vertical, where positive numbers indicate to the right.

For convenience, the AutoCAD reader and writer will treat the range of values from 275.0..360.0, as an alternative specification of the range from -85.0..0.

Range: -85.0 ..85.0

Default: 0


The name of the file which contains fonts for large character sets.

Range: char[65]

Default: No default


The name of the shape which is being read or written.

Range: char[33]

Default: No default


The name of the file in which the shape is defined.

Range: char[65];

Default: No default


The rotation of the shape definition relative to the shape file specification.

Range: 64-bit floating point number

Default: 0


The height of the shape as defined in the shape file.

Range: 64-bit floating point number

Default: 0


The width of the shape as defined in the shape file.

Range: 64-bit floating point number

Default: 1


Indicates if the shape text, as defined in the shape file, is vertical or horizontal.

Range: yes | no

Default: None