Mit dem Modul SHPIN können Objekte aus ESRI Shapefile Dateien gelesen werden.
SHPIN wird mit:
|INCL \script\shpin.mod
in einer ICS RUN1-Konfiguration verfügbar gemacht.
Folgende Parameter können in der Map
SHPIN_PARAM für den Modul SHPIN gesetzt
werden:
| Parameter | req/opt | Beschreibung |
STATISTICS | r | ON oder OFF.
Objektstatistik am Ende der .log Datei ausgeben. |
DEBUG | r | ON oder OFF.
Debugmodus ein- oder ausschalten (Default =
OFF). |
DBF_DOS | o | ON oder OFF.
Falls ON gesetzt wird, werden DBF-Dateien
im DOS-Zeichensatz gelesen. Sonst wird der
Windowszeichensatz gelesen. |
READ_M | o | ON oder OFF.
Falls ON gesetzt wird, werden die
Measurement-Werte als Z-Koordinaten gelesen, falls
vorhanden. Eventuelle Z-Koordinaten werden nicht gelesen.
Mesurement-Werte können in fogenden Shape Typen vorkommen:
POINTZ,POINTM,
MULTIPOINTZ,MULTIPOINTM,POLYLINEZ,POLYLINEM,
POLYGONZ,POLYGONM. |
Der Modul SHPIN liefert pro IN-Objekt folgende Systemkomponenten:
| Komponente | req/opt | Beschreibung |
IN.FILE(s) | r | Name der Inputdatei ohne Verzeichnis und ohne Endung. |
IN.TYPE(s) | r | Typ des Objekts. Mögliche Werte für
IN.TYPE sind: NULL,
POINT,
MULTIPOINT,POLYLINE,
POLYGON. |
IN.SHPTYPE(s) | r | Shapetyp des Objekts. Mögliche Werte für
IN.SHPTYPE sind:
NULLSHP,
POINT,POINTZ,POINTM,
MULTIPOINT,MULTIPOINTZ,MULTIPOINTM,POLYLINE,POLYLINEZ,POLYLINEM,
POLYGON,POLYGONZ,POLYGONM. |
IN.DIMENSION(s) | r | Dimension der Objektgeometrie. Mögliche Werte
sind: |
IN.FEATUREID(i) | r | Featureid. |
IN.MINX(r),
IN.MINY(r) IN.MAXX(r),
IN.MAXY(r) | r | XY-Rangebox um die Objektgeometrie
IN.GEOM. |
IN.MINZ(r),
IN.MINZ(r) | o | Z-Range der Objektgeometrie
IN.GEOM, falls Z vorhanden ist. |
IN.MINM(r),
IN.MINM(r) | o | M-Range der Objektgeometrie
IN.GEOM, falls M vorhanden ist. |
IN.GEOM(p,l) | r | Objektgeometrie. Bemerkungen: Die Geometrie
wird beim Typ |
Neben dem IN-Objekt liefert der Modul SHPIN alle Attribute des
aktuellen Objekts in der Map SHPIN_REC.
| Prozedur | SHPIN_OPEN ! [s input][] |
| Beschreibung | Öffnet die SHP Datei
<input>. Die Prozedur wird von RUN1
automatisch aufgerufen. |
| Beispiel | |
| Prozedur | SHPIN_READ_OBJECT ! [][b state] |
| Beschreibung | Liest das nächste Objekt
aus der aktuellen SHP-Inputdatei. Das Objekt wird in der MAP
|
| Beispiel | |
| Prozedur | SHPIN_CLOSE ! [][] |
| Beschreibung | Schliesst den Modul und gibt die durch den Modul belegten Resourcen wieder frei. Die Prozedur wird von RUN1 automatisch aufgerufen. |
| Beispiel | |
! Diese ICS Konfiguration zeigt alle von shpin.mod ! gelesenen Objekte in der .log Datei an. |LICENSE \license\iltools.lic MAP USER_INPUT1 DIALOG => FILE ! FILE | STRING | ODBC MESSAGE => 'Enter .shp Input File' FILE_FILTER => shp FILE_EXISTS => TRUE OPT => input END_MAP MAP SHPIN_PARAM STATISTICS => ON DEBUG => OFF END_MAP MAP INPUT_SOURCES I1 => SHPIN,OPT.input END_MAP MAP INOUT I1 => DISPLAY_OBJECT1,IN,DISPLAY_OBJECT1,SHPIN_REC END_MAP |INCL \script\util.lib |INCL \script\shpin.mod |INCL \script\run1.prg