| 패키지 | flash.display3D.textures |
| 클래스 | public final class CubeTexture |
| 상속 | CubeTexture  TextureBase EventDispatcher Object |
렌더링 도중 사용할 정육면체 맵 텍스처를 정의합니다. 정육면체 매핑은 환경 맵, 관람석 및 채광 조명과 같은 다양한 렌더링 기법에 사용됩니다.
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
바이트 배열에서 ATF(Adobe 텍스처 형식)의 정육면체 텍스처를 업로드합니다. | 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 |
바이트 배열에서 ATF(Adobe 텍스처 형식)의 정육면체 텍스처를 업로드합니다.
바이트 배열에는 텍스처의 모든 면과 밉맵이 포함되어야 합니다.
매개 변수
data:ByteArray — 밉맵을 비롯한 압축된 정육면체 텍스처가 포함된 바이트 배열입니다. ByteArray 객체는 little endian 형식을 사용해야 합니다.
| |
byteArrayOffset:uint — 텍스처 데이터를 읽기 시작할 선택적 오프셋입니다.
| |
async:Boolean (default = false)Texture 객체가 Event.TEXTURE_READY를 전달합니다. 기본값: false.
|
오류
TypeError — Null 포인터 오류: data가 null인 경우입니다.
| |
ArgumentError — 텍스처 디코딩 실패: 이 객체의 압축 형식이 data의 압축된 데이터 형식에서 파생될 수 없는 경우입니다.
| |
ArgumentError — 텍스처가 사각형이어야 함: 압축이 해제된 텍스처의 폭과 높이가 같지 않은 경우입니다.
| |
ArgumentError — 텍스처 크기가 일치하지 않음: 압축이 해제된 텍스처의 폭과 높이가 텍스처의 가장자리 길이와 같지 않은 경우입니다.
| |
ArgumentError — 밉레벨이 너무 큼: 압축을 해제한 텍스처의 밉 레벨이 텍스처의 가장자리 길이가 나타내는 값보다 큰 경우입니다.
| |
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 객체에서 정육면체 맵 텍스처의 구성 요소를 업로드합니다.
이 함수는 정육면체 맵의 한 면에서 하나의 밉 레벨을 업로드합니다. 필요에 따라 uploadFromBitmapData()를 호출하여 정육면체 맵의 각 밉 레벨과 면을 업로드합니다.
매개 변수
source:BitmapData — 비트맵입니다.
| |
side:uint — 업로드할 정육면체의 면을 나타내는 코드입니다.
| |
miplevel:uint (default = 0) |
오류
TypeError — Null 포인터 오류: source가 null인 경우입니다.
| |
ArgumentError — 밉레벨이 너무 큼: 지정된 밉 레벨이 텍스처의 크기가 나타내는 값보다 큰 경우입니다.
| |
ArgumentError — 유효하지 않은 정육면체 면: side가 5보다 큰 경우입니다.
| |
ArgumentError — 유효하지 않은 BitmapData 오류: source BitmapData 객체에 유효한 정육면체 텍스처 면이 포함되어 있지 않은 경우입니다. 이미지는 면이 2의 거듭제곱이고 지정된 밉레벨에 대해 크기가 올바른 사각형이어야 합니다.
| |
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 객체에서 정육면체 맵 텍스처의 구성 요소를 업로드합니다.
이 함수는 정육면체 맵의 한 면에서 하나의 밉 레벨을 업로드합니다. 필요에 따라 uploadFromByteArray()를 호출하여 정육면체 맵의 각 밉 레벨과 면을 업로드합니다.
매개 변수
data:ByteArray — 이 CubeTexture 객체가 만들어질 때 지정된 형식의 이미지를 포함하는 바이트 배열입니다. ByteArray 객체는 little endian 형식을 사용해야 합니다.
| |
byteArrayOffset:uint — 바이트 배열의 읽기가 시작되는 위치입니다.
| |
side: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는 사용할 수 없습니다.
|
Tue Jun 12 2018, 03:17 PM Z