ImportISFF()
Summary
Imports features from Intergraph Design File format (DGN) files, also known as Intergraph Standard File Format (ISFF).
Syntax
ImportISFF(array filenames, string new_db_name, string layer_type, string units, array options)
| Argument | Contents |
|---|---|
| filenames | An array containing the path and file names of the files to import |
| new_db_name | The path and file name of the new geographic file |
| layer_type | The type of the layer: "Point", "Line", or "Area" |
| units | The units to use: "UOR", "MU", or "SU" |
| Option | Type | Contents |
|---|---|---|
| Entity | Integer | The entity number to match for MSLINK |
| Label | String | A descriptive label for the geographic file |
| Layer Name | String | The name of the layer in the geographic file |
| Levels | Array | An array of desired levels (defaults to all) |
| Median Split | Boolean | If "True" special handling ensures that entities which cross the 180 degree longitude line are imported properly; if "False" (the default), no special handling is invoked |
| NAD Conversion | Array | Input datum, output datum, and conversion file (if needed); the input and output datums should be different |
| Node Layer Name | String | Name of the node layer; only for line layers |
| Optimize | Boolean | Whether to optimize the geographic file automatically after the import (defaults to "True") |
| Projection | String and Array | A string with the projection name, and an array of projection options; the option {"units","us-ft"} needs to be specified for normal 1927 State Plane Coordinates |
| Table Filename | String | The path and name of the file in which attributes are stored; the file extension must be .BIN, .CSV, .DBF, or .TXT; a required option |
| Transform | Array | Array indicating the transformation to apply to coordinates in the file. This can have three forms:1. An array of two or more four-element arrays containing local and world coordinates for control points, for example, {{real localX1, real localY1, real longitude1, real latitude1}, ...}2. An array of four elements - {real X_multiplier, real Y_multiplier, real X_offset, real Y_offset}3. Center and Extent transform {c1_x, c1_y, width_1, c2_x, c2_y, width_2}where center is shifted from (c1_x,c1_y) to (c2_x,c2_y), and vector of length width_1 out of c_1 becomes a vector of length width_2 out of c_2. |
Notes
-
For more details on the NAD Conversion option, see Datum Conversions.
-
For more details on the Projection option, see Using Projections and Coordinate Systems.
-
The table is hard linked to the geography if it exists and Layer Name has been specified.
Example
ImportISFF({"c:\\isfffiles\\boston.dgn"}, "boston.dbd", {
{"Label", "Boston Parcels"},
{"Layer Name", "Parcels"},
{"Optimize", "True"},
{"Table Filename", "boston.bin"}
})
Error Codes
| Error Type | Meaning |
|---|---|
| NotFound | The specified file could not be found |
| Error | The file is not a valid ISFF file |
See Also
| Function | Summary |
|---|---|
| GetISFFInfo() | Collects summary information on the contents of an Intergraph Standard File Format (ISFF) file |
| ImportDXF() | Imports features from a DXF file into a geographic file |