ImageData (クラス)
public ImageData
インポート元： CURL.GUI.STANDARD. package 内で定義されています CURL.GRAPHICS.IMAGEIO.BASE.

イメージの入力および出力の結果またはソース。

説明

一連の Pixmap (または単一の Pixmap) およびそれらの表示方法に関する情報。

コンストラクタ
default:空の ImageData を作成します。
コンストラクタ public {ImageData.default}
from-stream:ByteInputStream ソースから ImageData をロードします。
ファクトリ public {ImageData.from-stream
bis:ByteInputStream,
mime-type:String,
pixel-count-limit:int = max-int,
out:#ImageData = null
}:ImageData
from-url:Url ソースから ImageData をロードします。
ファクトリ public {ImageData.from-url
url:Url,
mime-type:#String = null,
pixel-count-limit:int = max-int,
out:#ImageData = null
}:ImageData

プロパティ
delays:各フレームが表示される時間。
フィールド public ImageData.delays:{Array-of Time} ={new {Array-of Time}, efficient-size = 1}
expires-at:このイメージがリロードされた後の時間
フィールド public ImageData.expires-at:#DateTime
loop-count:フレームのループ回数。
フィールド public ImageData.loop-count:int =0
pixmaps:Pixmap の配列。
フィールド public ImageData.pixmaps:{Array-of Pixmap} ={new {Array-of Pixmap}, efficient-size = 1}
properties:ImageData のロード元になるファイル形式に定義されたイメージのプロパティ。
フィールド public ImageData.properties:{HashTable-of String, any} ={new {HashTable-of String, any}, efficient-size = 0}

クラス プロシージャ
add-mime-handler:特定の mime タイプのハンドラを追加します。
public {ImageData.add-mime-handler
mime-type:String,
load-image:#{proc-type {bbis:BufferedByteInputStream, mime-type:String, pixel-count-limit:int, out:#ImageData }:ImageData } = null,
save-image:#{proc-type {bos:ByteOutputStream, mime-type:String, image-data:ImageData }:void } = null,
make-loader:#{proc-type {bis:BufferedByteInputStream, mime-type:String, pixel-count-limit:int }:ImageLoader } = null
}:void

メソッド
reset:ImageData オブジェクトをリセットして、このオブジェクトを新規作成オブジェクトと同じ状態にします。
public {ImageData.reset}:void
save-to-stream:ImageData を ByteOutputStream の出力先に格納します。
public {ImageData.save-to-stream
bos:ByteOutputStream,
mime-type:String
}:void
save-to-url:ImageData を Url の出力先に格納します。
public {ImageData.save-to-url url:Url, mime-type:String}:void
メソッド 継承 Object: object-describe, object-describe-for-debugging, object-serialize



コンストラクタ詳細
default (コンストラクタ)
public {ImageData.default}

空の ImageData を作成します。


from-stream (ファクトリ)
public {ImageData.from-stream
bis:ByteInputStream,
mime-type:String,
pixel-count-limit:int = max-int,
out:#ImageData = null
}:ImageData

ByteInputStream ソースから ImageData をロードします。

bis: イメージのロード元の ByteInputStream。
mime-type:
イメージのcontent-type
mime-typeがnullの時（デフォルトです）、ストリームまたはファイル名の拡張子を使用します。
サポートされるイメージファイルフォーマットとcontent-typeは以下のとおりです:
  • "image/bmp" .BMPファイル
  • "image/gif" .GIF ファイル、読み込みのみ、マルチフレーム (アニメーション GIF) がサポートされます。
  • "image/jpeg" .JPG、 .JPEG、 .JFIF ファイル
  • "image/png" .PNG ファイル
  • "image/ppm" または、"image/x-portable-pixmap" .PPM ファイル
  • "image/tiff" .TIF、または .TIFF ファイル。マルチフレームがサポートされます。
pixel-count-limit: イメージが壊れている (または使用不可能である) と宣言する前にロードするピクセルの最大数。既定値は無限です。
out:
新規にロードされるイメージで再利用されるオプションの ImageData。可能な場合、ImageData.pixmaps の Pixmap は常に out.pixmaps から再利用されます。
ビデオカメラからのストリーミング イメージのように、同一サイズの新規イメージを繰り返しロードする必要があるアプリケーションでは、これによりメモリの割り当て (およびガーベッジ コレクション) を大幅に削減できます。
out パラメータではなく、この factory から返される ImageData を常に使用してください。

from-url (ファクトリ)
public {ImageData.from-url
url:Url,
mime-type:#String = null,
pixel-count-limit:int = max-int,
out:#ImageData = null
}:ImageData

Url ソースから ImageData をロードします。

url: イメージのロード元を示す Url。
mime-type:
イメージのcontent-type
mime-typeがnullの時（デフォルトです）、ストリームまたはファイル名の拡張子を使用します。
サポートされるイメージファイルフォーマットとcontent-typeは以下のとおりです:
  • "image/bmp" .BMPファイル
  • "image/gif" .GIF ファイル、読み込みのみ、マルチフレーム (アニメーション GIF) がサポートされます。
  • "image/jpeg" .JPG、 .JPEG、 .JFIF ファイル
  • "image/png" .PNG ファイル
  • "image/ppm" または、"image/x-portable-pixmap" .PPM ファイル
  • "image/tiff" .TIF、または .TIFF ファイル。マルチフレームがサポートされます。
