XR_ANDROID_recommended_resolution

Name String

XR_ANDROID_recommended_resolution

Loại phần mở rộng

Tiện ích Instance

Số máy nhánh đã đăng ký

462

Bản sửa đổi

1

Trạng thái phê chuẩn

Chưa được phê chuẩn

Phần mở rộng và các phần phụ thuộc của phiên bản

OpenXR 1.0

Trạng thái IP

Không có thông báo xác nhận quyền sở hữu nào đã biết về quyền sở hữu trí tuệ.

Cộng tác viên

Trevor Debrechtabel, Google
Spencer Quin, Google
Lachlan Ford, Google
Vasiliy Baranov, Google

Tổng quan

Tiện ích này cho phép thời gian chạy thông báo cho ứng dụng khi độ phân giải được đề xuất thay đổi, dựa trên hiệu suất hiện tại của hệ thống, nhiệt độ thiết bị hoặc các yếu tố khác.

Tiện ích này sửa đổi quy cách theo cách sau:

• Thời gian chạy có thể trả về nội dung vùng đệm không giống nhau từ quá trình liệt kê xrEnumerateViewConfigurationViews cho systemId và viewConfigurationType đã cho trong suốt thời gian tồn tại của thực thể.

Cấu trúc XrEventDataRecommendedResolutionChangedANDROID được xác định như sau:

typedef struct XrEventDataRecommendedResolutionChangedANDROID {
    XrStructureType    type;
    const void*        next;
} XrEventDataRecommendedResolutionChangedANDROID;

Nội dung mô tả thành viên

• type là XrStructureType của cấu trúc này.
• next là NULL hoặc con trỏ đến cấu trúc tiếp theo trong chuỗi cấu trúc. Không có cấu trúc nào như vậy được xác định trong OpenXR cốt lõi hoặc tiện ích này.

Việc nhận cấu trúc sự kiện XrEventDataRecommendedResolutionChangedANDROID cho biết độ phân giải đề xuất đã thay đổi. Ứng dụng phải truy vấn thời gian chạy để biết độ phân giải được đề xuất mới bằng cách sử dụng xrEnumerateViewConfigurationViews .

Sử dụng hợp lệ (Ngầm ẩn)

• Bạn phải bật tiện ích XR_ANDROID_recommended_resolution trước khi sử dụng XrEventDataRecommendedResolutionChangedANDROID
• type phải là XR_TYPE_EVENT_DATA_RECOMMENDED_RESOLUTION_CHANGED_ANDROID
• next phải là NULL hoặc một con trỏ hợp lệ đến cấu trúc tiếp theo trong chuỗi cấu trúc

Mã ví dụ

Đoạn mã ví dụ sau đây minh hoạ cách lắng nghe các sự kiện thay đổi độ phân giải được đề xuất.

// 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 = {
  .type = 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;
  }
}

Danh sách phiên bản

• Bản sửa đổi 1, ngày 4/4/2025 (Kenny Vercaemer)

  • Nội dung mô tả ban đầu của tiện ích