ImageSnapshot

Paket	mx.graphics
Klasse	public dynamic class ImageSnapshot
Vererbung	ImageSnapshot Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Hilfsklasse zum Erfassen eines Schnappschusses von einer beliebigen Flash-Komponente, die flash.display.IBitmapDrawable implementiert, einschließlich Flex UIComponents.

Eine Instanz dieser Klasse kann als RemoteObject an die LiveCycle Data Services von Adobe gesendet werden, um eine PDF-Datei eines clientseitigen Bilds zu generieren. Wenn Sie für das Bild außer den Eigenschaften contentType, width, und height weitere Eigenschaften definieren müssen, sollten Sie für das properties-Objekt Name/Wert-Paare festlegen.

In früheren Flex-Versionen legen Sie diese zusätzlichen Eigenschaften in der ImageSnapshot-Instanz selbst fest. Um das zu ermöglichen, ist diese Klasse bislang noch dynamisch, was in zukünftigen Flex-Versionen eventuell nicht mehr der Fall ist.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		contentType : String Der MIME-Inhaltstyp für das Bild-Kodierungsformat, das zum Erfassen dieses Schnappschusses verwendet wurde.	ImageSnapshot
		data : ByteArray Die kodierten Daten, die den Bildschnappschuss darstellen.	ImageSnapshot
		defaultEncoder : Class [statisch] Die standardmäßige mx.graphics.codec.IImageEncoder-Implementierung zum Erfassen von Bildern.	ImageSnapshot
		height : int Die Bildhöhe in Pixeln.	ImageSnapshot
		properties : Object Ein Objekt mit Name/Wert-Paaren, die die zusätzlichen Eigenschaften des Bildes angeben.	ImageSnapshot
		width : int Die Bildbreite in Pixeln.	ImageSnapshot

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ImageSnapshot(width:int = 0, height:int = 0, data:ByteArray = null, contentType:String = null) Konstruktor.	ImageSnapshot
		captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData [statisch] Eine Dienstprogrammmethode zum Erfassen eines unformatierten Schnappschusses einer UI-Komponente als BitmapData.	ImageSnapshot
		captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot [statisch] Eine Dienstprogrammmethode zum Erfassen eines Schnappschusses einer Komponente, der auf eine bestimmte Auflösung (in dots per inch, Punkte pro Zoll) skaliert und in einem bestimmten Bildformat kodiert ist.	ImageSnapshot
		encodeImageAsBase64(snapshot:ImageSnapshot):String [statisch] Eine Dienstprogrammklasse zum Konvertieren eines ImageSnapshot in einen nach Base-64 kodierten String zur Übertragung in textbasierten Serialisierungsformaten wie XML.	ImageSnapshot
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

	Konstante		Definiert von
		MAX_BITMAP_DIMENSION : int = 2880 [statisch] Die maximale Breite und Höhe einer Bitmap.	ImageSnapshot

Eigenschaftendetails

contentType

Eigenschaft

contentType:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der MIME-Inhaltstyp für das Bild-Kodierungsformat, das zum Erfassen dieses Schnappschusses verwendet wurde. Für Bilder im PNG-Format lautet der MIME-Typ „image/png“. Für JPG- oder JPEG-Bilder lautet der MIME-Typ „image/jpeg“.

Implementierung
public function get contentType():String
public function set contentType(value:String):void

data

Eigenschaft

data:ByteArray

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die kodierten Daten, die den Bildschnappschuss darstellen.

Implementierung
public function get data():ByteArray
public function set data(value:ByteArray):void

defaultEncoder

Eigenschaft

public static var defaultEncoder:Class

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die standardmäßige mx.graphics.codec.IImageEncoder-Implementierung zum Erfassen von Bildern. Die beiden Implementierungen sind PNGEncoder und JPEGEncoder. Der Standard-Encoder verwendet das PNG-Format.

height

Eigenschaft

height:int

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Bildhöhe in Pixeln.

Implementierung
public function get height():int
public function set height(value:int):void

properties

Eigenschaft

properties:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Objekt mit Name/Wert-Paaren, die die zusätzlichen Eigenschaften des Bildes angeben.

Sie stellen solche Informationen im Allgemeinen nur bereit, wenn sie eine ImageSnapshot-Instanz an die LiveCycle Data Services von Adobe senden, um eine PDF-Datei zu generieren. Sie können entweder ein ganzes Objekt festlegen oder einzelne Name/Wert-Paare für das vorhandene, leere Objekt festlegen.

Der Standardwert ist {}.

Implementierung
public function get properties():Object
public function set properties(value:Object):void

width

Eigenschaft

width:int

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Bildbreite in Pixeln.

Implementierung
public function get width():int
public function set width(value:int):void

Konstruktordetails

()

Konstruktor

