com.docomostar.media
クラス ImageReference

Object
  com.docomostar.media.ImageReference

public class ImageReference
extends Object

イメージリファレンスを定義します。 イメージリファレンス クラスは画像データを直接描画する場合などに使用します。

このクラスのオブジェクトは createImageReference(String) メソッドにより生成します。 生成したオブジェクトは、指定したリソースの URL を保持します。 同じ URL を指定した場合に、 同一のオブジェクトが返されるか、新しいオブジェクトが返されるかは機種依存です。 このクラスのオブジェクトを生成した時点では、画像データを展開しません。 オブジェクトを生成する際に、 Java ヒープ上に画像データの展開をしないので、 MediaImage を使用した場合と比較してメモリの消費量を抑えることができます。 すなわち、Java ヒープ領域が限られるミニアプリ実行環境での描画に有効です。

このクラスのオブジェクトを指定して描画メソッドを呼び出した時に、初めて画像データを内部形式に展開して描画します。 そのため、描画に要する処理速度が遅くなる可能性があります。 展開したデータはネイティブのキャッシュ領域に保持されます。 これにより再描画の際には、描画に要する処理速度の低下が軽減されることがあります。 ミニアプリ実行環境においては、複数のミニアプリが単一のキャッシュ領域を共有して使用するため、他のアプリによってキャッシュの画像データが失われる可能性があります。

導入されたバージョン:

Star-1.0

メソッドの概要

static ImageReference

createImageReference(String location) リソースの場所を指定して、イメージリファレンスを生成します。

クラス Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

createImageReference

public static ImageReference createImageReference(String location)

リソースの場所を指定して、イメージリファレンスを生成します。

location に指定可能なリソースは Jar ファイルまたはスクラッチパッドです。 指定のフォーマット形式が正しくない場合、例外が発生します。

パラメータ:

location - リソースの URL を指定します。

戻り値:

生成したイメージリファレンスを返します。

例外:

NullPointerException -
引数 location に null を指定した場合に発生します。

IllegalArgumentException -
引数 location が、"resource:///" または "scratchpad:///d (0 ≤ Integer.parseInt(d) ≤ 15)" 以外が先頭にある場合に発生します。

IllegalArgumentException -
引数 location が、実装がサポートしているバイト数を超える場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) URL の ";" 以下が pos=m または pos=m,length=n という形式 (m や n は Integer.parseInt(String) の引数に与えても例外が発生しないような文字列) でない場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) ADF の UseMSO キーによって Flash^® コンテンツ用に割り当てたスクラッチパッド領域が指定された場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) ミニアプリから呼び出された場合に、1 つ目(scratchpad:///0) 以外のスクラッチパッドが指定された場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) 引数 location の文字列に pos=m が含まれる場合に、Integer.parseInt(m) の値が負かスクラッチパッドのサイズを超える場合、 かつ、 pos=end とは指定されていない場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) 引数 location の文字列に pos=m,length=n が含まれる場合に、Integer.parseInt(n) の値が負か、(Integer.parseInt(m) + Integer.parseInt(n)) の値がスクラッチパッドのサイズを超える場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) 引数 location の文字列に scratchpad:///? で指定されたスクラッチパッドが、ADF のスクラッチパッドサイズ指定キーで指定されていない場合に発生します。

IllegalArgumentException -
(スクラッチパッドのみ) ミニアプリから呼び出された場合に、ADF の SPsize キーで指定されている 1 つ目のスクラッチパッドサイズ値が、 ミニアプリで利用可能なスクラッチパッドの最大サイズを越えている場合に発生します。

IllegalArgumentException -
(Jar ファイルのみ) 引数 location で指定されたリソースファイルが存在しない場合に発生します。

SecurityException -
(Jar ファイルのみ) 引数 location の jar-relative-path 部分が絶対パスである場合に発生します。

SecurityException -
(Jar ファイルのみ) 引数 location に親ディレクトリへの参照が含まれる場合に発生します。

SecurityException -
(Jar ファイルのみ) 引数 location に "/./", "/../", ":", "¥" が含まれる場合に発生します。 ただし、":" は "resource:///" の後の文字列に含まれていた場合のみ発生します。