blur2d

The blur2d utility applies a 2D motion blur on the input image based on saved motion vector information. In Autodesk^® Maya^®, motion vectors are saved with the image during rendering when Keep Motion Vectors is turned on in the Motion Blur section of the Render Settings window.

To use blur2d

From a Linux^® shell, Terminal window, or command prompt, type:

blur2d [-h] [-l blurLength] [-s blurSharpness] [-m smoothValue] [-n start end step] [-f inputFileName] 
[-r smoothColor]

Option	Description
-h	Displays the help file.
-l <float>	Blur length. The value must be greater than 0. The default value is 1.
-s <float>	Blur sharpness. The value must be greater than 0. The default value is 1.
-m <int>	Smooth value. The value must be greater than or equal to 0. The default value is 2.
-r <boolean>	Whether to smooth color (1) or not (0). The default setting is 0.
-n	Animation start frame, end frame, and step.
-c <string>	Name of the image file, for example, picNoBlur.iff
-v <string>	Name of the file containing motion vectors (cannot be used with -f).
-f <string>	Name of the containing images and vectors (cannot be used with -v).
-p <int>	Frame padding to the maximum number of leading zeros. The default is none.
-o memLimit	Maximum allowed memory usage in MB.

Note

When using the -c and -v options, the image files must be the same size or the results may be unpredictable.

Examples

blur2d -f sphere.iff

The blurred image is saved as sphere_blur.iff.

blur2d -l 4 -f sphere.iff

The image is blurred with a blur length of 4 and saved as sphere_blur.iff.

blur2d -n 1 10 1 -f sphere.iff

The input image sequence being sphere.iff.1 ... sphere.iff.10, the output sequence would be sphere_blur.iff.1 ... sphere_blur.iff.10.

To blur an animation sequence, the sequence files have to be named as name.ext.# or name.#.

The command to blur the name.ext.# sequence is:

blur2d -n start end by -f name.ext

The command to blur the name.# sequence is:

The following example uses the motion path of one image and applies it to another. This is useful when you are rendering a very large file (which you want to speed up by not rendering motion blur). This example does a second, fast render (no lights or textures, low anti-aliasing) at the same resolution and with motion vectors on, and uses this to apply blur to the very large render.

Note

Lowering the anti-aliasing quality may reduce the blur quality.

blur2d -n 1 500 1 -l 2 -f ImageBeautry -v imageVector

imageBeauty is the high quality render and imageVector is the low quality render with motion vectors.

blur2d -n start end by -f name