Interface VectorImageAsset

ベクタ画像リソースを表すインターフェース。 本クラスのインスタンスをゲーム開発者が直接生成することはない。 game.jsonによって定義された内容をもとに暗黙的に生成されたインスタンスを、 Scene#assets、またはGame#assetsによって取得して利用する。

interface VectorImageAsset {
    height: number;
    hint: undefined | VectorImageAssetHint;
    id: string;
    onDestroyed: Trigger<Asset>;
    originalPath: string;
    path: string;
    type: "vector-image";
    width: number;
    createSurface(width: number, height: number): null | Surface;
    createSurface(
        width: number,
        height: number,
        sx: number,
        sy: number,
        sWidth: number,
        sHeight: number,
    ): null | Surface;
    destroy(): void;
    destroyed(): boolean;
    inUse(): boolean;
}

Hierarchy (View Summary)

Properties

height: number
hint: undefined | VectorImageAssetHint
id: string
onDestroyed: Trigger<Asset>
originalPath: string
path: string
type: "vector-image"
width: number

Methods

  • サーフェスを生成する。 ベクタ画像をサポートしない環境においては null を返す。

    Parameters

    • width: number

      作成するサーフェスの幅。

    • height: number

      作成するサーフェスの高さ。

    Returns null | Surface

  • サーフェスを生成する。 ベクタ画像をサポートしない環境においては null を返す。

    Parameters

    • width: number

      作成するサーフェスの幅。

    • height: number

      作成するサーフェスの高さ。

    • sx: number

      元画像の描画矩形範囲のx座標。

    • sy: number

      元画像の描画矩形範囲のy座標。

    • sWidth: number

      元画像の描画矩形範囲の幅。

    • sHeight: number

      元画像の描画矩形範囲の高さ。

    Returns null | Surface

  • このアセットのリソースの破棄を行う。

    Returns void

  • このアセットのリソースが破棄済みであるかどうかを判定する。

    Returns boolean

  • 現在利用中で解放出来ない Asset かどうかを返す。 戻り値は、利用中である場合真、でなければ偽である。

    本メソッドは通常 false が返るべきである。 例えば Sprite の元画像として使われているケース等では、その Sprite によって AssetSurface に変換されているべきで、 Asset が利用中で解放出来ない状態になっていない事を各プラットフォームで保障する必要がある。

    唯一、例外的に本メソッドが true を返すことがあるのは音楽を表す Asset である。 BGM等はシーンをまたいで演奏することもありえる上、 演奏中のリソースのコピーを常に各プラットフォームに強制するにはコストがかかりすぎるため、 本メソッドは true を返し、適切なタイミングで Asset が解放されるよう制御する必要がある。

    Returns boolean