stingray.RenderBuffer 오브젝트 참조

설명

렌더링용 데이터의 버퍼를 조작하기 위한 API입니다.

기타 관련 참조 항목

stingray.ProceduralMesh.add_resource() stingray.ProceduralMesh.remove_resource()

상수

RB_BINORMAL_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

RB_BLEND_INDICES_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

RB_BLEND_WEIGHTS_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

RB_BLOCK_COMPRESSED_1 : integer 압축된 데이터 형식입니다.

RB_BLOCK_COMPRESSED_2 : integer 압축된 데이터 형식입니다.

RB_BLOCK_COMPRESSED_3 : integer 압축된 데이터 형식입니다.

RB_BLOCK_COMPRESSED_4 : integer 압축된 데이터 형식입니다.

RB_BLOCK_COMPRESSED_5 : integer 압축된 데이터 형식입니다.

RB_BLOCK_COMPRESSED_6 : integer 압축된 데이터 형식입니다.

RB_BLOCK_COMPRESSED_7 : integer 압축된 데이터 형식입니다.

RB_COLOR_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

RB_ETC2_R11 : integer 압축된 데이터 형식입니다.

RB_ETC2_RG11 : integer 압축된 데이터 형식입니다.

RB_ETC2_RGB8 : integer 압축된 데이터 형식입니다.

RB_ETC2_RGB8A1 : integer 압축된 데이터 형식입니다.

RB_ETC2_RGBA8 : integer 압축된 데이터 형식입니다.

RB_FLOAT_COMPONENT : integer 구성요소가 부동 데이터를 사용합니다.

관련 샘플 코드

절차적으로 메시 생성

RB_INDEX_BUFFER_VIEW : integer 버퍼 뷰 유형을 설명합니다.

관련 샘플 코드

절차적으로 메시 생성

RB_INTEGER_COMPONENT : integer 구성요소가 정수 데이터를 사용합니다.

RB_NORMAL_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

관련 샘플 코드

절차적으로 메시 생성

RB_POSITION_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

관련 샘플 코드

절차적으로 메시 생성

RB_PVR_RGBA_2BPP : integer 압축된 데이터 형식입니다.

RB_PVR_RGBA_4BPP : integer 압축된 데이터 형식입니다.

RB_PVR_RGB_2BPP : integer 압축된 데이터 형식입니다.

RB_PVR_RGB_4BPP : integer 압축된 데이터 형식입니다.

RB_RAW_BUFFER_VIEW : integer 버퍼 뷰 유형을 설명합니다.

RB_TANGENT_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

RB_TEXCOORD_SEMANTIC : integer 구성요소의 의미 체계를 설명합니다.

RB_TEXTURE_BUFFER_VIEW : integer 버퍼 뷰 유형을 설명합니다.

RB_TEXTURE_TYPE_2D : integer 2D 텍스처 유형입니다.

RB_TEXTURE_TYPE_3D : integer 3D 텍스처 유형입니다.

RB_TEXTURE_TYPE_CUBE : integer 정육면체 텍스처 유형입니다.

RB_VALIDITY_STATIC : integer 버퍼의 컨텐츠를 변경할 수 없다는 것을 나타냅니다.

관련 샘플 코드

절차적으로 메시 생성

RB_VALIDITY_UPDATABLE : integer 버퍼의 컨텐츠를 update_buffer()를 통해 변경할 수 있다는 것을 나타냅니다.

관련 샘플 코드

절차적으로 메시 생성

RB_VERTEX_BUFFER_VIEW : integer 버퍼 뷰 유형을 설명합니다.

관련 샘플 코드

절차적으로 메시 생성

RB_VERTEX_DESCRIPTION : integer 정점 버퍼를 설명합니다.

관련 샘플 코드

절차적으로 메시 생성

함수

component_type ( format ) : integer 해당 형식을 통해 사용된 구성요소 유형을 반환합니다.

매개변수

format :

integer

형식 설명자입니다.

반환하는 항목

integer

해당 형식을 통해 사용된 구성요소 유형입니다.

compressed_format ( compression ) : integer 압축된 데이터의 형식 설명자를 반환합니다.

매개변수

compression :

integer

압축 RB_*의 유형입니다.

반환하는 항목

integer

정수 형식 설명자 코드입니다.

compressed_format ( format ) : boolean 설명자가 압축된 형식을 설명하는 경우 true를 반환합니다.

매개변수

format :

integer

형식 설명자입니다.

반환하는 항목

boolean

형식이 압축 형식인 경우 True입니다.

create_buffer ( validity, view, stride, data ) : integer 데이터 버퍼를 생성하고, 이에 대한 핸들을 반환합니다.

