docs.unity3d.com
    Show / Hide Table of Contents

    The Visual Compositor Window

    • Introduction
      • Ports
      • Edges
    • Creating and Deleting Nodes
    • Navigation
      • Selecting
      • Zooming
      • Panning
      • Minimap
    • Enabling and Disabling Nodes
    • Special Nodes
      • Group
      • Layer
    • Additional Options

    Introduction

    InitialView

    The Visual Compositor window shows the Compositor Graph of the selected GameObject, as indicated by the GameObject name located at the top.

    When we create a new Compositor Graph , two nodes (Render and Layer), which are connected by an edge, will be automatically created as shown in the figure above.

    Ports

    InputPorts

    The small circles on the left and right sides of the nodes are called input and output ports.
    They can be connected to ports in other nodes to form edges.

    Edges

    Edges

    Edges connect output ports to input ports in order to create the functionality of the graph.
    Click and drag an output port to the input port of another node to connect them.


    Creating and Deleting Nodes

    Creating

    To create a node:

    1. Show the search box by:
      • Right clicking in an empty area and choose Create Node, or
      • Pressing the spacebar key.
    2. Select the node to create in the search box.
      We can filter nodes by name in the search box.

    The types of supported nodes can be seen in the nodes documentation.

    Deleting

    To delete a node, select it, and then press the delete key.


    Navigation

    Selecting

    Selecting

    Selecting nodes is done with the left mouse button. We can also select multiple nodes by left clicking an empty area, and dragging to draw a rectangle around the nodes we want to select. We can then reposition all selected nodes by left clicking on a selected node and dragging to the new position.

    Zooming

    Zooming

    We can zoom the view in and out, using the scroll wheel on the mouse.

    Panning

    Panning

    We can pan the view by middle-clicking in an empty space, and dragging in the appropriate direction.

    Minimap

    Minimap

    As we pan the view, some nodes will disappear off the edge of the window.
    We can find them using the minimap, which will grow and shrink in scale so that it can display the entire graph.

    Right-clicking on the minimap will open a context menu which allows us to anchor the minimap to a certain position or to make the minimap floating so that we can drag it around.

    The minimap can also be hidden.
    Please refer to additional options to hide the minimap.


    Enabling and Disabling Nodes

    Some nodes have a checkbox at the top right corner which can be used to enable or disable the nodes.
    If a node is disabled, then the node is grayed out and the input goes straight to become the output directly.


    Special Nodes

    Group

    Group

    Group is a special node which can contain other nodes.
    Other than helping organize our graph, it has no other functionality.
    We can drag nodes into the group node, which will add them to the group.
    To remove a node from a group, press shift while dragging the node outside of the group.

    Layer

    Layer

    Layer is a special node, which represents a part of the composition final output.
    Multiple layers are arranged in a stack, and we can re-order individual layer nodes as required.
    If a layer is detached from the stack, it is no longer used in the composition, and it can be dragged back into the stack when needed.


    Additional Options

    The Visual Compositor window has additional options which can be accessed by right-clicking on the window title.

    Options Description
    Lock Lock the Visual Compositor window to the current Compositor Graph asset.
    Minimap Show/hide the minimap.
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023