Lens

Commands for applying Lenses.

Activating and burning lenses

Lens commands are applied on currently selected layer. While lens is turned it will act as non-destructive realtime effect for that layer. To turn lens off you run lens-clear command or if you want to apply the effect and burn it into pixels (cannot modify after) then run lens-burn.

CommandDescription
lens-clarityTurns on Clarity lens
lens-cmyk-halftoneTurns on CMYK halftone lens
lens-difference-of-gaussianTurns on Difference of Gaussian lens
lens-directional-blurTurns on Directional Blur lens
lens-displaceTurns on Displace lens
lens-hexallateTurns on Hexallate lens
lens-kaleidoscopeTurns on Kaleidoscope lens
lens-pixellateTurns on Pixellate lens
lens-spin-blurTurns on Spin Blur lens
lens-burnBurns current Lens effect into pixels
lens-clearClear lenses, turn off the effect

Modifying Lens Parameters

Not every Lens have same parameters to tweak. Here are the commands available per lens. Ranges and value types are not absolutes but more like suggestions.

Pixellate

CommandValueRange
lens-set-blur-amountint0..100
lens-set-pixel-sizeint0..100
lens-set-gaussian-mulint0..10

Hexallate

CommandValueRange
lens-set-blur-amountint0..100
lens-set-pixel-sizeint0..100
lens-set-gaussian-mulint0..10

Displace

CommandValueRange
lens-set-blur-amountint0..100
lens-set-gaussian-mulint0..10
lens-set-displace-strengthfloat0..0.5
lens-set-mask-scalefloat0..0.25

Spin Blur

CommandValueRange
lens-set-centerx:y0..100
lens-set-gaussian-mulint0..10
lens-set-anglefloat0..1

Directional Blur

CommandValueRange
lens-set-blur-amountint0..100
lens-set-blur-directionx:y0..100

Kaleidoscope

CommandValueRange
lens-set-anglefloat0..1
lens-set-sectionsint3..24
lens-set-centerx:y0..100
lens-set-curve-strengthfloat-5..5
lens-set-curve-powerfloat0.25..3
lens-set-lens-powerfloat0.25..3

Clarity

CommandValueRange
lens-set-blur-amountint0..100
lens-set-gaussian-strengthint0..64

CMYK halftone

CommandValueRange
lens-set-contrastint1..30
lens-set-dot-sizeint1..64
lens-set-pressurefloat1..3
lens-set-noise-amountfloat0..2
lens-set-noise-scalefloat0.2..10

Difference of Gaussians

CommandValueRange
lens-set-depth1float0..6
lens-set-depth2float0..6

Example

// Turn on Kaleidoscope
cmd("lens-kaleidoscope")
// Set the Angle
cmd("lens-set-angle:33")