利用者:Psy-Fi/Framebuffer Post-processingのソースを表示

== Viewport Compositing ==

=== User Documentation ===

[[File:Frank_DOF_release.png|thumb|600px|none|Frank from project gooseberry with SSAO and Depth of Field.]]

The current viewport compositing system includes two effects that can be used as a post process in the 3D viewport and during offscreen rendering.
The goal is to generalize the system and allow node definition of effects in the future but for now there are only two hard-coded effects that can be used:
<br /><br />
The controls for the effects can be found in a few places: <br />
To control how the effect appears in a certain 3D viewport, use the checkboxes, "SSO" and "Depth Of Field" located under the "Shading" panel. 
Camera objects, also have a new panel in their properties, "GPU Depth of Field" that controls the real time depth of field effect. This is
used during sequencer or OpenGL rendering and when looking through a camera in the 3D viewport.

<b> Limitations: </b>

* The current system depends on the scene depth buffer to generate information for the effects. As such, invalidating the depth buffer will cause the effects to fail. The most common case where this might happen is when XRay is set on an object.
* Any drawing that writes to the depth buffer, such as widgets and wires will contribute in the effects.
* The SSAO effect relies on the surface normals to function, however since the current system is not true deferred shading, those get composited from the depth buffer and smooth shading is not taken into account.


<b>Ambient Occlusion</b><br />
This effect tries to simulate the effects of ambient occlusion by doing raycasting in screen space. To control the effect, the following controls are added:

<i>Strength:</i><br />
This factor directly multiplies the computed color of the effect, so increase this for a stronger effect.<br /><br />
<i>Distance:</i><br />
The maximum world space distance the effect is computed in.<br /><br />
<i>Attenuation:</i><br />
How strongly the effect attenuates with distance. Increasing this makes far away surfaces contribute less to the effect. Use this to get rid of some banding artifacts.<br /><br />
<i>Samples:</i><br />
The amount of samples used for the effect. Higher is better, but the actual number used is squared so use with caution.<br /><br />
<i>Color:</i><br />
Color of the effect, can be modified to give a different feel, from ambient lighting to dirt/rust.<br /><br />


<b>Depth Of Field</b><br />
This effect tries to simulate a depth of field effect, similar to one produced by a camera.
The effect is controlled by certain options of the active camera, namely, the GPU fstop option (in the depth of field panel), the focal length, the sensor size and the focus distance/focus object.

[[File:Caterpillar_options_viewport.png|thumb|600px|none|Options influencing the effects. Ambient Occlusion settings in green, Depth of Field settings in yellow]]

<i>Viewport f-stop:</i><br />
This setting is relevant to the aperture of the camera lens. Less means more blur.<br /><br />
<i>Distance:</i><br />
The distance where the focus of the lens is. Using the eyedropper ({{Shortcut|E}}) it's possible to sample directly on the 3D viewport to set the focus<br /><br />
<i>Focus:</i><br />
Same as above but uses the centre of an object to define the focus. Overrides distance when used. <br /><br />
<i>Focal Length:</i><br />
More focal length means more blur.<br /><br />
<i>Size:</i><br />
Bigger sensor size means less blur.<br /><br />