Viewinfo Reader/Writer

Transkript

1 Viewinfo Reader/Writer Version 0.9rc5_FME2010 Der Viewinfo Reader/Writer ermöglicht das Lesen bzw. Schreiben von Dateien im Format Viewinfo mittels FME 1 und ist ein Produkt von Axmann Geoinformation. Das Format Viewinfo wurde von Fa. NOVOtec entwickelt. Der viewinfo Reader/Writer basiert auf folgenden Dokumenten GEOBESTAND.TXT GEOOBJECT.TXT ncanvas.n.html View Info Beispiel Schnittstelle nativ.view Der Viewinfo Reader/Writer wurde zur Anwendung unter Windows 2000/XP entwickelt. Die Verwendung von Windows 98/ME ist nicht möglich, da FME diese Plattform nicht unterstützt. Die Version 0.9rc5_FME2010 des Viewinfo Reader/Writers erfordert FME FME ist ein Produkt von Safe Software Inc., Surrey BC, Kanada axmann geoinformation gmbh Tech Gate Vienna, Donau-City-Straße 1, A-1220 Wien Tel. +43/1/ Fax. +43/1/ office@axmann.at FN f, HG Wien Konto-Nr: Erste Bank, BLZ: UID: ATU

2 INHALTSVERZEICHNIS 1 Überblick FUNKTION UNTERSTÜTZTE TOOLS DER FME LIZENZ INSTALLATION LIZENZ- UND NUTZUNGSBEDINUNGEN Allgemeines EINSCHRÄNKUNGEN Reader Überblick READER KEYWORDS DATASET ENCODING MATRIX_CHAR_WIDTH MATRIX_SCALE_FACTOR Writer Überblick WRITER KEYWORDS DATASET ENCODING MATRIX_CHAR_WIDTH MATRIX_SCALE_FACTOR Feature Representation ALLGEMEINES GEOOBJECT RELATION GRAPHIKATTRIBUTE...14 axmann geoinformation gmbh Seite 2 von 14

3 1 Überblick 1.1 Funktion In der vorliegenden Version werden folgende Objektarten verarbeitet, d.h. durch den Reader gelesen bzw. durch den Writer geschrieben. Nicht unterstützte Objektarten werden durch den Reader ignoriert. Geometrietyp Reader Writer ARC Nein Nein BITMAP Nein Nein CIRCLE Nein Nein IMAGE Nein Nein LINE Ja Ja OVAL Nein Nein POLYGON Ja Ja RASTER Nein Nein RECTANGLE Nein Nein SYMBOL Ja Ja TEXT 2 Nein Nein WINDOW Nein Nein 1.2 Unterstützte Tools der FME Tool Reader Writer FME Universal Translator, "Run mapping file" Ja Ja FME Universal Translator, "Generate mapping file" Ja Nein FME Universal Translator, "Translate" Ja Nein FME Viewer Ja n/a FME Workbench Ja Ja FME Objects Ja Ja 2 Texte werden als SYMBOL abgebildet. axmann geoinformation gmbh Seite 3 von 14

