GetDXFInfo()

Summary

Collects summary information on the contents of a DXF file.

Syntax

dxf_info = GetDXFInfo(string dxf_file_name, string detail_flag)

Argument Contents
dxf_file_name The path and file name of the DXF file
detail_flag If "True" GetDXFInfo() collects information on the fields and entity types in the file; if "False" this information is not collected

Returns

An array of information as follows:

Element Type Contents
1 Array An array of strings indicating the names of layers in the DXF file, or null if the DXF file header is missing
2 Array An array of four real numbers indicating the bounding coordinates of the file: {x_min, y_min, x_max, y_max}
3 String The DXF file version number, or null if the DXF file header is missing
4 Array An array of strings indicating the names of the applications that created the file, or null if this information is missing
5 Array An array of field name-type pairs identifying the name and type of attributes in the file; or null if detail_flag was "False"
6 Array An array of entity type-count pairs indicating the quantity of each type of entity in the file; or null if detail_flag was "False"

Notes

  • If detail_flag is "True" GetDXFInfo() uses but does not release memory holding the results. You should call either ImportDXF() or ClearDXFInfo() to release this memory.

  • The entity type-count list includes one entry for each of the following types: POINT, TEXT, LINE, POLYLINE, ARC, POLYGON, CIRCLE, 3DFACE, SOLID, and TRACE.

  • Valid field types are "Long", "Real", and "String."

Example

// This call...
dxf_info = GetDXFInfo("c:\\drawing.dxf", "True")
// Returns this type of information...
// dxf_info = {
// {"Streets", "Water", "Bldgs", ... }, (layer names)
// {2000, 8000, 42600, 31000}, (bounding rect)
// "R11", (version number)
// {"ACAD"}, (application)
// {{"Name", "String"}, {"Level", "Long"}}, (attributes and types)
// {{"POINT", 231}, {"TEXT", 100}, ...} (counts by entity type)
// }

Error Codes

Error Type Meaning
NotFound There is no DXF file with the given path and file name
Error The file is not a valid DXF file

See Also

Function Summary
ImportDXF() Imports features from a DXF file into a geographic file
ClearDXFInfo() Frees memory used by GetDXFInfo()