2D view
This pages describes the user interface and features of the 2D View panel in Substance 3D Designer.
Overview
The 2D View is one of the main panels of Designer's user interface. Its main purposes are the following:
- displaying value or image output by a specified node or going through a specified node connector
- displaying bitmaps and vector graphics resources
- displaying additional information about the content it currently holds, such as color channels or exact color values
- controlling parameters' gizmos
When a displayed image or value is modified, the 2D View updates automatically to stay in sync with the current state of the data.
Multiple 2D View panels can be active at any time, and each can display different images or values. You can control when a new panel should be used by using the Pin feature of the user interface panel.
Displaying content in the 2D View
The most straightforward way to display any image in the 2D View is to double-click LMB on the Bitmap or vector graphics resource, node or node connector hosting the image.
Images can also be dragged and dropped directly into the viewport by holding LMB or RMB on a resource in the Explorer panel, or RMB on a node in a graph.
For nodes, you can also use the View output in 2D View option from their contextual menu, which is opened by clicking RMB on the node.
Viewport
The viewport is the display area of the 2D View, and lets you navigate the displayed image using the following mouse and keyboard shortcuts:
- Pan: Ctrl+RMB or MMB
Zoom: Alt+RMB or Mouse wheel or
Display scale toolZoom direction
Each of the zooming methods is inverted with the other:
- Mouse wheel up pulls the image closer
- Alt+RMB and drag up pushes the image away
- Adjust to fit viewport: F or Fit to view button
- Adjust to 1:1 scale: Z or Fit to scale button
It is not possible to pan the image if the current display size of the image is lower than the size of the viewport.
It is not possible to zoom in/out of the image if the displayed content does not exist anymore – e.g. a image's reference node or resource was deleted.
The image native resolution, color format and bit depth appear in the bottom left area of the viewport.
In addition to navigation, the viewport offers the following features:
- Tiled display: repeats the image in the viewport in a tiled pattern. This is useful for checking how a pattern or texture will repeat. It is enabled using the Space bar or Tiled display button
- Physical size display: Displays the image with a ratio matching the Physical size property of the graph It is enabled using the Physical size ratio button
- Keep view size: This option locks the display scale so it stays consistent throughout different images. It is enabled by default and can be disabled using the Keep view size button
Main toolbar
The main toolbar of the 2D View panel lets you do more with your displayed images, and offers the following features:
Background image
You can overlay a different image on top of the currently displayed one. Press the
Background image button and you will be prompted to select an image file to use as an overlay.Once the file is selected, a new toolbar appears with the following controls for the image overlay:
- Close: close the overlay controls toolbar and disable the background image overlay
- Load image: select another image file to use as an overlay
- Source image: sets the overlay image to 0% opacity
- Background image: sets the overlay image to 100% opacity
- Reset: sets the overlay image to 50% opacity
- A slider gives you manual control over the opacity of the overlay image
Export image
The image currently displayed can be exported to an image file. Press the
Save current image as bitmap button and you will be prompted to select an location, name and file format for the exported file.While the image will be exported as its native resolution – which is displayed in the bottom left area of the viewport – the bit depth and color format will depend on the image format selected. For instance, 32-bit floating point precision images can only be exported at their full data range with image formats which support this precision, such as TIFF, EXR and HDR. If the image format does not support the data, clamping and/or color banding are likely to occur in the exported image.
In general, be mindful of which precision and features are offered by the image formats you intend to use – floating point support, ICC profiles, etc.
If either OCIO or Adobe ACE color management mode is currently used, and additional option is available to select the color space of the exported image.
Copy to clipboard
The image currently displayed can be copied to the clipboard. Press the
Copy view into the clipboard button and the image will be ready to be pasted into any third party software, such as Adobe Photoshop.The image will be copied as an 8-bit precision image at its native resolution, which is displayed in the bottom left area of the viewport.
Switch graph outputs
If the image currently displayed is a graph output, you can quickly switch to any other graph output using the
Switch graph outputs button.This feature is not available to other nodes, including nodes which have more than one output.
UV overlay
If the Display UVs in 2D View option is enabled in the Scene menu of the 3D View panel, then the UV overlay feature is available in the 2D View. You can enable it using the UV button.
This displays the UVs of the 3D View panel's current mesh as a colored wireframe. If material color information is available in the mesh file, then the material color is used as the color of the UV overlay.
If the mesh has multiple UV sets, the desired UVs can be selected in the drop-down checklist which can be opened by clicking the arrow next to the UV label in the button.
Image information
You can display the exact pixel values and coordinates in an image with the Information panel, which is enabled using the
Image information button. This is very helpful when inspecting HDR images, for instance, or making sure stepping between pixels follows the intended progression.Colors are represented by RGBA and HSV values, and displayed depending on the precision of the image, as follows:
- 8-bit: 0-255 integer / 0.0-1.0 floating point
- 16-bit: 0-65532 integer / 0.0-1.0 floating point
- 16F (16-bit floating point): raw floating-point value
- 32F (32-bit floating point): raw floating-point value
Pixel coordinates are represented by X and Y values.
Histogram
You can display the histogram of the image with the Histogram panel, which is enabled using the
Display histogram button.The following histogram modes are available:
- Luminance
- Red
- Green
- Blue
- RGB
- Alpha
The following information is listed below the modes:
- Pixels: the number of pixels in the image
- Range: the entire value range available
- Used range: the value range from the lowest value pixel to the highest
Additionally, you can click LMB on the histogram, or hold LMB and drag across the histogram to select a specific portion of the data. The following information is then displayed for this selection:
- Selected pixels: the number of pixels which have the selected values
- Selected range: the value range of the selected portion
- Selected max: the highest number of pixels which have a value included in the selected portion
The selection can be cleared by clicking RMB on the histogram.
How some of the values above are represented depends on the precision selected in the lower section of the panel, as follows:
- 8 bits: 0-255 integer
- 16 bits: 0-65532 integer
- 32 bits: raw floating-point value
Some portions of the histogram may include very low pixel count values, and thus be challenging to read. In this case, you may enable the square root mode, using the Sqrt button, which uses the square root of the actual values to draw the histogram.
Display toolbar
The Display toolbar, which is located at the bottom of the 2D View panel by default, lets you control how the image is displayed in the viewport.
The leftmost section includes controls for color and transparency, while the rightmost section includes the viewport controls detailed in the Viewport section of this page.
Color channels
You can display a single channel of the image using the
Color channels button. This opens a combo Box letting you select which of the Red, Green, Blue and Alpha channels should be displayed. The normal aspect of the image with all channels is restored by selecting the RGB option.The following keyboard shortcuts can be used to quickly switch over to different color channels:
- RGB: C
- Red: R
- Green: G
- Blue: B
- Alpha: A
The icon of the Color channels button changes depending on the currently display channel(s).
Keyboard shortcuts can only be used if the 2D View panel has focus. You may click on this panel at least once to ensure this is the case.
Since the panel needs focus, these shortcuts do not interfere with any custom shortcuts you may have set for creating nodes in the graph – learn more about this feature here.
Transparency toggle
Transparency display can be toggled on and off, using the
/ Show checkerboard button. When this is enabled, transparency is displayed using a checkerboard pattern.There are two main ways to interpret transparency, which can be selected using the
/ Transparency mode button:- Straight: transparency information is only stored in the alpha channel, and does not impact any other aspect of the image
- Premultiplied: transparency information is stored in the alpha channel, and also impacts the RGB channels since they are effectively multiplied against the alpha channel
To display correct colors, the appropriate transparency mode should be selected in the 2D View panel to match the transparency method which was applied when the image was created.
Color space
For the most accurate representation of color, images are displayed by default in a color space which matches the one used by the monitor.
The available controls and the effect of the Color management mode set in the Project settings. Learn more about these controls in the Color management section in this page.
/ Color space button will depend on theBitmap painting tools
The Bitmap painting tools are available for Bitmap resources matching these criteria:
- The bitmap uses 8-bit precision
- The bitmap resource is imported into the package, linked images are not supported
You can learn more in the Bitmap painting editor page of the documentation.
Vector graphics editor
The Vector graphics editor is available for imported SVG resources, linked resources are not supported.
You can learn more in the Vector Graphic Editor (deprecated) page of the documentation.
Color management
The 2D View offers simple color management controls to let you choose which display color space should be used when displaying the image.
These controls will adapt to the current Color management mode set in the Project settings, as follows:
- Legacy: you can display the image in the sRGB or Linear sRGB color spaces
- Adobe ACE: you can enable color management and set the most appropriate color space for the current monitor as detected by the Adobe ACE engine, or disable color management and display the image using the Raw color values
- OCIO: you can OCIO configuration file currently used, or disable color management and display the image using the Raw color values enable color management and set the most appropriate one for the current monitor as detected by the OCIO engine, use the combo box and select any of the display color spaces available in the
Be mindful that these controls only impact the display color space. The original color space of images and the working color space should also be taken into account to make sure colors are displayed accurately in the 2D View.
Go to the Color management section of this documentation to learn more about this feature and its broader implementation in Designer.