Extended data (XDATA)

Extended data allows for the inclusion of additional information that is not explicitly defined by the standard DXF entity data, such as custom application-specific data or metadata. It is stored as a list of name-value pairs associated with the entity.

Register application id

To use XDATA in a DXF file, you need to first register an APPID in the tables section of the file:

const appIdTest = dxf.tables.addAppId("TEST_APPID")

Create an entity

Next create an entity that needs XDATA to be associated with it:

const line = dxf.addLine(point3d(), point3d(100, 100))

Add xdata object

const xdataTest = line.addXData(appIdTest.name)

Add a string

xdataTest.string('Test string')

Add a layer name

xdataTest.layerName('layer_name')

DANGER

The layer name should be defined in order to make DXF file valid.

const layerExist = dxf.layer('layer_name')
if (layerExist) {
  xdataTest.layerName(layerExist.name)
}

Add a binary data

xdataTest.binaryData('.....')

Add a database handle

xdataTest.databaseHandle('1A16235')

Add a 3 reals

xdataTest.point(point3d(100.2, 100.3, 100))

Add a world space position

xdataTest.position(point3d(100.2, 100.3, 100))

Add a world space displacement

xdataTest.displacement(point3d(100.2, 100.3, 100))

Add a world direction

xdataTest.displacement(point3d(100.2, 100.3, 100))

Add a real

xdataTest.real(100.34)

Add a distance

xdataTest.distance(1002.56)

Add a scale factor

xdataTest.scale(2)

Add a integer

xdataTest.integer(209)

Add a long

xdataTest.long(27353653)