Set Color Space

The ColorSpace API allows developers to set the color space in which they have mastered their app so the appropriate colors are shown when the app appears on the headset’s displays. Once an app’s color space has been set, developers should see that the colors on the headset match the colors in which the app was mastered.

Mastering to a known color space on a monitor and using the ColorSpace API can reduce iteration time during development by minimizing time spent checking and adjusting colors on the device.

For information on color spaces, see the Color and Brightness Mastering Guide.

The ovr_SetClientColorDesc function is used to set the color space used by the client app. This function takes a pointer to the ovrSession context and a pointer to an ovrHmdColorDesc structure that contains an ovrColorSpace enumeration that declares the color space. Once the app’s color space has been set, the runtime will adjust the color for the headset’s displays. Note that this function only handles color space remapping. It does not affect brightness, contrast, or gamma curves.

The ovr_GetHmdColorDesc function takes a pointer to the ovrSession context and returns a fixed value in an ovrHmdColorDesc structure specifying the color space of the current HMD. Note that this is not a “get” function for ovr_SetClientColorDesc.

Supported color space values in ovrColorSpace are as follows: