blur2d

The blur2d utility applies a 2D motion blur on the input image based on saved motion vector information. In 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

1. From a 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