This extension defines an API for the application to give optimization hints to the runtime for tracker domains.
For example, an application might be interested in tracking targets that are at a far distance from the camera which may increase tracking latency, while another application might be interested in minimizing power consumption at the cost of tracking accuracy. Targets are domains which are defined in XrTrackingOptimizationSettingsDomainQCOM.
This allows the application to tailor the tracking algorithms to specific use-cases and scene-scales in order to provide the best experience possible.
Summary: provide domain hints to the run-time about which parameters to optimize tracking for.
| Modifier and Type | Field and Description |
|---|---|
| public static final int | XR_ERROR_HINT_ALREADY_SET_QCOM
Extends |
| public static final String | XR_QCOM_TRACKING_OPTIMIZATION_SETTINGS_EXTENSION_NAME
The extension name. |
| public static final int | XR_QCOM_tracking_optimization_settings_SPEC_VERSION
The extension specification version. |
| public static final int | XR_TRACKING_OPTIMIZATION_SETTINGS_DOMAIN_ALL_QCOM
XrTrackingOptimizationSettingsDomainQCOM - Domains to apply tracking optimization hints Enumerant Descriptions
|
| public static final int | XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_CLOSE_RANGE_PRIORIZATION_QCOM
XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
|
| public static final int | XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_HIGH_POWER_PRIORIZATION_QCOM
XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
|
| public static final int | XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_LONG_RANGE_PRIORIZATION_QCOM
XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
|
| public static final int | XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_LOW_POWER_PRIORIZATION_QCOM
XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
|
| public static final int | XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_NONE_QCOM
XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
|
| Access | Constructor and Description |
|---|---|
| protected |
| Modifier and Type | Method and Description |
|---|---|
| public static int | xrSetTrackingOptimizationSettingsHintQCOM(XrSession
a valid session, int XrSession handle.the tracking domain for which the hint is applied domain, int the hint to be applied hint)Submit a tracking optimization hint. |
| XR_ERROR_HINT_ALREADY_SET_QCOM | back to summary |
|---|---|
| public static final int XR_ERROR_HINT_ALREADY_SET_QCOM Extends | |
| XR_QCOM_TRACKING_OPTIMIZATION_SETTINGS_EXTENSION_NAME | back to summary |
|---|---|
| public static final String XR_QCOM_TRACKING_OPTIMIZATION_SETTINGS_EXTENSION_NAME The extension name. | |
| XR_QCOM_tracking_optimization_settings_SPEC_VERSION | back to summary |
|---|---|
| public static final int XR_QCOM_tracking_optimization_settings_SPEC_VERSION The extension specification version. | |
| XR_TRACKING_OPTIMIZATION_SETTINGS_DOMAIN_ALL_QCOM | back to summary |
|---|---|
| public static final int XR_TRACKING_OPTIMIZATION_SETTINGS_DOMAIN_ALL_QCOM XrTrackingOptimizationSettingsDomainQCOM - Domains to apply tracking optimization hints Enumerant Descriptions
See Also | |
| XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_CLOSE_RANGE_PRIORIZATION_QCOM | back to summary |
|---|---|
| public static final int XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_CLOSE_RANGE_PRIORIZATION_QCOM XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
See Also | |
| XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_HIGH_POWER_PRIORIZATION_QCOM | back to summary |
|---|---|
| public static final int XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_HIGH_POWER_PRIORIZATION_QCOM XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
See Also | |
| XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_LONG_RANGE_PRIORIZATION_QCOM | back to summary |
|---|---|
| public static final int XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_LONG_RANGE_PRIORIZATION_QCOM XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
See Also | |
| XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_LOW_POWER_PRIORIZATION_QCOM | back to summary |
|---|---|
| public static final int XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_LOW_POWER_PRIORIZATION_QCOM XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
See Also | |
| XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_NONE_QCOM | back to summary |
|---|---|
| public static final int XR_TRACKING_OPTIMIZATION_SETTINGS_HINT_NONE_QCOM XrTrackingOptimizationSettingsHintQCOM - Hints for prioritizing different tracking goals Enumerant Descriptions
See Also | |
| QCOMTrackingOptimizationSettings | back to summary |
|---|---|
| protected QCOMTrackingOptimizationSettings() | |
| xrSetTrackingOptimizationSettingsHintQCOM | back to summary |
|---|---|
| public static int xrSetTrackingOptimizationSettingsHintQCOM(XrSession session, int domain, int hint) Submit a tracking optimization hint. C SpecificationThe
DescriptionThe XR runtime behaves as if The XR runtime must return A hint is typically set before a domain handle is created. If hints are set more than once from one or concurrent sessions, the runtime may accommodate the first hint it received and return If the application destroys the active domain handle associated with the hint, the runtime may behave as if Valid Usage (Implicit)
Return Codes
| |