ST_AsSVG-Methode für den ST

geometry-expression.ST_AsSVG([ format])

Name	Typ	Beschreibung
format	VARCHAR(128)	Eine Zeichenfolge, die die Parameter für die Konvertierung des geometry-expression in eine SVG-Darstellung definiert. Wenn sie nicht festgelegt wird, ist der Standardwert 'SVG'.

LONG VARCHAR Gibt ein vollständiges oder teilweises SVG-Dokument zurück, das den geometry-expression darstellt.

Die ST_AsSVG-Methode gibt ein vollständiges oder teilweises SVG-Dokument zurück, das für die grafische Anzeige der SVG-Datei verwendet werden kann. Die meisten Webbrowser mit Ausnahme von Microsoft Internet Explorer enthalten integrierte SVG-Anzeigefunktionen.

Verschiedene Optionen werden unterstützt und das gewünschte Format wird mit dem optionalen format-Parameter ausgewählt. Wenn der format-Parameter nicht angegeben wird, ist der Standardwert 'SVG'.

Die Formatzeichenfolge definiert ein Ausgabeformat und Parameter für das Format. Die Formatzeichenfolge hat eines der folgenden Formate:

Formatname

Formatname(Parameter1=Wert1;Parameter2=Wert2;...)

Parameter1=Wert1;Parameter2=Wert2;...

Das erste Format legt den Formatnamen und keine Parameter fest. Alle Formatparameter benutzen ihre Standardwerte. Das zweite Format legt den Formatnamen und eine Liste von benannten Parameterwerten fest. Nicht angegebene Parameter verwenden die Standardwerte. Das letzte Format gibt nur Parameterwerte an, der Formatname verwendet den Standardnamen 'SVG'.

Die folgenden Formatnamen können benutzt werden:

SVG Das Scalable Vector Graphics (SVG) 1.1-Format gemäß der Definition des World Wide Web Consortium (W3C).

Die folgenden format-Parameter können angegeben werden:

Formatname	Parametername	Standardwert	Zulässige Werte	Beschreibung
SVG	Approximate	Yes	Yes oder No	Der Parameter "Approximate" gibt an, ob die Größe des ausgegebenen SVG-Dokuments mit einer geringfügigen Verringerung der sichtbaren Details reduziert werden soll oder nicht. Die SVG-Daten werden als Näherungswert ("Approximate") dargestellt, indem Punkte nicht einbezogen werden, die sich innerhalb der Linienbreite des letzten Punkts befinden. Bei Geometrien mit mehreren Megabyte kann dies zu Kompressionsraten von 80 % oder mehr führen.
SVG	Attribute	Automatisch generierte optionale Attribute	Ein oder mehr SVG-Attribute, die an SVG-Formelemente angewendet werden können	Standardmäßig werden optionale SVG-Formattribute wie "fill", "stroke" und "stroke-width" generiert. Wenn der Attribute-Parameter angegeben ist, werden keine optionalen SVG-Formattribute generiert und der Attribute-Wert wird stattdessen verwendet. Wird ignoriert, wenn PathDataOnly=Yes festgelegt ist.
SVG	DecimalDigits	Basierend auf der Anzahl von Dezimalstellen der Rastergröße für die Funktion "Am Raster ausrichten" des räumlichen Bezugssystems. Der maximale Standardwert ist 5 und der Mindestwert ist 0 MB.	integer	Der DecimalDigits-Parameter begrenzt die Anzahl der Ziffern hinter dem Dezimalzeichen für Koordinaten, die in der SVG-Ausgabe generiert werden. Eine negative Stellenanzahl zeigt an, dass die Gesamtstellenzahl der Koordinaten in die SVG-Ausgabe einbezogen werden soll.
SVG	PathDataOnly	No (ein vollständiges SVG-Dokument wird generiert)	Yes oder No	Der PathDataOnly-Parameter legt fest, ob nur die Daten für das SVG-Pfadelement generiert werden sollen. Das nachstehende PathDataOnly-Beispiel zeigt, wie PathDataOnly=Yes verwendet werden kann, um ein vollständiges SVG-Dokument zu erstellen, das angezeigt werden kann. Standardmäßig wird ein vollständiges SVG-Dokument generiert. Die von PathDataOnly=Yes zurückgegebenen Pfaddaten können verwendet werden, um flexiblere SVG-Dokumente zu erstellen, die andere Elemente enthalten, beispielsweise Text.
SVG	RandomFill	Yes	Yes oder No	Der RandomFill-Parameter gibt an, ob Polygone mit einer zufallsgenerierten Farbe gefüllt werden sollen. Die verwendete Farbensequenz hält sich nicht an eine bestimmte Reihenfolge und ändert sich in der Regel jedes Mal, wenn eine SVG-Ausgabe generiert wird. None legt fest, dass nur ein Umriss jedes Polygons ausgegeben wird. Der RandomFill-Parameter wird ignoriert, wenn der Attribute-oder PathDataOnly=Yes-Parameter angegeben ist.
SVG	Relative	Yes	Yes oder No	Der Relative-Parameter legt fest, ob Koordinaten im relativen Format (Offset) oder absoluten Format ausgegeben werden sollen. Relative Koordinatendaten sind in der Regel kompakter als absolute Koordinatendaten.

Hinweis

Standardmäßig verwendet ST_AsSVG das Originalformat für eine Geometrie, wenn es verfügbar ist. Andernfalls wird das interne Format verwendet. Weitere Hinweise zu den internen Formaten und Originalformaten finden Sie unter STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung.

ST_AsSVGAggr-Methode für den ST_Geometry-Datentyp

SQL/MM (ISO/IEC 13249-3: 2006) Erweiterung des Herstellers

Der folgende Code gibt ein vollständiges SVG-Dokument mit Polygonen zurück, die mit zufallsgenerierten Farben gefüllt sind.

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsSVG()

Der folgende Code gibt ein vollständiges SVG-Dokument mit Umrisspolygonen zurück und beschränkt die Koordinaten auf 3 Zeichen hinter dem Dezimalzeichen.

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsSVG( 'RandomFill=No;DecimalDigits=3' )

Der folgende Code gibt ein vollständiges SVG-Dokument mit Polygonen zurück, die blau gefüllt sind und Koordinaten mit maximaler Gesamtstellenzahl aufweisen. Alle Formen mit Kurven enthalten ungültige SVGs, weil fill="none" und fill="blue" generiert werden.

SELECT Shape.ST_AsSVG( 'Attribute=fill="blue";DecimalDigits=-1' ) 
FROM SpatialShapes

Der folgende Code gibt ein vollständiges SVG-Dokument von SVG-Pfaddaten mit relativen, auf 5 Zeichen hinter dem Dezimalzeichen begrenzten Koordinaten zurück.

SELECT '<?xml version="1.0" standalone="no"?>
	<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
	"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
	<svg viewBox="-180 -90 360 180" xmlns="http://www.w3.org/2000/svg" 
	    version="1.1">
	    <path fill="lightblue" stroke="black" stroke-width="0.1%" d="' ||
    NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
	    .ST_AsSVG( 'PathDataOnly=Yes' ) ||
       '"/></svg>'

Der folgende Code gibt SVG-Pfaddaten mit absoluten, auf 7 Zeichen hinter dem Dezimalzeichen begrenzten Koordinaten.

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsSVG( 'PathDataOnly=Yes;Relative=No;DecimalDigits=7' )

ST_AsSVG-Methode für den ST_Geometry-Datentyp

Syntax

Parameter

Rückgabe

Bemerkungen

Hinweis

Siehe auch

Standards und Kompatibilität

Beispiel