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