Layer Image
Brief Description
The Layer Image returns a reference of an image of a specific layer (if in Source or Source With Modifiers mode) or the given layer blended with the rest of the Composition below if in Post Blend mode. This is useful to duplicate an element without making a hard-copy of it but just referring to the element so that if anything changes in the source, it is reflected in the copy.
If the blend mode of the layer that uses the Layer Image is set to replace and the Layer Image Which parameter is set to Post-Blend, this will act as an Adjustement Layer to everything below in the Composition stack.
N.B: When set in Post-Blend mode, the Layer Image can only reference layers that are below in the Composition, otherwise this would create a cyclic dependency and Autograph will prevent you to do so.
Referencing 3D layers
The Layer Image is also able to reference a 3D layer. If the referenced layer is a 3D layer, a new render of the 3D scene to which the 3D layer belongs to will be performed, unless Use Existing 3D render is checked. Launching a new 3D render is very useful to extract other render passes of a scene (such as the Z depth) or to render it with a different format.
Controls
| Parameter / Script Name | Type | Default | Function |
|---|---|---|---|
Enabled / enabled | Boolean | On | |
Layer Source / layerSource | Choice | Layer Below | - Layer Below - Layer Above - Linked Layer |
Layer / layer | Link | - | |
Follow Time / followTime | Boolean | On | When checked, the layer rect is sampled at the local time of the layer pointed to. When unchecked, the layer rect is sampled at the time of this layer |
Which / which | Choice | Post Blend | - Source - Source With Modifiers - Post Blend |
Use Existing 3D Render / useExisting3DRender | Boolean | On | When checked, the color pass image in output of the pointed 3D scene is re-used. When unchecked, you can render a new pass of the 3D scenes, possibly using different settings |
Render Delegate / render_delegate | Choice | Filament | - Storm - Filament |
AoV / aov | Choice | Color | - Color - Depth |
Use Parent Comp 3D Settings / inherit3DSettings | Boolean | On | When checked, the 3D renderer settings are inherited from the parent Composition settings. |
Output Format / output_format_mode | Choice | Composition Format | - Preset - Composition Format - Custom |
Format / formatPreset | Choice | HD (1920x1080) | - PC VIDEO (640x480) - NTSC (720x486:0.91) - PAL (720x576:1.09) - NTSC 16:9 (720x486:1.21) - PAL 16:9 (720x576:1.46) - QHD (960x540) - LHD (1280x720) - HD (1920x1080) - UHD 4K (3840x2160) - UHD 8K (7680x4320) - Super35 1K FULL AP (1024x778) - Cinemascope 1K (914x778:2.00) - Super35 2K FULL AP (2048x1556) - Cinemascope 2K (1828x1556:2.00) - DCP 2K (2048x1080) - Super35 4K FULL AP (4096x3112) - DCP 4K (4096x2160) - Square 256 (256x256) - Square 512 (512x512) - Square 1K (1024x1024) - Square 2K (2048x2048) |
Width / width | Float | 1920 | |
Height / height | Float | 1080 | |
Pixel Aspect Ratio / customAspect | Float | 1 | |
Camera / camera | Choice | - | |
Filament Settings / FilamentSettings | Category | - | |
Ambient Occlusion / group:Ambient Occlusion | Category | - | |
Enabled / filament_ao_enabled | Boolean | Off | |
Bent normals / filament_ao_bent_normals | Boolean | Off | |
Min. Horizon Angle / filament_min_horiz_angle | Float | 0 | Minimum angle to consider |
Quality / filament_ao_quality | Choice | Ultra | - Low - Medium - High - Ultra |
Radius / filament_ao_radius | Float | 0.3 | Ambient Occlusion radius in meters, between 0 and ~10. |
Intensity / filament_ao_intensity | Float | 1 | Strength of the Ambient Occlusion effect |
Bias / filament_ao_bias | Float | 0.0005 | Self-occlusion bias in meters. Use to avoid self-occlusion. Between 0 and a few mm |
Bilateral threshold / filament_ao_bilateral_threshold | Float | 0.05 | Depth distance that constitute an edge for filtering |
Power / filament_ao_power | Float | 1 | Controls ambient occlusion's contrast. Must be positive. |
Upsampling / filament_ao_upsampling | Choice | Ultra | - Low - Medium - High - Ultra |
Low pass filter / filament_ao_low_pass_filter | Choice | Ultra | - Low - Medium - High - Ultra |
SSCT / filament_ssct_enabled | Boolean | Off | Enable or disable screen space cone tracing for ambient shadows of dominant lights |
Light Cone Radius / filament_ssct_light_cone_radius | Float | 1 | |
SSCT Shadow Distance / filament_ssct_shadow_distance | Float | 0.3 | How far shadows can be cast |
SSCT Contact Distance / filament_ssct_contact_distance | Float | 1 | Max distance for contact |
SSCT Intensity / filament_ssct_intensity | Float | 0.8 | |
SSCT Light Direction / filament_ssct_light_direction | Float 3D | 0, -1, 0 | |
SSCT Depth Bias / filament_ssct_depth_bias | Float | 0.01 | Depth bias in world units (mitigate self-shadowing |
SSCT Depth Slope Bias / filament_ssct_depth_slope_bias | Float | 0.01 | Depth slope bias (mitigate self-shadowing |
SSCT Sample Count / filament_ssct_sample_count | Float | 4 | Tracing sample count |
SSCT Ray Count / filament_ssct_ray_count | Float | 1 | Tracing ray count |
Depth of field / group:Depth of field | Category | - | |
Enabled / filament_dof_enabled | Boolean | Off | Enable or disable depth of field effect |
COC Scale / filament_dof_coc_scale | Float | 1 | Circle of confusion scale factor (amount of blur) |
Filter / filament_dof_filter | Choice | Median | filter to use for filling gaps in the kernel - None - Median |
Max aperture diameter / filament_dof_max_aperture_diameter | Float | 0.01 | Maximum aperture diameter in meters (zero to disable rotation) |
Max background COC / filament_dof_max_background_coc | Float | 0 | maximum circle-of-confusion in pixels for the background |
Max foreground COC / filament_dof_max_foreground_coc | Float | 0 | maximum circle-of-confusion in pixels for the foreground |
Native resolution / filament_dof_native_resolution | Boolean | On | perform DoF processing at native resolution |
Background Ring Count / filament_dof_background_ring_count | Float | 0 | number of kernel rings for background tiles |
Foreground Ring Count / filament_dof_foreground_ring_count | Float | 0 | number of kernel rings for foreground tiles |
Fast-Gather Ring Count / filament_dof_fast_gather_ring_count | Float | 0 | number of kernel rings for fast tiles |
Fog / group:Fog | Category | - | |
Enabled / filament_fog_enabled | Boolean | Off | enable or disable fog |
Color / filament_fog_color | Color | 0.5, 0.5, 0.5, 1 | fog's color |
Density / filament_fog_density | Float | 0.1 | fog's density at altitude given by 'height' |
Distance / filament_fog_distance | Float | 0 | distance in world units from the camera where the fog starts ( >= 0.0 ) |
Height / filament_fog_height | Float | 0 | fog's floor in world units |
Height falloff / filament_fog_height_falloff | Float | 1 | how fast fog dissipates with altitude |
Maximum opacity / filament_fog_maximum_opacity | Float | 1 | fog's maximum opacity between 0 and 1 |
Fog Color from IBL / filament_fog_color_from_ibl | Boolean | Off | Fog color will be modulated by the IBL color in the view direction. |
In-scattering size / filament_fog_in_scattering_size | Float | -1 | size of in-scattering (>0 to activate). Good values are >> 1 (e.g. ~10 - 100). |
In-scattering Start / filament_fog_in_scattering_start | Float | 0 | distance in world units from the camera where in-scattering starts |
FXAA / filament_fxaa | Boolean | Off | |
Multisample anti-aliasing / group:Multisample anti-aliasing | Category | - | |
Enabled / filament_msaa_enabled | Boolean | On | |
Sample count / filament_msaa_sample_count | Float | 16 | |
Custom resolve / filament_msaa_custom_resolve | Boolean | Off | |
Shadow Type / filament_shadow_type | Choice | Percentage-Closer Filtered (PCF) | - Percentage-Closer Filtered (PCF) - Variance Shadows (VSM) - PCM + Contact Hardening (DPCF) - PCM + Contact Hardening + Soft Shadows (PCSS) |
Soft shadows / group:Soft shadows | Category | - | |
Penumbra ratio scale / filament_soft_shadows_penumbra_ratio_scale | Float | 1 | Globally scales the computed penumbra ratio of all DPCF and PCSS shadows. |
Penumbra scale / filament_soft_shadows_penumbra_scale | Float | 1 | Globally scales the penumbra of all DPCF and PCSS shadows |
Screen-Space Reflections / group:Screen-Space Reflections | Category | - | |
Enabled / filament_ssr_enabled | Boolean | Off | Enable Screen-Space Reflections |
Thickness / filament_ssr_thickness | Float | 0.1 | Ray thickness (world units) |
Bias / filament_ssr_bias | Float | 0.01 | Bias, in world units, to prevent self-intersections |
Max distance / filament_ssr_max_distance | Float | 3 | Maximum distance, in world units, to raycast |
Stride / filament_ssr_stride | Float | 2 | stride, in texels, for samples along the ray |
Variance shadow maps / group:Variance shadow maps | Category | - | |
Anisotropy / filament_vsm_anisotropy | Float | 0 | Number of anisotropic samples to use when sampling a VSM shadow map |
Light bleed reduction / filament_vsm_light_bleed_reduction | Float | 0.15 | VSM light bleeding reduction amount, between 0 and 1 |
Minimum variance scale / filament_vsm_min_variance_scale | Float | 0.5 | VSM minimum variance scale, must be positive |
Mipmapping / filament_vsm_mipmapping | Boolean | Off | Whether to generate mipmaps for all VSM shadow maps |
Adjust To Source Format / adjustToFormat | Boolean | Off | When checked, the size of the image is exactly the size of the input format |