Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
1.0.0:skybox [2023/02/23 12:36] – [SkyBox:Procedural] admin1.0.0:skybox [2023/02/23 12:54] (current) – [Procedural] admin
Line 20: Line 20:
  
  
-===== SkyBox:Blank =====+===== Blank =====
  
 A blank skybox is useful for rendering a scene background in a simple color without being affected by light or shadow. A blank skybox is useful for rendering a scene background in a simple color without being affected by light or shadow.
Line 26: Line 26:
 Fog computation instead will be applied. Fog computation instead will be applied.
  
-===== SkyBox:Procedural =====+To set the intended color, simply set the Diffuse property. 
 + 
 +<file pascal> 
 +GorillaSkyBox1.Diffuse := TAlphaColorRec.Blue; 
 +</file> 
 + 
 +===== Procedural =====
  
 The basic TGorillaSkyBox component provides a fully configurable procedural rendering with clouds, stars, moon/sun and azimuth / inclination settings. The basic TGorillaSkyBox component provides a fully configurable procedural rendering with clouds, stars, moon/sun and azimuth / inclination settings.
Line 34: Line 40:
 You can configure the settings at design time and can directly see the changes in rendering. You can configure the settings at design time and can directly see the changes in rendering.
  
 +1. Color Settings
 +^Property ^ Type ^ Description ^
 +|Diffuse | TAlphaColorF | Global overall coloring of the skybox. Take care in combination with "Primaries"
 +|Emissive | TAlphaColorF | RGB channels defining the color of emissive color, while the alpha channel defines the intensity. |
 +|Primaries | TPoint3D | Defining the main coloring for gradient rendering. Change carefully. Tiny changes might modify massively. |  
 +
 +2. General Settings
 ^Property ^ Type ^ Description ^ ^Property ^ Type ^ Description ^
-|Diffuse | TAlphaColorF |  |  
-|Emissive | TAlphaColorF |  |  
 |Resolution | TVector3D |  |  |Resolution | TVector3D |  | 
-|CrescentOfs | TPointF |  |  
-|CrescentMoon | Single |  |  
-|MoonSurface | Single |  |  
 |DepolarizationFactor | Single |  |  |DepolarizationFactor | Single |  | 
 |Luminance | Single |  |  |Luminance | Single |  | 
Line 48: Line 56:
 |MieZenithLength | Single |  |  |MieZenithLength | Single |  | 
 |MieKCoefficient | TVector3D |  |  |MieKCoefficient | TVector3D |  | 
-|Primaries | TPoint3D |  |  
 |NumMolecules | Single |  |  |NumMolecules | Single |  | 
 |Rayleigh | Single |  |  |Rayleigh | Single |  | 
Line 58: Line 65:
 |TonemapWeighting | Single | Tonemapping |  |TonemapWeighting | Single | Tonemapping | 
 |Turbidity | Single |  |  |Turbidity | Single |  | 
 +
 +3. Day-Night Simulation
 +^Property ^ Type ^ Description ^
 |Inclination | Single | Y-Offset |  |Inclination | Single | Y-Offset | 
 |Azimuth | Single | X-Offset |  |Azimuth | Single | X-Offset | 
  
 +4. Moon / Sun Disk
 ^Property ^ Type ^ Description ^ ^Property ^ Type ^ Description ^
-|StarDensity Single  |  +|CrescentOfs TPointF Define a x,y offset of the moon shadow for simulating different moon phases. |  
-|StarProbe | Single |  |  +|CrescentMoon | Single | To deactivate a crescent moon, set this value to < 0.0000001. Setting to zero will activate the default value again on startup.  |  
-|StarSize | Single |  |  +|MoonSurface | Single | Activate moon surface rendering and its intensity. 
-|StarSpark | Single |  |  +
-|StarBrightness |Single |  |  +
-|StarColor  | TAlphaColorF |  +
  
 +5. Stars
 ^Property ^ Type ^ Description ^ ^Property ^ Type ^ Description ^
-|CloudColor  TAlphaColorF  |  +|StarDensity Single Density of stars rendered |  
-|CloudIterations  FixedInt  |  +|StarProbe Single Number of stars rendered |  
-|CloudFrequency   Single |  |  +|StarSize | Single | Inner star size |  
-|CloudAmplitude  | Single |  | +|StarSpark | Single | Star spark intensity |  
 +|StarBrightness |Single | Brightness of stars |  
 +|StarColor  | TAlphaColorF | Color of stars. Default is white. 
  
 +^Property ^ Type ^ Description ^
 +|CloudColor  | TAlphaColorF | Main color of rendered clouds. | 
 +|CloudIterations  | FixedInt | Number of steps producing clouds. | 
 +|CloudFrequency  | Single | Frequency of cloud computation. | 
 +|CloudAmplitude  | Single | Amplitude or intensity of cloud computation. | 
 +
 +===== CubeMap =====
 +
 +==== DesignTime ====
 +
 +Drag and drop the TGorillaSkyBox component onto your viewport and start by uploading
 +the cubemap texture. This is done by loading all 6 faces of a box.
 +
 +When downloading a precomputed skybox texture set, you will get 6 textures, which can be associated the following way:
 +
 +^Property^Face^Common TextureName^
 +|FrontSide|TGorillaCubeMapFace.NegativeZ|negz.jpg|
 +|BackSide|TGorillaCubeMapFace.PositiveZ|posz.jpg|
 +|TopSide|TGorillaCubeMapFace.NegativeY|negy.jpg|
 +|BottomSide|TGorillaCubeMapFace.PositiveY|posy.jpg|
 +|LeftSide|TGorillaCubeMapFace.NegativeX|negx.jpg|
 +|RightSide|TGorillaCubeMapFace.PositiveX|posx.jpg|
  
-===== SkyBox:CubeMap =====+==== Runtime ====
  
 If you need to create the Gorilla3D viewport at runtime, you can do it the following way:  If you need to create the Gorilla3D viewport at runtime, you can do it the following way: 
Line 123: Line 156:
 (before only by 6 planes with simple 2D textures) (before only by 6 planes with simple 2D textures)
  
-===== DesignTime ===== 
- 
-Drag and drop the TGorillaSkyBox component onto your viewport and start by uploading 
-the cubemap texture. This is done by loading all 6 faces of a box. 
- 
-When downloading a precomputed skybox texture set, you will get 6 textures, which can be associated the following way: 
- 
-^Property^Face^Common TextureName^ 
-|FrontSide|TGorillaCubeMapFace.NegativeZ|negz.jpg| 
-|BackSide|TGorillaCubeMapFace.PositiveZ|posz.jpg| 
-|TopSide|TGorillaCubeMapFace.NegativeY|negy.jpg| 
-|BottomSide|TGorillaCubeMapFace.PositiveY|posy.jpg| 
-|LeftSide|TGorillaCubeMapFace.NegativeX|negx.jpg| 
-|RightSide|TGorillaCubeMapFace.PositiveX|posx.jpg| 
  
 Next step: [[volumerendering|Volume-Rendering]] Next step: [[volumerendering|Volume-Rendering]]