openvr显示相关接口

概述

本文档介绍openvr上关于显示接口的内容,基于目前(2017.10.09)最新版本(openVR V1.0.10)进行描述,并你可以基于开源项目openvr_survivor对这些接口进行修改和验证.

显示接口

目前显示接口包括IVRDisplayComponent,IVRVirtualDisplay,IVRDriverDirectModeComponent

IVRDisplayComponent

GetWindowBounds

void GetWindowBounds( int32_t *pnX, int32_t *pnY, uint32_t *pnWidth, uint32_t *pnHeight )用来设置窗口的位置和尺寸.
参数说明:

• pnX和pnY
  设置显示窗口左上角的起始坐标,比如你有2个显示器,显示器1的分辨率为1920x1080,显示器2的分辨率为1280x1024,那么如果希望在第一个显示显示,将pnX和pnY设置为0,如果希望在第二个显示器显示,则将pnX设置为1920,pnY设置为0即可.
• pnWidth和pnHeight
  显示窗口的大小,这个与显示屏的实际分辨率相对应.

IsDisplayOnDesktop

bool IsDisplayOnDesktop( )显示是否是桌面扩展显示

IsDisplayRealDisplay

bool IsDisplayRealDisplay( )显示是否真实显示器
注:”IsDisplayRealDisplay”和”IsDisplayOnDesktop”,在实际使用中,这2个接口的返回值,并不会影响扩展显示和直接渲染,应该是一个弃用的接口,官网上查不到更多信息.

GetRecommendedRenderTargetSize

void GetRecommendedRenderTargetSize( uint32_t *pnWidth, uint32_t *pnHeight )获取处理过程中被畸变影响的渲染目标的大小.
这个接口设定的参数是一个建议值,应用程序仍然可以随意设定渲染目标的大小,合成器会根据情况进行缩放.一般设定为显示屏大小一致.
注:这里我在survivor工程上做了一个实验,如果把”renderWidth”和”renderHeight”设置为分辨率的1/4,也许处理效率上会增加(这里我没实际测量)将会看到画质被降低了很多.这里还是建议设定为与显示器分辨率大小一致.

GetEyeOutputViewport

void GetEyeOutputViewport( EVREye eEye, uint32_t *pnX, uint32_t *pnY, uint32_t *pnWidth, uint32_t *pnHeight )获取左/右眼视口的位置和大小
参数说明:

• eEye
  Eye_Left或Eye_Right
• pnX和pnY
  起始位置
• pnWidth和pnHeight
  宽/高大小

这里如果有横竖屏切换的,可以调整这里的参数来实现.

GetProjectionRaw

void GetProjectionRaw( EVREye eEye, float *pfLeft, float *pfRight, float *pfTop, float *pfBottom )用来设置你的投影矩阵
参数说明:

• eEye
  Eye_Left或Eye_Right
• pfLeft,pfRight,pfTop,pfBottom
  透视投影后所成的像的左,右,上,下的坐标位置.

关于投影矩阵可以参考这个资料opengl projection matrix.
关于这个接口使用有一个详解的链接

ComputeDistortion

DistortionCoordinates_t ComputeDistortion( EVREye eEye, float fU, float fV )基于左/右眼的UV做反畸变功能的接口,UV坐标的(0,0)表示视口的左下角,(1,1)表示视口的右下角
参数说明:

• eEye
  Eye_Left或Eye_Right
• fU或fV
  UV坐标

这个接口还可以用来配合GetEyeOutputViewport来做横竖屏的切换,以及视图的旋转.

IVRVirtualDisplay

IVRVirtualDisplay接口目前存在闪黑的bug,等修复后整理.

IVRDriverDirectModeComponent

IVRVirtualDisplay和IVRDriverDirectModeComponent这两个接口用来实现”扩展显示”和”直接渲染”的,后续再做详解.