0026477: Porting PRODUCTS and OCCT QT samples for OCCT 7.0.0
[occt.git] / src / OpenGl / OpenGl_View.hxx
CommitLineData
b311480e 1// Created on: 2011-09-20
2// Created by: Sergey ZERCHANINOV
973c2be1 3// Copyright (c) 2011-2014 OPEN CASCADE SAS
b311480e 4//
973c2be1 5// This file is part of Open CASCADE Technology software library.
b311480e 6//
d5f74e42 7// This library is free software; you can redistribute it and/or modify it under
8// the terms of the GNU Lesser General Public License version 2.1 as published
973c2be1 9// by the Free Software Foundation, with special exception defined in the file
10// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
11// distribution for complete text of the license and disclaimer of any warranty.
b311480e 12//
973c2be1 13// Alternatively, this file may be used under the terms of Open CASCADE
14// commercial license or contractual agreement.
b311480e 15
2166f0fa
SK
16#ifndef _OpenGl_View_Header
17#define _OpenGl_View_Header
18
19#include <MMgt_TShared.hxx>
ec357c5c 20#include <Standard_Type.hxx>
2166f0fa
SK
21
22#include <TColStd_Array2OfReal.hxx>
23#include <NCollection_List.hxx>
189f85a3 24#include <math_BullardGenerator.hxx>
2166f0fa
SK
25
26#include <Quantity_NameOfColor.hxx>
27#include <Aspect_FillMethod.hxx>
28#include <Aspect_GradientFillMethod.hxx>
29#include <Aspect_TypeOfTriedronPosition.hxx>
30#include <Aspect_CLayer2d.hxx>
31
32#include <InterfaceGraphic_Graphic3d.hxx>
33#include <InterfaceGraphic_Visual3d.hxx>
34
35#include <Graphic3d_CView.hxx>
a79f67f8 36#include <Graphic3d_GraduatedTrihedron.hxx>
51b10cd4 37#include <Graphic3d_SequenceOfHClipPlane.hxx>
825aa485 38#include <Graphic3d_WorldViewProjState.hxx>
c5751993 39#include <Graphic3d_ZLayerSettings.hxx>
2166f0fa 40#include <Visual3d_TypeOfSurfaceDetail.hxx>
8625ef7e 41#include <Visual3d_TypeOfModel.hxx>
2166f0fa 42
0b0320e7 43#include <OpenGl_AspectFace.hxx>
44#include <OpenGl_BackgroundArray.hxx>
b7cd4ba7 45#include <OpenGl_BVHTreeSelector.hxx>
59f45b7c 46#include <OpenGl_LayerList.hxx>
2166f0fa 47#include <OpenGl_Light.hxx>
73192b37 48#include <OpenGl_LineAttributes.hxx>
536d98e2 49#include <OpenGl_Trihedron.hxx>
50#include <OpenGl_GraduatedTrihedron.hxx>
2166f0fa 51
2166f0fa 52
2166f0fa
SK
53struct OPENGL_ZCLIP
54{
55 struct {
56 Standard_Boolean IsOn;
57 Standard_ShortReal Limit; /* in the range [0., 1.] */
58 } Back;
59 struct {
60 Standard_Boolean IsOn;
61 Standard_ShortReal Limit; /* in the range [0., 1.] */
62 } Front;
63};
64
65struct OPENGL_FOG
66{
67 Standard_Boolean IsOn;
68 Standard_ShortReal Front; /* in the range [0., 1.] */
69 Standard_ShortReal Back; /* in the range [0., 1.] */
70 TEL_COLOUR Color;
71};
72
b5ac8292 73struct OpenGl_Matrix;
2166f0fa 74class OpenGl_Structure;
392ac980 75class OpenGl_StateCounter;
2166f0fa 76
c04c30b3 77class OpenGl_View;
78DEFINE_STANDARD_HANDLE(OpenGl_View,MMgt_TShared)
79
2166f0fa
SK
80class OpenGl_View : public MMgt_TShared
81{
82 public:
62e1beed 83 Standard_EXPORT OpenGl_View (const CALL_DEF_VIEWCONTEXT &AContext, OpenGl_StateCounter* theCounter);
84 Standard_EXPORT virtual ~OpenGl_View ();
2166f0fa 85
62e1beed 86 Standard_EXPORT void ReleaseGlResources (const Handle(OpenGl_Context)& theCtx);
bf75be98 87
88 void SetTextureEnv (const Handle(OpenGl_Context)& theCtx,
89 const Handle(Graphic3d_TextureEnv)& theTexture);
e276548b 90 void SetSurfaceDetail (const Visual3d_TypeOfSurfaceDetail AMode);
2166f0fa
SK
91 void SetBackfacing (const Standard_Integer AMode);
92 void SetLights (const CALL_DEF_VIEWCONTEXT &AContext);
93 void SetAntiAliasing (const Standard_Boolean AMode) { myAntiAliasing = AMode; }
51b10cd4 94 void SetClipPlanes (const Graphic3d_SequenceOfHClipPlane &thePlanes) { myClipPlanes = thePlanes; }
2166f0fa
SK
95 void SetVisualisation (const CALL_DEF_VIEWCONTEXT &AContext);
96
c827ea3a 97 const Handle(Graphic3d_Camera)& Camera() { return myCamera; }
b5ac8292 98 void SetCamera (const Handle(Graphic3d_Camera)& theCamera) { myCamera = theCamera; }
99
bf75be98 100 void SetClipLimit (const Graphic3d_CView& theCView);
2166f0fa 101
bf75be98 102 void SetFog (const Graphic3d_CView& theCView, const Standard_Boolean theFlag);
2166f0fa 103
536d98e2 104 OpenGl_Trihedron& ChangeTrihedron() { return myTrihedron; }
105 void TriedronDisplay (const Aspect_TypeOfTriedronPosition thePosition,
a174a3c5 106 const Quantity_NameOfColor theColor,
107 const Standard_Real theScale,
108 const Standard_Boolean theAsWireframe);
109 void TriedronErase (const Handle(OpenGl_Context)& theCtx);
2166f0fa 110
536d98e2 111 OpenGl_GraduatedTrihedron& ChangeGraduatedTrihedron() { return myGraduatedTrihedron; }
a174a3c5 112 void GraduatedTrihedronDisplay (const Handle(OpenGl_Context)& theCtx,
a79f67f8 113 const Graphic3d_GraduatedTrihedron& theCubic);
a174a3c5 114 void GraduatedTrihedronErase (const Handle(OpenGl_Context)& theCtx);
2166f0fa 115
b5ac8292 116 Standard_Real Height () const { return myCamera->ViewDimensions().X(); }
117 Standard_Real Width () const { return myCamera->ViewDimensions().Y(); }
2166f0fa
SK
118
119 Standard_Integer Backfacing () const { return myBackfacing; }
120
59f45b7c 121 //! Add structure to display list with specified priority.
122 //! The structure will be added to associated with it z layer.
123 //! If the z layer is not presented in the view, the structure will
124 //! be displayed in default bottom-level z layer.
a1954302 125 void DisplayStructure (const Handle(Graphic3d_Structure)& theStructure,
126 const Standard_Integer thePriority);
59f45b7c 127
128 //! Erase structure from display list.
a1954302 129 void EraseStructure (const Handle(Graphic3d_Structure)& theStructure);
679ecdee 130
131 //! Add structure to the list of immediate structures.
a1954302 132 void DisplayImmediateStructure (const Handle(Graphic3d_Structure)& theStructure);
679ecdee 133
134 //! Erase structure from display list.
135 void EraseImmediateStructure (const OpenGl_Structure* theStructure);
59f45b7c 136
137 //! Insert a new top-level z layer with ID <theLayerId>
a1954302 138 void AddZLayer (const Graphic3d_ZLayerId theLayerId);
59f45b7c 139
140 //! Remove a z layer with ID <theLayerId>
a1954302 141 void RemoveZLayer (const Graphic3d_ZLayerId theLayerId);
59f45b7c 142
143 //! Display structure in z layer with ID <theNewLayerId>
144 //! If the layer with ID <theNewLayerId> is not presented in the view,
145 //! the structure will be displayed in default bottom-level layer.
a1954302 146 void ChangeZLayer (const OpenGl_Structure* theStructure,
147 const Graphic3d_ZLayerId theNewLayerId);
2166f0fa 148
c5751993 149 //! Sets the settings for a single Z layer of specified view.
a1954302 150 void SetZLayerSettings (const Graphic3d_ZLayerId theLayerId,
151 const Graphic3d_ZLayerSettings& theSettings);
c5751993 152
b7cd4ba7 153 //! Changes the priority of a structure within its ZLayer
a1954302 154 void ChangePriority (const OpenGl_Structure* theStructure,
155 const Standard_Integer theNewPriority);
b7cd4ba7 156
0b0320e7 157 void CreateBackgroundTexture (const Standard_CString AFileName,
158 const Aspect_FillMethod AFillStyle);
159
2166f0fa
SK
160 void SetBackgroundTextureStyle (const Aspect_FillMethod FillStyle);
161 void SetBackgroundGradient (const Quantity_Color& AColor1, const Quantity_Color& AColor2, const Aspect_GradientFillMethod AType);
162 void SetBackgroundGradientType (const Aspect_GradientFillMethod AType);
163
a174a3c5 164 void Render (const Handle(OpenGl_PrinterContext)& thePrintContext,
165 const Handle(OpenGl_Workspace)& theWorkspace,
38a0206f 166 OpenGl_FrameBuffer* theReadDrawFbo,
167 Graphic3d_Camera::Projection theProjection,
a174a3c5 168 const Graphic3d_CView& theCView,
169 const Aspect_CLayer2d& theCUnderLayer,
a1954302 170 const Aspect_CLayer2d& theCOverLayer,
171 const Standard_Boolean theToDrawImmediate);
2166f0fa 172
0b0320e7 173 void DrawBackground (const Handle(OpenGl_Workspace)& theWorkspace);
e276548b 174
175 //! Returns list of OpenGL Z-layers.
176 const OpenGl_LayerList& LayerList() const { return myZLayers; }
177
178 //! Returns list of openGL light sources.
179 const OpenGl_ListOfLight& LightList() const { return myLights; }
180
181 //! Returns OpenGL environment map.
182 const Handle(OpenGl_Texture)& TextureEnv() const { return myTextureEnv; }
183
184 //! Returns visualization mode for objects in the view.
185 Visual3d_TypeOfSurfaceDetail SurfaceDetail() const { return mySurfaceDetail; }
186
b7cd4ba7 187 //! Returns selector for BVH tree, providing a possibility to store information
188 //! about current view volume and to detect which objects are overlapping it.
189 OpenGl_BVHTreeSelector& BVHTreeSelector() { return myBVHSelector; }
190
191 //! Marks BVH tree for given priority list as dirty and
192 //! marks primitive set for rebuild.
193 void InvalidateBVHData (const Standard_Integer theLayerId);
194
679ecdee 195 //! Returns list of immediate structures rendered on top of main presentation
9f112210 196 const OpenGl_IndexedMapOfStructure& ImmediateStructures() const
679ecdee 197 {
198 return myImmediateList;
199 }
200
a1954302 201 //! Returns true if there are immediate structures to display
202 bool HasImmediateStructures() const
203 {
204 return !myImmediateList.IsEmpty()
205 || myZLayers.NbImmediateStructures() != 0;
206 }
207
679ecdee 208protected:
2166f0fa 209
a1954302 210 void RenderStructs (const Handle(OpenGl_Workspace)& theWorkspace,
38a0206f 211 OpenGl_FrameBuffer* theReadDrawFbo,
91c60b57 212 const Graphic3d_CView& theCView,
a1954302 213 const Standard_Boolean theToDrawImmediate);
91c60b57 214
a174a3c5 215 void RedrawLayer2d (const Handle(OpenGl_PrinterContext)& thePrintContext,
91c60b57 216 const Handle(OpenGl_Workspace)& theWorkspace,
a174a3c5 217 const Graphic3d_CView& theCView,
218 const Aspect_CLayer2d& theCLayer);
91c60b57 219
a89742cf 220 void RedrawTrihedron (const Handle(OpenGl_Workspace) &theWorkspace);
2166f0fa 221
b5ac8292 222 //! Redraw contents of model scene: clipping planes,
223 //! lights, structures. The peculiar properties of "scene" is that
224 //! it requires empty Z-Buffer and uses projection and orientation
225 //! matrices supplied by 3d view.
b5ac8292 226 void RedrawScene (const Handle(OpenGl_PrinterContext)& thePrintContext,
a1954302 227 const Handle(OpenGl_Workspace)& theWorkspace,
38a0206f 228 OpenGl_FrameBuffer* theReadDrawFbo,
91c60b57 229 const Graphic3d_CView& theCView,
a1954302 230 const Standard_Boolean theToDrawImmediate);
b5ac8292 231
73192b37 232 Handle(OpenGl_LineAttributes) myLineAttribs;
233 Handle(OpenGl_Texture) myTextureEnv;
234 Visual3d_TypeOfSurfaceDetail mySurfaceDetail;
235 Standard_Integer myBackfacing;
2166f0fa 236
2166f0fa 237 OPENGL_ZCLIP myZClip;
2166f0fa 238
51b10cd4 239 Graphic3d_SequenceOfHClipPlane myClipPlanes;
4269bd1b 240
b5ac8292 241 Handle(Graphic3d_Camera) myCamera;
242
2166f0fa 243 OPENGL_FOG myFog;
536d98e2 244 OpenGl_Trihedron myTrihedron;
245 OpenGl_GraduatedTrihedron myGraduatedTrihedron;
246 bool myToShowTrihedron;
247 bool myToShowGradTrihedron;
2166f0fa
SK
248
249 //View_LABViewContext
250 int myVisualization;
8625ef7e 251 Visual3d_TypeOfModel myShadingModel; //!< lighting shading model
2166f0fa
SK
252
253 //View_LABLight
254 OpenGl_ListOfLight myLights;
255
256 //View_LABPlane
257 //View_LABAliasing
258 Standard_Boolean myAntiAliasing;
259
260 //View_LABDepthCueing - fixed index used
261
9f112210 262 OpenGl_LayerList myZLayers; //!< main list of displayed structure, sorted by layers
263 OpenGl_IndexedMapOfStructure myImmediateList; //!< list of immediate structures rendered on top of main presentation
2166f0fa 264
b5ac8292 265 //! Modification state
825aa485 266 Graphic3d_WorldViewProjState myWorldViewProjState;
392ac980 267 OpenGl_StateCounter* myStateCounter;
268
392ac980 269 Standard_Size myCurrLightSourceState;
270
271 typedef std::pair<Standard_Size, Standard_Size> StateInfo;
272
273 StateInfo myLastOrientationState;
274 StateInfo myLastViewMappingState;
275 StateInfo myLastLightSourceState;
30f0ad28 276
b7cd4ba7 277 //! Is needed for selection of overlapping objects and storage of the current view volume
278 OpenGl_BVHTreeSelector myBVHSelector;
279
0b0320e7 280protected: //! @name Background parameters
281
282 OpenGl_AspectFace* myTextureParams; //!< Stores texture and its parameters for textured background
283 OpenGl_BackgroundArray* myBgGradientArray; //!< Primitive array for gradient background
284 OpenGl_BackgroundArray* myBgTextureArray; //!< Primitive array for texture background
285
91c60b57 286protected: //! @name data types related to ray-tracing
287
288 //! Result of OpenGL shaders initialization.
289 enum RaytraceInitStatus
290 {
291 OpenGl_RT_NONE,
292 OpenGl_RT_INIT,
293 OpenGl_RT_FAIL
294 };
295
296 //! Describes update mode (state).
297 enum RaytraceUpdateMode
298 {
299 OpenGl_GUM_CHECK, //!< check geometry state
300 OpenGl_GUM_PREPARE, //!< collect unchanged objects
301 OpenGl_GUM_REBUILD //!< rebuild changed and new objects
302 };
303
304 //! Defines frequently used shader variables.
305 enum ShaderVariableIndex
306 {
307 OpenGl_RT_aPosition,
308
189f85a3 309 // camera position
91c60b57 310 OpenGl_RT_uOriginLT,
311 OpenGl_RT_uOriginLB,
312 OpenGl_RT_uOriginRT,
313 OpenGl_RT_uOriginRB,
314 OpenGl_RT_uDirectLT,
315 OpenGl_RT_uDirectLB,
316 OpenGl_RT_uDirectRT,
317 OpenGl_RT_uDirectRB,
318 OpenGl_RT_uUnviewMat,
319
189f85a3 320 // 3D scene params
91c60b57 321 OpenGl_RT_uSceneRad,
322 OpenGl_RT_uSceneEps,
323 OpenGl_RT_uLightAmbnt,
324 OpenGl_RT_uLightCount,
325
189f85a3 326 // background params
327 OpenGl_RT_uBackColorTop,
328 OpenGl_RT_uBackColorBot,
91c60b57 329
189f85a3 330 // ray-tracing params
331 OpenGl_RT_uShadowsEnabled,
332 OpenGl_RT_uReflectEnabled,
333 OpenGl_RT_uSphereMapEnabled,
334 OpenGl_RT_uSphereMapForBack,
335 OpenGl_RT_uTexSamplersArray,
8c820969 336 OpenGl_RT_uBlockedRngEnabled,
189f85a3 337
338 // sampled frame params
339 OpenGl_RT_uSampleWeight,
340 OpenGl_RT_uFrameRndSeed,
341
342 // adaptive FSAA params
91c60b57 343 OpenGl_RT_uOffsetX,
344 OpenGl_RT_uOffsetY,
345 OpenGl_RT_uSamples,
91c60b57 346
347 OpenGl_RT_NbVariables // special field
348 };
349
350 //! Defines texture samplers.
351 enum ShaderSamplerNames
352 {
353 OpenGl_RT_SceneNodeInfoTexture = 0,
354 OpenGl_RT_SceneMinPointTexture = 1,
355 OpenGl_RT_SceneMaxPointTexture = 2,
356 OpenGl_RT_SceneTransformTexture = 3,
357
358 OpenGl_RT_GeometryVertexTexture = 4,
359 OpenGl_RT_GeometryNormalTexture = 5,
360 OpenGl_RT_GeometryTexCrdTexture = 6,
361 OpenGl_RT_GeometryTriangTexture = 7,
362
363 OpenGl_RT_EnvironmentMapTexture = 8,
364
365 OpenGl_RT_RaytraceMaterialTexture = 9,
366 OpenGl_RT_RaytraceLightSrcTexture = 10,
367
189f85a3 368 OpenGl_RT_FsaaInputTexture = 11,
369 OpenGl_RT_PrevAccumTexture = 12,
91c60b57 370
189f85a3 371 OpenGl_RT_OpenGlColorTexture = 13,
372 OpenGl_RT_OpenGlDepthTexture = 14
91c60b57 373 };
374
375 //! Tool class for management of shader sources.
376 class ShaderSource
377 {
378 public:
379
189f85a3 380 //! Default shader prefix - empty string.
381 static const TCollection_AsciiString EMPTY_PREFIX;
382
91c60b57 383 //! Creates new uninitialized shader source.
384 ShaderSource()
385 {
386 //
387 }
388
73722cc9 389 public:
189f85a3 390
73722cc9 391 //! Returns error description in case of load fail.
392 const TCollection_AsciiString& ErrorDescription() const
393 {
394 return myError;
91c60b57 395 }
396
91c60b57 397 //! Returns prefix to insert before the source.
398 const TCollection_AsciiString& Prefix() const
399 {
400 return myPrefix;
401 }
402
403 //! Sets prefix to insert before the source.
404 void SetPrefix (const TCollection_AsciiString& thePrefix)
405 {
406 myPrefix = thePrefix;
407 }
408
409 //! Returns shader source combined with prefix.
410 TCollection_AsciiString Source() const;
411
412 //! Loads shader source from specified files.
73722cc9 413 Standard_Boolean Load (const TCollection_AsciiString* theFileNames, const TCollection_AsciiString& thePrefix = EMPTY_PREFIX);
91c60b57 414
415 private:
416
417 TCollection_AsciiString mySource; //!< Source string of the shader object
418 TCollection_AsciiString myPrefix; //!< Prefix to insert before the source
73722cc9 419 TCollection_AsciiString myError; //!< error state
91c60b57 420
421 };
422
423 //! Default ray-tracing depth.
424 static const Standard_Integer THE_DEFAULT_NB_BOUNCES = 3;
425
426 //! Default size of traversal stack.
427 static const Standard_Integer THE_DEFAULT_STACK_SIZE = 24;
428
429 //! Compile-time ray-tracing parameters.
430 struct RaytracingParams
431 {
432 //! Actual size of traversal stack in shader program.
433 Standard_Integer StackSize;
434
435 //! Actual ray-tracing depth (number of ray bounces).
436 Standard_Integer NbBounces;
437
f483f2ed 438 //! Enables/disables light propagation through transparent media.
91c60b57 439 Standard_Boolean TransparentShadows;
440
189f85a3 441 //! Enables/disables global illumination (GI) effects.
442 Standard_Boolean GlobalIllumination;
443
f483f2ed 444 //! Enables/disables the use of OpenGL bindless textures.
445 Standard_Boolean UseBindlessTextures;
446
91c60b57 447 //! Creates default compile-time ray-tracing parameters.
448 RaytracingParams()
449 : StackSize (THE_DEFAULT_STACK_SIZE),
450 NbBounces (THE_DEFAULT_NB_BOUNCES),
f483f2ed 451 TransparentShadows (Standard_False),
189f85a3 452 GlobalIllumination (Standard_False),
f483f2ed 453 UseBindlessTextures (Standard_False)
91c60b57 454 {
455 //
456 }
457 };
458
d4aaad5b 459 //! Describes state of OpenGL structure.
460 struct StructState
461 {
462 Standard_Size StructureState;
463 Standard_Size InstancedState;
464
465 //! Creates new structure state.
466 StructState (const Standard_Size theStructureState = 0,
467 const Standard_Size theInstancedState = 0)
468 : StructureState (theStructureState),
469 InstancedState (theInstancedState)
470 {
471 //
472 }
473
474 //! Creates new structure state.
475 StructState (const OpenGl_Structure* theStructure)
476 {
477 StructureState = theStructure->ModificationState();
478
479 InstancedState = theStructure->InstancedStructure() != NULL ?
480 theStructure->InstancedStructure()->ModificationState() : 0;
481 }
482 };
483
91c60b57 484protected: //! @name methods related to ray-tracing
485
486 //! Updates 3D scene geometry for ray-tracing.
487 Standard_Boolean updateRaytraceGeometry (const RaytraceUpdateMode theMode,
488 const Standard_Integer theViewId,
489 const Handle(OpenGl_Context)& theGlContext);
490
491 //! Updates 3D scene light sources for ray-tracing.
492 Standard_Boolean updateRaytraceLightSources (const OpenGl_Mat4& theInvModelView, const Handle(OpenGl_Context)& theGlContext);
493
494 //! Updates environment map for ray-tracing.
495 Standard_Boolean updateRaytraceEnvironmentMap (const Handle(OpenGl_Context)& theGlContext);
496
497 //! Checks to see if the OpenGL structure is modified.
498 Standard_Boolean toUpdateStructure (const OpenGl_Structure* theStructure);
499
500 //! Adds OpenGL structure to ray-traced scene geometry.
501 Standard_Boolean addRaytraceStructure (const OpenGl_Structure* theStructure,
502 const Handle(OpenGl_Context)& theGlContext);
503
504 //! Adds OpenGL groups to ray-traced scene geometry.
8c820969 505 Standard_Boolean addRaytraceGroups (const OpenGl_Structure* theStructure,
506 const OpenGl_RaytraceMaterial& theStructMat,
507 const Standard_ShortReal* theTransform,
508 const Handle(OpenGl_Context)& theGlContext);
91c60b57 509
510 //! Creates ray-tracing material properties.
511 OpenGl_RaytraceMaterial convertMaterial (const OpenGl_AspectFace* theAspect,
512 const Handle(OpenGl_Context)& theGlContext);
513
514 //! Adds OpenGL primitive array to ray-traced scene geometry.
515 OpenGl_TriangleSet* addRaytracePrimitiveArray (const OpenGl_PrimitiveArray* theArray,
516 const Standard_Integer theMatID,
517 const OpenGl_Mat4* theTrans);
518
519 //! Adds vertex indices from OpenGL primitive array to ray-traced scene geometry.
520 Standard_Boolean addRaytraceVertexIndices (OpenGl_TriangleSet& theSet,
521 const Standard_Integer theMatID,
522 const Standard_Integer theCount,
523 const Standard_Integer theOffset,
524 const OpenGl_PrimitiveArray& theArray);
525
526 //! Adds OpenGL triangle array to ray-traced scene geometry.
527 Standard_Boolean addRaytraceTriangleArray (OpenGl_TriangleSet& theSet,
528 const Standard_Integer theMatID,
529 const Standard_Integer theCount,
530 const Standard_Integer theOffset,
531 const Handle(Graphic3d_IndexBuffer)& theIndices);
532
533 //! Adds OpenGL triangle fan array to ray-traced scene geometry.
534 Standard_Boolean addRaytraceTriangleFanArray (OpenGl_TriangleSet& theSet,
535 const Standard_Integer theMatID,
536 const Standard_Integer theCount,
537 const Standard_Integer theOffset,
538 const Handle(Graphic3d_IndexBuffer)& theIndices);
539
540 //! Adds OpenGL triangle strip array to ray-traced scene geometry.
541 Standard_Boolean addRaytraceTriangleStripArray (OpenGl_TriangleSet& theSet,
542 const Standard_Integer theMatID,
543 const Standard_Integer theCount,
544 const Standard_Integer theOffset,
545 const Handle(Graphic3d_IndexBuffer)& theIndices);
546
547 //! Adds OpenGL quadrangle array to ray-traced scene geometry.
548 Standard_Boolean addRaytraceQuadrangleArray (OpenGl_TriangleSet& theSet,
549 const Standard_Integer theMatID,
550 const Standard_Integer theCount,
551 const Standard_Integer theOffset,
552 const Handle(Graphic3d_IndexBuffer)& theIndices);
553
554 //! Adds OpenGL quadrangle strip array to ray-traced scene geometry.
555 Standard_Boolean addRaytraceQuadrangleStripArray (OpenGl_TriangleSet& theSet,
556 const Standard_Integer theMatID,
557 const Standard_Integer theCount,
558 const Standard_Integer theOffset,
559 const Handle(Graphic3d_IndexBuffer)& theIndices);
560
561 //! Adds OpenGL polygon array to ray-traced scene geometry.
562 Standard_Boolean addRaytracePolygonArray (OpenGl_TriangleSet& theSet,
563 const Standard_Integer theMatID,
564 const Standard_Integer theCount,
565 const Standard_Integer theOffset,
566 const Handle(Graphic3d_IndexBuffer)& theIndices);
567
568 //! Uploads ray-trace data to the GPU.
569 Standard_Boolean uploadRaytraceData (const Handle(OpenGl_Context)& theGlContext);
570
571 //! Generates shader prefix based on current ray-tracing options.
572 TCollection_AsciiString generateShaderPrefix (const Handle(OpenGl_Context)& theGlContext) const;
573
574 //! Performs safe exit when shaders initialization fails.
575 Standard_Boolean safeFailBack (const TCollection_ExtendedString& theMessage,
576 const Handle(OpenGl_Context)& theGlContext);
577
578 //! Loads and compiles shader object from specified source.
579 Handle(OpenGl_ShaderObject) initShader (const GLenum theType,
580 const ShaderSource& theSource,
581 const Handle(OpenGl_Context)& theGlContext);
582
189f85a3 583 //! Creates shader program from the given vertex and fragment shaders.
584 Handle(OpenGl_ShaderProgram) initProgram (const Handle(OpenGl_Context)& theGlContext,
585 const Handle(OpenGl_ShaderObject)& theVertShader,
586 const Handle(OpenGl_ShaderObject)& theFragShader);
587
91c60b57 588 //! Initializes OpenGL/GLSL shader programs.
589 Standard_Boolean initRaytraceResources (const Graphic3d_CView& theCView,
590 const Handle(OpenGl_Context)& theGlContext);
591
592 //! Releases OpenGL/GLSL shader programs.
593 void releaseRaytraceResources (const Handle(OpenGl_Context)& theGlContext);
594
595 //! Resizes OpenGL frame buffers.
596 Standard_Boolean resizeRaytraceBuffers (const Standard_Integer theSizeX,
597 const Standard_Integer theSizeY,
598 const Handle(OpenGl_Context)& theGlContext);
599
600 //! Generates viewing rays for corners of screen quad.
601 void updateCamera (const OpenGl_Mat4& theOrientation,
602 const OpenGl_Mat4& theViewMapping,
603 OpenGl_Vec3* theOrigins,
604 OpenGl_Vec3* theDirects,
605 OpenGl_Mat4& theUnView);
606
607 //! Binds ray-trace textures to corresponding texture units.
608 void bindRaytraceTextures (const Handle(OpenGl_Context)& theGlContext);
609
610 //! Unbinds ray-trace textures from corresponding texture unit.
611 void unbindRaytraceTextures (const Handle(OpenGl_Context)& theGlContext);
612
613 //! Sets uniform state for the given ray-tracing shader program.
614 Standard_Boolean setUniformState (const Graphic3d_CView& theCView,
615 const OpenGl_Vec3* theOrigins,
616 const OpenGl_Vec3* theDirects,
617 const OpenGl_Mat4& theUnviewMat,
618 const Standard_Integer theProgramId,
619 const Handle(OpenGl_Context)& theGlContext);
620
621 //! Runs ray-tracing shader programs.
622 Standard_Boolean runRaytraceShaders (const Graphic3d_CView& theCView,
623 const Standard_Integer theSizeX,
624 const Standard_Integer theSizeY,
625 const OpenGl_Vec3* theOrigins,
626 const OpenGl_Vec3* theDirects,
627 const OpenGl_Mat4& theUnviewMat,
38a0206f 628 OpenGl_FrameBuffer* theReadDrawFbo,
91c60b57 629 const Handle(OpenGl_Context)& theGlContext);
630
631 //! Redraws the window using OpenGL/GLSL ray-tracing.
632 Standard_Boolean raytrace (const Graphic3d_CView& theCView,
633 const Standard_Integer theSizeX,
634 const Standard_Integer theSizeY,
38a0206f 635 OpenGl_FrameBuffer* theReadDrawFbo,
91c60b57 636 const Handle(OpenGl_Context)& theGlContext);
637
638protected: //! @name fields related to ray-tracing
639
640 //! Result of shaders initialization.
641 RaytraceInitStatus myRaytraceInitStatus;
642
643 //! Is geometry data valid?
644 Standard_Boolean myIsRaytraceDataValid;
645
646 //! Warning about missing extension GL_ARB_bindless_texture has been displayed?
647 Standard_Boolean myIsRaytraceWarnTextures;
648
649 //! 3D scene geometry data for ray-tracing.
650 OpenGl_RaytraceGeometry myRaytraceGeometry;
651
652 //! Compile-time ray-tracing parameters.
653 RaytracingParams myRaytraceParameters;
654
655 //! Radius of bounding sphere of the scene.
656 Standard_ShortReal myRaytraceSceneRadius;
657 //! Scene epsilon to prevent self-intersections.
658 Standard_ShortReal myRaytraceSceneEpsilon;
659
660 //! OpenGL/GLSL source of ray-tracing fragment shader.
661 ShaderSource myRaytraceShaderSource;
662 //! OpenGL/GLSL source of adaptive-AA fragment shader.
663 ShaderSource myPostFSAAShaderSource;
664
665 //! OpenGL/GLSL ray-tracing fragment shader.
666 Handle(OpenGl_ShaderObject) myRaytraceShader;
667 //! OpenGL/GLSL adaptive-AA fragment shader.
668 Handle(OpenGl_ShaderObject) myPostFSAAShader;
669
670 //! OpenGL/GLSL ray-tracing shader program.
671 Handle(OpenGl_ShaderProgram) myRaytraceProgram;
672 //! OpenGL/GLSL adaptive-AA shader program.
673 Handle(OpenGl_ShaderProgram) myPostFSAAProgram;
189f85a3 674 //! OpenGL/GLSL program for displaying texture.
675 Handle(OpenGl_ShaderProgram) myOutImageProgram;
91c60b57 676
677 //! Texture buffer of data records of bottom-level BVH nodes.
678 Handle(OpenGl_TextureBufferArb) mySceneNodeInfoTexture;
679 //! Texture buffer of minimum points of bottom-level BVH nodes.
680 Handle(OpenGl_TextureBufferArb) mySceneMinPointTexture;
681 //! Texture buffer of maximum points of bottom-level BVH nodes.
682 Handle(OpenGl_TextureBufferArb) mySceneMaxPointTexture;
683 //! Texture buffer of transformations of high-level BVH nodes.
684 Handle(OpenGl_TextureBufferArb) mySceneTransformTexture;
685
686 //! Texture buffer of vertex coords.
687 Handle(OpenGl_TextureBufferArb) myGeometryVertexTexture;
688 //! Texture buffer of vertex normals.
689 Handle(OpenGl_TextureBufferArb) myGeometryNormalTexture;
690 //! Texture buffer of vertex UV coords.
691 Handle(OpenGl_TextureBufferArb) myGeometryTexCrdTexture;
692 //! Texture buffer of triangle indices.
693 Handle(OpenGl_TextureBufferArb) myGeometryTriangTexture;
694
695 //! Texture buffer of material properties.
696 Handle(OpenGl_TextureBufferArb) myRaytraceMaterialTexture;
697 //! Texture buffer of light source properties.
698 Handle(OpenGl_TextureBufferArb) myRaytraceLightSrcTexture;
699
700 //! 1st framebuffer (FBO) to perform adaptive FSAA.
701 Handle(OpenGl_FrameBuffer) myRaytraceFBO1;
702 //! 2nd framebuffer (FBO) to perform adaptive FSAA.
703 Handle(OpenGl_FrameBuffer) myRaytraceFBO2;
704 //! Framebuffer (FBO) for preliminary OpenGL output.
705 Handle(OpenGl_FrameBuffer) myOpenGlFBO;
706
707 //! Vertex buffer (VBO) for drawing dummy quad.
708 OpenGl_VertexBuffer myRaytraceScreenQuad;
709
710 //! Cached locations of frequently used uniform variables.
711 Standard_Integer myUniformLocations[2][OpenGl_RT_NbVariables];
712
713 //! State of OpenGL structures reflected to ray-tracing.
d4aaad5b 714 std::map<const OpenGl_Structure*, StructState> myStructureStates;
91c60b57 715
716 //! PrimitiveArray to TriangleSet map for scene partial update.
717 std::map<Standard_Size, OpenGl_TriangleSet*> myArrayToTrianglesMap;
718
189f85a3 719 //! Set of IDs of non-raytracable elements (to detect updates).
720 std::set<Standard_Integer> myNonRaytraceStructureIDs;
721
722 //! Render filter to filter out all raytracable structures.
91c60b57 723 Handle(OpenGl_RaytraceFilter) myRaytraceFilter;
724
725 //! Marks if environment map should be updated.
726 Standard_Boolean myToUpdateEnvironmentMap;
727
728 //! State of OpenGL layer list.
189f85a3 729 Standard_Size myLayerListState;
730
731 //! Number of accumulated frames (for progressive rendering).
732 Standard_Integer myAccumFrames;
733
734 //! Stored ray origins used for detection of camera movements.
735 OpenGl_Vec3 myPreviousOrigins[3];
736
737 //! Bullard RNG to produce random sequence.
738 math_BullardGenerator myRNG;
91c60b57 739
679ecdee 740public:
741
1c35b92f 742 DEFINE_STANDARD_ALLOC
ec357c5c 743 DEFINE_STANDARD_RTTI(OpenGl_View, MMgt_TShared) // Type definition
679ecdee 744
a89742cf 745 friend class OpenGl_Workspace;
746
2166f0fa
SK
747};
748
679ecdee 749#endif // _OpenGl_View_Header