Unit CastleScene

Warning: this symbol is deprecated: use TCastleRenderOptionsEvent

Warning: this symbol is deprecated: use TCastleRenderOptions

Possible checks done while frustum culling.

This is used by TCastleScene.FrustumCulling (what checks should be done when shapes octree is not available) and TCastleScene.OctreeFrustumCulling (what checks should be done when shapes octree is available).

In the second case, checks done by TFrustumCulling are applied after octree traverse. That is, octree already eliminated some shapes, and fully included some other shapes while traversing. TFrustumCulling are used in this case only as a "last resort", to check only the shapes in octree leaves that are in "possibly-colliding" state with frustum.

Generally, more checks mean that more shapes may be eliminated but also that we waste more time on checks themselves. What is optimal depends on given 3D model, and how you expect the player to view it (e.g. if player usually sees the whole model, then TFrustumCulling checks may be useless waste of time; OTOH, if player stands inside the model composed from many shapes then TFrustumCulling may help).

Values

• fcNone: No checks.

  Setting this as TCastleScene.FrustumCulling turns off frustum culling entirely, which is usually not a wise thing to do. Setting this as TCastleScene.OctreeFrustumCulling means that frustum culling is only done during octree traversal (we only visit octree nodes possibly colliding with frustum), this is also not optimal.

• fcSphere: Check shape's bounding sphere for collision with frustum.
• fcBox: Check shape's bounding box for collision with frustum.
• fcBoth: Check shape's bounding sphere, and then box, for collision with frustum. This is the most rigoristic check, but usually this is a waste of time: in most cases, when bounding sphere collides, then bounding box collides too.

Possible value of TCastleRootTransform.UseHeadlight.

Values

• hlOn: Always show a headlight. The headlight properties (color, intensity, shape) are taken from TCastleRootTransform.HeadlightNode.
• hlOff: Never show a headlight.
• hlMainScene: Show a headlight following the TCastleRootTransform.MainScene properties.

  If TCastleRootTransform.MainScene is Nil, there is no headlight.

  If TCastleRootTransform.MainScene is assigned, the headlight is shown if MainScene.HeadlightOn is True. MainScene.HeadlightOn in turn is configutable, and by default looks at X3D NavigationInfo.headlight field. (If no NavigationInfo node is present, the headlight is shown, as NavigationInfo.headlight is True by default.)

  The headlight properties (color, intensity, shape) follow MainScene.CustomHeadlight, which can be customized in an X3D file using https://castle-engine.io/x3d_implementation_navigation_extensions.php#section_ext_headlight . If no MainScene.CustomHeadlight is set, we use TCastleRootTransform.HeadlightNode.

We recommend using CastleRenderOptions unit to get these types. But for backward compatibility, they are also available here.

Global OpenGL context cache. This caches common things, like textures, shapes, and much more. Our OpenGL resources are currently shared across all OpenGL contexts, and they all automatically share this cache.

Combine (right before rendering) multiple shapes with a similar appearance into one. This can drastically reduce the number of "draw calls", making rendering much faster.