Layer

Layer commands.

Layers commands are applied on currently selected layer. Layer index param is always optional. If not supplied the currently active layer will be targetet. Layer indexes are such that zero is the botton layer.

CommandValueDescription
layer-addAdds a new layer
layer-add-colorhex colorCreate new layer with some color
layer-analyze-colorsAnalyze layer colors and add them to tatami.state
layer-blending-modemodeSet blending mode for the selected layer
layer-brush-textureConvert layer into brush texture
layer-brush-tipConvert layer into brush tip
layer-centerCenters layer to middle of canvas
layer-clearindexClear layer
layer-copyindexCopy layer to clipboard.
layer-copy-selectionindexCopy layer pixels from currently selected area
layer-crop-autoAuto crop and center layer
layer-cutindexCut layer
layer-deleteindexDelete layer
layer-duplicateDuplicates layer
layer-exportindexExports layers as PNG file
layer-export-allExports all layers as separate PNG files
layer-flip-horizontalFlips layer horizontally
layer-flip-verticalFlips layer vertically
layer-hideindexHide layer
layer-importImport image from device into new layer
layer-import-maskImport image from device and use as mask layer
layer-import-urlurlImport image from given URL as new layer
layer-invert-colorsInvert colors of the layer
layer-lockindexLock layer
layer-merge-downMerge layer with the layer below
layer-movefrom:toMove layer from index to other (0 = bottom)
layer-namenameSet layer name
layer-opacity0..100Set layer opacity
layer-pastePaste clipboard content to layer
layer-rotate-180Rotate layer 180 degrees
layer-rotate-90Rotate layer 90 degrees clockwise
layer-rotate-90-ccwRotate layer 90 degrees counter clockwise
layer-scalewidth:heightResize layer into given width and height
layer-scale-to-coverResize layer to cover the paper area
layer-scale-to-fitResize layer to fit inside paper area
layer-selectindexSelect layer
layer-showindexShow layer (vs Hide Layer)
layer-toggleindexToggle layer visibility
layer-toggle-lockindexToggle layer lock
layer-transformx:y:w:hMove and scale layer (width and height optional)
layer-unlockindexUnlock layer (vs Lock Layer)

Blending Mode

These are the possible mode string values for layer-blending-mode command

  • normal
  • screen
  • add
  • overlay
  • darken
  • lighten
  • difference
  • negate
  • multiply
  • exclude
  • hardlight
  • softlight
  • pinlight
  • layerMask

Example

// Creates bright red layer
cmd("layer-add-color:#ff0000")
// Create new layer (always gets the topmost)
cmd("layer-add")
// Lock bottom layer
cmd("layer-lock:0")
// Give layer a name
cmd("layer-name:Draw here")