| 패키지 | 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 객체에서 ATF(Adobe 텍스처 형식)의 압축된 텍스처를 업로드합니다. | 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 객체에서 ATF(Adobe 텍스처 형식)의 압축된 텍스처를 업로드합니다. ATF 파일 버전 2에는 SWF 버전 21 이상이 필요하고, ATF 파일 버전 3에는 SWF 버전 29 이상이 필요합니다. 알파가 포함되지 않은 png 이미지를 사용하여 만든 ATF 파일의 경우 Context3DObject::createTexture 동안 제공된 format 문자열이 "COMPRESSED"여야 하고, 알파가 포함된 png 이미지를 사용하여 만든 ATF 파일의 경우 Context3DObject::createTexture 동안 제공된 format 문자열이 "COMPRESSED_ALPHA"여야 합니다.
매개 변수
data:ByteArray — 밉맵을 비롯한 압축된 텍스처가 포함된 바이트 배열입니다. ByteArray 객체는 little endian 형식을 사용해야 합니다.
| |
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 — 밉레벨이 너무 큼: 지정된 밉 레벨이 더 큰 텍스처의 크기가 나타내는 값보다 큰 경우입니다.
| |
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을 비동기적으로 업로드합니다. 업로드가 완료될 때까지 텍스처를 사용하려는 모든 draw 메서드가 실패합니다. 업로드 성공 시, 이 Texture 객체가 Event.TEXTURE_READY를 전달합니다. Event.TEXTURE_READY는 텍스처 객체에 대해 수신된 비동기적 호출이 성공적으로 실행되었음을 나타내는 콜백입니다. 백그라운드 업로드 도중 오류 발생 시, 이 Texture 객체는 Event.ERROREVENT를 전달합니다.
매개 변수
source:BitmapData — 비트맵입니다
| |
miplevel:uint (default = 0) |
오류
TypeError — Null 포인터 오류: source가 null인 경우입니다.
| |
ArgumentError — 잘못된 BitmapData 오류: 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)로 읽습니다. float 텍스처는 텍셀 구성 요소당 부동 항목 수(1 또는 4)로 읽습니다. ByteArray 객체는 little endian 형식을 사용해야 합니다.
| |
byteArrayOffset:uint — 바이트 배열 객체에서 텍스처 데이터를 읽기 시작할 위치입니다.
| |
miplevel:uint (default = 0) |
오류
TypeError — Null 포인터 오류: data가 null인 경우입니다.
| |
ArgumentError — 밉레벨이 너무 큼: 지정된 밉 레벨이 더 큰 텍스처의 크기가 나타내는 값보다 큰 경우입니다.
| |
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을 비동기적으로 업로드합니다. 업로드가 완료될 때까지 텍스처를 사용하려는 모든 draw 메서드가 실패합니다. 업로드 성공 시, 이 Texture 객체가 Event.TEXTURE_READY를 전달합니다. Event.TEXTURE_READY는 텍스처 객체에 대해 수신된 비동기적 호출이 성공적으로 실행되었음을 나타내는 콜백입니다. 백그라운드 업로드 도중 오류 발생 시, 이 Texture 객체는 Event.ERROREVENT를 전달합니다.
매개 변수
data:ByteArray — 텍스처를 채우기에 충분한 바이트를 텍스처 내부 형식에 포함하는 바이트 배열입니다. rgba 텍스처는 텍셀 구성 요소당 바이트 수(1 또는 4)로 읽습니다. float 텍스처는 텍셀 구성 요소당 부동 항목 수(1 또는 4)로 읽습니다. ByteArray 객체는 little endian 형식을 사용해야 합니다.
| |
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, 03:17 PM Z