4 1.3 Lizenz Um dieses Produkt nutzen zu können, benötigen Sie eine Lizenz von Axmann Geoinformation. Ihre Lizenzen befinden sich in der Datei ax_license.dat, die im $FME_HOME Verzeichnis vorhanden sein muss. Eine Evaluierungslizenz liegt bei. Diese muss ins $FME_HOME Verzeichnis kopiert werden, bzw. wenn eine ax_license.dat Datei bereits existiert, so muss der Inhalt angehängt werden. Die Textblöcke dürfen dabei nicht verändert werden. Die Installation dieser Lizenzdatei wird vom Installationsprogramm nicht automatisch ausgeführt. Um eine uneingeschränkte Lizenz zu erhalten, schicken Sie bitte die mit dem Axmann HostID Generator (im Startmenü) erzeugte ID an Axmann Geoinformation Sie erhalten dafür im Gegenzug ihren Lizenzierungscode zugesandt. Sie können die Funktion An Datei anhängen verwenden, um die ID in eine Textdatei zu schreiben, die Sie versenden können. Für nähere Informationen wenden sie sich bitte an Axmann Geoinformation. 1.4 Installation Die Auslieferung erfolgt auf einer CD, die ein Setup Programm enthält (Install-Shield). Sollte das nicht möglich sein, gehen Sie nach folgender Anleitung vor: plugins\viewinfo.dll metafile\viewinfo.fmf formatsinfo\viewinfo.db in $FME_HOME\plugins kopieren in $FME_HOME\metafile kopieren in $FME_HOME\formatsinfo kopieren Die Dateien msvcr71.dll und msvcp71.dll, msvcr90.dll und msvcp90.dll, icuuc42.dll und icudt42.dll enthalten die MS Visual C, bzw. MS Visual C++ Runtime. Diese sind in das FME_HOME zu kopieren. Keine existierenden Dateien ersetzen. 1.5 Lizenz- und Nutzungsbedinungen Durch den rechtmäßigen Erwerb eines FME PlugIns von Axmann Geoinformation ist der Lizenznehmer zur Nutzung des Produktes im Rahmen der nachfolgend spezifizierten Lizenz- und Nutzungebedingungen berechtigt. Mit Installation und Inbetriebnahme des Produktes erklärt sich der Lizenznehmer mit diesen Bedingungen einverstanden. Gegenstand der Lizenzierung Axmann Geoinformation ist Eigentümer und Inhaber der jeweiligen Software und gewährt dem Lizenznehmer nach Maßgabe dieser Lizenzbedingungen das nichtausschließliche und nicht-übertragbare Nutzungsrecht (Lizenz) an der Software und der zugehörigen Dokumentation. Axmann Geoinformation hat das Recht, jederzeit Ausführung und Inhalt des Produktes zu aktualisieren und(oder zu revidieren. Aktualisierte oder revidierte Produkte unterliegen ebenfalls den Bestimmungen dieses Vertrages. axmann geoinformation gmbh Seite 4 von 14

5 Nutzungsrecht, Missbrauch Der Lizenznehmer erkennt die Rechte von Axmann Geoinformation an der gegenständlichen Software (Patente, Urheberrechte, Warenzeichen, Geschäftsgeheimnisse) uneingeschränkt an. Das betrifft auch das exklusive Copyright an sämtlichen analogen und digitalen Dokumentationen der Produkte. Kopien des Produktes samt Dokumentation dürfen nur für Sicherungszwecke angefertigt werden. Das Nutzungsrecht der Software umfasst bei Einzelplatzlizenzen die Anwendung der Software auf einem Personal-Computer. Bei Mehrplatzlizenzen kann die Software auf beliebig vielen Personal-Computern installiert werden, die parallele Nutzung ist jedoch nur entsprechend der Anzahl der erworbenen Lizenzen gestattet. Nicht erlaubt ist: die Nutzung der Software über das Nutzungsrecht gemäß Punkt 2 hinaus jegliche Form der Weitergabe der Software und zugehörigen Materialien an Dritte (z.b. Verkauf, Vermietung, Verleih und unentgeltliche Weitergabe) Einsatz als Application Service Provider (ASP). Hierzu ist eine gesonderte Lizenzvereinbarung erforderlich. Jegliche nicht lizenzierte Nutzung stellt eine Verletzung der Schutzrechte von Axmann Geoinformation dar, die eine strafrechtliche Verfolgung nach sich ziehen kann. Der Lizenznehmer erklärt sich bereit, alle notwendigen Maßnahmen zum Schutz dieser Rechte zu treffen und insbesondere die unautorisierte Nutzung, Vervielfältigung, Weitergabe und Veröffentlichung der Software zu verhindern. Haftung und Gewährleistung Das Produkt ist erprobt und auf seine Funktionstüchtigkeit bei sachgemäßer Anwendung und Nutzung überprüft. Für die jeweilige Verwendung des Lizenznehmers wird keine Garantie übernommen. Auftretende Mängel sind Axmann Geoinformation sofort mitzuteilen. Die Gewährleistung erfolgt durch Nachbesserung bzw. Ersatzlieferung. Eins Anspruch auf Wandlung oder Minderung besteht nur bei Fehlschlagen der Nachbesserung bzw. Ersatzlieferung innerhalb angemessener Frist (mindestens 4 Wochen). Weitergehende Gewährleistungs- oder Ersatzansprüche, insbesondere die Haftung für mittelbare Schäden, sind ausgeschlossen. Es gelten die gesetzlichen Mindestzeiträume der Gewährleistungsansprüche für Softwareprodukte. Geltungsdauer Das Nutzungsrecht tritt mit der Zahlung der Lizenzgebühr an Axmann Geoinformation in Kraft. Die Lizenz wird auf unbestimmte Dauer erteilt. Wird das Nutzungsrecht durch den Lizenznehmer nicht mehr ausgeübt oder ist es widerrufen, ist der Lizenznehmer verpflichtet, sämtliche in seinem Besitz befindliche Produkt-Software einschließlich der Dokumentation zu vernichten oder auf seinen Kosten an Axmann Geoinformation zu retournieren. Der Lizenznehmer ist auch über die Nutzungsdauer hinaus zur Wahrung der Schutzrechte der Lizenzgeberin verpflichtet. Schlussbestimmungen Alle Änderungen oder Ergänzungen dieser Lizenzbedingungen bedürfen zu ihrer Wirksamkeit der Schriftform. Sollten einzelne Bestimmungen dieser Lizenzbedingungen unwirksam sein, berührt das die Wirksamkeit der übrigen Bestimmungen nicht. Unwirksame Bestimmungen sind durch Regelungen zu ersetzen, deren Wirkung dem angestrebten wirtschaftlichen Zweck der Lizenzbedingungen entspricht. Es gilt das Recht der Republik Österreich. Gerichtsstand für alle Streitigkeiten in Zusammenhang mit den Regelungen dieser Lizenzbedingungen ist Wien. axmann geoinformation gmbh Seite 5 von 14

6 2 Allgemeines 2.1 Einschränkungen Symboldefinitionsdateien können nicht gelesen werden ARCs werden als (lineare) Kreisbögen verarbeitet, da FME keine (flächigen) Kreis/Ellipsensegmente kennt. axmann geoinformation gmbh Seite 6 von 14

7 3 Reader Überblick 3.1 Reader Keywords Die nachfolgende Tabelle listet die Keywords, die durch den Viewinfo Reader verarbeitet werden. Den Suffixes der Liste steht das <ReaderKeyword> voran. Im Standardfall ist das <ReaderKeyword> für den Viewinfo Reader VIEWINFO. Keyword Suffix Bedeutung Required/ DATASET DEBUG ENCODING Beinhaltet den vollständigen Pfadnamen der zu lesenden Datei Zeigt an, ob Debug-Informationen ausgegeben werden sollen. 0 (default) bedeutet aus; Werte über 2 erzeugen große Mengen an Ausgaben die nur für Entwickler interessant sind. Zeichensatz, der bei der Bearbeitung in FME verwendet werden soll. Standardwert: ISO MATRIX_CHAR_WIDTH Das Seitenverhältnis, das zur Konstruktion der Text/Symbol Matrix verwendet werden soll. Standardwert: 1.0 MATRIX_SCALE_FACTOR Der Skalierungsfactor, der zur Konstruktion der Text/Symbol Matrix verwendet werden soll. Standardwert: Required DATASET Dieses Keyword beinhaltet den vollständigen Pfadnamen der Viewinfo-Datei. Ein typischer Eintrag in die Regeldatei kann sein: VIEWINFO_DATASET C:\Daten\Gsdf\ view Der Viewinfo Reader/Writer erwartet die Filename-Extension.view aber akzeptiert auch jede andere Endung ENCODING Zeichensatz, der bei der Bearbeitung in FME verwendet werden soll. Es können alle Bezeichnungen verwendet werden, die die ICU Bibliothek kennt. Nach dem Lesen der Viewinfo Datei werden Texte von UTF-8 in diesem Zeichensatz konvertiert. Standardwert ist ISO axmann geoinformation gmbh Seite 7 von 14

8 VIEWINFO_ENCODING WINDOWS MATRIX_CHAR_WIDTH Das Seitenverhältnis, das zur Interpretation der Text/Symbol Matrix verwendet werden soll. Im Reader wird dieser Wert nur für die Darstellung im FME-Viewer verwendet. Standardwert ist MATRIX_SCALE_FACTOR Der Skalierungsfactor, der zur Interpretation der Text/Symbol Matrix verwendet werden soll. Im Reader wird dieser Wert nur für die Darstellung im FME-Viewer verwendet. Standardwert ist axmann geoinformation gmbh Seite 8 von 14

9 4 Writer Überblick 4.1 Writer Keywords Die nachfolgende Tabelle listet die Keywords, die durch den Viewinfo Writer verarbeitet werden. Den Suffixes der Liste steht das <WriterKeyword> voran. Im Standardfall ist das <WriterKeyword> für den Viewinfo Writer VIEWINFO. Keyword Suffix Bedeutung Required/ DATASET ENCODING MATRIX_CHAR_WIDTH Beinhaltet den vollständigen Pfadnamen der zu erzeugenden Viewinfo-Datei Zeichensatz, der bei der Bearbeitung in FME verwendet werden soll. Standardwert: ISO Das Seitenverhältnis, das zur Konstruktion der Text/Symbol Matrix verwendet werden soll. Standardwert: 1.0 MATRIX_SCALE_FACTOR Der Skalierungsfactor, der zur Konstruktion der Text/Symbol Matrix verwendet werden soll. Standardwert: Required DATASET Dieses Keyword beinhaltet den vollständigen Pfadnamen der Viewinfo-Datei. Eine typische Eintragung in die Regeldatei kann sein: VIEWINFO_DATASET C:\Daten\Gsdf\ view ENCODING Zeichensatz, der bei der Bearbeitung in FME verwendet werden soll. Es können alle Bezeichnungen verwendet werden, die die ICU Bibliothek kennt. Vor dem Schreiben in die Viewinfo Datei werden Texte von diesem Zeichensatz nach UTF-8 konvertiert. Standardwert ist ISO VIEWINFO_ENCODING WINDOWS MATRIX_CHAR_WIDTH Das Seitenverhältnis, das zur Konstruktion der Text/Symbol Matrix verwendet werden soll. Auf diese Weise kann nur ein Seitenverhältnis für die ganze Abbildung verwendet deren. Müssen verschiedene Seitenverhältnisse verwendet werden, so muss die Matrix explizit angegeben werden, denn wenn vom Benutzer eine Matrix explizit angegeben ist, wird keine konstruiert. Standardwert ist 1.0. axmann geoinformation gmbh Seite 9 von 14

10 4.1.4 MATRIX_SCALE_FACTOR Der Skalierungsfactor, der zur Konstruktion der Text/Symbol Matrix verwendet werden soll. Auf diese Weise kann nur ein Skalierungsfactor für die ganze Abbildung verwendet deren. Müssen verschiedene Skalierungsfactoren verwendet werden, so muss die Matrix explizit angegeben werden, denn wenn vom Benutzer eine Matrix explizit angegeben ist, wird keine konstruiert. Standardwert ist axmann geoinformation gmbh Seite 10 von 14

11 5 Feature Representation 5.1 Allgemeines Als FME FeatureType wird der Grafikbestand verwendet, i.e. der Teil der Objektid, der vor dem Doppelpunkt steht. Der Viewinfo Reader/Writer erzeugt bzw. verarbeitet FME Rich Geometries. Dadurch ist es möglich, die Struktur der Viewinfo-Datei im Wesentlichen zu erhalten. Das viewinfo_type Attribut gibt an, um welche Objektart es sich handelt. Viewinfo Kennung draw command viewinfo_type viewinfo_geometr y GEOOBJECT symbol viewinfo_symbol symbol/point GEOOBJECT symbol viewinfo_text symbol/text GEOOBJECT line viewinfo_line line GEOOBJECT polygon viewinfo_polygon polygon GEOOBJECT arc viewinfo_arc arc GEOOBJECT circle viewinfo_circle circle GEOOBJECT oval viewinfo_oval oval GEOOBJECT rectangle viewinfo_rectangle rectangle GEOOBJECT {*} viewinfo_composite_geoobject {*} REL viewinfo_relation Der Viewinfo Reader/Writer kennt folgende Geometrietypen: viewinfo_geometry FME Geometry Beschreibung line IFMELine Linie polygon IFMEPolygon Polygon symbol/point IFMEPoint Symbol als Punkt symbol/text IFMEText Symbol als Text. Wenn es in den folgenden Vektorklassen vorkommt: DistMeasure, ArcMeasure, Collin{1,2}Measure, Ortho{1,2}Measure, Text, TX, TA arc IFMEArc Kreis bzw. Ellipsenbogen. Siehe Einschränkungen. circle IFMEEllipse Kreis oval IFMEEllipse Oval rectangle IFMEPolygon Rechteck - IFMENull Bei Relationen {*} IFMEAggregate Aggregate werden unterstützt. axmann geoinformation gmbh Seite 11 von 14

12 Wenn eine GEOOBJECT aus mehreren Geometrieelementen besteht, wird es vom Reader als IFMEAggregate Feature ausgegeben mit dem viewinfo_type viewinfo_composite_geoobject. Der Writer akzeptiert sowohl diese Komplexobjekte als auch einzelne Geometrieelemente, die nach ihrer Objektid automatisch zusammengefasst werden. Relationen werden immer nach der Master ObjektID zusammengefasst und müssen auch so an den Writer übergeben werden. Die erzeugten Attribute richten sich danach, was in der Viewinfo Datei gefunden wird. Es gibt zwei große Attributgruppen: viewinfo_user.xxx für u und viewinfo_draw.xxx. für -draw, wobei letzteres als Geometrieattribute an die Geometrie gebunden ist. Wofür xxx steht lässt sich im wesentlichen aus folgenden Regeln ableiten: Bei viewinfo_user wird das erste Element der Liste verwendet. Bei viewinfo_draw wird der Name des Zeichenattributs ohne den - verwendet. Bei viewinfo_detail wird der Name der Relation verwendet. Das type Attribut wird als viewinfo_class übergeben. Der Wert des z Attributes wird als z-koordinaten Geometrie übergeben. Das bound Attribut wird vom Reader ignoriert und vom Writer automatisch generiert. 5.2 Attributreihenfolge Das Plugin versucht die Reihenfolge der User-Attribute (-u) beizubehalten. Er verwendet dazu spezielle Funktionen der FME API, die die Attributreihenfolge berücksichtigt. Der Reader setzt diese Sequenced Attributes automatisch. Für den Writer muss man diese Sequenced Attributes selbst erzeugen. Das geht z.b. mit einem PythonCaller Transformer: from pyfme import * class seqattsetter(object): def init (self): pass def input(self, feature): feature.setseqattribute( viewinfo_user.width, 2m ) self.pyoutput(feature) def close(self): pass Dabei müssen die Attribute mit setseqattribute() in der richtigen Reihenfolge gesetzt werden. axmann geoinformation gmbh Seite 12 von 14

13 5.3 Geoobject FME geometry: FME FeatureType: FME Rich Geometry Identisch dem viewinfo_bestand Attribut FME Attribut Name viewinfo_id viewinfo_bestand viewinfo_objectid viewinfo_meridian viewinfo_netzart viewinfo_bzl viewinfo_user.<attributname> Beschreibung Numerische ID des Objektes Zeichenkette vor der numerischen ID, ohne trennenden Doppelpunkt. Vollständige Objektid Meridan Netzart BZL User Attribute. <attributname> steht für den ersten Wert der Liste. Die Reihenfolge wird über Sequenced Attributes gesteuert, siehe Kapitel Relation viewinfo_type: FME geometry: FME FeatureType: viewinfo_relation keine Identisch dem viewinfo_bestand Attribut FME Attribut Name viewinfo_id viewinfo_bestand viewinfo_objectid viewinfo_meridian viewinfo_netzart viewinfo_bzl viewinfo_detail.<relationsname> Viewinfo_detail_ids{} Beschreibung Numerische ID des Objektes Zeichenkette vor der numerischen ID, ohne trennenden Doppelpunkt. Vollständige Objektid Meridan Netzart BZL ObjektID des Details bei benannten Relationen. xxx steht für den Relationsnamen. ObjectID des Details bei numerierten Relationen. axmann geoinformation gmbh Seite 13 von 14

14 5.5 Graphikattribute FME Attribut Name viewinfo_draw.<attributname> viewinfo_geometry viewinfo_draw.rotation viewinfo_draw.italic_angle viewinfo_draw.char_height viewinfo_draw.char_width Beschreibung Attribute des draw Befehls. <attributname> steht für das Zeichenattribut ohne Bindestrich. Geometietyp. Siehe Tabelle Geometrietypen. Pseudo-Graphikattribut. Beim Lesen wird es aus der viewinfo_draw.matrix extrahiert. Beim Schreiben wird es verwendet um die viewinfo_draw.matrix zu konstruieren (Schreiben), wenn sie nicht explizit gegeben ist. Wenn weder viewinfo_draw.matrix noch viewinfo_draw.rotation gegeben ist, wird die fme_rotation bzw. das Rich-Geometry Pendant dazu verwendet. Pseudo-Graphikattribut. Beim Lesen wird es aus der viewinfo_draw.matrix extrahiert. Beim Schreiben wird es verwendet um die viewinfo_draw.matrix zu konstruieren (Schreiben), wenn sie nicht explizit gegeben ist. Wenn weder viewinfo_draw.matrix noch viewinfo_draw.rotation gegeben ist, wird 90 verwendet. Pseudo-Graphikattribut. Beim Lesen wird es aus der viewinfo_draw.matrix extrahiert. Beim Schreiben wird es verwendet um die viewinfo_draw.matrix zu konstruieren (Schreiben), wenn sie nicht explizit gegeben ist. Wenn weder viewinfo_draw.matrix noch viewinfo_draw.rotation gegeben ist, wird fme_text_size bzw. dessen Rich-Geometry Pendant dazu verwendet. Pseudo-Graphikattribut. Beim Lesen wird immer MATRIX_CHAR_WIDTH verwendet, da dieser Wert ohne Nebenbedingungen nicht eindeutig aus der Matrix extrahiert werden kann. Beim Schreiben wird es verwendet um die viewinfo_draw.matrix zu konstruieren (Schreiben), wenn sie nicht explizit gegeben ist. Wenn weder viewinfo_draw.matrix noch viewinfo_draw.rotation gegeben ist, wird MATRIX_CHAR_WIDTH verwendet. axmann geoinformation gmbh Seite 14 von 14