ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.graphics 

ImageSnapshot  - AS3 Flex

Paketmx.graphics
Klassepublic dynamic class ImageSnapshot
VererbungImageSnapshot Inheritance 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
 EigenschaftDefiniert von
 Inheritedconstructor : 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
 MethodeDefiniert 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
  
[statisch] Eine Dienstprogrammklasse zum Konvertieren eines ImageSnapshot in einen nach Base-64 kodierten String zur Übertragung in textbasierten Serialisierungsformaten wie XML.
ImageSnapshot
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert 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

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.

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

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.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.