Input


Input Color

Input Grayscale

Input Value

In: Atomic Nodes

Intermediate

Value since SD 2019.1.0

Description

Input nodes are a special type of node that creates a dynamic slot in your graph, allowing for any input to be connected once your Graph is used in another context.Unlike Output Nodes, you have to explicitely place either a Color, Grayscale or Value input. It is not possible to create your own "agnostic" inputs that change type depending on what is connected to them.

Input Nodes are not as crucial as Output Nodes: you can have perfectly functioning, advanced Graphs that have no need for an Input. Inputs are only used when you want to base your Graph or Node Instance's result on an external input, for example when creating an Instance or a Filter for Painter.

Most of the time the generic, black data an Input Node passes on is not sufficient to build your graph with. Easiest is to drag an existing Bitmap Resource from the Explorer onto the Input Node in your graph, to preview this data in the slot. This only works for Color and Grayscale Inputs.

If you want to see it with the outputs of another Graph, you'll have to either export that Graph to Bitmap for the above method, or make use of "In-Context" editing.

Attributes

  • Identifier:
    The only mandatory, unique Attribute. Can not contains spaces.
    This one is used for labeling inputs if no Label is set up, and for telling different outputs apart. Don't just leave these at "input_1"!
  • Description:
    Optional Description used in Designer's library and Painter's shelf.
  • Label
    UI Label used for nice labeling in Designer and Painter UI. Can contain spaces. Recommended to set up with a name similar to the Identifier, just with spacebars instead of underscores.
  • User Data
    Additional, optional User Data that can be used for specific filtering operations, Basically a wildcard, custom data field.
  • Group
    Group Attribute used to group inputs together for Designer's Link Creation Modes. Inputs with an identical (case-sensitive) Group Attribute, will be presented as a single connection in Compact Material Mode.

Integration Attributes

Inputs are not directly sent to the 3D View, but their Usage Attributes are used in Painter for automatically filling slots with certain maps (with Filters).

Additionally their Usage attributes also used with Link Creation Modes, to match the correct input and output slots.

  • Usage
    • Component
      This determines what channels are actually in the resulting input.
    • Usage
      The most important one of the three: this sets what data this slot represents and will be matched to a connecting output slot's Usage.
    • Color Space
      Sets the colorspace this input should be interpreted in.