Blur
Function
This blurs the image. This is a gaussian blur (by default), but you can
change the filter for both X and Y. A curious feature of Shake is that
the more you blur, the faster it goes. You should use this function instead
of the similar, but slower, ApplyFilter function.
Shake's Blur is about the only place you have to be concerned
with the infinite workspace, since you can choose to be blurring only
pixels inside of the image, or outside as well. If you are getting clipping
on your final image and you aren't sure why (i.e., there are no Crop
commands), go back and check your Blur's spread parameters.
Toggle it over to Outside Frame (1), and the clipping should
disappear.
Click here for more information on the
Infinite Workspace.
Parameters
|
Type
|
Defaults
|
Function
|
x/yPixels |
float
|
0,xPixels |
The amount of blur as described in Pixels,
ie 200 will blur 200 pixels to either side of the current pixel. |
spread |
int
|
0 |
This tells shake to consider outside of the frame or not.
0 = Compute within the frame (default)
1 = Compute outside of the frame
Because of the infinite workspace, it is sometimes handy to compute
outside of the frame as well, for example, if the Blur is
placed after a Scale command. Note that if nothing is outside
of the frame (ie, black), you will see a black edge.
|
x/yFilter |
string
|
"gauss","gauss" |
Jump
to Filter Types |
channels |
string
|
"rgba" |
Which channels Shake should blur. Any or
all of rgba. Default is "rgba". |
Synopsis
image Blur(
image In,
float xPixels,
float yPixels,
int spread,
const char * xFilter,
const char * yFilter,
const char * channels
);
Script
image = Blur( In, xPixels, yPixels,
spread, "xFilter", "yFilter", "channels" );
Command Line
shake -blur xPixels yPixels spread etc...
Examples
shake lisa.iff -blur 400
shake lisa.iff -blur "Linear(0,0@1,637@20)" -t 1-20
shake lisa.iff -blur 0 500
shake lisa.iff -blur 100 500 0 "gauss" "gauss" "rg"
See Also
PercentBlur
|