VTK  9.6.20260402
vtkVRRenderWindow.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-License-Identifier: BSD-3-Clause
38
39#ifndef vtkVRRenderWindow_h
40#define vtkVRRenderWindow_h
41
42#include "vtkEventData.h" // for enums
43#include "vtkNew.h" // for vtkNew
45#include "vtkRenderingVRModule.h" // For export macro
46#include "vtkSmartPointer.h" // for vtkSmartPointer
47#include "vtkWrappingHints.h" // For VTK_MARSHALAUTO
48#include "vtk_glad.h" // used for methods
49
50#include <vector> // ivars
51
52VTK_ABI_NAMESPACE_BEGIN
53class vtkCamera;
54class vtkMatrix4x4;
55class vtkVRModel;
56
57class VTKRENDERINGVR_EXPORT VTK_MARSHALAUTO vtkVRRenderWindow : public vtkOpenGLRenderWindow
58{
59public:
60 enum
61 {
64 };
65
67 void PrintSelf(ostream& os, vtkIndent indent) override;
68
74
76
79 GLuint GetLeftResolveBufferId() { return this->FramebufferDescs[LeftEye].ResolveFramebufferId; }
80 GLuint GetRightResolveBufferId() { return this->FramebufferDescs[RightEye].ResolveFramebufferId; }
81 void GetRenderBufferSize(int& width, int& height)
82 {
83 width = this->Size[0];
84 height = this->Size[1];
85 }
86
87
89
95
97
100 void SetModelForDeviceHandle(uint32_t handle, vtkVRModel* model);
102
104
112
114 /*
115 * This method gets a device handle for a given device. index is used to
116 * disambiguate when there are multiple device handles that map to a
117 * device.
118 */
119 uint32_t GetDeviceHandleForDevice(vtkEventDataDevice dev, uint32_t index = 0);
121
123 /*
124 * This method returns how many device handles map to a device.
125 */
128
130 /*
131 * This method adds a device handle if not already present. The second
132 * signature also sets the device associated with the device handle.
133 */
134 void AddDeviceHandle(uint32_t handle);
135 void AddDeviceHandle(uint32_t handle, vtkEventDataDevice device);
137
139 /*
140 * This method gets a device for a given device handle.
141 */
144
152 vtkEventDataDevice device, vtkMatrix4x4* deviceToWorldMatrix) override;
154 uint32_t handle, vtkMatrix4x4* deviceToWorldMatrix);
155
164
168 void AddRenderer(vtkRenderer*) override;
169
173 void MakeCurrent() override;
174
178 void ReleaseCurrent() override;
179
183 bool IsCurrent() override;
184
188 const char* ReportCapabilities() override { return "VR System"; }
189
193 vtkTypeBool IsDirect() override { return 1; }
194
200 vtkTypeBool GetEventPending() override { return 0; }
201
205 int* GetScreenSize() override;
206
208
215 void SetSize(int width, int height) override;
216 void SetSize(int a[2]) override { this->SetSize(a[0], a[1]); }
218
220
223 void* GetGenericDisplayId() override { return this->HelperWindow->GetGenericDisplayId(); }
224 void* GetGenericWindowId() override { return this->HelperWindow->GetGenericWindowId(); }
225 void* GetGenericParentId() override { return nullptr; }
226 void* GetGenericContext() override { return this->HelperWindow->GetGenericContext(); }
227 void* GetGenericDrawable() override { return this->HelperWindow->GetGenericDrawable(); }
229
233 int SupportsOpenGL() override { return 1; }
234
239 void Render() override;
240
242
248
253
259
263 virtual void RenderModels() = 0;
264
266
269 vtkGetMacro(BaseStationVisibility, bool);
270 vtkSetMacro(BaseStationVisibility, bool);
271 vtkBooleanMacro(BaseStationVisibility, bool);
273
277 virtual void UpdateHMDMatrixPose(){};
278
283 vtkGetMacro(VRInitialized, bool);
284
285protected:
288
295
296 void CreateAWindow() override {}
297 void DestroyWindow() override {}
298
304 virtual bool GetSizeFromAPI() = 0;
305
306 virtual std::string GetWindowTitleFromAPI() { return "VTK - VR"; }
307
308 virtual bool CreateFramebuffers(uint32_t viewCount = 2) = 0;
309 virtual void RenderFramebuffer(FramebufferDesc& framebufferDesc) = 0;
310
311 bool VRInitialized = false;
312
313 // One per view (typically one per eye)
314 std::vector<FramebufferDesc> FramebufferDescs;
315
324
325 std::map<uint32_t, DeviceData> DeviceHandleToDeviceDataMap;
326 uint32_t InvalidDeviceIndex = UINT32_MAX;
327
329
331
332private:
333 vtkVRRenderWindow(const vtkVRRenderWindow&) = delete;
334 void operator=(const vtkVRRenderWindow&) = delete;
335};
336
337VTK_ABI_NAMESPACE_END
338#endif
a virtual camera for 3D rendering
Definition vtkCamera.h:151
a simple class to control print indentation
Definition vtkIndent.h:108
represent and manipulate 4x4 transformation matrices
Allocate and hold a VTK object.
Definition vtkNew.h:168
OpenGL state storage.
platform-independent render window interaction including picking and frame rate control.
abstract specification for renderers
Hold a reference to a vtkObjectBase instance.
VR device model.
Definition vtkVRModel.h:30
vtkNew< vtkMatrix4x4 > DeviceToPhysicalMatrix
vtkSmartPointer< vtkVRModel > Model
void Render() override
Overridden to not release resources that would interfere with an external application's rendering.
vtkVRModel * GetModelForDeviceHandle(uint32_t handle)
Get the VRModel corresponding to the device or device handle.
void AddDeviceHandle(uint32_t handle)
void CreateAWindow() override
Create a not-off-screen window.
void MakeCurrent() override
Make this windows OpenGL context the current context.
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
void ReleaseGraphicsResources(vtkWindow *) override
Free up any graphics resources associated with this window a value of nullptr means the context may a...
std::map< uint32_t, DeviceData > DeviceHandleToDeviceDataMap
const char * ReportCapabilities() override
Get report of capabilities for the render window.
virtual void RenderModels()=0
Render the controller and base station models.
void * GetGenericParentId() override
Implement required virtual functions.
vtkOpenGLRenderWindow * HelperWindow
void * GetGenericWindowId() override
Implement required virtual functions.
virtual bool GetDeviceToWorldMatrixForDeviceHandle(uint32_t handle, vtkMatrix4x4 *deviceToWorldMatrix)
uint32_t GetNumberOfDeviceHandlesForDevice(vtkEventDataDevice dev)
vtkVRModel * GetModelForDevice(vtkEventDataDevice idx)
Get the VRModel corresponding to the device or device handle.
~vtkVRRenderWindow() override
virtual void UpdateHMDMatrixPose()
Update the HMD pose.
virtual bool GetSizeFromAPI()=0
Attempt to get the size of the display from the API and store it in this->Size.
int SupportsOpenGL() override
Does this render window support OpenGL?
vtkMatrix4x4 * GetDeviceToPhysicalMatrixForDeviceHandle(uint32_t handle)
Get the DeviceToPhysical matrix corresponding to the device or device handle.
void AddRenderer(vtkRenderer *) override
Add a renderer to the list of renderers.
GLuint GetLeftResolveBufferId()
Get the frame buffers used for rendering.
uint32_t GetDeviceHandleForDevice(vtkEventDataDevice dev, uint32_t index=0)
void SetSize(int width, int height) override
Set the size of the window in screen coordinates in pixels.
void * GetGenericDrawable() override
Implement required virtual functions.
virtual void RenderFramebuffer(FramebufferDesc &framebufferDesc)=0
vtkEventDataDevice GetDeviceForDeviceHandle(uint32_t handle)
void DestroyWindow() override
Destroy a not-off-screen window.
vtkOpenGLState * GetState() override
Get the state object used to keep track of OpenGL state.
void AddDeviceHandle(uint32_t handle, vtkEventDataDevice device)
void GetRenderBufferSize(int &width, int &height)
Get the frame buffers used for rendering.
bool IsCurrent() override
Tells if this window is the current OpenGL context for the calling thread.
GLuint GetRightResolveBufferId()
Get the frame buffers used for rendering.
bool GetDeviceToWorldMatrixForDevice(vtkEventDataDevice device, vtkMatrix4x4 *deviceToWorldMatrix) override
Store in deviceToWorldMatrix the matrix that goes from device coordinates to world coordinates.
vtkTypeBool GetEventPending() override
Check to see if a mouse button has been pressed or mouse wheel activated.
vtkTypeBool IsDirect() override
Is this render window using hardware acceleration?
int * GetScreenSize() override
Get the current size of the screen in pixels.
virtual void InitializeViewFromCamera(vtkCamera *cam)
Initialize the HMD to World setting and camera settings so that the VR world view most closely matche...
virtual bool CreateFramebuffers(uint32_t viewCount=2)=0
void * GetGenericContext() override
Implement required virtual functions.
void * GetGenericDisplayId() override
Implement required virtual functions.
vtkMatrix4x4 * GetDeviceToPhysicalMatrixForDevice(vtkEventDataDevice idx)
Get the DeviceToPhysical matrix corresponding to the device or device handle.
std::vector< FramebufferDesc > FramebufferDescs
void SetHelperWindow(vtkOpenGLRenderWindow *val)
Set/Get the window to use for the openGL context.
void SetModelForDeviceHandle(uint32_t handle, vtkVRModel *model)
Set the VRModel corresponding to the device handle.
virtual std::string GetWindowTitleFromAPI()
void SetSize(int a[2]) override
Set the size of the window in screen coordinates in pixels.
vtkRenderWindowInteractor * MakeRenderWindowInteractor() override=0
Create an interactor to control renderers in this window.
void ReleaseCurrent() override
Release the current context.
int Size[2]
Definition vtkWindow.h:341
int vtkTypeBool
Definition vtkABI.h:64
vtkEventDataDevice
platform-independent event data structures
#define VTK_MARSHALAUTO