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
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. |
When using the -c and -v options, the image files must be the same size or the results may be unpredictable.
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.
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