XR_ANDROID_recommended_resolution
이름 문자열
XR_ANDROID_recommended_resolution
확장 프로그램 유형
인스턴스 확장
등록된 내선 번호
462
버전
1
비준 상태
비준되지 않음
확장 프로그램 및 버전 종속 항목
최종 수정일
IP 상태
도움을 주신 분들
트레버 데브레히타벨, Google
스펜서 퀸, Google
라클란 포드, Google
바실리 바라노프, Google
개요
이 확장 프로그램을 사용하면 런타임이 현재 시스템 성능, 기기 열 또는 기타 요인을 기반으로 권장 해상도가 변경될 때 애플리케이션에 알릴 수 있습니다.
이 확장 프로그램은 다음과 같은 방식으로 사양을 수정합니다.
- 런타임은 인스턴스의 수명 동안 지정된
systemId및viewConfigurationType에 대해 xrEnumerateViewConfigurationViews 열거에서 동일하지 않은 버퍼 콘텐츠를 반환할 수 있습니다.
XrEventDataRecommendedResolutionChangedANDROID 구조는 다음과 같이 정의됩니다.
typedef struct XrEventDataRecommendedResolutionChangedANDROID {
XrStructureType type;
const void* next;
} XrEventDataRecommendedResolutionChangedANDROID;
회원 설명
type은 이 구조의 XrStructureType입니다.next는NULL이거나 구조체 체인의 다음 구조체에 대한 포인터입니다. 이러한 구조는 핵심 OpenXR이나 이 확장 프로그램에 정의되어 있지 않습니다.
XrEventDataRecommendedResolutionChangedANDROID 이벤트 구조를 수신하면 권장 해상도가 변경되었음을 나타냅니다. 애플리케이션은 xrEnumerateViewConfigurationViews를 사용하여 런타임에 새 권장 해상도를 쿼리해야 합니다 .
유효한 사용 (암시적)
- XrEventDataRecommendedResolutionChangedANDROID를 사용하기 전에
XR_ANDROID_recommended_resolution확장 프로그램을 사용 설정해야 합니다. -
type은XR_TYPE_EVENT_DATA_RECOMMENDED_RESOLUTION_CHANGED_ANDROID이어야 합니다. -
next은NULL이거나 구조 체인의 다음 구조를 가리키는 유효한 포인터여야 합니다.
예시 코드
다음 예시 코드는 권장 해상도 변경 이벤트를 수신 대기하는 방법을 보여줍니다.
// Created at app startup time.
XrInstance instance;
XrSystemId systemId; // Previously initialized.
uint32_t viewCountOutput; // Previously initialized.
// View configuration type the application uses.
XrViewConfigurationType viewConfigType;
// Poll events for recommended resolution changes.
XrEventDataBuffer event = {XR_TYPE_EVENT_DATA_BUFFER};
XrResult result = xrPollEvent(instance, &event);
if (result == XR_SUCCESS) {
switch (event.type) {
case XR_TYPE_EVENT_DATA_RECOMMENDED_RESOLUTION_CHANGED_ANDROID: {
uint32_t viewCapacityInput = viewCountOutput;
std::vector<XrViewConfigurationView> views(viewCapacityInput);
result = xrEnumerateViewConfigurationViews(instance, systemId,
viewConfigType, viewCapacityInput, &viewCountOutput, views.data());
if(!XR_SUCCEEDED(result)) {
// Handle error
}
// New recommended resolution is found in
// views.recommendedImageRectWidth and views.recommendedImageRectHeight
// Change the resolution for the viewConfigType
break;
}
default:
break;
}
}
버전 기록
버전 1, 2025-04-04 (케니 베르카에머)
- 초기 확장 프로그램 설명