パッケージ | mx.graphics |
クラス | public dynamic class ImageSnapshot |
継承 | ImageSnapshot Object |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
flash.display.IBitmapDrawable
を実装する Flash コンポーネントのスナップショットをキャプチャするのに使用するヘルパークラスです。
このクラスのインスタンスは、クライアント側イメージの PDF ファイルを生成するために、RemoteObject として Adobe の LiveCycle Data Services に送信できます。contentType
、width
、および height
プロパティ以外の、イメージの追加プロパティを指定する必要がある場合、properties
オブジェクトに名前と値のペアを設定する必要があります。
Flex の以前のバージョンでは、これらの追加プロパティは ImageSnapshot インスタンス自体に設定していました。 設定を可能にするために、このクラスは動的でしたが、Flex の今後のバージョンでは、このクラスは動的でなくなる可能性があります。
プロパティ | 定義元 | ||
---|---|---|---|
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
contentType : String
このスナップショットをキャプチャするために使用されたイメージエンコード形式の MIME コンテンツタイプです。 | ImageSnapshot | ||
data : ByteArray
イメージスナップショットを表すエンコードされたデータです。 | ImageSnapshot | ||
defaultEncoder : Class [静的]
イメージをキャプチャするために使用される、デフォルトの mx.graphics.codec.IImageEncoder 実装です。 | ImageSnapshot | ||
height : int
ピクセル単位で表したイメージの高さです。 | ImageSnapshot | ||
properties : Object
イメージの追加プロパティを指定する名前と値のペアを含む Object です。 | ImageSnapshot | ||
width : int
ピクセル単位で表したイメージの幅です。 | ImageSnapshot |
メソッド | 定義元 | ||
---|---|---|---|
コンストラクターです。 | ImageSnapshot | ||
captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData [静的]
BitmapData として UI コンポーネントの生のスナップショットを取得するユーティリティメソッドです。 | ImageSnapshot | ||
captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot [静的]
コンポーネントのスナップショットを取得し、それを特定の解像度(dpi 単位)に拡大 / 縮小し、特定のイメージ形式にエンコードするユーティリティメソッドです。 | ImageSnapshot | ||
[静的]
ImageSnapshot を Base-64 でエンコードされたストリングに変換するユーティリティメソッドです。このストリングは、XML などのテキストベースの直列化形式で転送できます。 | ImageSnapshot | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
定数 | 定義元 | ||
---|---|---|---|
MAX_BITMAP_DIMENSION : int = 2880 [静的]
Bitmap の最大の幅および高さです。 | ImageSnapshot |
contentType | プロパティ |
contentType:String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このスナップショットをキャプチャするために使用されたイメージエンコード形式の MIME コンテンツタイプです。 PNG 形式のイメージの場合、MIME タイプは "image/png" です。 JPG イメージまたは JPEG イメージの場合、MIME タイプは "image/jpeg" です。
実装
public function get contentType():String
public function set contentType(value:String):void
data | プロパティ |
defaultEncoder | プロパティ |
public static var defaultEncoder:Class
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
イメージをキャプチャするために使用される、デフォルトの mx.graphics.codec.IImageEncoder
実装です。 実装は PNGEncoder と JPEGEncoder の 2 つがあります。 デフォルトのエンコーダーでは、PNG 形式が使用されます。
height | プロパティ |
properties | プロパティ |
properties:Object
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
イメージの追加プロパティを指定する名前と値のペアを含む Object です。
通常、PDF ファイルを生成するために ImageSnapshot インスタンスを Adobe の LiveCycle Data Services に送信する場合に限り、このような情報を指定します。 既存の空の Object に対してオブジェクト全体を設定すること、または個々の名前と値のペアを設定することができます。
デフォルト値: {}。
実装
public function get properties():Object
public function set properties(value:Object):void
width | プロパティ |
ImageSnapshot | () | コンストラクター |
public function ImageSnapshot(width:int = 0, height:int = 0, data:ByteArray = null, contentType:String = null)
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
コンストラクターです。
パラメーターwidth:int (default = 0 ) — イメージの幅です。
| |
height:int (default = 0 ) — イメージの高さです。
| |
data:ByteArray (default = null ) — イメージを含むバイト配列です。
| |
contentType:String (default = null ) — イメージのエンコーダーのタイプ(PNGEncoder または JPEGEncoder)です。
|
captureBitmapData | () | メソッド |
public static function captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
BitmapData として UI コンポーネントの生のスナップショットを取得するユーティリティメソッドです。
パラメーター
source:IBitmapDrawable — flash.display.IBitmapDrawable インターフェイスを実装するオブジェクトです。
| |
matrix:Matrix (default = null ) — キャプチャしたビットマップの座標を拡大 / 縮小、回転、または変換するために使用される Matrix オブジェクトです。 マトリックス変換をイメージに適用したくない場合は、(デフォルトの new Matrix() コンストラクターを使用して作成される)単位マトリックスにこのパラメーターを設定するか、null 値を渡してください。
| |
colorTransform:flash.geom:ColorTransform (default = null ) — ビットマップのカラー値を調整するために使用する ColorTransform オブジェクトです。オブジェクトが提供されない場合、ビットマップイメージのカラーは変換されません。このパラメーターを渡す必要があるが、イメージを変換したくない場合、このパラメーターを、デフォルトの new ColorTransform() コンストラクターを使って作成される ColorTransform オブジェクトに設定します。
| |
blendMode:String (default = null ) — 結果として生成されるビットマップに適用されるブレンドモードを指定する、flash.display.BlendMode クラスのストリング値です。
| |
clipRect:Rectangle (default = null ) — 描画するソースオブジェクトの領域を定義する矩形オブジェクトです。この値を指定しない場合、クリッピングは発生せず、ソースオブジェクト全体が描画されます。
| |
smoothing:Boolean (default = false ) — 拡大および縮小時に BitmapData オブジェクトのスムージングを行うかどうかを決定するブール値です。
|
BitmapData — キャプチャされたスナップショットを表す BitmapData オブジェクトです。ソースに境界線が表示されていない場合は null になります。
|
captureImage | () | メソッド |
public static function captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
コンポーネントのスナップショットを取得し、それを特定の解像度(dpi 単位)に拡大 / 縮小し、特定のイメージ形式にエンコードするユーティリティメソッドです。
パラメーター
source:IBitmapDrawable — flash.display.IBitmapDrawable インターフェイスを実装するオブジェクトです。
| |
dpi:Number (default = 0 ) — dpi(1 インチあたりのドット数)単位の解像度です。 解像度を指定しない場合、デフォルトでは現在の画面の解像度が使用されます。
| |
encoder:IImageEncoder (default = null ) — 生のビットマップをエンコードするのに使用されるイメージ形式です。 エンコーダーは PNGEncoder と JPEGEncoder の 2 つがあります。 エンコーダーを指定しない場合、デフォルトは PNGEncoder です。
| |
scaleLimited:Boolean (default = true ) — Flash におけるビットマップの最大の幅および高さは 2880 ピクセルです。scaleLimited を true に設定した場合、解像度は 2880 ピクセル以内に収まるように比率を保ちながら縮小されます。scaleLimited を false に設定した場合、小さいスナップショットウィンドウが使用され、大きいイメージをキャプチャするために、それらが結合されます。 デフォルト値は true です。
|
ImageSnapshot — キャプチャされエンコードされたスナップショットと関連するイメージメタデータを格納する ImageSnapshot です。
|
encodeImageAsBase64 | () | メソッド |
public static function encodeImageAsBase64(snapshot:ImageSnapshot):String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ImageSnapshot を Base-64 でエンコードされたストリングに変換するユーティリティメソッドです。このストリングは、XML などのテキストベースの直列化形式で転送できます。
パラメーター
snapshot:ImageSnapshot — mx.graphics.ImageSnapshot としてキャプチャされたイメージです。
|
String — base64 でエンコードされたスナップショットを表す文字列です。
|
関連する API エレメント
MAX_BITMAP_DIMENSION | 定数 |
public static const MAX_BITMAP_DIMENSION:int = 2880
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
Bitmap の最大の幅および高さです。
Tue Jun 12 2018, 10:34 AM Z