Complete Command documentation

Author: ckaiser

api/app_command.md

@@ -7,10 +7,10 @@ app.command.AddColor {
 }
 ```
 
-Adds a new color into the palette.
+Adds a new color to the palette.
 
 * `source`: Can be `"fg"`, `"bg"`, or `"color"` (default). To add the foreground, background, or a specific color respectively.
-* `color`: A [Color](../color.md#color) instance to add too the palette.
+* `color`: A [Color](../color.md#color) instance to add to the palette.
 
 ## Example
 

api/command/AddColor.md

@@ -0,0 +1,11 @@
+# AutocropSprite
+
+```lua
+app.command.AutocropSprite {
+    byGrid=bool
+}
+```
+
+Automatically crops the sprite.
+
+* `byGrid`: Aligns the crop to the grid. Optional, defaults to `false`.

api/command/AutocropSprite.md

@@ -2,16 +2,14 @@
 
 ```lua
 app.command.BrightnessContrast {
-  ui=true,
+  ui=bool,
   channels=FilterChannels...,
-  brightness=0,
-  contrast=0
+  brightness=int,
+  contrast=int
 }
 ```
 
-* `ui`: Shows the dialog on the screen, `true` by default. Set to
-  `false` for automatic change brightness and/or contrast without
-  asking to the user for the change.
+* `ui`: Shows the brightness dialog, `true` by default. Set to `false` to apply the changes immediately without user input or preview.
 * `channels`: A combination of [FilterChannels](../filterchannels.md#filterchannels) with
   [bitwise OR (`|`) operator](https://www.lua.org/manual/5.3/manual.html#3.4.2).
   By default it is equal to:

api/command/BrightnessContrast.md

@@ -2,13 +2,13 @@
 
 ```lua
 app.command.CanvasSize {
-  ui=true,
-  left=0,
-  top=0,
-  right=0,
-  bottom=0,
+  ui=bool,
+  left=int,
+  top=int,
+  right=int,
+  bottom=int,
   bounds=Rectangle,
-  trimOutside=false
+  trimOutside=bool
 }
 ```
 

api/command/CanvasSize.md

@@ -2,7 +2,7 @@
 
 ```lua
 app.command.CelOpacity {
-    opacity = 0
+    opacity=int
 }
 ```
 

api/command/CelOpacity.md

@@ -0,0 +1,14 @@
+# ChangeBrush
+
+```lua
+app.command.ChangeBrush {
+    change=string
+    slot=int
+}
+```
+
+Changes the brush of the active tool
+
+* `change`: Can be: "increment-size", "decrement-size", "increment-angle", "decrement-angle", "flip-x", "flip-y", "flip-d", "rotate-90cw", "custom"
+* `slot`: Custom brush slot (optional, only for "custom" change)
+

api/command/ChangeBrush.md

@@ -0,0 +1,13 @@
+# ChangeColor
+
+```lua
+app.command.ChangeColor {
+    target=string
+    change=string
+}
+```
+
+Changes the current foreground or background color by moving up or down on the palette by index.
+
+* `target`: Can be `"foreground"` or `"background"`
+* `change`: Can be `"increment-index"` or `"decrement-index"`

api/command/ChangeColor.md

@@ -6,22 +6,23 @@ app.command.ChangePixelFormat {
   dithering=string,
   ["dithering-matrix"]=string,
   rgbmap=string,
-  toGray=string
+  toGray=string,
+  fitCriteria=string
 }
 ```
 
 Changes the [ColorMode](../colormode.md) of the active [sprite](../sprite.md)
 
-* `format`: Can be `"rgb"`, `"gray"`, or `"indexed"`.
-* `dithering`: Can be `"ordered"`, `"old"` `"error-diffusion"`,
-  or empty.
-* `dithering-matrix`: It can be `"bayer8x8"`, `"bayer4x4"`, or `"bayer2x2"` (when When `dithering` is `ordered` or `old`).
-  Actually it can be a matrix ID from any extensions ([for example](https://github.com/aseprite/aseprite/blob/fc79146c56f941f834f28809f0d2c4d7fd60076c/data/extensions/bayer-matrices/package.json#L8)).
-* `rgmap`: `"octree"`, `"rgb5a3"`, or `"default"` (generally default
+* `format`: `"rgb"`, `"gray"`, or `"indexed"`.
+* `dithering`: Optional, `"ordered"`, `"old"` `"error-diffusion"`
+* `dithering-matrix`: Optional, `"bayer8x8"`, `"bayer4x4"`, or `"bayer2x2"` (when When `dithering` is `ordered` or `old`).
+  Actually it can be a matrix ID from any extension ([for example](https://github.com/aseprite/aseprite/blob/fc79146c56f941f834f28809f0d2c4d7fd60076c/data/extensions/bayer-matrices/package.json#L8)).
+* `rgbmap`: Optional, `"octree"`, `"rgb5a3"`, or `"default"` (generally default
   will be octree, but it might change in the future). If nothing is
-  specified the default configured quantization method from prefereces
+  specified the default configured quantization method from preferences
   will be used if the GUI is enabled.
-* `toGray`: `"luma"`, `"hsv"`, or `"hsl"`.
+* `toGray`: Optional, `"luma"`, `"hsv"`, or `"hsl"`.
+* `fitCriteria`: Optional, `"rgb"`, `"linearizedRGB"`, `"ciexyz"`, `"cielab"`, or `"default"`
 
 ## Example
 

api/command/ChangePixelFormat.md

@@ -2,15 +2,14 @@
 
 ```lua
 app.command.ColorCurve {
-  ui=true,
+  ui=bool,
   channels=FilterChannels...,
   curve={ Point, Point, Point... }
 }
 ```
 
 * `ui`: Shows the dialog on the screen, `true` by default. Set to
-  `false` to apply the color curve filter automatically without asking
-  to the user for the change.
+  `false` to apply the color curve filter automatically without user input.
 * `channels`: A combination of [FilterChannels](../filterchannels.md#filterchannels) with
   [bitwise OR (`|`) operator](https://www.lua.org/manual/5.3/manual.html#3.4.2).
   By default it is equal to: