OpenVR SDK Update 0.9.14:

* IVRSystem 
  * Added PerformanceTestEnableCapture(bool) for performance testing tools to toggle when frame timing data should be recorded.
  * Added PerformanceTestReportFidelityLevelChange(int) for performance testing tools to report when they've changed fidelity settings.

* General
  * Added present count field to Compositor_FrameTiming.

[git-p4: depot-paths = "//vr/steamvr/sdk_release/": change = 3205113]

Author: Jeep Barnett

bin/linux32/libopenvr_api.so

@@ -415,6 +415,10 @@ enum EVREventType
 	VREvent_TrackedCamera_StopVideoStream   = 1501,
 	VREvent_TrackedCamera_PauseVideoStream  = 1502,
 	VREvent_TrackedCamera_ResumeVideoStream = 1503,
+
+	VREvent_PerformanceTest_EnableCapture = 1600,
+	VREvent_PerformanceTest_DisableCapture = 1601,
+	VREvent_PerformanceTest_FidelityLevel = 1602,
 
 	// Vendors are free to expose private events in this reserved region
 	VREvent_VendorSpecific_Reserved_Start = 10000,
@@ -541,6 +545,11 @@ struct VREvent_Reserved_t
 	uint64_t reserved1;
 };
 
+struct VREvent_PerformanceTest_t
+{
+	uint32_t m_nFidelityLevel;
+};
+
 /** If you change this you must manually update openvr_interop.cs.py */
 typedef union
 {
@@ -554,6 +563,7 @@ typedef union
 	VREvent_Keyboard_t keyboard;
 	VREvent_Ipd_t ipd;
 	VREvent_Chaperone_t chaperone;
+	VREvent_PerformanceTest_t performanceTest;
 } VREvent_Data_t;
 
 /** An event posted by the server to all running applications */
@@ -882,16 +892,23 @@ VR_CAMERA_DECL_ALIGN( 8 ) struct CameraVideoStreamFrame_t
 	uint32_t m_nWidth;
 	uint32_t m_nHeight;
 
+	uint32_t m_nImageDataSize;			// Based on stream format, width, height
+
 	uint32_t m_nFrameSequence;			// Starts from 0 when stream starts.
-	uint32_t m_nTimeStamp;				// Driver provided time stamp per driver centric time base
+
+	uint32_t m_nISPFrameTimeStamp;		// Driver provided time stamp per driver centric time base
+	uint32_t m_nISPReferenceTimeStamp;
+	uint32_t m_nSyncCounter;
+
+	uint32_t m_nExposureTime;
 
 	uint32_t m_nBufferIndex;			// Identifies which buffer the image data is hosted
 	uint32_t m_nBufferCount;			// Total number of configured buffers
 
-	uint32_t m_nImageDataSize;			// Based on stream format, width, height
-
 	double m_flFrameElapsedTime;		// Starts from 0 when stream starts. In seconds.
+
 	double m_flFrameCaptureTime;		// Relative to when the frame was exposed/captured.
+	uint64_t m_nFrameCaptureTicks;
 
 	bool m_bPoseIsValid;				// Supplied by HMD layer when used as a tracked camera
 	vr::HmdMatrix34_t m_matDeviceToAbsoluteTracking;	
@@ -1170,6 +1187,18 @@ class IVRSystem
 	* halts the timeout and dismisses the dashboard (if it was up). Applications should be sure to actually 
 	* prompt the user to save and then exit afterward, otherwise the user will be left in a confusing state. */
 	virtual void AcknowledgeQuit_UserPrompt() = 0;
+
+	// ------------------------------------
+	// Performance Test methods
+	// ------------------------------------
+
+	/** Performance Testing applications can call this to enable/disable when frame timing data should be 
+	* captured for the Perf Test Report. */
+	virtual void PerformanceTestEnableCapture( bool bEnable ) = 0;
+
+	/** Performance Testing applications can call this to note on the Perf Test Report when they've shifted 
+	* their fidelity to a new mode. */
+	virtual void PerformanceTestReportFidelityLevelChange( int nFidelityLevel ) = 0;
 };
 
 static const char * const IVRSystem_Version = "IVRSystem_010";
@@ -1597,6 +1626,9 @@ class IVRChaperoneSetup
 
 	/** Returns the preferred seated position. */
 	virtual bool GetLiveSeatedZeroPoseToRawTrackingPose( HmdMatrix34_t *pmatSeatedZeroPoseToRawTrackingPose ) = 0;
+
+	virtual void SetWorkingWallTagInfo( VR_ARRAY_COUNT(unTagCount) uint8_t *pTagsBuffer, uint32_t unTagCount ) = 0;
+	virtual bool GetLiveWallTagInfo( VR_OUT_ARRAY_COUNT(punTagCount) uint8_t *pTagsBuffer, uint32_t *punTagCount ) = 0;
 };
 
 static const char * const IVRChaperoneSetup_Version = "IVRChaperoneSetup_004";
@@ -1655,6 +1687,8 @@ struct Compositor_FrameTiming
 	float m_flHandoffStartMs;
 	float m_flHandoffEndMs;
 	float m_flCompositorUpdateCpuMs;
+
+	uint32_t m_nPresents; // number of times this frame was presented
 };
 
 
@@ -1759,7 +1793,7 @@ class IVRCompositor
 	virtual void CompositorDumpImages() = 0;
 };
 
-static const char * const IVRCompositor_Version = "IVRCompositor_009";
+static const char * const IVRCompositor_Version = "IVRCompositor_010";
 
 } // namespace vr
 
@@ -2391,8 +2425,6 @@ class IVRTrackedCamera
 	virtual bool SetAutoExposure( vr::TrackedDeviceIndex_t nDeviceIndex, bool bEnable ) = 0;
 
 	// A stream can only be paused after it is started. The pause state is cleared after stopping.
-	// The camera may not support pause/resume semantics due to HW limitations.
-	virtual bool SupportsPauseResume( vr::TrackedDeviceIndex_t nDeviceIndex ) = 0;
 	virtual bool PauseVideoStream( vr::TrackedDeviceIndex_t nDeviceIndex ) = 0;
 	virtual bool ResumeVideoStream( vr::TrackedDeviceIndex_t nDeviceIndex ) = 0;
 	virtual bool IsVideoStreamPaused( vr::TrackedDeviceIndex_t nDeviceIndex ) = 0;

bin/linux32/libopenvr_api.so.dbg

@@ -105,6 +105,10 @@ class VRNativeEntrypoints
 	internal static extern void VR_IVRSystem_AcknowledgeQuit_Exiting(IntPtr instancePtr);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRSystem_AcknowledgeQuit_UserPrompt")]
 	internal static extern void VR_IVRSystem_AcknowledgeQuit_UserPrompt(IntPtr instancePtr);
+	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRSystem_PerformanceTestEnableCapture")]
+	internal static extern void VR_IVRSystem_PerformanceTestEnableCapture(IntPtr instancePtr, bool bEnable);
+	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRSystem_PerformanceTestReportFidelityLevelChange")]
+	internal static extern void VR_IVRSystem_PerformanceTestReportFidelityLevelChange(IntPtr instancePtr, int nFidelityLevel);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRExtendedDisplay_GetWindowBounds")]
 	internal static extern void VR_IVRExtendedDisplay_GetWindowBounds(IntPtr instancePtr, ref int pnX, ref int pnY, ref uint pnWidth, ref uint pnHeight);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRExtendedDisplay_GetEyeOutputViewport")]
@@ -195,6 +199,10 @@ class VRNativeEntrypoints
 	internal static extern void VR_IVRChaperoneSetup_ReloadFromDisk(IntPtr instancePtr, EChaperoneConfigFile configFile);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRChaperoneSetup_GetLiveSeatedZeroPoseToRawTrackingPose")]
 	internal static extern bool VR_IVRChaperoneSetup_GetLiveSeatedZeroPoseToRawTrackingPose(IntPtr instancePtr, ref HmdMatrix34_t pmatSeatedZeroPoseToRawTrackingPose);
+	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRChaperoneSetup_SetWorkingWallTagInfo")]
+	internal static extern void VR_IVRChaperoneSetup_SetWorkingWallTagInfo(IntPtr instancePtr,  [In, Out] byte[] pTagsBuffer, uint unTagCount);
+	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRChaperoneSetup_GetLiveWallTagInfo")]
+	internal static extern bool VR_IVRChaperoneSetup_GetLiveWallTagInfo(IntPtr instancePtr,  [In, Out] byte[] pTagsBuffer, ref uint punTagCount);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRCompositor_SetTrackingSpace")]
 	internal static extern void VR_IVRCompositor_SetTrackingSpace(IntPtr instancePtr, ETrackingUniverseOrigin eOrigin);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRCompositor_GetTrackingSpace")]
@@ -435,8 +443,6 @@ class VRNativeEntrypoints
 	internal static extern bool VR_IVRTrackedCamera_ReleaseVideoStreamFrame(IntPtr instancePtr, uint nDeviceIndex, ref CameraVideoStreamFrame_t pFrameImage);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRTrackedCamera_SetAutoExposure")]
 	internal static extern bool VR_IVRTrackedCamera_SetAutoExposure(IntPtr instancePtr, uint nDeviceIndex, bool bEnable);
-	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRTrackedCamera_SupportsPauseResume")]
-	internal static extern bool VR_IVRTrackedCamera_SupportsPauseResume(IntPtr instancePtr, uint nDeviceIndex);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRTrackedCamera_PauseVideoStream")]
 	internal static extern bool VR_IVRTrackedCamera_PauseVideoStream(IntPtr instancePtr, uint nDeviceIndex);
 	[DllImportAttribute("openvr_api", EntryPoint = "VR_IVRTrackedCamera_ResumeVideoStream")]
@@ -502,6 +508,8 @@ public abstract class IVRSystem
 	public abstract EVRFirmwareError PerformFirmwareUpdate(uint unDeviceIndex);
 	public abstract void AcknowledgeQuit_Exiting();
 	public abstract void AcknowledgeQuit_UserPrompt();
+	public abstract void PerformanceTestEnableCapture(bool bEnable);
+	public abstract void PerformanceTestReportFidelityLevelChange(int nFidelityLevel);
 }
 
 
@@ -571,6 +579,8 @@ public abstract class IVRChaperoneSetup
 	public abstract void SetWorkingStandingZeroPoseToRawTrackingPose(ref HmdMatrix34_t pMatStandingZeroPoseToRawTrackingPose);
 	public abstract void ReloadFromDisk(EChaperoneConfigFile configFile);
 	public abstract bool GetLiveSeatedZeroPoseToRawTrackingPose(ref HmdMatrix34_t pmatSeatedZeroPoseToRawTrackingPose);
+	public abstract void SetWorkingWallTagInfo(byte [] pTagsBuffer);
+	public abstract bool GetLiveWallTagInfo(out byte [] pTagsBuffer);
 }
 
 
@@ -727,7 +737,6 @@ public abstract class IVRTrackedCamera
 	public abstract CameraVideoStreamFrame_t GetVideoStreamFrame(uint nDeviceIndex);
 	public abstract bool ReleaseVideoStreamFrame(uint nDeviceIndex,ref CameraVideoStreamFrame_t pFrameImage);
 	public abstract bool SetAutoExposure(uint nDeviceIndex,bool bEnable);
-	public abstract bool SupportsPauseResume(uint nDeviceIndex);
 	public abstract bool PauseVideoStream(uint nDeviceIndex);
 	public abstract bool ResumeVideoStream(uint nDeviceIndex);
 	public abstract bool IsVideoStreamPaused(uint nDeviceIndex);
@@ -1016,6 +1025,16 @@ public override void AcknowledgeQuit_UserPrompt()
 		CheckIfUsable();
 		VRNativeEntrypoints.VR_IVRSystem_AcknowledgeQuit_UserPrompt(m_pVRSystem);
 	}
+	public override void PerformanceTestEnableCapture(bool bEnable)
+	{
+		CheckIfUsable();
+		VRNativeEntrypoints.VR_IVRSystem_PerformanceTestEnableCapture(m_pVRSystem,bEnable);
+	}
+	public override void PerformanceTestReportFidelityLevelChange(int nFidelityLevel)
+	{
+		CheckIfUsable();
+		VRNativeEntrypoints.VR_IVRSystem_PerformanceTestReportFidelityLevelChange(m_pVRSystem,nFidelityLevel);
+	}
 }
 
 
@@ -1373,6 +1392,20 @@ public override bool GetLiveSeatedZeroPoseToRawTrackingPose(ref HmdMatrix34_t pm
 		bool result = VRNativeEntrypoints.VR_IVRChaperoneSetup_GetLiveSeatedZeroPoseToRawTrackingPose(m_pVRChaperoneSetup,ref pmatSeatedZeroPoseToRawTrackingPose);
 		return result;
 	}
+	public override void SetWorkingWallTagInfo(byte [] pTagsBuffer)
+	{
+		CheckIfUsable();
+		VRNativeEntrypoints.VR_IVRChaperoneSetup_SetWorkingWallTagInfo(m_pVRChaperoneSetup,pTagsBuffer,(uint) pTagsBuffer.Length);
+	}
+	public override bool GetLiveWallTagInfo(out byte [] pTagsBuffer)
+	{
+		CheckIfUsable();
+		uint punTagCount = 0;
+		bool result = VRNativeEntrypoints.VR_IVRChaperoneSetup_GetLiveWallTagInfo(m_pVRChaperoneSetup,null,ref punTagCount);
+		pTagsBuffer= new byte[punTagCount];
+		result = VRNativeEntrypoints.VR_IVRChaperoneSetup_GetLiveWallTagInfo(m_pVRChaperoneSetup,pTagsBuffer,ref punTagCount);
+		return result;
+	}
 }
 
 