public function ImageSnapshot(width:int = 0, height:int = 0, data:ByteArray = null, contentType:String = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

	`width:int` (default = `0`) — Breite des Bilds.

	`height:int` (default = `0`) — Höhe des Bilds.

	`data:ByteArray` (default = `null`) — Ein Byte-Array zur Aufnahme des Bildes.

	`contentType:String` (default = `null`) — Der Encoder-Formattyp für das Bild, entweder PNGEncoder oder JPEGEncoder.

Methodendetails

captureBitmapData

()

Methode

 public static function captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Dienstprogrammmethode zum Erfassen eines unformatierten Schnappschusses einer UI-Komponente als BitmapData.

Parameter

	`source:IBitmapDrawable` — Ein Objekt, das die `flash.display.IBitmapDrawable`-Oberfläche implementiert.

	`matrix:Matrix` (default = `null`) — Ein Matrix-Objekt, mit dem die Koordinaten der erfassten Bitmap skaliert, gedreht oder umgesetzt werden können. Wenn Sie auf das Bild keine Matrixtransformation anwenden möchten, setzen Sie diesen Parameter auf eine Identitätsmatrix, die mit dem Standardkonstruktor new Matrix() erstellt wurde, oder übergeben Sie einen null-Wert.

	`colorTransform:flash.geom:ColorTransform` (default = `null`) — Ein ColorTransform-Objekt, mit dem die Farbwerte der Bitmap angepasst werden können. Falls kein Objekt vorhanden ist, findet keine Transformation der Bitmap-Farben statt. Wenn Sie diesen Parameter übergeben müssen, das Bild aber nicht transformieren möchten, setzen Sie diesen Parameter auf ein ColorTransform-Objekt, das mit dem Standardkonstruktor new ColorTransform() erstellt worden ist.

	`blendMode:String` (default = `null`) — Ein String-Wert aus der flash.display.BlendMode-Klasse, der den Mischmodus festlegt, der auf die resultierende Bitmap angewendet werden soll.

	`clipRect:Rectangle` (default = `null`) — Ein Rechteckobjekt, das den Bereich des zu zeichnenden Quellobjekts definiert. Wenn Sie diesen Wert nicht angeben, wird das Bild nicht abgeschnitten, und das gesamte Quellobjekt wird gezeichnet.

	`smoothing:Boolean` (default = `false`) — Ein boolescher Wert, der bestimmt, ob ein BitmapData-Objekt beim Skalieren geglättet wird.

Rückgabewerte

BitmapData — Ein BitmapData-Objekt, das den erfassten Schnappschuss oder „null“ darstellt, wenn die Quelle keine sichtbaren Grenzen aufweist.

captureImage

()

Methode

 public static function captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Dienstprogrammmethode zum Erfassen eines Schnappschusses einer Komponente, der auf eine bestimmte Auflösung (in dots per inch, Punkte pro Zoll) skaliert und in einem bestimmten Bildformat kodiert ist.

Parameter

	`source:IBitmapDrawable` — Ein Objekt, das die `flash.display.IBitmapDrawable`-Oberfläche implementiert.

	`dpi:Number` (default = `0`) — Die Auflösung in dpi (dots per inch, Punkte pro Zoll). Wird keine Auflösung angegeben, dann wird standardmäßig die aktuelle Bildschirmauflösung verwendet.

	`encoder:IImageEncoder` (default = `null`) — Das zum Kodieren der unformatierten Bitmap verwendete Bildformat. Die beiden Encoder sind PNGEncoder und JPEGEncoder. Wird kein Encoder festgelegt, wird standardmäßig der PNGEncoder verwendet.

	`scaleLimited:Boolean` (default = `true`) — Ein Bitmap kann in Flash maximal eine Breite oder Höhe von 2880 Pixel besitzen. Wenn scaleLimited auf „true“ gesetzt ist, wird die Auflösung proportional verringert, um sie an die 2880 Pixel anzupassen. Wenn scaleLimited dagegen auf „false“ gesetzt ist, werden kleinere Schnappschussfenster erstellt und zu einem größeren Bild zusammengefügt. Der Standardwert lautet true.

Rückgabewerte

ImageSnapshot — Ein ImageSnapshot mit einem erfassten Schnappschuss und den zugehörigen Bild-Metadaten.

encodeImageAsBase64

()

Methode

public static function encodeImageAsBase64(snapshot:ImageSnapshot):String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Dienstprogrammklasse zum Konvertieren eines ImageSnapshot in einen nach Base-64 kodierten String zur Übertragung in textbasierten Serialisierungsformaten wie XML.

Parameter

snapshot:ImageSnapshot — Ein als mx.graphics.ImageSnapshot erfasstes Bild.

Rückgabewerte

String — Ein String, der den nach Base-64 kodierten Schnappschuss darstellt.

Verwandte API-Elemente

captureImage

Konstantendetails

MAX_BITMAP_DIMENSION

Konstante

public static const MAX_BITMAP_DIMENSION:int = 2880

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die maximale Breite und Höhe einer Bitmap.

Rechtliche Hinweise | Onlinedatenschutzerklärung

ImageSnapshot - AS3 Flex

Klassen x

contentType

data

defaultEncoder

height

properties

width

ImageSnapshot

captureBitmapData

captureImage

encodeImageAsBase64

MAX_BITMAP_DIMENSION