Compositor: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
No edit summary
Line 195: Line 195:


Since the Compositor is completely data-driven, new rendering pipelines can be created by writing a custom XML pipeline definition. This section tries to document most of the available parameters, but the best and most up-to-date resource is the Compositor parsing code in SimGear ({{simgear file|simgear/scene/viewer}}). See existing pipelines in {{fgdata file|Compositor}} for practical examples on how to use these parameters.
Since the Compositor is completely data-driven, new rendering pipelines can be created by writing a custom XML pipeline definition. This section tries to document most of the available parameters, but the best and most up-to-date resource is the Compositor parsing code in SimGear ({{simgear file|simgear/scene/viewer}}). See existing pipelines in {{fgdata file|Compositor}} for practical examples on how to use these parameters.
Also keep in mind that every pipeline element can be enabled/disabled through a <code><condition></code> block. This allows for dynamic rendering pipelines that have toggleable features. However, the pipeline can't be updated in real-time: the simulator has to be restarted or the Compositor has to be reloaded through the <tt>reload-compositor</tt> [[Fgcommands|fgcommand]].


=== Buffers ===
=== Buffers ===
Line 446: Line 448:
! scope="col" | Default Value
! scope="col" | Default Value
! scope="col" | Description
! scope="col" | Description
|-
! scope="row"| <tt>max-pointlights</tt>
| {{Yes}}
| int
| 1024
| Maximum amount of point light sources allowed on the entire scene
|-
! scope="row"| <tt>max-spotlights</tt>
| {{Yes}}
| int
| 1024
| Maximum amount of spot light sources allowed on the entire scene
|-
! scope="row"| <tt>max-light-indices</tt>
| {{Yes}}
| int
| 256
| Size of the light indices texture. Keep in mind that it is a 2D texture, so the total size will be e.g. 256x256
|-
|-
! scope="row"| <tt>tile-size</tt>
! scope="row"| <tt>tile-size</tt>
Line 477: Line 497:
! scope="row"| <tt>geometry</tt>
! scope="row"| <tt>geometry</tt>
| {{Yes}}
| {{Yes}}
| float values for <code><x>, <y>, <width>, <height></code>
| float values for <code><x>, <y>, <width>, <height>, <scale></code>
| <tt>0.0, 0.0, 1.0, 1.0</tt> respectively
| <tt>0.0, 0.0, 1.0, 1.0, 1.0</tt> respectively
| Size of the fullscreen quad inside the viewport using normalized coordinates.
| Size of the fullscreen quad inside the viewport using normalized coordinates.
|-
|-
Line 513: Line 533:
| float (meters)
| float (meters)
|
|
| They specify the depth range of the shadow map
| They specify the range of the shadow map
|}
|}
== Known Issues ==
See [https://sourceforge.net/p/flightgear/codetickets/search/?q=%21status%3AInvalid+%26%26+%21status%3ADuplicate+%26%26+%21status%3AFixed+%26%26+%21status%3ADone++%26%26+labels%3ACompositor open SourceForge tickets with the Compositor label].


== References ==
== References ==
342

edits

Navigation menu