| 套件 | flash.display3D.textures |
| 類別 | public final class CubeTexture |
| 繼承 | CubeTexture  TextureBase EventDispatcher Object |
定義立方體對應紋理，以供顯示期間使用。立方體對應可用於許多顯示技術，例如，環境對應、Skybox 以及天光照明。
您無法直接建立 CubeTexture 物件；請改用 Context3D createCubeTexture() 。
詳細資訊
相關 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
從位元組陣列上傳 Adobe Texture Format (ATF) 格式的立方體紋理。 | CubeTexture | ||
從 BitmapData 物件上傳立方體對應紋理的組件。 | CubeTexture | ||
從 ByteArray 物件上傳立方體對應紋理的組件。 | CubeTexture | ||
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
方法詳細資訊
uploadCompressedTextureFromByteArray | () | 方法 |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3 |
從位元組陣列上傳 Adobe Texture Format (ATF) 格式的立方體紋理。
位元組陣列必須包含紋理的所有表面與 MIP 映射。
參數
data:ByteArray — 位元組陣列，其中包含壓縮的立方體紋理，包括 MIP 映射。ByteArray 物件必須使用 little endian 格式。
| |
byteArrayOffset:uint — 要開始讀取紋理資料的選擇性偏移值。
| |
async:Boolean (default = false)Texture 物件就會傳送 Event.TEXTURE_READY。預設值：false。
|
擲回值
TypeError — Null 指標錯誤：data 為 null。
| |
ArgumentError — 紋理解碼失敗：無法從 data 中的壓縮資料格式衍生此物件的壓縮格式。
| |
ArgumentError — 紋理必須是正方形：解壓縮的紋理沒有相同的寬度和高度。
| |
ArgumentError — 紋理大小不相符：解壓縮的紋理寬度與高度不等於紋理邊緣的長度。
| |
ArgumentError — MIP 層級太大：解壓縮的紋理的 MIP 層級大於紋理邊緣的長度所隱含的層級。
| |
ArgumentError — 紋理格式不相符：解碼的 ATF 位元組未包含與這個紋理格式相容的紋理，或者不是立方體紋理。
| |
Error — 3768：在背景執行期間不會使用 Stage3D API。
| |
RangeError — 輸入大小錯誤：byteArrayOffset 出現整數溢出，或者 byteArrayOffset + 6 大於 data 的長度，或者從 byteArrayOffset 到 data 位元組陣列結尾之間可用的位元組數小於 ATF 紋理所需的資料數量。
|
相關 API 元素
uploadFromBitmapData | () | 方法 |
public function uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3 |
從 BitmapData 物件上傳立方體對應紋理的組件。
這個函數會上傳一邊立方體對應的一個 Mip 層級。請在必要時呼叫 uploadFromBitmapData()，以便上傳立方體對應的每個 Mip 層級和每一面。
參數
source:BitmapData — 點陣圖。
| |
side:uint — 表示要上傳立方體哪一邊的程式碼：
| |
miplevel:uint (default = 0) |
擲回值
TypeError — Null 指標錯誤：source 為 null。
| |
ArgumentError — MIP 層級太大：指定的 MIP 層級大於紋理尺寸所隱含的層級。
| |
ArgumentError — 無效的立方體面：side 大於 5。
| |
ArgumentError — 無效的 BitmapData 錯誤：source BitmapData 物件未包含有效的立方體紋理面。影像必須為正方形，邊長為 2 的倍數且指定正確的 MIP 層級大小。
| |
ArgumentError — 紋理格式不相符：紋理格式為 Context3DTextureFormat.COMPRESSED 或 Context3DTextureFormat.COMPRESSED_ALPHA，並且程式碼是在不支援執行階段紋理壓縮的行動平台上執行。
| |
Error — 3768：在背景執行期間不會使用 Stage3D API。
|
uploadFromByteArray | () | 方法 |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 11, AIR 3 |
從 ByteArray 物件上傳立方體對應紋理的組件。
這個函數會上傳一邊立方體對應的一個 Mip 層級。請在必要時呼叫 uploadFromByteArray()，以便上傳立方體對應的每個 Mip 層級和每一面。
參數
data:ByteArray — 位元組陣列，包含建立這個 CubeTexture 物件時所指定之格式的影像。ByteArray 物件必須使用 little endian 格式。
| |
byteArrayOffset:uint — 從那裡開始讀取位元組陣列。
| |
side:uint — 表示要上傳立方體哪一邊的程式碼：
| |
miplevel:uint (default = 0) |
擲回值
TypeError — Null 指標錯誤：data 為 null。
| |
ArgumentError — MIP 層級太大：指定的 MIP 層級大於紋理尺寸所隱含的層級。
| |
RangeError — 輸入大小錯誤：從 byteArrayOffset 到 data 位元組陣列結尾之間可用的位元組數小於此 MIP 層級紋理所需的資料數量，或者 byteArrayOffset 大於或等於 data 的長度。
| |
ArgumentError — 紋理格式不相符：紋理格式為 Context3DTextureFormat.COMPRESSED 或 Context3DTextureFormat.COMPRESSED_ALPHA，並且程式碼是在不支援執行階段紋理壓縮的行動平台上執行。
| |
Error — 3768：在背景執行期間不會使用 Stage3D API。
|
Tue Jun 12 2018, 03:47 PM Z