매개변수

validity :	integer	버퍼가 정적인지, 업데이트 가능한지를 설명하는 RB_VALIDITY_* 값입니다.
view :	integer	생성 중인 버퍼의 유형을 설명하는 RB_*_BUFFER_VIEW입니다.
stride :	integer	데이터의 스트라이드입니다.
data :	table	데이터가 포함된 숫자 테이블입니다.

반환하는 항목

integer

버퍼에 대한 핸들입니다.

관련 샘플 코드

절차적으로 메시 생성

기타 관련 참조 항목

stingray.RenderBuffer.destroy_buffer()

create_description ( view, desc ) : integer 버퍼 설명 오브젝트를 생성하고, 이에 대한 핸들을 반환합니다.

매개변수

view :	integer	생성 중인 RB_*_DESCRIPTION입니다.
desc :	table	버퍼에 대한 설명입니다.

반환하는 항목

integer

버퍼 설명 오브젝트에 대한 핸들입니다.

desc는 각각 정점 채널을 설명하는 하위 테이블을 가진 여러 테이블로 이루어진 테이블이어야 합니다. 하위 테이블에는 다음 필드가 있습니다.

• format: 채널의 형식(format()을 통해 반환)입니다.
• semantic: 채널의 RB_*_SEMANTIC입니다.
• vb_index: 이 채널이 참조하는 정점 버퍼의 인덱스입니다.
• set: 의미 체계 세트(즉, TEXCOORD0, TEXCOORD1 등)입니다.
• instance: 정점 채널에 인스턴스별 데이터가 포함되어 있는 경우 True입니다.

관련 샘플 코드

절차적으로 메시 생성

기타 관련 참조 항목

stingray.RenderBuffer.destroy_description() stingray.RenderBuffer.update_description()

destroy_buffer ( handle ) create_buffer()를 통해 생성된 버퍼를 제거합니다.

매개변수

handle :

integer

제거해야 하는 버퍼에 대한 핸들입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

관련 샘플 코드

절차적으로 메시 생성

destroy_description ( handle ) 이전에 생성한 버퍼 설명을 제거합니다.

매개변수

handle :

integer

create_description()을 통해 반환된 설명 핸들입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

관련 샘플 코드

절차적으로 메시 생성

format ( component_type, signed, normalize, bit_depth_x, bit_depth_y, bit_depth_z, bit_depth_w ) : integer 버퍼 데이터 조각에 대한 형식 설명자를 생성하고 반환합니다.

매개변수

component_type :	integer	구성요소 RB_*_COMPONENT의 유형입니다.
signed :	boolean	데이터를 서명된 것으로 취급해야 하는 경우 True입니다.
normalize :	boolean	입력 정수 데이터가 0--1 또는 -1 -- 1 범위로 정규화되어야 하는 경우 True입니다.
bit_depth_x :	integer	x 구성요소의 비트 수입니다.
bit_depth_y :	integer	y 구성요소의 비트 수입니다.
bit_depth_z :	integer	z 구성요소의 비트 수입니다.
bit_depth_w :	integer	w 구성요소의 비트 수입니다.

반환하는 항목

integer

정수 형식 설명자 코드입니다.

관련 샘플 코드

절차적으로 메시 생성

기타 관련 참조 항목

stingray.RenderBuffer.create_description()

num_bits ( format ) : integer 형식에 의해 사용되는 비트 수를 반환합니다.

매개변수

format :

integer

형식 설명자입니다.

반환하는 항목

integer

형식에 의해 사용되는 비트 수입니다.

num_components ( format ) : integer 형식에 의해 사용되는 구성요소 수를 반환합니다.

매개변수

format :

integer

형식 설명자입니다.

반환하는 항목

integer

형식에 의해 사용되는 구성요소 수입니다.

update_buffer ( handle, type, data ) 새 데이터로 버퍼를 업데이트합니다.

매개변수

handle :	integer	업데이트해야 하는 버퍼에 대한 핸들입니다.
type :	integer	RB_*_COMPONENT 데이터 유형입니다.
data :	table	버퍼에 대한 새 데이터입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

관련 샘플 코드

절차적으로 메시 생성

기타 관련 참조 항목

stingray.RenderBuffer.RB_VALIDITY_UPDATABLE

update_description ( handle, desc ) 이전에 생성한 버퍼 설명을 업데이트합니다.

매개변수

handle :	integer	create_description()을 통해 반환된 설명 핸들입니다.
desc :	table	업데이트된 버퍼 설명입니다. create_description()을 참조하십시오.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.