ImageSnapshot

Pacchetto	mx.graphics
Classe	public dynamic class ImageSnapshot
Ereditarietà	ImageSnapshot Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

A helper class used to capture a snapshot of any Flash component that implements flash.display.IBitmapDrawable, including Flex UIComponents.

An instance of this class can be sent as a RemoteObject to Adobe's LiveCycle Data Services to generate a PDF file of a client-side image. If you need to specify additional properties of the image beyond its contentType, width, and height properties, you should set name/value pairs on the properties object.

In earlier versions of Flex, you set these additional properties on the ImageSnapshot instance itself. This class is still dynamic in order to allow that, but in a future version of Flex it might no longer be dynamic.

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		contentType : String The MIME content type for the image encoding format that was used to capture this snapshot.	ImageSnapshot
		data : ByteArray The encoded data representing the image snapshot.	ImageSnapshot
		defaultEncoder : Class [statico] The default mx.graphics.codec.IImageEncoder implementation used to capture images.	ImageSnapshot
		height : int The image height in pixels.	ImageSnapshot
		properties : Object An Object containing name/value pairs specifying additional properties of the image.	ImageSnapshot
		width : int The image width in pixels.	ImageSnapshot

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		ImageSnapshot(width:int = 0, height:int = 0, data:ByteArray = null, contentType:String = null) Constructor.	ImageSnapshot
		captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData [statico] A utility method to grab a raw snapshot of a UI component as BitmapData.	ImageSnapshot
		captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot [statico] A utility method to grab a snapshot of a component, scaled to a specific resolution (in dpi) and encoded into a specific image format.	ImageSnapshot
		encodeImageAsBase64(snapshot:ImageSnapshot):String [statico] A utility method to convert an ImageSnapshot into a Base-64 encoded String for transmission in text based serialization formats such as XML.	ImageSnapshot
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

	Costante		Definito da
		MAX_BITMAP_DIMENSION : int = 2880 [statico] The maximum width and height of a Bitmap.	ImageSnapshot

Descrizione delle proprietà

contentType

proprietà

contentType:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The MIME content type for the image encoding format that was used to capture this snapshot. For PNG format images, the MIME type is "image/png". For JPG or JPEG images, the MIME type is "image/jpeg"

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

data

proprietà

data:ByteArray

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The encoded data representing the image snapshot.

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

defaultEncoder

proprietà

public static var defaultEncoder:Class

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The default mx.graphics.codec.IImageEncoder implementation used to capture images. The two implementations are PNGEncoder and JPEGEncoder. The default encoder uses the PNG format.

height

proprietà

height:int

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The image height in pixels.

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

properties

proprietà

properties:Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

An Object containing name/value pairs specifying additional properties of the image.

You generally supply such information only when sending an ImageSnapshot instance to Adobe's LiveCycle Data Services in order to generate a PDF file. You can either set the entire object or set individual name/value pairs on the pre-existing empty Object.

Il valore predefinito è {}.

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

width

proprietà

width:int

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The image width in pixels.

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

Descrizione della funzione di costruzione

()

Funzione di costruzione

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Constructor.

Parametri

	`width:int` (default = `0`) — Width of the image.

	`height:int` (default = `0`) — Height of the image.

	`data:ByteArray` (default = `null`) — A byte array to contain the image.

	`contentType:String` (default = `null`) — The encoder format type for the image, either PNGEncoder or JPEGEncoder.

Descrizione dei metodi

captureBitmapData

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

A utility method to grab a raw snapshot of a UI component as BitmapData.

Parametri

	`source:IBitmapDrawable` — An object that implements the `flash.display.IBitmapDrawable` interface.

	`matrix:Matrix` (default = `null`) — A Matrix object used to scale, rotate, or translate the coordinates of the captured bitmap. If you do not want to apply a matrix transformation to the image, set this parameter to an identity matrix, created with the default new Matrix() constructor, or pass a null value.

	`colorTransform:flash.geom:ColorTransform` (default = `null`) — A ColorTransform object that you use to adjust the color values of the bitmap. If no object is supplied, the bitmap image's colors are not transformed. If you must pass this parameter but you do not want to transform the image, set this parameter to a ColorTransform object created with the default new ColorTransform() constructor.

	`blendMode:String` (default = `null`) — A string value, from the flash.display.BlendMode class, specifying the blend mode to be applied to the resulting bitmap.

	`clipRect:Rectangle` (default = `null`) — A Rectangle object that defines the area of the source object to draw. If you do not supply this value, no clipping occurs and the entire source object is drawn.

	`smoothing:Boolean` (default = `false`) — A Boolean value that determines whether a BitmapData object is smoothed when scaled.

Restituisce

BitmapData — A BitmapData object representing the captured snapshot or null if the source has no visible bounds.

captureImage

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

A utility method to grab a snapshot of a component, scaled to a specific resolution (in dpi) and encoded into a specific image format.

Parametri

	`source:IBitmapDrawable` — An object that implements the `flash.display.IBitmapDrawable` interface.

	`dpi:Number` (default = `0`) — The resolution in dots per inch. If a resolution is not provided, the current on-screen resolution is used by default.

	`encoder:IImageEncoder` (default = `null`) — The image format used to encode the raw bitmap. The two encoders are PNGEncoder and JPEGEncoder. If an encoder is not provided, the default is PNGEncoder.

	`scaleLimited:Boolean` (default = `true`) — The maximum width or height of a bitmap in Flash is 2880 pixels - if scaleLimited is set to true the resolution will be reduced proportionately to fit within 2880 pixels, otherwise, if scaleLimited is false, smaller snapshot windows will be taken and stitched together to capture a larger image. The default is true.

Restituisce

ImageSnapshot — An ImageSnapshot holding an encoded captured snapshot and associated image metadata.

encodeImageAsBase64

()

metodo

public static function encodeImageAsBase64(snapshot:ImageSnapshot):String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

A utility method to convert an ImageSnapshot into a Base-64 encoded String for transmission in text based serialization formats such as XML.

Parametri

snapshot:ImageSnapshot — An image captured as an mx.graphics.ImageSnapshot.

Restituisce

String — A string representing the base64 encoded snapshot.

Elementi API correlati

captureImage

Descrizione delle costanti

MAX_BITMAP_DIMENSION

Costante

public static const MAX_BITMAP_DIMENSION:int = 2880

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The maximum width and height of a Bitmap.

Note legali | Informativa sulla privacy online

ImageSnapshot - AS3 Flex

Classi x

contentType

data

defaultEncoder

height

properties

width

ImageSnapshot

captureBitmapData

captureImage

encodeImageAsBase64

MAX_BITMAP_DIMENSION