Skip to content

LayerScene

LayerScene#

(Scene)

No corresponding User page.

Description#

An abstract image layer with an attached scene to render.

Public Attributes#

Type Name Visual Hint Description
reference (Camera) active_camera VISUAL_HINT_DEFAULT Set the camera to use to render the scene
reference (Renderer) renderer VISUAL_HINT_DEFAULT Set the renderer to use for the scene
reference (Group) lights VISUAL_HINT_GROUP Select objects used for ligthing.
reference (Group) geometries VISUAL_HINT_GROUP Select the geometries used by the layer.
reference (Material) override_material VISUAL_HINT_DEFAULT The selected material will override all materials of the scene.
reference (ShadingLayer) shading_layer VISUAL_HINT_DEFAULT The selected shading layer will override materials of the scene according to its name mapping rules.

Inherited Public Attributes#

Type Name Visual Hint Description
long blending VISUAL_HINT_DEFAULT Set the blending mode of current layer. Depending on the mode the layer will blend differently over the bottom layer. Blending mode has no effect if there's only one layer in the image.
double opacity VISUAL_HINT_PERCENTAGE Set the opacity of the layer. An opacity value of 50% will make the layer 50% transparent.
long[2] pre_filter_offset VISUAL_HINT_PIXEL Pre-filtered position of the layer in the canvas. This position the one before filtering. Each time the layer is translated, filters are reapplied.
long limited_region_mode VISUAL_HINT_DEFAULT Uses the limited region set by the parent image or the region set below.
double[4] limited_region VISUAL_HINT_PERCENTAGE Region of interest to be rendered: x, y, width, height in percentages of the image visible window size.
long comp_mode VISUAL_HINT_DEFAULT Defines how the layer will be used during the compositing of the image: it will be either resized to match the image size, or used with its original size.
bool use_image_margin VISUAL_HINT_DEFAULT
long margin_mode VISUAL_HINT_DEFAULT Set the mode to use to determine the size of the overscan.
long[4] margin_pixel VISUAL_HINT_PIXEL Set the overscan for the current layer: Left, Top, Right, Bottom
double[4] margin_ratio VISUAL_HINT_PERCENTAGE Set the overscan for the current layer: Left, Top, Right, Bottom
object[] (ImageFilter) filters VISUAL_HINT_DEFAULT List of image filters that are applied to the layer. This filters are applied procedurally. Each time the layer is modified, all the filters in list are reapplied to the layer.
string output_layer VISUAL_HINT_TAG Select the aov channel to use RGBA. Other channels are discarded. Selecting 'all' disable the filter.
long alpha_channel VISUAL_HINT_DEFAULT Use default: the 4th channel of the output layer is used as alpha. Use custom channel: the channel specified below is used as alpha.
string custom_channel_name VISUAL_HINT_ENUM The specified channel will be written in the alpha channel
bool render_to_disk VISUAL_HINT_DEFAULT If checked, the image is flagged to be rendered and saved to disk at the specified output path. Note the image supports rendering sequences. If you wish to export a still, make sure first frame and last frame have the same value.
string save_as VISUAL_HINT_FILENAME_SAVE Set the image output filename, without file extension. Please note that the frame number is automatically appended to the filename.
long first_frame VISUAL_HINT_FRAME Set the first output render frame range. If set to 10, the rendering of the image will start at frame 10.
long last_frame VISUAL_HINT_FRAME Set the last output render frame range. If set to 20, the rendering of the image will stop at frame 20.
long frame_step VISUAL_HINT_FRAME Set the output render frame step. The frame step is simply the frame increment between two renders in the frame range defined by first and last frame.
long format VISUAL_HINT_DEFAULT Image output fileformat.
string LUT VISUAL_HINT_ENUM Select the color correction to apply to the output image.
long open_exr_output_compression_mode VISUAL_HINT_DEFAULT Set the OpenEXR output compression mode.
string metadata VISUAL_HINT_SCRIPT Declare custom metadata to write in the EXR header.

CID#

class "LayerScene" "Layer" {
    abstract yes
    #version 0.92
    icon "../icons/object_icons/layer.iconrc"
    doc "An abstract image layer with an attached scene to render."
    attribute_group "rendering" {
        reference "active_camera" {
            doc "Set the camera to use to render the scene"
            filter "Camera"
            value ""
        }
        reference "renderer" {
            doc "Set the renderer to use for the scene"
            filter "Renderer"
            value ""
        }
    }
    attribute_group "rendering>visibility" {
        doc "For each category, set which objects are visible (used) to render the scene."
        group "lights" {
            doc "Select objects used for ligthing."
            filter "Light"
            null_label "Use Current Context"
            input "shading_light"
            dg_active no
            value ""
        }
        reference "__lights__" {
            filter "Group"
            input "shading_light"
            private yes
            hidden yes
            saveable no
            dirtiness_pass_through yes
            value ""
        }
        group "geometries" {
            doc "Select the geometries used by the layer."
            filter "SceneObject"
            null_label "Use Current Context"
            input "shading" "motion" "parenting" "geometry"
            dg_active no
            value ""
        }
        reference "__geometries__" {
            filter "Group"
            input "shading" "motion" "parenting" "geometry"
            private yes
            hidden yes
            saveable no
            dirtiness_pass_through yes
            value ""
        }
    }
    attribute_group "rendering>materials" {
        doc "Select the channels that will be computed during the shading process."
        reference "override_material" {
            doc "The selected material will override all materials of the scene."
            filter "Material"
            output "shading_material"
            value ""
        }
        reference "shading_layer" {
            doc "The selected shading layer will override materials of the scene according to its name mapping rules."
            filter "ShadingLayer"
            output "shading_material" "shading_group"
            value ""
        }
    }
}