...

Online Help for Chasys Draw IES: Automation - Scripting Effects


Automation : Scripting Effects
 

Commands

All commands for effects start with “fx_”. Here’s the listing of the available commands and their syntax:

Command & Syntax Details
fx_antialias type level param;

Anti-alias.
Parameters are type [normal, edges] and level [0..100], param [0..100].

fx_bilevel lim_r lim_g lim_b lim_a flags; Bilevelize.
The parameters lim_r, lim_g, lim_b, lim_a [0..100] are the cutoff limits for the color channels, while the flags parameter [r|g|b|a] indicates which channels should be modified.
fx_chromablur level; Chroma Blur.
The parameter level [0..100] is the effect level.
fx_chromakey type level #color; Chroma Keying.
The parameter type [normal, exact, black, white] is the kind of keying to perform, level [0..100] is the effect level, #color is the color to key and type [0..3] indicates the type of chroma-keying to use.
fx_clouds x_size y_size detail seed turbulent tilable #color1 #color2; Render Clouds.
The parameters x_size, y_size, detail [0..100] are the effect levels, seed is the seed value for the randomizer, turbulence [yes, no] indicates whether or not to use turbulence, tilable [yes, no] indicates if the pattern will be tilable, #color1 and #color2 are the colors to use.
fx_correct_ca level_r level_g level_b; Chromatic Aberration Correction.
The parameters level_r, level_g, level_b [-5..+5] are the effect levels for the three channels (percentage, decimals allowed).
fx_correct_ca r.x, r.y, g.x, g.y, b.x, b.y; Color Misalignment Correction.
The parameters r.x, r.y, g.x, g.y, b.x, b.y [-10..+10] are the X and Y distances for the three channels (pixels, decimals allowed).
fx_correct_jpeg level; JPEG Artifact Correction.
Parameter is level [0..100].
fx_decolor level; Decolorize.
Parameter is level [0..100].
fx_diffglow level threshold radius; Diffuse glow.
All parameters are [0..100].
fx_displace zero mul_x mul_y off_x off_y file-path; Displace.
Parameters are zero [0..192], which is the zero level in the displacement map, mul_x, mul_y, the displacement multipliers, off_x, off_y and file-path (URL-encoded string therefore no spaces).
fx_dissolve; Dissolve.
No parameters.
fx_duotone #light_color #dark_color; Duotone.
Both parameters are #color.
fx_dyncontrast level flags; Dynamic Contrast.
Parameters are level [0..100] and flags parameter [r|g|b|a]. The latter indicates which channels should be modified.
fx_edgedetect level; Edge Detection.
Parameter is level [0..100].
fx_emboss type level angle; Emboss.
Parameters are type parameter [normal, relief, alpha], level [0..100] and angle [0..360].
fx_gaussblur radius flags; Gaussian Blur.
The parameter radius [0..1024] is the gaussian kernel radius while the flags parameter [r|g|b|a] indicates which channels should be modified.
fx_gradient point_list...;

Gradient mapping.
The point list consists of a number (the "count") followed by "count" coordinate pairs, e.g.
fx_gradient 3 0 0 128 128 255 255 ;

fx_grid width_x width_y offset_x offset_y spacing_x spacing_y intersect_x intersect_y opacity #color; Grid.
The width parameters determine the line width. The offset is the start-point for the first line. Spacing is the spacing between lines. Intersect is the size of intersections. The opacity parameter [0..100%] determines how visible the lines are.
fx_halo size blur #color; Halo.
The parameter size [0..100] is the halo size (percentage), blur is the blurring level [0..100] and #color is the color of the halo.
fx_highpass level flags; Sharpen, High-pass filter.
Parameters are level [0..100] and flags parameter [r|g|b|a]. The latter indicates which channels should be modified.
fx_limitcolor pal_type pal_size dithering;

Limit Colors.
The parameter pal_type [optimal, current] determines the palette to use, the default being “optimal” which generates an optimized octree palette. The parameter pal_size [8..256] determines size of the palette where applicable. The parameter dithering [none, floyd, jarvis, atkinson] determines the dithering algorithm if any. The value "floyd" means Floyd-Steinberg error diffusion, "jarvis" means Jarvis-Judice-Ninke error diffusion and "atkinson" means Atkinson partial error diffusion. The preferred method is Floyd-Steinberg.

