#[non_exhaustive]pub struct OutputLayer {Show 13 fields
pub handle: String,
pub variable_name: Option<String>,
pub variable_source: String,
pub layer_name: Option<String>,
pub layer_type: String,
pub scalar_format: String,
pub with_alpha: bool,
pub dithering: bool,
pub filter: String,
pub filter_width: f64,
pub color_profile: Option<String>,
pub sort_key: Option<i32>,
pub drivers: Vec<String>,
}Expand description
One AOV, resolved: what to output, how to encode it, and where it goes.
Every field but handle and drivers is an outputlayer
attribute, with the specification’s default already applied –
variablesource “shader”, layertype “color”, scalarformat
“uint8”, filter “blackman-harris”, filterwidth 3.0,
withalpha and dithering off. A backend that re-derives these
gets them subtly wrong: the defaults are stated once in the
specification and nowhere in the scene, so a layer that sets none
of them still means “a uint8 colour from a shader closure”.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.handle: StringThe outputlayer node’s handle.
variable_name: Option<String>The variable to output. None when the layer does not name one,
which is a scene error rather than a default.
variable_source: StringWhere the variable is read from: "shader", "attribute" or
"builtin". Defaults to "shader".
layer_name: Option<String>The layer’s name as the driver writes it – the layer name
inside an EXR, say. None when unset; ɴsɪ gives no default, so
a driver picks its own.
layer_type: String"scalar", "color", "vector" or "quad". Defaults to
"color".
scalar_format: StringThe quantisation: "uint8" through "float". Defaults to
"uint8", which surprises a backend expecting float AOVs.
with_alpha: boolWhether an alpha channel is included. Defaults to false.
dithering: boolWhether integer scalars are dithered. Defaults to false.
filter: StringThe reconstruction filter. Defaults to "blackman-harris".
filter_width: f64The filter’s diameter in pixels. Defaults to 3.0, and ɴsɪ says
it is not applied for "box" or "zmin".
color_profile: Option<String>An ᴏᴄɪᴏ colour profile to apply before quantisation, if set.
sort_key: Option<i32>The ordering key among layers on one driver, if set.
See drivers: this crate applies it rather than leaving it to
the backend.
drivers: Vec<String>A layer may fan out to several drivers – a file and a display, say.
In connection order. ɴsɪ orders layers on a driver by
sortkey, not drivers on a layer, so this stays as connected.