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 |
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.
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 |
Methode | Definiert von | ||
---|---|---|---|
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 | ||
[statisch]
Eine Dienstprogrammklasse zum Konvertieren eines ImageSnapshot in einen nach Base-64 kodierten String zur Übertragung in textbasierten Serialisierungsformaten wie XML. | ImageSnapshot | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert von | ||
---|---|---|---|
MAX_BITMAP_DIMENSION : int = 2880 [statisch]
Die maximale Breite und Höhe einer Bitmap. | ImageSnapshot |
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 |
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 |
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 |
ImageSnapshot | () | 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.
Parameterwidth: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.
|
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.
|
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.
|
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.
|
String — Ein String, der den nach Base-64 kodierten Schnappschuss darstellt.
|
Verwandte API-Elemente
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.
Tue Jun 12 2018, 10:04 AM Z