fx_localcontrast level locality bk_sub color_mode subtract_mode; Local Contrast Enhancement.
Parameters are level [0..100], locality [0..100], bk_sub [0..100], color_mode parameter [luma, rgb], and subtract_mode parameter [black, white].
fx_lowpass level flags; Blur, Low-pass filter.
Parameters are level [0..100] and flags parameter [r|g|b|a]. The latter indicates which channels should be modified.
fx_lumasharp level; Sharpen, Luma.
Parameter is level [0..100].
fx_maketile type overlap; Make Tile.
The parameter type [normal, content] is the algorithm to use and overlap [0..100] is the percentage of overlap. The “content” algorithm is currently not supported.
fx_matconv elements ... ; Convolution Matrix.
Parameters are a list of 25 elements representing a 5x5 matrix.
fx_matfilt elements ... ; Color Filter Matrix.
Parameters are a list of 20 elements representing a 5x4 matrix. The columns are input R, G, B, A and Offset, while the rows are output R, G, B and A. All values use 1.0 as 100%; e.g.
fx_matfilt
    1.0    0.0    0.0    0.0    0.0
    0.0    1.0    0.0    0.0    0.0
    0.0    0.0    1.0    0.0    0.0
    0.0    0.0    0.0    1.0    0.0   ;
fx_motionblur level direction; Motion-blur.
Parameters are level [0..100] and direction [0..360] (direction of motion).
fx_negative; Negative.
No parameters.
fx_nr_bayer pixels; Bayer Denoise.
Parameters is pixels [2..7]. This corresponds to the number of pixels to consider as a bayer matrix cell.
fx_nr_linear blurring threshold flags; Linear Denoise.
Parameters are blurring [0..100], threshold [0..100] and flags parameter [r|g|b|a]. The latter indicates which channels should be modified.
fx_nr_median radius; Median Denoise.
Parameter is radius [1..16].
fx_nr_wavelet luminance chrominance; Wavelet Denoise.
Parameters are luminance [0..100] and chrominance [0..100].
fx_oilify level; Oilify.
Parameter is level [0..100].
fx_pinch level; Pinch.
Parameter is level [-100..+100].
fx_pixelate pixels; Pixelate.
Parameter is pixels [2..128].
fx_premultiply_alpha; Premultiply Alpha.
No parameters.
fx_posterize bits flags; Posterize.
Parameters are bits [1..7] and flags parameter [r|g|b|a]. The latter indicates which channels should be modified.

fx_recolor selectivity #ref_clr #new_clr;

fx_recolor selectivity #ref_clr delta_hue delta_sat delta_val;

Recolor.
The first two parameters are selectivity [0..100] and ref_color (color to replace). If using a replacement color, one more parameter is required, namely new_color. If using color shifting, a three more parameters are required, namely delta_hue [-180..180], delta_sat [-100..100] and delta_val [-100..100].
fx_reflection height opacity gradient; Reflection.
Parameters are height [0..100], opacity [0..100] and gradient [0..100].
fx_shadow visibility distance blur #color; Drop Shadow.
Parameters are visibility [0..100], distance [0..100] blur [0..100] and #color.
fx_sharpen level flags; Sharpen, Normal.
Parameters are level [0..100] and flags [r|g|b|a]. The latter indicates which channels should be modified.
fx_shrinkalpha pixels; Shrink Alpha.
Parameter is pixels [-32..+32] (pixels to add or shave off).
fx_smartsharp intensity threshold tolerance flags;

Smart Sharpen.
Parameters are intensity [0..100], threshold [0..4096], tolerance [0..100] and flags parameter [r|g|b|a].

fx_spinblur angle center_x center_y; Spin-blur.
Parameters are angle [0..15] and center_x / center_y (center of rotation).
fx_surfaceblur threshold radius; Surface-blur.
Parameters are threshold [0..100] and radius [0..256].
fx_synenhance; Synthetic Enhance.
fx_twirl angle center_x center_y; Twirl.
Parameter are angle [-360..+360] and center_x / center_y (center of rotation).
fx_unmultiply_alpha; Unmultiply Alpha.
No parameters.
fx_unsharp intensity threshold radius rad_type flags;

Unsharp masking.
Parameters are intensity [0..100], threshold [0..100], radius [0..100], rad_type [pixel, level] and flags [r|g|b|a].

fx_watermark pos_x pos_y size fade file-path; Watermark.
Parameters are pos_x [0..100], pos_y [0..100], size [0..100], fade [0..100] and file-path (URL-encoded string therefore no spaces).
fx_zoomblur level center_x center_y; Zoom-blur.
Parameters are level [0..100] and center_x / center_y (center of zoom).

 

You can generate script code for most commands in Chasys Draw IES by using them while running the record function.

 

 

Copyright © John Paul Chacha, 2001-2023