From Derivative
Jump to navigation Jump to search

OP TOP.png

See also Category:TOPs for a full list of articles related to TOPs.

Texture Operators, also known as TOPs, are image operators that provide real-time, GPU-based compositing and image manipulation. All calculations for TOPs are performed on the system's GPU. TOPs can be used for preparing textures, compositing streams images and movies, building control panel elements, manipulation of 32-bit floating point data, and almost any other image task you might have. TOPs support many formats, including floating-point image formats for working with high-dynamic range (HDR) images.

All renders and composites occur offscreen with TOPs. Data can be scaled to any resolution, limited only by the amount of graphics RAM and the maximum resolution of the graphics card.

TOPs that are being used to hold point cloud data, where R G B holds 32-bit X Y Z data can be viewed as a 3D set of points by right-clicking on the viewer and selecting View as Points.

NOTE: TouchDesigner Non-Commercial is limited to 1280x1280 resolution.

Sweet 16 TOPs[edit]

The following 16 TOPs are commonly used, we recommend familiarizing yourself with them.

TOP Purpose Related TOP
Movie File In Read movies, still images, or a sequence of still images. Video Device In, Movie File Out
Ramp Create vertical, horizontal, radial, and circular ramps. Constant, Noise
Level Adjust contrast, brightness, gamma, black level, color range, opacity. Luma Level
Transform Translate, scale, rotate, multi-repeat tile, background fill. Flip
Over Place and shift one image over another based on the alpha of one image. Cross, Multiply
Text Text generation with variety of fonts.
Blur Blur. Luma Blur
Composite Combine multiple images with variety of operations like under, difference.
Render Render 3D objects, lights and camera into an image.
CHOP to Convert CHOP channels into scanlines of an image.
Resolution Change the resolution of an image and smooth-filter down. all TOPs alter resolution
Crop Crop image to smaller resolution. Corner Pin, Fit
Select Selects an image from the same network or a different network. Switch
Reorder Re-order the channels of an image. Channel Mix
Cache Hold a static or dynamic sequence of images and output one of them. Feedback
Displace Use red-blue of one image to warp another image. Time Machine

All TOPs are documented in the Category:TOPs.

TOP Flags[edit]

The lower right corner contains only 2 flags, the TOP’s Display Flag and Viewer Active Flag. Turning on the display flag displays the TOP as a background in the current Network Pane. Turning on multiple TOP Display Flags will display a tiled sequence of multiple TOP outputs as the background of the network pane.

TOPDisplaySingle.jpg TOPDisplayMulti.jpg

TOP Viewers[edit]

All TOP operators have interactive Node Viewers. To interact with it, turn on the TOP's Viewer Active Flag to make the viewer active.


A gray checkerboard background will be displayed in images where an alpha channel is present. This can be turned off by opening Preferences in the Edit menu. In preferences you can choose to use checkerboard or black as you alpha background.

Use LMB to move the image around. Use MMB to zoom in and out of the image. Re-center the image by using the home shortcut "h".

Clicking the RMB will open the viewer options menu. Keyboard shortcuts are listed beside each entry in the menu.


Home - Re-centers and scales the image to fit in the viewer.

Display Pixel Values - Displays pixel information over the image. The Timeline should be playing forward for the values to properly update.

The following is displayed:

  • cursor uv coordinates
  • cursor xy pixel coordinates
  • RGB values 0-255
  • RGB values 0-1

Display Field Guide - Displays a 24x24 field guide over the image. The guide also displays the action safe zone and title safe zone for the image.

Display Mode - The display mode options give the option of viewing certain channels of the image.

The following display modes are available:

  • Color - Display all RGB channles.
  • Red/Green/Blue/Alpha - Display the Red/Green/Blue/Alpha channel respectively.
  • Mono - Display the image in monochrome.
  • Normalize Split - Displays each channel in the image at the same time normalized from 0-1. Excellent for viewing floating point and point cloud data.

View as Points - Displays the data in the TOP as 3D points for each pixel assuming red = x, green = y, and blue = z. Useful for viewing point cloud data.


Point cloud data displayed 3 modes: 1) Color 2) Normalized Split 3) View as Points

Using TOPs[edit]

  • 2D image data, everything processed on GPU, generators and filters, real-time compositing
  • Import: Movie File In TOP, Video Device In TOP
  • Export: right-click menu, Movie File Out TOP, Export Movie Dialog

See also[edit]

Mipmapping and Texture Filtering
TOP Generator Common Page and TOP Filter Common Page
Pixel Formats

Add • Analyze • Anti Alias • Blob Track • Blur • Cache Select • Cache • Channel Mix • CHOP to • Chroma Key • Circle • Composite • Constant • Convolve • Corner Pin • Experimental:Corner Pin • CPlusPlus • Crop • Cross • Cube Map • Depth • Difference • DirectX In • DirectX Out • Displace • Edge • Emboss • Feedback • Fit • Experimental:Fit • Flip • Function • GLSL Multi • GLSL • HSV Adjust • HSV to RGB • Import Select • In • Inside • Introduction To s Vid • Kinect Azure Select • Kinect Azure • Kinect • Layout • Experimental:Layout • Leap Motion • Lens Distort • Level • Experimental:Level • Limit • Lookup • Luma Blur • Luma Level • Math • Matte • Mirror • Monochrome • Movie File In • Movie File Out • Multiply • Ncam • NDI In • NDI Out • Noise • Normal Map • Notch • Null • Nvidia Background • Nvidia Denoise • Nvidia Flex • Nvidia Flow • Oculus Rift • OP Viewer • OpenColorIO • OpenVR • Ouster Select • Ouster • Experimental:Ouster • Out • Outside • Over • Pack • Photoshop In • Point File In • Point File Select • Point Transform • PreFilter Map • Projection • Ramp • RealSense • Rectangle • Remap • Render Pass • Render Select • Render • Reorder • Resolution • RGB Key • RGB to HSV • Scalable Display • Screen Grab • Screen • Script • Select • Shared Mem In • Shared Mem Out • Slope • Spectrum • SSAO • Stype • Substance Select • Substance • Subtract • SVG • Experimental:SVG • Switch • Syphon Spout In • Syphon Spout Out • Text • Experimental:Text • Texture 3D • Texture Sampling Parameters • Threshold • Tile • Time Machine • TOP • TOP Viewer • Touch In • Touch Out • Transform • Experimental:Transform • Under • Video Device In • Experimental:Video Device In • Video Device Out • Video Stream In • Video Stream Out • Vioso • Web Render • ZED