pixel-count-limit: イメージが壊れている (または使用不可能である) と宣言する前にロードするピクセルの最大数。既定値は無限です。
out:
新規にロードされるイメージで再利用されるオプションの ImageData。可能な場合、ImageData.pixmaps の Pixmap は常に out.pixmaps から再利用されます。
ビデオカメラからのストリーミング イメージのように、同一サイズの新規イメージを繰り返しロードする必要があるアプリケーションでは、これによりメモリの割り当て (およびガーベッジ コレクション) を大幅に削減できます。
out パラメータではなく、この factory から返される ImageData を常に使用してください。


プロパティ詳細
delays (フィールド)
public ImageData.delays:{Array-of Time} ={new {Array-of Time}, efficient-size = 1}

各フレームが表示される時間。

説明

遅延はそれぞれ pixmaps 配列内の 1 つの要素に対応します。

expires-at (フィールド)
public ImageData.expires-at:#DateTime

このイメージがリロードされた後の時間

説明

この値は、イメージがHTTP経由でロードされた時のみ存在し、HTTPヘッダーに含まれる情報に基づいています。この値がnullでない場合は、一般的に指定された時間が過ぎた後は、リロードしなければなりません。 nullの場合は、イメージは無期限に使用されるかもしれません。これはローカルファイルのようなHTTPストリーム以外のイメージの場合、そのようになります。それはHTTPベースのイメージの場合でも値を返すかもしれません。
キャッシュされてはいけないイメージは、最初にロードされる時でも既に過去となっている有効期限を持っているかも知れないことに注意してください。このような場合、最初はイメージを使用することは安全ですが、将来、再利用してはいけません。
導入: バージョン 7.0

loop-count (フィールド)
public ImageData.loop-count:int =0

フレームのループ回数。

説明

値 0 は無限ループを意味します。

pixmaps (フィールド)
public ImageData.pixmaps:{Array-of Pixmap} ={new {Array-of Pixmap}, efficient-size = 1}

Pixmap の配列。


properties (フィールド)
public ImageData.properties:{HashTable-of String, any} ={new {HashTable-of String, any}, efficient-size = 0}

ImageData のロード元になるファイル形式に定義されたイメージのプロパティ。




クラス プロシージャ詳細
add-mime-handler (クラスプロシージャ)
public {ImageData.add-mime-handler
mime-type:String,
load-image:#{proc-type {bbis:BufferedByteInputStream, mime-type:String, pixel-count-limit:int, out:#ImageData }:ImageData } = null,
save-image:#{proc-type {bos:ByteOutputStream, mime-type:String, image-data:ImageData }:void } = null,
make-loader:#{proc-type {bis:BufferedByteInputStream, mime-type:String, pixel-count-limit:int }:ImageLoader } = null
}:void

特定の mime タイプのハンドラを追加します。



メソッド詳細
reset (メソッド)
public {ImageData.reset}:void

ImageData オブジェクトをリセットして、このオブジェクトを新規作成オブジェクトと同じ状態にします。

オーバーライド

ImageData のサブクラスでは、そこで追加されるあらゆる状態をリセットするためにこのメソッドをオーバーライドして、常に super.reset を呼び出す必要があります。

save-to-stream (メソッド)
public {ImageData.save-to-stream
bos:ByteOutputStream,
mime-type:String
}:void

ImageData を ByteOutputStream の出力先に格納します。

bos: イメージのエンコード先の ByteOutputStream。
mime-type:
イメージのcontent-type
注意 : GIF のファイルフォーマットの書き込みについてはサポートされていません。
サポートされるイメージファイルフォーマットとcontent-typeは以下のとおりです:
  • "image/bmp" .BMPファイル
  • "image/jpeg" .JPG、 .JPEG、 .JFIF ファイル
  • "image/png" .PNG ファイル
  • "image/ppm" または、"image/x-portable-pixmap" .PPM ファイル
  • "image/tiff" .TIF、または .TIFF ファイル。マルチフレームがサポートされます。

save-to-url (メソッド)
public {ImageData.save-to-url url:Url, mime-type:String}:void

ImageData を Url の出力先に格納します。

url: イメージの格納先を示す Url。
mime-type:
イメージのcontent-type
注意 : GIF のファイルフォーマットの書き込みについてはサポートされていません。
サポートされるイメージファイルフォーマットとcontent-typeは以下のとおりです:
  • "image/bmp" .BMPファイル
  • "image/jpeg" .JPG、 .JPEG、 .JFIF ファイル
  • "image/png" .PNG ファイル
  • "image/ppm" または、"image/x-portable-pixmap" .PPM ファイル
  • "image/tiff" .TIF、または .TIFF ファイル。マルチフレームがサポートされます。