IDilateErode

Function
This function isolates each channel and will cut pixels away or add them to the edge of that channel. For example, if you wanted to eat into your mask, you would set your channels to "a", and then set x- and yPixels values of -1. By default, you are working on whole pixels, but you can switch to sub-pixel chewing by toggling on soften. Note that the soften parameter *really* slows the function down. We recommend low values for x- and yPixels if you are turning on the soften feature.

Parameters
Type
Defaults
Function
channels
string
"rgba" The effected channels.
x/yPixels
float
0, xPixels The amount of pixels added or taken on an edge. Positive values add to the edge, negative values eat away at the edge.
border
int
0

This tells Shake to consider or ignore the border pixels.

soften
int
0 This toggle turns on softening, or effecting the sub-pixel. If this is turned on, it will considerably slow down the software at high x/yPixel values.
sharpness
float
0 The sharpness factor for the softening. A value of 0 gives a smooth gradation, whereas 2 will give you a sharp cutoff.
steps
int
5 This is the amount of regions that the image is divided up into. The intensity of the control image is divided up X amount of zones, with X being equal to regions.
stepBlend
float
1 This controls the blending between the amount of regions (see below). If you put this at 0, each step will have a constant dilate value. If this is 1, there is a continuous blend between the different regions.
controlChannel
string
"a" The channel of the second image to use to control the amount of dilate.
invert
int
0 Inverts the controlChannel.


Synopsis

image IDilateErode( 
image img, image controlImg const char * channels, float xPixels, float yPixels, int borders, int soften float sharpness float stepBlend, int steps, const char * controlChannel, const char * channels, int invert );


Script

image = IDilateErode(
  img, 
  controlImg,
  "channels", 
  xPixels, 
  yPixels, 
  borders, 
  soften, 
  sharpness,
  stepBlend,
  steps,
  "controlChannel",
  "channels",
  invert 
       
);


Command Line

shake -idilateerode controlImg channels xPixels yPixels etc...