Plugins and Scripts - trueSpace Compositing

Image Resample

Resize an image.

X Size - set width of the new image
Y Size - set height of the new image
based on Graphics Gems 2, "Fast Anamorphic Image Scaling", by Dale A Schumacher

Image Bump to Normal Converter

Input a grayscale bump map to generate a normal map.

Strength - normalmap strength control

Color Curve

Uses workspace curves to to define the 1d bitmap that feeds the Image Curve node.

Use Start Interactive Update/Stop if editing the curves directly instead of using the radio buttons
Press the red, green, blue or alpha radio buttons to select the corresponding curve and start point edit mode. May need to press more than once the first time.
Exit point edit mode when complete
Clear Appearance will hide the curve handles.
Reset Curves sets all curves to defaults
Hide All hides all the curves and the backdrop

Response can be slow while in interactive update mode. Use the Image Resample or Image Shrink or Zoom nodes to temporarily reduce the resolution of the image or press the Start Interactive Update/Stop to enable/disable updates temporarily.

I guess colorIn and colorOut can be used inside a material context?

Color Picker

Choose/Examine a color from an image or use as a preview display.

Option to drag and drop an image onto the thumbnail or ctrl click to use a file dialog

Save swatch button for use with the web based colorpicker.

Composite Add

Add the values of two images.

Composite Add Interlace

Combine images by alternating horizontal lines. Value of 2 swaps images every 2 lines. 1 swaps every other line.

Composite Maximum

Create an image based on the maximum rgba values of two images.

Composite Minimum

Create an image based on the minimum rgba values of two images.

Composite Mix

Create an image based on the weighted rgba values of two images. A mix value of 0.5 will mix equal amounts of the 2 images. The mix value is between 0 and 1. The mix amount can also be driven by an input image. Check mix alpha to read the mix value from the image alpha channel, uncheck to read from the color portion of the image.

Value = bitmapA * mix + bitmapB * (1-mix)

Composite Multiply/Divide

Create an image based on the multiplication of two images. The Divide checkbox will change the node to divide instead of multiply.

Composite Render / Composite Render with Alpha

Display the composite result through a camera on an image plane. The distanceIn controls how far the image plane is from the camera and the xsize and ysize control the image aspect ratio.

To use select a camera and push the Connect to Camera button then open a 3d view and set it to camera view mode. To fit the image in the view also use the window settings to set the width and height to match.

A second version of this node is included that takes an alpha bitmap input.

Composite Over

Combine two images with the composite over process using the alpha channel of bitmapA or if connected the Input alpha image.

The alpha alpha check will take the alpha value from the alpha channel of the Input alpha image. Otherwise it will use the color of the Input alpha image to control the alpha.

Composite Overlay/Hard Light

Combine two images using overlay mode. Reverse the input connections for a Hard Light mode.

Composite Screen

Combine two images using screen mode.

Composite Subtract

Combine two images using subtraction. Use absolute value to use as a difference node.

Image Add

Add a constant value to an image. The Alpha Value Only will add the Alpha In constant to each of the rgb values of the image, otherwise the Red in, Green in, Blue in and Alpha in inputs will be added to the corresponding rgba values of the input image.

A Mask Input image can be used to apply the change to portions of the input. Mask Alpha Only will use the mask alpha value instead of the rgb values of the mask.

Note that the mask image processing is slow.

Image Blur

Blur an image. A mask input image can be used to apply the change to portions of the input. Mask Alpha Only will use the mask alpha instead of the rgb values of the mask.

Blur code taken from http://www.blackpawn.com/texts/blur/default.html

Note that the mask image processing is slow.

Image Channel Combine

Combine 4 input images to a single rgba image. All inputs must be used to generate an output. Only the red channel of each input image will be read. Gray images in truespace use the red channel.

Image Channel Split

Split an image into it's color components, rgba.

Image Color Distance Key

Computes the distance from the input color defined by the rgb values and generates an image based on the color distance.

Image Color Difference

Basic green/blue screen image processor. Uncheck for blue screen.

value = green - max(red, blue) or value = blue - max(red, green)

Image Convolve

This convolve has the effect of sharpening the image. Check edge finder to output the image lines. Mask input is used to restrict the effect to areas defined by it's rgb or alpha value. The convolve radius set to 1 for a 3x3 pixel window.

Note that the mask image processing is slow.

Image Curve

Connect a color curve to control the output effect on an image. Alpha Curve Only checked means to only look at the alpha color curve for all color channels. If unchecked each of the rgba color curves will be used.

A color curve is a 1 dimensional image generated from the Color Curves node.

Note that the mask image processing is slow.

Image Gamma

Apply gamma to an input image with optional mask and optional separate rgb gammas.

Note that the mask image processing is slow.

Image Info

Display filename, image format and image size information.

Image Invert

Invert the input image.

Note that the mask image processing is slow.

Image Loader

Load a single image or sequence of images. Check "isaSequence" to load a sequence. Push the "setup keyframes" button to set keyframes needed to switch images as the timeline progresses.

tiff image loader can be used to load a sequence of tiff image files

Image Luminance

Convert rgb to grayscale image.

Note that the mask image processing is slow.

Image Multiply/Contrast

Multiply an image by a constant. Option mask input to restrict the effect to a mask image values.

Alpha Value Only check will multiply the rgb by the alpha in input. Unchecked and each rgba will be multiplied individually.

Any contrast amount other than 1 will apply a contrast to the image.

Note that the mask image processing is slow.

Image Perlin

Perlin noise. X and Y Scale controls the size of the noise pattern. X and Y Size controls the image resolution
based on Blender code

Image RGB2Alpha

Store an image rgb values to the alpha channel. Use the alpha2rgb check box to reverse and store the alpha to the rgb values.

Image Saver

Save the result to disk. Don't check "enableSave" until all else is setup. Click save as to define the base file name and type of image(choose "all" to change from the tga default). Check "isaSequence" to save a sequence of images. Set the timeline to the desired output range and push the setup keyframes button so that images will be saved as the time progresses. It may be necessary to set playback to all frames(not sure about that). Uncheck repeat in the animation preferences so it only plays once. last step is to rewind the animation, check enableSave and play the animation. In this case the animation would be the sequence of images processed through the compositing system.

The composite render node can also be used to render the sequence from a camera, but alpha values and any hdr values will not be preserved. Extensions must be typed in manually in the save as dialog.

BMP - Save as bitmap file
JPG - Save as jpeg
TGA - Save as targa
PNG - Save as PNG
DDS - Save as DirectX DDS file
HDR - Save in HDR format

Note(April 2011): Just found that one of my assumptions was wrong. Setting playback to "all frames" does not guarantee that all frames will be evaluated. Use the Truespace "Render to File" to render a dummy sequence which in turn will force each frame to be evaluated.

April 2011 - fixed bug in the image saver number sequencer.

Dec 2023 - open folder button from the unofficial updates

Image Shrink

The nodes can be slow. This node will reduce the size of it's input image by resolution divisor factor. 2= half the size in horizontal and vertical, 3= one third the size. The compositing nodes are slow so apply an image shrink to all input images while working. Remove/bypass the image shrink when rendering the final result. Check zoom to zoom the image and X and Y offsets to move the image center(actually the upper left corner). Zoom can be used with the color picker to see a closeup.