Renderer - stingray.Renderer 네임스페이스 참조 - Stingray Lua API 참조
설명
렌더 리소스를 생성/삭제하는 인터페이스입니다.
기타 관련 참조 항목 
관련 도움말 항목
함수
 |
create_resource ( type, format, width, height ) : stingray.RenderResource GPU 리소스를 생성합니다.
|
type : | string | 생성할 GPU 리소스 유형으로, "render_target"이어야 합니다. |
format : | string | render_target의 픽셀 형식으로, "R8G8B8A8"이어야 합니다. |
width : | integer | 렌더 대상의 폭(픽셀)입니다. |
height : | integer | 렌더 대상의 높이(픽셀)입니다. |
|
새로운 렌더 리소스입니다. |
참고: 이 인터페이스는 이후 더 많은 옵션으로 확장될 예정입니다.
| |
destroy_resource ( resource )GPU 리소스를 삭제합니다.
|
| |
is_d3d12_supported ( ) : booleanD3D12를 엔진에서 지원하는지 쿼리합니다.
|
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
boolean |
D3D12를 엔진에서 지원하면 true, 그렇지 않으면 false입니다. |
| |
resource ( name ) : stingray.RenderResource기존 GPU 리소스를 반환합니다.
|
name : | string | 로드할 리소스의 이름입니다. |
|
렌더 리소스입니다. |
참고: 이 인터페이스는 이후 더 많은 옵션으로 확장될 예정입니다.
| |
run_resource_generator ( generator, resource_mapping )render_config 파일 내에서 임의의 리소스 생성기를 실행합니다.
|
generator : | string | 실행할 리소스 생성기의 이름입니다. |
resource_mapping : | table | 슬롯 이름을 사용자가 생성한 RenderResource와 연결해주는 바인딩 테이블입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
보통 이 함수는 표준 렌더링이 발생하기 전에 Gameplay 레이어의 렌더링 범위 내에서 호출해야 합니다.
예:
stingray.Renderer.run_resource_generator(self.resource_generator_name, {output_color = self.color})
텍스처 스트리밍
이 함수는 텍스처 스트리밍 시스템의 동작을 제어합니다.
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
이 함수를 호출하면 텍스처 스트리머가 선택한 자동 밉 수준 항목을 오버라이드합니다. 하지만 텍스처 스트리밍 시스템이 텍스처를 자동으로 스트리밍하도록 설정되어 있는 경우에는 다음에 시스템이 표시할 최선의 밉 수준을 선택할 때 사용자의 지침이 오버라이드됩니다. 자체 코드에서 밉 수준을 직접 설정하고 싶다면 set_automatic_streaming(false)을 호출하여 자동 스트리밍을 비활성화해야 합니다.
| |
immediate_streaming ( on_off )즉시 스트리밍 모드를 토글합니다.
|
on_off : | boolean | 즉시 스트리밍 모드를 활성화하려면 true를, 비활성화(기본값)하려면 false를 사용합니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
이 모드에서는 텍스처 스트리밍 시스템이 요청된 모든 밉 수준을 처음 요청된 동일한 프레임 내에서 즉시 로드합니다. 이 모드에서는 고품질 밉 수준이 요청 이후 가시적으로 로드되지 않습니다. 하지만 게임의 프레임 속도가 느려지는 원인이 될 수도 있습니다.
| |
override_texture_pool_size ( on_off )텍스처 스트리밍 시스템이 공유 메모리 풀의 크기를 프로젝트의 settings.ini 파일에 streaming_texture_pool_size 설정으로 정해져 있는 한도 이상으로 늘릴 수 있도록 허용할지 여부를 결정합니다.
|
on_off : | boolean | 스트리머가 최대 메모리 풀 크기를 초과할 수 있도록 허용하려면 true를, 공유 메모리 풀의 크기를 제한(기본값)하려면 false를 사용합니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| 이 함수는 어떠한 매개변수도 수용하지 않습니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
이 함수를 호출하면 텍스처 스트리머가 선택한 자동 밉 수준 항목을 오버라이드합니다. 하지만 텍스처 스트리밍 시스템이 텍스처를 자동으로 스트리밍하도록 설정되어 있는 경우에는 다음에 시스템이 표시할 최선의 밉 수준을 선택할 때 사용자의 지침이 오버라이드됩니다. 자체 코드에서 밉 수준을 직접 설정하고 싶다면 set_automatic_streaming(false)을 호출하여 자동 스트리밍을 비활성화해야 합니다.
기타 관련 참조 항목
| |
set_automatic_streaming ( on_off )자동 텍스처 스트리밍을 토글합니다.
|
on_off : | boolean | 자동 스트리밍을 활성화(기본값)하려면 true를, 비활성화하려면 false를 사용합니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
이 함수에 false를 전달하면 사용자가 이 인터페이스의 다른 함수(set_texture_requested_mip_level() 또는 request_textures_to_highest_mip_level() 등)를 호출하여 스트리밍을 명시적으로 지시하지 않는 한 텍스처 스트리밍 시스템이 더 이상 텍스처 데이터를 스트리밍하지 않습니다.
기타 관련 참조 항목
| |
set_texture_requested_mip_level ( texture_resource, mip_level )텍스처 스트리밍 시스템에게 지정된 텍스처에 대한 특정 밉 수준을 로드하도록 요청합니다.
|
texture_resource : | string | 밉 수준을 설정하려는 텍스처 리소스의 이름입니다. |
mip_level : | integer | 지정된 텍스처에 대해 로드하려는 밉 수준입니다. 가장 작고, 가장 덜 상세한 항목부터 시작하여 밉 수준을 색인화하는 0 기반 값입니다. 따라서, 0은 최저 해상도 밉 수준을 가리키고, 1은 그 다음으로 가장 작은 수준을 가리키는 식입니다. 예를 들어, 텍스처에 밉 수준이 10개 있는데, 그 중 가장 상세한 수준을 요청하려면 9를 사용해야 합니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
이 함수를 호출하면 텍스처 스트리머가 선택한 자동 밉 수준 항목을 오버라이드합니다. 하지만 텍스처 스트리밍 시스템이 텍스처를 자동으로 스트리밍하도록 설정되어 있는 경우에는 다음에 시스템이 해당 텍스처에 대해 표시할 최선의 밉 수준을 선택할 때 사용자의 지침이 오버라이드됩니다. 자체 코드에서 밉 수준을 직접 설정하고 싶다면 set_automatic_streaming(false)을 호출하여 자동 스트리밍을 비활성화해야 합니다.
기타 관련 참조 항목