Routines (alphabetical) > Routines: G > GET_DXF_OBJECTS

# GET_DXF_OBJECTS

The GET_DXF_OBJECTS function returns an IDLgrModel containing graphics from a given DXF file.

## Examples

filename = FILEPATH('heart.dxf', SUBDIR=['examples', 'data'])

oModel = GET_DXF_OBJECTS(filename)

XOBJVIEW, oModel

## Syntax

Result = GET_DXF_OBJECTS( Filename [, Blocktable] [, Layertable] [, /BYLAYER] [, IGNORED=array])

## Return Value

Returns an IDLgrModel object for the Model_Space block (the default block of the DXF file).

## Arguments

### Filename

A string containing the full path to the DXF file.

### Blocktable

A named variable that will contain an array of structures describing the blocks contained in the DXF file.

### Layertable

A named variable that will contain an array of structures describing the layers contained in the DXF file.

## Keywords

### BYLAYER

Set this keyword to read files by layer. By default, files are read by block.

### IGNORED

Set this keyword to a named variable that will contain an array of 21 elements containing the counts of DXF entities that were ignored because of unimplemented DXF data types.

## Structure of DXF File Information

The tags for the structure passed by the BLOCKTABLE and LAYERTABLE keywords are as follows:

Structure Tag | Type | Description
Name | string | Block/layer name or NULL for *Model_Space block
Model | object | IDLgrModel object for this block/layer
nEntries | lonarr(21) | Number of DXF entities in this block, indexed by DXF type
ColorName | string | Entity’s color name
Color | bytarr(3) | Entity’s color RGB
ColorIndex | int | DXF color index
Visible | int | Set if layer is visible

## Version History

7.1 | Introduced

## See Also

IDLffDXF, XDXF