ST_AsSVGAggr-Methode für den ST

ST_Geometry::ST_AsSVGAggr(geometry-column[ ORDER BY order-by-expression [ ASC | DESC ], ... ] [, format])

Name	Typ	Beschreibung
geometry-column	ST_Geometry	Der Geometriewert für die SVG-Abbildung. Das ist üblicherweise eine Spalte.
format	VARCHAR(128)	Eine Zeichenfolge, die die Parameter definiert, die bei der Konvertierung der einzelnen Geometriewerte in eine SVG-Darstellung zu verwenden sind. Wenn sie nicht festgelegt wird, ist der Standardwert 'SVG'.

LONG VARCHAR Gibt ein vollständiges oder teilweises SVG-Dokument zurück, das die Geometrien in einer Gruppe darstellt.

Die ST_AsSVGAggr-Methode gibt ein komplettes oder teilweises SVG-Dokument zurück, das verwendet werden kann, um die Vereinigung einer Gruppe von Geometrien mit einer SVG-Anzeigefunktion grafisch darzustellen. 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.

Die ORDER BY-Klausel kann angegeben werden, um zu steuern, wie überlappende Geometrien dargestellt werden, wobei die Geometrien von hinten nach vorn angezeigt werden. Wenn dieser Parameter nicht festgelegt wird, werden die Geometrien in einer Reihenfolge angezeigt, die vom Ausführungsplan abhängt, der vom Abfrageoptimierer ausgewählt wird. Dies kann von Ausführung zu Ausführung der Anweisung unterschiedlich sein.

Hinweis

Standardmäßig verwendet ST_AsSVGAggr 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_AsSVG-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 ST_Geometry::ST_AsSVGAggr( Shape ) 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="-10 -10 20 12" xmlns="http://www.w3.org/2000/svg" 
	    version="1.1">
	    <path fill="lightblue" stroke="black" stroke-width="0.1%" d="' ||
	      ST_Geometry::ST_AsSVGAggr( Shape, 'PathDataOnly=Yes' ) ||
       '"/></svg>'
FROM SpatialShapes

ST_AsSVGAggr-Methode für den ST_Geometry-Datentyp

Syntax

Parameter

Rückgabe

Bemerkungen

Hinweis

Siehe auch

Standards und Kompatibilität

Beispiel