| パッケージ | flash.display3D.textures |
| クラス | public final class Texture |
| 継承 | Texture  TextureBase EventDispatcher Object |
レンダリング時に使用するための 2D テクスチャを定義しします。
Texture を直接インスタンス化することはできません。Context3D createTexture() を使用して、インスタンスを作成します。
関連する API エレメント
パブリックプロパティ
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示パブリックメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
このテクスチャに関連付けられているすべての GPU リソースを解放します。 | TextureBase | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
ByteArray オブジェクトから、圧縮されたテクスチャを Adobe Texture Format（ATF）形式でアップロードします。 | Texture | ||
BitmapData オブジェクトからテクスチャをアップロードします。 | Texture | ||
BitmapData オブジェクトからテクスチャのミップレベル 0 を非同期でアップロードします。 | Texture | ||
ByteArray からテクスチャをアップロードします。 | Texture | ||
ByteArray からテクスチャのミップレベル 0 を非同期でアップロードします。 | Texture | ||
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
メソッドの詳細
uploadCompressedTextureFromByteArray | () | メソッド |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 11, AIR 3 |
ByteArray オブジェクトから、圧縮されたテクスチャを Adobe Texture Format（ATF）形式でアップロードします。ATF ファイルバージョン 2 には SWF バージョン 21 以降が必要です。ATF ファイルバージョン 3 には SWF バージョン 29 以降が必要です。アルファなしの png 画像を使用して作成された ATF ファイルの場合、Context3DObject::createTexture で指定される format 文字列は「COMPRESSED」である必要があります。アルファ付きの png 画像を使用して作成された ATF ファイルの場合、Context3DObject::createTexture で指定される format 文字列は「COMPRESSED_ALPHA」である必要があります。
パラメーター
data:ByteArray — ミップマップ付きの圧縮されたテクスチャが含まれているバイト配列。ByteArray オブジェクトではリトルエンディアン形式を使用する必要があります。
| |
byteArrayOffset:uint — バイト配列内でテクスチャデータの読み取りを開始する位置。
| |
async:Boolean (default = false)CubeTexture オブジェクトは Event.TEXTURE_READY を送出します。デフォルト値は false です。
|
例外
TypeError — Null ポインターエラーです：data が null の場合。
| |
ArgumentError — テクスチャのデコードに失敗しました：data にある圧縮データの形式から、このオブジェクトの圧縮形式を判定できない場合または SWF のバージョンと ATF ファイルのバージョンに互換性がない場合。
| |
ArgumentError — テクスチャのサイズが一致しません：解凍したテクスチャの幅と高さが、この Texture オブジェクトのサイズと等しくない場合。
| |
ArgumentError — ミップレベルが大きすぎます：解凍したテクスチャのミップレベルが、テクスチャのサイズによって示されるレベルを超える場合。
| |
ArgumentError — テクスチャ形式が一致しません：デコードされた ATF バイトに、このテクスチャの形式に一致するテクスチャが含まれていない場合。
| |
Error — 3768：バックグラウンドでの実行中、Stage3D API は使用できません。
| |
RangeError — 入力サイズが正しくありません：byteArrayOffset の整数オーバーフローがある場合、byteArrayOffset + 6 が data の長さより大きい場合または byteArrayOffset から data バイト配列の末尾までのバイト数が ATF テクスチャに必要とされるデータ量よりも少ない場合。
|
関連する API エレメント
uploadFromBitmapData | () | メソッド |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 11, AIR 3 |
BitmapData オブジェクトからテクスチャをアップロードします。
パラメーター
source:BitmapData — ビットマップ。
| |
miplevel:uint (default = 0) |
例外
TypeError — Null ポインターエラーです：source が null の場合。
| |
ArgumentError — ミップレベルが大きすぎます：指定したミップレベルが、Texture のサイズのいずれか大きいほうによって示されるレベルを超える場合。
| |
ArgumentError — BitmapData が無効です：source の BitmapData オブジェクトに有効な立方体テクスチャ面が含まれていない場合。イメージには、2 の累乗に等しい数の側面と、指定されたミップレベルにおける正しいサイズが設定されている必要があります。
| |
ArgumentError — テクスチャ形式が一致しません：テクスチャ形式が Context3DTextureFormat.COMPRESSED または Context3DTextureFormat.COMPRESSED_ALPHA で、ランタイムのテクスチャ圧縮がサポートされていないモバイルプラットフォームでコードが実行されている場合。
| |
Error — 3768：バックグラウンドでの実行中、Stage3D API は使用できません。
|
uploadFromBitmapDataAsync | () | メソッド |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 24 |
BitmapData オブジェクトからテクスチャのミップレベル 0 を非同期でアップロードします。テクスチャの使用を試みる描画メソッドは、アップロードが完了するまでは失敗します。アップロードが完了すると、この Texture オブジェクトは Event.TEXTURE_READY を送出します。Event.TEXTURE_READY は、そのテクスチャオブジェクトに対する非同期呼び出しが正常に実行されたことを示すコールバックです。バックグラウンドでのアップロード中にエラーが発生した場合、この Texture オブジェクトは Event.ERROREVENT を送出します。
パラメーター
source:BitmapData — ビットマップ
| |
miplevel:uint (default = 0) |
例外
TypeError — Null ポインターエラーです：source が null の場合。
| |
ArgumentError — BitmapData が無効です：source に有効なテクスチャが含まれていない場合。イメージは、サイズが 2 の累乗で、指定されたミップレベルにおける正しいサイズが設定されている必要があります。
| |
ArgumentError — テクスチャ形式が一致しません：テクスチャ形式が Context3DTextureFormat.COMPRESSED または Context3DTextureFormat.COMPRESSED_ALPHA で、ランタイムのテクスチャ圧縮がサポートされていないモバイルプラットフォームでコードが実行されている場合。
| |
ArgumentError — 非同期アップロードはミップレベル 0 の場合のみサポートされています。
| |
Error — 3768：バックグラウンドでの実行中、Stage3D API は使用できません。
|
関連する API エレメント
uploadFromByteArray | () | メソッド |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | Flash Player 11, AIR 3 |
ByteArray からテクスチャをアップロードします。
パラメーター
data:ByteArray — テクスチャの塗りに必要なバイト数をテクスチャの内部形式で含むバイト配列。RGBA テクスチャは、テクセルコンポーネントごとのバイト数（1 または 4）として読み取られます。浮動小数点テクスチャは、テクセルコンポーネントごとの浮動小数点数（1 または 4）として読み取られます。ByteArray オブジェクトではリトルエンディアン形式を使用する必要があります。
| |
byteArrayOffset:uint — バイト配列オブジェクト内でテクスチャデータの読み取りを開始する位置。
| |
miplevel:uint (default = 0) |
例外
TypeError — Null ポインターエラーです：data が null の場合。
| |
ArgumentError — ミップレベルが大きすぎます：指定したミップレベルが、Texture のサイズのいずれか大きいほうによって示されるレベルを超える場合。
| |
RangeError — 入力サイズが正しくありません：byteArrayOffset から data バイト配列の末尾までのバイト数が、そのミップレベルのテクスチャに必要とされるデータ量よりも少ない場合または byteArrayOffset が data の長さ以上の場合。
| |
ArgumentError — テクスチャ形式が一致しません：テクスチャ形式が Context3DTextureFormat.COMPRESSED または Context3DTextureFormat.COMPRESSED_ALPHA で、ランタイムのテクスチャ圧縮がサポートされていないモバイルプラットフォームでコードが実行されている場合。
| |
Error — 3768：バックグラウンドでの実行中、Stage3D API は使用できません。
|
uploadFromByteArrayAsync | () | メソッド |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 24 |
ByteArray からテクスチャのミップレベル 0 を非同期でアップロードします。テクスチャの使用を試みる描画メソッドは、アップロードが完了するまでは失敗します。アップロードが完了すると、この Texture オブジェクトは Event.TEXTURE_READY を送出します。Event.TEXTURE_READY は、そのテクスチャオブジェクトに対する非同期呼び出しが正常に実行されたことを示すコールバックです。バックグラウンドでのアップロード中にエラーが発生した場合、この Texture オブジェクトは Event.ERROREVENT を送出します。
パラメーター
data:ByteArray — テクスチャの塗りに必要なバイト数をテクスチャの内部形式で含むバイト配列。RGBA テクスチャは、テクセルコンポーネントごとのバイト数（1 または 4）として読み取られます。浮動小数点テクスチャは、テクセルコンポーネントごとの浮動小数点数（1 または 4）として読み取られます。ByteArray オブジェクトではリトルエンディアン形式を使用する必要があります。
| |
byteArrayOffset:uint — バイト配列オブジェクト内でテクスチャデータの読み取りを開始する位置。
| |
miplevel:uint (default = 0) |
例外
TypeError — Null ポインターエラーです：data が null の場合。
| |
RangeError — 入力サイズが正しくありません：byteArrayOffset から data バイト配列の末尾までのバイト数が、ミップレベル 0 のテクスチャに必要とされるデータ量よりも少ない場合または byteArrayOffset が data の長さ以上の場合。
| |
ArgumentError — テクスチャ形式が一致しません：テクスチャ形式が Context3DTextureFormat.COMPRESSED または Context3DTextureFormat.COMPRESSED_ALPHA で、ランタイムのテクスチャ圧縮がサポートされていないモバイルプラットフォームでコードが実行されている場合。
| |
ArgumentError — 非同期アップロードはミップレベル 0 の場合のみサポートされています。
| |
Error — 3768：バックグラウンドでの実行中、Stage3D API は使用できません。
| |
Error — テクスチャオブジェクトの非同期アップロードが開始されたが、同じテクスチャオブジェクトに対して別の非同期アップロード呼び出しがおこなわれている場合。
|
関連する API エレメント
Tue Jun 12 2018, 10:34 AM Z