@@ -2004,8 +2037,6 @@ public override bool GetComponentState(string pchRenderModelName,string pchCompo
 }
 
 
-
-
 public class CVRNotifications : IVRNotifications
 {
 	public CVRNotifications(IntPtr VRNotifications)
@@ -2210,12 +2241,6 @@ public override bool SetAutoExposure(uint nDeviceIndex,bool bEnable)
 		bool result = VRNativeEntrypoints.VR_IVRTrackedCamera_SetAutoExposure(m_pVRTrackedCamera,nDeviceIndex,bEnable);
 		return result;
 	}
-	public override bool SupportsPauseResume(uint nDeviceIndex)
-	{
-		CheckIfUsable();
-		bool result = VRNativeEntrypoints.VR_IVRTrackedCamera_SupportsPauseResume(m_pVRTrackedCamera,nDeviceIndex);
-		return result;
-	}
 	public override bool PauseVideoStream(uint nDeviceIndex)
 	{
 		CheckIfUsable();
@@ -2482,6 +2507,9 @@ public enum EVREventType
 	VREvent_TrackedCamera_StopVideoStream = 1501,
 	VREvent_TrackedCamera_PauseVideoStream = 1502,
 	VREvent_TrackedCamera_ResumeVideoStream = 1503,
+	VREvent_PerformanceTest_EnableCapture = 1600,
+	VREvent_PerformanceTest_DisableCapture = 1601,
+	VREvent_PerformanceTest_FidelityLevel = 1602,
 	VREvent_VendorSpecific_Reserved_Start = 10000,
 	VREvent_VendorSpecific_Reserved_End = 19999,
 }
@@ -2937,6 +2965,10 @@ public enum ECameraVideoStreamFormat
 	public ulong reserved0;
 	public ulong reserved1;
 }
+[StructLayout(LayoutKind.Sequential)] public struct VREvent_PerformanceTest_t
+{
+	public uint m_nFidelityLevel;
+}
 [StructLayout(LayoutKind.Sequential)] public struct VREvent_t
 {
 	public EVREventType eventType;
@@ -3000,6 +3032,7 @@ public enum ECameraVideoStreamFormat
 	public float m_flHandoffStartMs;
 	public float m_flHandoffEndMs;
 	public float m_flCompositorUpdateCpuMs;
+	public uint m_nPresents;
 }
 [StructLayout(LayoutKind.Sequential)] public struct VROverlayIntersectionParams_t
 {
@@ -3053,15 +3086,17 @@ public enum ECameraVideoStreamFormat
 	public ECameraVideoStreamFormat m_nStreamFormat;
 	public uint m_nWidth;
 	public uint m_nHeight;
+	public uint m_nImageDataSize;
 	public uint m_nFrameSequence;
-	public uint m_nTimeStamp;
-	public uint m_nISPTimeStamp;
+	public uint m_nISPFrameTimeStamp;
+	public uint m_nISPReferenceTimeStamp;
+	public uint m_nSyncCounter;
 	public uint m_nExposureTime;
 	public uint m_nBufferIndex;
 	public uint m_nBufferCount;
-	public uint m_nImageDataSize;
 	public double m_flFrameElapsedTime;
 	public double m_flFrameCaptureTime;
+	public ulong m_nFrameCaptureTicks;
 	[MarshalAs(UnmanagedType.I1)]
 	public bool m_bPoseIsValid;
 	public HmdMatrix34_t m_matDeviceToAbsoluteTracking;
@@ -3111,7 +3146,7 @@ public static string GetStringForHmdError(EVRInitError error)
 	public const string IVRApplications_Version = "IVRApplications_002";
 	public const string IVRChaperone_Version = "IVRChaperone_003";
 	public const string IVRChaperoneSetup_Version = "IVRChaperoneSetup_004";
-	public const string IVRCompositor_Version = "IVRCompositor_009";
+	public const string IVRCompositor_Version = "IVRCompositor_010";
 	public const uint k_unVROverlayMaxKeyLength = 128;
 	public const uint k_unVROverlayMaxNameLength = 128;
 	public const uint k_unMaxOverlayCount = 32;