├── .gitignore ├── ink └── inks.png ├── flip └── flip.gif ├── tags ├── tags.png └── tag-properties.png ├── canvas ├── canvas.gif ├── crop.gif ├── canvas-flip.gif ├── canvas-trim.gif └── canvas-rotate.gif ├── cli ├── list-tags.png ├── list-layers.png ├── border-padding.png ├── inner-padding.png ├── shape-padding.png └── list-layer-hierarchy.png ├── resize ├── resize.gif └── resize-selection.gif ├── rotate ├── handle.png ├── edit-rotate.png ├── pivot-point.png ├── rotate-handles.gif ├── rotation-algorithm.gif ├── pivot-point-settings.gif ├── rotate-menu-options.gif ├── rotation-algorithms.png ├── pivot-point-context-bar.png └── pivot-point-mouse-move.gif ├── tablet └── tablet.png ├── cel ├── cel-opacity.gif ├── cel-properties.gif ├── cel-on-timeline.png └── frame-on-timeline.png ├── color ├── gray-mode.png ├── rgb-mode.png ├── indexed-mode.gif └── indexed-mode.png ├── dynamics ├── minmax.png ├── dynamics.png ├── contextbar.png └── thresholds.png ├── focus-tag ├── bands.gif └── focus.gif ├── tools ├── hand-tool.png ├── line-tool.png ├── move-tool.png ├── timeline.png ├── zoom-tool.png ├── curve-tool.png ├── ellipse-tool.png ├── eraser-tool.png ├── marquee-tool.png ├── pencil-tool.png ├── polygon-tool.png ├── slice-tool.png ├── countour-tool.png ├── rectangle-tool.png ├── eyedropper-tool.png └── filled-rectangle-tool.png ├── brushes ├── alignment1.gif ├── alignment2.gif ├── alignment3.gif ├── brushangle.png ├── brushtype.png ├── contextbar.png ├── parameters.png ├── custombrush.png └── patternbrush.gif ├── context-bar ├── move.png ├── pencil.png ├── text.png ├── gradient.png ├── opacity.png ├── brushangle.png ├── brushtype.png ├── contextbar.png ├── dithering.png ├── eyedropper.png ├── paintbucket.png ├── selection.png ├── tolerance.gif ├── transparent.gif ├── pixelperfect.png └── movingselection.png ├── loop └── loop-section.gif ├── numeric-field └── math.gif ├── open └── loadsequence.png ├── preferences ├── ranges.png ├── auto-guides.png ├── drag-value.png ├── edge-color.png ├── preffiles.png ├── show-alert.png ├── spotlight.png ├── drag-options.png ├── edge-negative.png ├── ui-one-window.png ├── crosshair-types.png ├── ui-multi-window.png ├── brush-preview-types.gif ├── move-selection-edges.gif ├── nonlinear-undohistory.gif └── keep-selection-deleted-content.gif ├── range ├── cels-range.png ├── frames-range.png └── layers-range.png ├── slices └── properties.png ├── symmetry ├── mid-pixel.gif ├── drag-handles.gif ├── options-icon.png ├── vertical-icon.png ├── horizontal-icon.png ├── symmetry-buttons.png └── draw-with-symmetry.gif ├── tilemap ├── auto-mode.png ├── stack-mode.png ├── tiles-mode.png ├── manual-mode.png ├── pixels-mode.png └── tilemap-example.png ├── timeline ├── timeline.png └── timeline-copy-and-paste.gif ├── workspace ├── screen.png └── drag-and-drop-tabs.gif ├── zoom ├── zoom-slider.png └── zoom-text-field.png ├── color-bar ├── color-bar.png ├── color-popup.png ├── color-warning.png └── color-warning-icon.png ├── copy-cels └── copy-cels.gif ├── cursor ├── resize-handle.png └── rotate-handle.png ├── debug ├── win-2-actions.png ├── win-1-start-menu.png ├── win-4-debug-option.png ├── macos-1-open-spotlight.png ├── macos-2-open-terminal.png └── win-3-right-click-properties.png ├── layers ├── hidden-layer.png ├── layer-options.png ├── locked-layer.png ├── visible-layer.png ├── editable-layer.png └── layer-in-timeline.png ├── move-cels └── move-cels.gif ├── move-tool ├── autoselect.gif ├── autoselect.png └── move-multiple-cels.gif ├── new-sprite ├── newsprite.png └── new-sprite-from-selection.gif ├── selecting ├── modifiers.png ├── add-selection.png ├── marching-ants.gif ├── replace-selection.png ├── subtract-selection.png └── intersect-selection.png ├── shading ├── shading_ref.png ├── shading_step1.gif ├── shading_step2.gif ├── shading_step3.gif └── shading_step4.gif ├── status-bar └── overview.png ├── animation ├── play-button.png ├── onion-skinning.png ├── configure-timeline.png ├── enable-onion-skinning.gif └── onion-skinning-settings.gif ├── color-profile ├── rgb-cube.png └── color-management-preferences.png ├── copy-frames └── copy-frames.gif ├── copy-layers └── copy-layers.gif ├── data-recovery ├── home-tab.png ├── in-sessions-folder.png ├── recover-files-tab.png ├── home-tab-after-crash.png ├── recover-data-preferences.png └── sessions-folder-focused.png ├── exporting ├── file-export.png ├── file-export-resize.png └── file-export-sel-frame.png ├── extensions ├── extensions.png ├── palettes.md ├── dithering-matrices.md ├── languages.md ├── keys.md └── themes.md ├── eyedropper ├── pick-options.png ├── sample-options.png └── eyedropper-group.png ├── linked-cels ├── linked-cels.png └── unlink-cels.gif ├── menu-bar ├── macos-menubar.png └── aseprite-menubar.png ├── move-frames └── move-frames.gif ├── move-layers └── move-layers.gif ├── wintab └── disable-wintab.png ├── layer-group └── layer-groups.png ├── move-selection ├── contextbar.png └── move-selection.gif ├── sprite-editor ├── right-click.png └── sprite-editor.png ├── sprite-sheet ├── running-guy.gif ├── running-guy-horz.png ├── running-guy-vert.png ├── running-guy-export.png ├── running-guy-matrix.png ├── running-guy-import-01.png └── running-guy-import-02.png ├── sprite └── sprite-components.png ├── new-frame └── new-frame-button.png ├── new-layer └── layer-right-click.png ├── preview-window ├── play-button.png └── preview-window.png ├── steam ├── steam-2-launch-options.png ├── steam-3-debug-option.png ├── steam-3-disable-wintab.png └── steam-1-open-properties.png ├── continuous-layers ├── broken-layer.png ├── cont-vs-dis.png └── continuous-layer.png ├── default-palette └── save-as-default.gif ├── keyboard-shortcuts ├── hand-shortcuts.png └── mouse-wheel-custom.png ├── frame-duration └── timeline-right-click.gif ├── sprite-properties └── sprite-properties.png ├── transparent-color └── transparent-color-property.png ├── status-bar.md ├── rotate-canvas.md ├── .github └── workflows │ ├── pdf │ ├── header.tex │ ├── title.tex │ └── link-gifs.lua │ └── md-to-pdf.yml ├── reverse-frames.md ├── numeric-field.md ├── new-layer.md ├── flip.md ├── flip-canvas.md ├── resize.md ├── sprite-size.md ├── right-click.md ├── loop.md ├── move-layers.md ├── move-frames.md ├── tool-bar.md ├── default-palette.md ├── frame-duration.md ├── copy-layers.md ├── eraser.md ├── open.md ├── sidebar.md ├── tiled-mode.md ├── range.md ├── focus-tag.md ├── canvas.md ├── preview-window.md ├── copy-frames.md ├── layer-group.md ├── copy-cels.md ├── move-cels.md ├── scripting.md ├── customization.md ├── ui-controls.md ├── onion-skinning.md ├── save.md ├── sprite-editor.md ├── tags.md ├── menu-bar.md ├── move-selection.md ├── drag-value.md ├── transparent-color.md ├── new-sprite.md ├── shading.md ├── move-tool.md ├── cel.md ├── linked-cels.md ├── symmetry.md ├── zoom.md ├── workspace.md ├── continuous-layers.md ├── eyedropper.md ├── sprite-properties.md ├── extensions.md ├── preferences-folder.md ├── reset-preferences.md ├── transformations.md ├── sprite-sheet.md ├── new-frame.md ├── color-mode.md ├── workflow.md ├── color.md ├── timeline.md ├── sprite.md ├── animation.md ├── ink.md ├── color-bar.md ├── dynamics.md ├── mouse-wheel.md ├── drawing.md ├── slices.md ├── wintab.md ├── troubleshooting.md ├── overview.md ├── tablet.md ├── debug.md ├── exporting.md ├── color-profile.md ├── rotate.md ├── selecting.md ├── files.md ├── tilemap.md ├── brushes.md ├── data-recovery.md ├── layers.md ├── basics.md ├── context-bar.md ├── tutorial.md ├── keyboard-shortcuts.md └── preferences.md /.gitignore: -------------------------------------------------------------------------------- 1 | Thumbs.db 2 | .#* 3 | -------------------------------------------------------------------------------- /ink/inks.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/ink/inks.png -------------------------------------------------------------------------------- /flip/flip.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/flip/flip.gif -------------------------------------------------------------------------------- /tags/tags.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tags/tags.png -------------------------------------------------------------------------------- /canvas/canvas.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/canvas/canvas.gif -------------------------------------------------------------------------------- /canvas/crop.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/canvas/crop.gif -------------------------------------------------------------------------------- /cli/list-tags.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cli/list-tags.png -------------------------------------------------------------------------------- /resize/resize.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/resize/resize.gif -------------------------------------------------------------------------------- /rotate/handle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/handle.png -------------------------------------------------------------------------------- /tablet/tablet.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tablet/tablet.png -------------------------------------------------------------------------------- /cel/cel-opacity.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cel/cel-opacity.gif -------------------------------------------------------------------------------- /cli/list-layers.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cli/list-layers.png -------------------------------------------------------------------------------- /color/gray-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color/gray-mode.png -------------------------------------------------------------------------------- /color/rgb-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color/rgb-mode.png -------------------------------------------------------------------------------- /dynamics/minmax.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/dynamics/minmax.png -------------------------------------------------------------------------------- /focus-tag/bands.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/focus-tag/bands.gif -------------------------------------------------------------------------------- /focus-tag/focus.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/focus-tag/focus.gif -------------------------------------------------------------------------------- /tools/hand-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/hand-tool.png -------------------------------------------------------------------------------- /tools/line-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/line-tool.png -------------------------------------------------------------------------------- /tools/move-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/move-tool.png -------------------------------------------------------------------------------- /tools/timeline.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/timeline.png -------------------------------------------------------------------------------- /tools/zoom-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/zoom-tool.png -------------------------------------------------------------------------------- /brushes/alignment1.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/alignment1.gif -------------------------------------------------------------------------------- /brushes/alignment2.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/alignment2.gif -------------------------------------------------------------------------------- /brushes/alignment3.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/alignment3.gif -------------------------------------------------------------------------------- /brushes/brushangle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/brushangle.png -------------------------------------------------------------------------------- /brushes/brushtype.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/brushtype.png -------------------------------------------------------------------------------- /brushes/contextbar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/contextbar.png -------------------------------------------------------------------------------- /brushes/parameters.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/parameters.png -------------------------------------------------------------------------------- /canvas/canvas-flip.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/canvas/canvas-flip.gif -------------------------------------------------------------------------------- /canvas/canvas-trim.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/canvas/canvas-trim.gif -------------------------------------------------------------------------------- /cel/cel-properties.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cel/cel-properties.gif -------------------------------------------------------------------------------- /cli/border-padding.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cli/border-padding.png -------------------------------------------------------------------------------- /cli/inner-padding.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cli/inner-padding.png -------------------------------------------------------------------------------- /cli/shape-padding.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cli/shape-padding.png -------------------------------------------------------------------------------- /color/indexed-mode.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color/indexed-mode.gif -------------------------------------------------------------------------------- /color/indexed-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color/indexed-mode.png -------------------------------------------------------------------------------- /context-bar/move.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/move.png -------------------------------------------------------------------------------- /context-bar/pencil.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/pencil.png -------------------------------------------------------------------------------- /context-bar/text.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/text.png -------------------------------------------------------------------------------- /dynamics/dynamics.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/dynamics/dynamics.png -------------------------------------------------------------------------------- /loop/loop-section.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/loop/loop-section.gif -------------------------------------------------------------------------------- /numeric-field/math.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/numeric-field/math.gif -------------------------------------------------------------------------------- /open/loadsequence.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/open/loadsequence.png -------------------------------------------------------------------------------- /preferences/ranges.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/ranges.png -------------------------------------------------------------------------------- /range/cels-range.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/range/cels-range.png -------------------------------------------------------------------------------- /range/frames-range.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/range/frames-range.png -------------------------------------------------------------------------------- /range/layers-range.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/range/layers-range.png -------------------------------------------------------------------------------- /rotate/edit-rotate.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/edit-rotate.png -------------------------------------------------------------------------------- /rotate/pivot-point.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/pivot-point.png -------------------------------------------------------------------------------- /slices/properties.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/slices/properties.png -------------------------------------------------------------------------------- /symmetry/mid-pixel.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/mid-pixel.gif -------------------------------------------------------------------------------- /tilemap/auto-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tilemap/auto-mode.png -------------------------------------------------------------------------------- /tilemap/stack-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tilemap/stack-mode.png -------------------------------------------------------------------------------- /tilemap/tiles-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tilemap/tiles-mode.png -------------------------------------------------------------------------------- /timeline/timeline.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/timeline/timeline.png -------------------------------------------------------------------------------- /tools/curve-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/curve-tool.png -------------------------------------------------------------------------------- /tools/ellipse-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/ellipse-tool.png -------------------------------------------------------------------------------- /tools/eraser-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/eraser-tool.png -------------------------------------------------------------------------------- /tools/marquee-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/marquee-tool.png -------------------------------------------------------------------------------- /tools/pencil-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/pencil-tool.png -------------------------------------------------------------------------------- /tools/polygon-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/polygon-tool.png -------------------------------------------------------------------------------- /tools/slice-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/slice-tool.png -------------------------------------------------------------------------------- /workspace/screen.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/workspace/screen.png -------------------------------------------------------------------------------- /zoom/zoom-slider.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/zoom/zoom-slider.png -------------------------------------------------------------------------------- /brushes/custombrush.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/custombrush.png -------------------------------------------------------------------------------- /brushes/patternbrush.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/brushes/patternbrush.gif -------------------------------------------------------------------------------- /canvas/canvas-rotate.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/canvas/canvas-rotate.gif -------------------------------------------------------------------------------- /cel/cel-on-timeline.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cel/cel-on-timeline.png -------------------------------------------------------------------------------- /color-bar/color-bar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color-bar/color-bar.png -------------------------------------------------------------------------------- /context-bar/gradient.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/gradient.png -------------------------------------------------------------------------------- /context-bar/opacity.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/opacity.png -------------------------------------------------------------------------------- /copy-cels/copy-cels.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/copy-cels/copy-cels.gif -------------------------------------------------------------------------------- /cursor/resize-handle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cursor/resize-handle.png -------------------------------------------------------------------------------- /cursor/rotate-handle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cursor/rotate-handle.png -------------------------------------------------------------------------------- /debug/win-2-actions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/debug/win-2-actions.png -------------------------------------------------------------------------------- /dynamics/contextbar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/dynamics/contextbar.png -------------------------------------------------------------------------------- /dynamics/thresholds.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/dynamics/thresholds.png -------------------------------------------------------------------------------- /layers/hidden-layer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layers/hidden-layer.png -------------------------------------------------------------------------------- /layers/layer-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layers/layer-options.png -------------------------------------------------------------------------------- /layers/locked-layer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layers/locked-layer.png -------------------------------------------------------------------------------- /layers/visible-layer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layers/visible-layer.png -------------------------------------------------------------------------------- /move-cels/move-cels.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-cels/move-cels.gif -------------------------------------------------------------------------------- /move-tool/autoselect.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-tool/autoselect.gif -------------------------------------------------------------------------------- /move-tool/autoselect.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-tool/autoselect.png -------------------------------------------------------------------------------- /new-sprite/newsprite.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/new-sprite/newsprite.png -------------------------------------------------------------------------------- /selecting/modifiers.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/selecting/modifiers.png -------------------------------------------------------------------------------- /shading/shading_ref.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/shading/shading_ref.png -------------------------------------------------------------------------------- /status-bar/overview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/status-bar/overview.png -------------------------------------------------------------------------------- /tags/tag-properties.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tags/tag-properties.png -------------------------------------------------------------------------------- /tilemap/manual-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tilemap/manual-mode.png -------------------------------------------------------------------------------- /tilemap/pixels-mode.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tilemap/pixels-mode.png -------------------------------------------------------------------------------- /tools/countour-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/countour-tool.png -------------------------------------------------------------------------------- /tools/rectangle-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/rectangle-tool.png -------------------------------------------------------------------------------- /zoom/zoom-text-field.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/zoom/zoom-text-field.png -------------------------------------------------------------------------------- /animation/play-button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/animation/play-button.png -------------------------------------------------------------------------------- /cel/frame-on-timeline.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cel/frame-on-timeline.png -------------------------------------------------------------------------------- /color-bar/color-popup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color-bar/color-popup.png -------------------------------------------------------------------------------- /color-bar/color-warning.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color-bar/color-warning.png -------------------------------------------------------------------------------- /color-profile/rgb-cube.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color-profile/rgb-cube.png -------------------------------------------------------------------------------- /context-bar/brushangle.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/brushangle.png -------------------------------------------------------------------------------- /context-bar/brushtype.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/brushtype.png -------------------------------------------------------------------------------- /context-bar/contextbar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/contextbar.png -------------------------------------------------------------------------------- /context-bar/dithering.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/dithering.png -------------------------------------------------------------------------------- /context-bar/eyedropper.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/eyedropper.png -------------------------------------------------------------------------------- /context-bar/paintbucket.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/paintbucket.png -------------------------------------------------------------------------------- /context-bar/selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/selection.png -------------------------------------------------------------------------------- /context-bar/tolerance.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/tolerance.gif -------------------------------------------------------------------------------- /context-bar/transparent.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/transparent.gif -------------------------------------------------------------------------------- /copy-frames/copy-frames.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/copy-frames/copy-frames.gif -------------------------------------------------------------------------------- /copy-layers/copy-layers.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/copy-layers/copy-layers.gif -------------------------------------------------------------------------------- /data-recovery/home-tab.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/data-recovery/home-tab.png -------------------------------------------------------------------------------- /debug/win-1-start-menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/debug/win-1-start-menu.png -------------------------------------------------------------------------------- /exporting/file-export.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/exporting/file-export.png -------------------------------------------------------------------------------- /extensions/extensions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/extensions/extensions.png -------------------------------------------------------------------------------- /eyedropper/pick-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/eyedropper/pick-options.png -------------------------------------------------------------------------------- /layers/editable-layer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layers/editable-layer.png -------------------------------------------------------------------------------- /linked-cels/linked-cels.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/linked-cels/linked-cels.png -------------------------------------------------------------------------------- /linked-cels/unlink-cels.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/linked-cels/unlink-cels.gif -------------------------------------------------------------------------------- /menu-bar/macos-menubar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/menu-bar/macos-menubar.png -------------------------------------------------------------------------------- /move-frames/move-frames.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-frames/move-frames.gif -------------------------------------------------------------------------------- /move-layers/move-layers.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-layers/move-layers.gif -------------------------------------------------------------------------------- /preferences/auto-guides.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/auto-guides.png -------------------------------------------------------------------------------- /preferences/drag-value.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/drag-value.png -------------------------------------------------------------------------------- /preferences/edge-color.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/edge-color.png -------------------------------------------------------------------------------- /preferences/preffiles.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/preffiles.png -------------------------------------------------------------------------------- /preferences/show-alert.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/show-alert.png -------------------------------------------------------------------------------- /preferences/spotlight.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/spotlight.png -------------------------------------------------------------------------------- /resize/resize-selection.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/resize/resize-selection.gif -------------------------------------------------------------------------------- /rotate/rotate-handles.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/rotate-handles.gif -------------------------------------------------------------------------------- /selecting/add-selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/selecting/add-selection.png -------------------------------------------------------------------------------- /selecting/marching-ants.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/selecting/marching-ants.gif -------------------------------------------------------------------------------- /shading/shading_step1.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/shading/shading_step1.gif -------------------------------------------------------------------------------- /shading/shading_step2.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/shading/shading_step2.gif -------------------------------------------------------------------------------- /shading/shading_step3.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/shading/shading_step3.gif -------------------------------------------------------------------------------- /shading/shading_step4.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/shading/shading_step4.gif -------------------------------------------------------------------------------- /symmetry/drag-handles.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/drag-handles.gif -------------------------------------------------------------------------------- /symmetry/options-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/options-icon.png -------------------------------------------------------------------------------- /symmetry/vertical-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/vertical-icon.png -------------------------------------------------------------------------------- /tilemap/tilemap-example.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tilemap/tilemap-example.png -------------------------------------------------------------------------------- /tools/eyedropper-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/eyedropper-tool.png -------------------------------------------------------------------------------- /wintab/disable-wintab.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/wintab/disable-wintab.png -------------------------------------------------------------------------------- /animation/onion-skinning.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/animation/onion-skinning.png -------------------------------------------------------------------------------- /cli/list-layer-hierarchy.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/cli/list-layer-hierarchy.png -------------------------------------------------------------------------------- /context-bar/pixelperfect.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/pixelperfect.png -------------------------------------------------------------------------------- /debug/win-4-debug-option.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/debug/win-4-debug-option.png -------------------------------------------------------------------------------- /eyedropper/sample-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/eyedropper/sample-options.png -------------------------------------------------------------------------------- /layer-group/layer-groups.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layer-group/layer-groups.png -------------------------------------------------------------------------------- /layers/layer-in-timeline.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/layers/layer-in-timeline.png -------------------------------------------------------------------------------- /menu-bar/aseprite-menubar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/menu-bar/aseprite-menubar.png -------------------------------------------------------------------------------- /move-selection/contextbar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-selection/contextbar.png -------------------------------------------------------------------------------- /preferences/drag-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/drag-options.png -------------------------------------------------------------------------------- /preferences/edge-negative.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/edge-negative.png -------------------------------------------------------------------------------- /preferences/ui-one-window.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/ui-one-window.png -------------------------------------------------------------------------------- /rotate/rotation-algorithm.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/rotation-algorithm.gif -------------------------------------------------------------------------------- /sprite-editor/right-click.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-editor/right-click.png -------------------------------------------------------------------------------- /sprite-sheet/running-guy.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy.gif -------------------------------------------------------------------------------- /sprite/sprite-components.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite/sprite-components.png -------------------------------------------------------------------------------- /symmetry/horizontal-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/horizontal-icon.png -------------------------------------------------------------------------------- /symmetry/symmetry-buttons.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/symmetry-buttons.png -------------------------------------------------------------------------------- /animation/configure-timeline.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/animation/configure-timeline.png -------------------------------------------------------------------------------- /color-bar/color-warning-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color-bar/color-warning-icon.png -------------------------------------------------------------------------------- /context-bar/movingselection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/context-bar/movingselection.png -------------------------------------------------------------------------------- /debug/macos-1-open-spotlight.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/debug/macos-1-open-spotlight.png -------------------------------------------------------------------------------- /debug/macos-2-open-terminal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/debug/macos-2-open-terminal.png -------------------------------------------------------------------------------- /exporting/file-export-resize.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/exporting/file-export-resize.png -------------------------------------------------------------------------------- /eyedropper/eyedropper-group.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/eyedropper/eyedropper-group.png -------------------------------------------------------------------------------- /move-tool/move-multiple-cels.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-tool/move-multiple-cels.gif -------------------------------------------------------------------------------- /new-frame/new-frame-button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/new-frame/new-frame-button.png -------------------------------------------------------------------------------- /new-layer/layer-right-click.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/new-layer/layer-right-click.png -------------------------------------------------------------------------------- /preferences/crosshair-types.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/crosshair-types.png -------------------------------------------------------------------------------- /preferences/ui-multi-window.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/ui-multi-window.png -------------------------------------------------------------------------------- /preview-window/play-button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preview-window/play-button.png -------------------------------------------------------------------------------- /rotate/pivot-point-settings.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/pivot-point-settings.gif -------------------------------------------------------------------------------- /rotate/rotate-menu-options.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/rotate-menu-options.gif -------------------------------------------------------------------------------- /rotate/rotation-algorithms.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/rotation-algorithms.png -------------------------------------------------------------------------------- /selecting/replace-selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/selecting/replace-selection.png -------------------------------------------------------------------------------- /selecting/subtract-selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/selecting/subtract-selection.png -------------------------------------------------------------------------------- /sprite-editor/sprite-editor.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-editor/sprite-editor.png -------------------------------------------------------------------------------- /steam/steam-2-launch-options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/steam/steam-2-launch-options.png -------------------------------------------------------------------------------- /steam/steam-3-debug-option.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/steam/steam-3-debug-option.png -------------------------------------------------------------------------------- /steam/steam-3-disable-wintab.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/steam/steam-3-disable-wintab.png -------------------------------------------------------------------------------- /symmetry/draw-with-symmetry.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/symmetry/draw-with-symmetry.gif -------------------------------------------------------------------------------- /tools/filled-rectangle-tool.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/tools/filled-rectangle-tool.png -------------------------------------------------------------------------------- /workspace/drag-and-drop-tabs.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/workspace/drag-and-drop-tabs.gif -------------------------------------------------------------------------------- /continuous-layers/broken-layer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/continuous-layers/broken-layer.png -------------------------------------------------------------------------------- /continuous-layers/cont-vs-dis.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/continuous-layers/cont-vs-dis.png -------------------------------------------------------------------------------- /move-selection/move-selection.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/move-selection/move-selection.gif -------------------------------------------------------------------------------- /preview-window/preview-window.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preview-window/preview-window.png -------------------------------------------------------------------------------- /rotate/pivot-point-context-bar.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/pivot-point-context-bar.png -------------------------------------------------------------------------------- /rotate/pivot-point-mouse-move.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/rotate/pivot-point-mouse-move.gif -------------------------------------------------------------------------------- /selecting/intersect-selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/selecting/intersect-selection.png -------------------------------------------------------------------------------- /sprite-sheet/running-guy-horz.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy-horz.png -------------------------------------------------------------------------------- /sprite-sheet/running-guy-vert.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy-vert.png -------------------------------------------------------------------------------- /steam/steam-1-open-properties.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/steam/steam-1-open-properties.png -------------------------------------------------------------------------------- /animation/enable-onion-skinning.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/animation/enable-onion-skinning.gif -------------------------------------------------------------------------------- /animation/onion-skinning-settings.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/animation/onion-skinning-settings.gif -------------------------------------------------------------------------------- /data-recovery/in-sessions-folder.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/data-recovery/in-sessions-folder.png -------------------------------------------------------------------------------- /data-recovery/recover-files-tab.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/data-recovery/recover-files-tab.png -------------------------------------------------------------------------------- /default-palette/save-as-default.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/default-palette/save-as-default.gif -------------------------------------------------------------------------------- /exporting/file-export-sel-frame.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/exporting/file-export-sel-frame.png -------------------------------------------------------------------------------- /keyboard-shortcuts/hand-shortcuts.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/keyboard-shortcuts/hand-shortcuts.png -------------------------------------------------------------------------------- /preferences/brush-preview-types.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/brush-preview-types.gif -------------------------------------------------------------------------------- /preferences/move-selection-edges.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/move-selection-edges.gif -------------------------------------------------------------------------------- /preferences/nonlinear-undohistory.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/nonlinear-undohistory.gif -------------------------------------------------------------------------------- /sprite-sheet/running-guy-export.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy-export.png -------------------------------------------------------------------------------- /sprite-sheet/running-guy-matrix.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy-matrix.png -------------------------------------------------------------------------------- /timeline/timeline-copy-and-paste.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/timeline/timeline-copy-and-paste.gif -------------------------------------------------------------------------------- /continuous-layers/continuous-layer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/continuous-layers/continuous-layer.png -------------------------------------------------------------------------------- /data-recovery/home-tab-after-crash.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/data-recovery/home-tab-after-crash.png -------------------------------------------------------------------------------- /debug/win-3-right-click-properties.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/debug/win-3-right-click-properties.png -------------------------------------------------------------------------------- /frame-duration/timeline-right-click.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/frame-duration/timeline-right-click.gif -------------------------------------------------------------------------------- /sprite-properties/sprite-properties.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-properties/sprite-properties.png -------------------------------------------------------------------------------- /sprite-sheet/running-guy-import-01.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy-import-01.png -------------------------------------------------------------------------------- /sprite-sheet/running-guy-import-02.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/sprite-sheet/running-guy-import-02.png -------------------------------------------------------------------------------- /data-recovery/recover-data-preferences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/data-recovery/recover-data-preferences.png -------------------------------------------------------------------------------- /data-recovery/sessions-folder-focused.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/data-recovery/sessions-folder-focused.png -------------------------------------------------------------------------------- /keyboard-shortcuts/mouse-wheel-custom.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/keyboard-shortcuts/mouse-wheel-custom.png -------------------------------------------------------------------------------- /new-sprite/new-sprite-from-selection.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/new-sprite/new-sprite-from-selection.gif -------------------------------------------------------------------------------- /color-profile/color-management-preferences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/color-profile/color-management-preferences.png -------------------------------------------------------------------------------- /preferences/keep-selection-deleted-content.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/preferences/keep-selection-deleted-content.gif -------------------------------------------------------------------------------- /transparent-color/transparent-color-property.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/aseprite/docs/HEAD/transparent-color/transparent-color-property.png -------------------------------------------------------------------------------- /status-bar.md: -------------------------------------------------------------------------------- 1 | # Status Bar 2 | 3 | The status bar is the region at the bottom of the screen: 4 | 5 | ![Statusbar Overview](status-bar/overview.png) 6 | 7 | It shows different content depending on the active mouse position. 8 | -------------------------------------------------------------------------------- /rotate-canvas.md: -------------------------------------------------------------------------------- 1 | # Rotate Canvas 2 | 3 | You can rotate the [whole canvas](canvas.md) using *Sprite > Rotate Canvas* menu. The available options are: 4 | 5 | * 180 6 | * 90 CW 7 | * 90 CCW 8 | 9 | ![Rotate Canvas Preview](canvas/canvas-rotate.gif) 10 | -------------------------------------------------------------------------------- /.github/workflows/pdf/header.tex: -------------------------------------------------------------------------------- 1 | \usepackage{listings} 2 | \usepackage{fancyhdr} 3 | \pagestyle{fancy} 4 | \title{Aseprite Documentation} 5 | \setkeys{Gin}{scale=1, height=0.4\textheight, keepaspectratio} 6 | \let\verbatim\undefined\let\verbatimend\undefined\lstnewenvironment{verbatim}{\lstset{breaklines}}{} 7 | -------------------------------------------------------------------------------- /reverse-frames.md: -------------------------------------------------------------------------------- 1 | # Reverse Frames 2 | 3 | You can reverse frames selecting a range of frames in the 4 | [timeline](timeline.md) and using the *Frame > Reverse Frames* menu 5 | option. 6 | 7 | --- 8 | 9 | **SEE ALSO** 10 | 11 | [Animation](animation.md) | 12 | [Timeline](timeline.md) 13 | -------------------------------------------------------------------------------- /numeric-field.md: -------------------------------------------------------------------------------- 1 | # Numeric Field 2 | 3 | Numeric fields on Aseprite can evaluate simple math expressions: 4 | 5 | ![Math demo in numeric field](numeric-field/math.gif) 6 | 7 | --- 8 | 9 | **SEE ALSO** 10 | 11 | [UI Controls](ui-controls.md) | 12 | [New Sprite](new-sprite.md) | 13 | [Issue #1762](https://github.com/aseprite/aseprite/issues/1762) 14 | -------------------------------------------------------------------------------- /new-layer.md: -------------------------------------------------------------------------------- 1 | # New Layer 2 | 3 | Add new layers using *Layer > New > New Layer* menu (`Shift+N` key). Also 4 | you can right-click a layer in the [timeline](timeline.md) and 5 | select *New* option: 6 | 7 | ![Layer right-click](new-layer/layer-right-click.png) 8 | 9 | --- 10 | 11 | **SEE ALSO** 12 | 13 | [Layers](layers.md) | 14 | [Timeline](timeline.md) 15 | -------------------------------------------------------------------------------- /flip.md: -------------------------------------------------------------------------------- 1 | # Flip Sprite or Selection 2 | 3 | ## Flip Horizontal 4 | 5 | To flip the sprite or selection horizontally, you can select *Edit > Flip Horizontal* menu (Shift+H). 6 | 7 | ## Flip Vertical 8 | 9 | To flip the sprite or selection vertically, you can select *Edit > Flip Vertical* menu (Shift+V). 10 | 11 | ![Flip preview](flip/flip.gif) 12 | -------------------------------------------------------------------------------- /flip-canvas.md: -------------------------------------------------------------------------------- 1 | # Flip Canvas 2 | 3 | ## Flip Canvas Horizontal 4 | 5 | To flip the canvas horizontally, you can select *Sprite > Rotate Canvas > Flip Canvas Horizontal* menu. 6 | 7 | ## Flip Canvas Vertical 8 | 9 | To flip the canvas vertically, you can select *Sprite > Rotate Canvas > Flip Canvas Vertical* menu. 10 | 11 | ![Flip Canvas Preview](canvas/canvas-flip.gif) 12 | -------------------------------------------------------------------------------- /resize.md: -------------------------------------------------------------------------------- 1 | # Resize Sprite or Selection 2 | 3 | You can resize your sprite using *Sprite > Sprite Size* menu option. 4 | 5 | > Note: Resizing a sprite resizes all slices accordingly, changing their position and size. 6 | 7 | ![Resize](resize/resize.gif) 8 | 9 | You can resize a selection using handles. 10 | 11 | ![Resize selection using handles](resize/resize-selection.gif) 12 | -------------------------------------------------------------------------------- /sprite-size.md: -------------------------------------------------------------------------------- 1 | # Sprite Size 2 | 3 | The sprite size is specified when you create a new sprite from *File > New* menu. 4 | But you can change it in several ways. You can change: 5 | 6 | * [Canvas size](canvas.md) 7 | * [Resize sprite content](resize.md) 8 | 9 | Also you can use the [Command Line Interface](cli.md#resize-one-sprite-to-several-dimensions) for the same purpose. 10 | -------------------------------------------------------------------------------- /right-click.md: -------------------------------------------------------------------------------- 1 | # Right-click 2 | 3 | By default, Right click paints with the [Background Color](color-bar.md#background-color), 4 | but you can change this configuration from *Edit > Preferences > Editor*: 5 | 6 | ![Right-click Preferences](sprite-editor/right-click.png) 7 | 8 | --- 9 | 10 | **SEE ALSO** 11 | 12 | [Basics](basics.md) | 13 | [Sprite Editor](sprite-editor.md) 14 | -------------------------------------------------------------------------------- /loop.md: -------------------------------------------------------------------------------- 1 | # Loop 2 | 3 | ## Set loop section 4 | 5 | After selecting a range of frames in the [timeline](timeline.md), 6 | you can use the *View > Set Loop Section* menu (F2 key) to set the 7 | animation loop section: 8 | 9 | ![Loop Section](loop/loop-section.gif) 10 | 11 | The loop section is just like a regular [tag](tags.md) named "Loop." 12 | 13 | --- 14 | 15 | **SEE ALSO** 16 | 17 | [Tags](tags.md) 18 | -------------------------------------------------------------------------------- /move-layers.md: -------------------------------------------------------------------------------- 1 | # Move Layers 2 | 3 | Use the [timeline](timeline.md) to move layers: 4 | 5 | ![Move Layers](move-layers/move-layers.gif) 6 | 7 | 1. Select a range of layers you want to move. 8 | 2. Put the mouse above the selection border. 9 | 3. Start dragging the from selection border. 10 | 4. Drop the layers where you want. 11 | 12 | --- 13 | 14 | **SEE ALSO** 15 | 16 | [Copy Layers](copy-layers.md) | 17 | [Timeline](timeline.md) 18 | -------------------------------------------------------------------------------- /move-frames.md: -------------------------------------------------------------------------------- 1 | # Move Frames 2 | 3 | Use the [timeline](timeline.md) to move frames: 4 | 5 | ![Move Frames](move-frames/move-frames.gif) 6 | 7 | 1. Select a range of frames you want to move. 8 | 2. Put the mouse above the selection border. 9 | 3. Start dragging the from selection border. 10 | 4. Drop the frames where you want. 11 | 12 | --- 13 | 14 | **SEE ALSO** 15 | 16 | [Copy Frames](copy-frames.md) | 17 | [Move Cels](move-cels.md) | 18 | [Timeline](timeline.md) 19 | -------------------------------------------------------------------------------- /tool-bar.md: -------------------------------------------------------------------------------- 1 | # Tool Bar 2 | 3 | The tool bar contains several tools that you can use for different purposes: 4 | 5 | * [Paint](drawing.md) ![Pencil Icon](tools/pencil-tool.png) 6 | * [Pick colors](eyedropper.md) ![Eyedropper Icon](tools/eyedropper-tool.png) 7 | * [Zoom](zoom.md) ![Zoom Icon](tools/zoom-tool.png) 8 | * [Select and transform regions](selecting.md) ![Marquee Tool Icon](tools/marquee-tool.png) 9 | * [Show Timeline](timeline.md) ![Timeline Icon](tools/timeline.png) 10 | -------------------------------------------------------------------------------- /default-palette.md: -------------------------------------------------------------------------------- 1 | # Default Palette 2 | 3 | New sprites are created with the default palette. This default palette is [Richard 4 | "DawnBringer" Fhager 32 colors palette](http://pixeljoint.com/forum/forum_posts.asp?TID=16247) 5 | initially. 6 | 7 | Anyway you can change it using the ☰ *> Save Palette as Default* menu option: 8 | 9 | ![Save Palette as Default demo](default-palette/save-as-default.gif) 10 | 11 | --- 12 | 13 | **SEE ALSO** 14 | 15 | [New Sprite](new-sprite.md) 16 | -------------------------------------------------------------------------------- /frame-duration.md: -------------------------------------------------------------------------------- 1 | # Frame Duration 2 | 3 | You can change the duration of the current frame with *Frame > Frame 4 | Properties* menu (P key). 5 | 6 | Also you change the duration of several frames selecting a range of 7 | frames in the [Timeline](timeline.md), right clicking them, and 8 | selecting *Properties* option in the popup: 9 | 10 | ![Timeline Right Click](frame-duration/timeline-right-click.gif) 11 | 12 | --- 13 | 14 | **SEE ALSO** 15 | 16 | [Animation](animation.md) 17 | -------------------------------------------------------------------------------- /copy-layers.md: -------------------------------------------------------------------------------- 1 | # Copy Layers 2 | 3 | Use the [timeline](timeline.md) to copy layers: 4 | 5 | ![Copy layers](copy-layers/copy-layers.gif) 6 | 7 | 1. Select a range of layers you want to copy. 8 | 2. Move the mouse to the selection border. 9 | 3. Hold Ctrl or Alt key and start dragging. 10 | 4. Drop the copy where you want, holding Ctrl or Alt keys. 11 | 12 | --- 13 | 14 | **SEE ALSO** 15 | 16 | [Move Layers](move-layers.md) | 17 | [Timeline](timeline.md) 18 | -------------------------------------------------------------------------------- /eraser.md: -------------------------------------------------------------------------------- 1 | # Eraser 2 | 3 | Erase pixels with the 4 | [background color](color-bar.md#background-color) when used on the 5 | [background layer](layers.md#background-layer), and with the 6 | transparent color on 7 | [transparent layers](layers.md#transparent-layers). 8 | 9 | If you use the Eraser tool with the right-click, it will replace the 10 | [foreground color](color-bar.md#foreground-color) with the 11 | [background color](color-bar.md#background-color). 12 | 13 | --- 14 | 15 | **SEE ALSO** 16 | 17 | [Drawing](drawing.md) | 18 | [Color bar](color-bar.md) | 19 | [Layers](layers.md) 20 | -------------------------------------------------------------------------------- /.github/workflows/pdf/title.tex: -------------------------------------------------------------------------------- 1 | \date{\today} 2 | \maketitle 3 | \lhead{Aseprite Documentation} 4 | \rhead{\today} 5 | \begin{center} 6 | This is the PDF version of the \href{https://aseprite.org/docs/}{online Aseprite documentation}. 7 | The latest version of this document can be downloaded from the \href{https://github.com/aseprite/docs/}{docs GitHub repository}. 8 | 9 | Some images in this document are GIF animations, which can not be played when embedded in a PDF. 10 | GIFs are linked to their online counterpart, so you can click the image to view the animation in your browser. 11 | \end{center} 12 | -------------------------------------------------------------------------------- /open.md: -------------------------------------------------------------------------------- 1 | # Open 2 | 3 | You can load your sprite and continue working on it using *File > Open* menu. 4 | 5 | ## Loading image sequences 6 | 7 | If you have a sequence of images like: 8 | 9 | * `frame0.png` 10 | * `frame1.png` 11 | * `frame2.png` 12 | * ... 13 | * `frameN.png` 14 | 15 | You can load this sequence as one animation using *File > Open* menu, 16 | selecting `frame0.png`, and then answering *Yes* to the following 17 | dialog that will appear: 18 | 19 | ![Load sequence confirmation](open/loadsequence.png) 20 | 21 | --- 22 | 23 | **SEE ALSO** 24 | 25 | [Save](save.md) | 26 | [Exporting](exporting.md) 27 | -------------------------------------------------------------------------------- /.github/workflows/pdf/link-gifs.lua: -------------------------------------------------------------------------------- 1 | function Image(img) 2 | if img.src:match("^.+(%..+)$") == ".gif" then 3 | local link 4 | 5 | if string.find(img.src, "www") then 6 | -- Image source is already a URL 7 | link = "https:" .. img.src 8 | else 9 | -- Image source is a local file 10 | link = "https://aseprite.org/docs/" .. img.src 11 | end 12 | 13 | return pandoc.Link( 14 | pandoc.Image(img.caption, img.src, img.title, img.attr), 15 | link 16 | ) 17 | else 18 | return img 19 | end 20 | end 21 | -------------------------------------------------------------------------------- /sidebar.md: -------------------------------------------------------------------------------- 1 | ### Table of content 2 | 3 | [Overview](overview.md) 4 | 5 | [Basics](basics.md) 6 | * [Image & Sprite](sprite.md) 7 | * [Color](color.md) 8 | * [Drawing](drawing.md) 9 | * [Selecting](selecting.md) 10 | * [Transformations](transformations.md) 11 | 12 | [Sprite](sprite.md) 13 | * [Layers](layers.md) 14 | * [Animation](animation.md) 15 | * [Tilemap](tilemap.md) 16 | * [Slices](slices.md) 17 | 18 | [Files](files.md) 19 | * [Save](save.md) 20 | * [Exporting](exporting.md) 21 | * [Sprite Sheet](sprite-sheet.md) 22 | * [CLI](cli.md) 23 | 24 | [Customization](customization.md) 25 | * [Preferences](preferences.md) 26 | * [Extensions](extensions.md) 27 | * [Scripting](scripting.md) 28 | -------------------------------------------------------------------------------- /tiled-mode.md: -------------------------------------------------------------------------------- 1 | # Tiled Mode 2 | 3 | The *Tiled Mode* is a simple method to draw patterns quickly, you can 4 | access it from *View > Tiled Mode* submenu. 5 | 6 | This mode is simpler than [tilemaps](tilemap.md), which offer a more 7 | extensive way to create levels using repeated tiles in any possible 8 | arrangement. 9 | 10 | 11 | 12 | --- 13 | 14 | **SEE ALSO** 15 | 16 | [Drawing](drawing.md) | 17 | [Tilemap](tilemap.md) 18 | -------------------------------------------------------------------------------- /range.md: -------------------------------------------------------------------------------- 1 | # Selected Range 2 | 3 | In the [timeline](timeline.md) you can select a range of frames: 4 | 5 | Frames Range 6 | 7 | A range of layers: 8 | 9 | Layers Range 10 | 11 | Or a range of cels: 12 | 13 | Cels Range 14 | 15 | After selecting the range you can do several operations with it like: 16 | 17 | * [moving frames](move-frames.md) or [tagging frames](tags.md), or 18 | * [changing the order of layers](move-layers.md), or 19 | * [moving cels](move-cels.md). 20 | 21 | --- 22 | 23 | **SEE ALSO** 24 | 25 | [Timeline](timeline.md) 26 | -------------------------------------------------------------------------------- /focus-tag.md: -------------------------------------------------------------------------------- 1 | # Focus Tag 2 | 3 | The [timeline](timeline.md) has the possibility to focus 4 | [a tag](tags.md), actually a *"tag band."* We define a 5 | *"tag band"* as these rows where several tags are grouped: 6 | 7 | ![Tag Bands](focus-tag/bands.gif) 8 | 9 | You can double-click one of these bands or press the little button at 10 | the right side to "focus" the tags in this band (and hide all others): 11 | 12 | ![Focus Band](focus-tag/focus.gif) 13 | 14 | When you do this, the Play button ![Play icon](animation/play-button.png) 15 | will reproduce only tags found in the currently focused band. 16 | 17 | --- 18 | 19 | **SEE ALSO** 20 | 21 | [Tags](tags.md) | 22 | [Timeline](timeline.md) | 23 | [Animation](animation.md) 24 | -------------------------------------------------------------------------------- /canvas.md: -------------------------------------------------------------------------------- 1 | # Canvas Size 2 | 3 | The canvas is the visible area of the sprite. You can change the 4 | canvas size using *Sprite > Canvas Size...* menu. 5 | 6 | > Note: Resizing the canvas updates all slices accordingly, changing their position. 7 | 8 | ![Canvas Preview](canvas/canvas.gif) 9 | 10 | In this window you can change the `Width` or `Height` manually, or 11 | using the blue rules in the editor window. 12 | 13 | ## Crop 14 | 15 | You can change the canvas size using the current selection bounds: 16 | 17 | ![Crop Preview](canvas/crop.gif) 18 | 19 | ## Trim 20 | 21 | You can remove transparent borders automatically from the canvas 22 | using the *Sprite > Trim* menu. 23 | 24 | ![Trim Preview](canvas/canvas-trim.gif) 25 | -------------------------------------------------------------------------------- /preview-window.md: -------------------------------------------------------------------------------- 1 | # Preview Window 2 | 3 | The preview window is the little window that can show you the 4 | animation preview in realtime while you edit your animation: 5 | 6 | Preview Window 7 | 8 | You can show/hide this little window pressing the F7 key or with the 9 | *View > Preview* menu option. 10 | 11 | You can also press the little play button ![Play 12 | button](preview-window/play-button.png) or press Shift+Enter to 13 | start playing the sprite animation (or the current [tag](tags.md)) in 14 | the window. 15 | 16 | --- 17 | 18 | **SEE ALSO** 19 | 20 | [Workspace](workspace.md) | 21 | [Drawing](drawing.md) | 22 | [Animation](animation.md) 23 | -------------------------------------------------------------------------------- /copy-frames.md: -------------------------------------------------------------------------------- 1 | # Copy Frames 2 | 3 | Use the [timeline](timeline.md) to copy frames: 4 | 5 | ![Copy frames](copy-frames/copy-frames.gif) 6 | 7 | 1. Select a range of frames you want to copy. 8 | 2. Move the mouse to the selection border. 9 | 3. Hold Ctrl or Alt key and start dragging. 10 | 4. Drop the copy where you want, holding Ctrl or Alt keys. 11 | 12 | Note that you can copy frames beyond the end of the animation, extending it. 13 | 14 | When copying frames on a [continuous layer](continuous-layers.md), copied cels will be [linked](linked-cels.md) to the original ones. 15 | 16 | --- 17 | 18 | **SEE ALSO** 19 | 20 | [Move Frames](move-frames.md) | 21 | [Copy Cels](copy-cels.md) | 22 | [Timeline](timeline.md) 23 | -------------------------------------------------------------------------------- /layer-group.md: -------------------------------------------------------------------------------- 1 | # Layer Group 2 | 3 | To better organize your sprite, you can group a set of layers in a little folder: 4 | 5 | ![Layer Groups](layer-group/layer-groups.png) 6 | 7 | With groups you can show/hide (Shift+X) or lock/unlock 8 | several layers at the same time, or expand/collapse the folder 9 | in the [timeline](timeline.md) (Shift+E) 10 | 11 | To create a new *Layer Group* you can use the *Layer > New > New 12 | Group* menu, or pressing Alt+Shift+N shortcut. If there is 13 | a [selected range of layers](range.md) in the [timeline](timeline.md), 14 | the new group will be created containing those selected layers 15 | automatically. 16 | 17 | --- 18 | 19 | **SEE ALSO** 20 | 21 | [Layers](layers.md) | 22 | [Timeline](timeline.md) 23 | -------------------------------------------------------------------------------- /copy-cels.md: -------------------------------------------------------------------------------- 1 | # Copy Cels 2 | 3 | Use the [timeline](timeline.md) to copy cels: 4 | 5 | ![Copy cels](copy-cels/copy-cels.gif) 6 | 7 | 1. Select a range of cels you want to copy. 8 | 2. Move the mouse to the selection border. 9 | 3. Hold Ctrl or Alt key and start dragging. 10 | 4. Drop the copy where you want, holding Ctrl or Alt keys. 11 | 12 | Note that you can copy cels beyond the end of the animation. In this 13 | case new empty frames are created automatically. 14 | 15 | When copying cels on a [continuous layer](continuous-layers.md), copied cels will be [linked](linked-cels.md) to the original ones. 16 | 17 | --- 18 | 19 | **SEE ALSO** 20 | 21 | [Move Cels](move-cels.md) | 22 | [Copy Frames](copy-frames.md) | 23 | [Timeline](timeline.md) 24 | -------------------------------------------------------------------------------- /move-cels.md: -------------------------------------------------------------------------------- 1 | # Move Cels 2 | 3 | Use the [timeline](timeline.md) to move cels: 4 | 5 | ![Move Cels](move-cels/move-cels.gif) 6 | 7 | 1. Select a range of cels you want to move. 8 | 2. Put the mouse above the selection border. 9 | 3. Start dragging the from selection border. 10 | 4. Drop the cels where you want. 11 | 12 | Note that you can move cels beyond the end of the animation. In this 13 | case new empty frames are created automatically. 14 | 15 | ## Canvas Position 16 | 17 | You can move the cel canvas position (*x* and *y* coordinates) using 18 | the [Move tool](move-tool.md) ![Move tool icon](tools/move-tool.png). 19 | 20 | --- 21 | 22 | **SEE ALSO** 23 | 24 | [Copy Cels](copy-cels.md) | 25 | [Move Frames](move-frames.md) | 26 | [Move Tool](move-tool.md) | 27 | [Timeline](timeline.md) 28 | -------------------------------------------------------------------------------- /extensions/palettes.md: -------------------------------------------------------------------------------- 1 | # Extensions: Palettes 2 | 3 | Content a `.aseprite-extension` file for a palette extension: 4 | 5 | ``` 6 | palette-example.aseprite-extension 7 | | 8 | +-- package.json 9 | | 10 | +-- my-palette.gpl 11 | ``` 12 | 13 | Content of `package.json`: 14 | 15 | ``` 16 | { 17 | "name": "palette-example", 18 | "displayName": "Palette Example", 19 | "description": "Palette created by Full Name", 20 | "version": "1.0", 21 | "author": { "name": "Full Name", "url": "https://twitter.com/your_username_or_homepage_url" }, 22 | "categories": [ 23 | "Palettes" 24 | ], 25 | "contributes": { 26 | "palettes": [ 27 | { "id": "Palette-Example", "path": "./my-palette.gpl" } 28 | ] 29 | } 30 | } 31 | ``` 32 | 33 | --- 34 | 35 | **SEE ALSO** 36 | 37 | [Extensions](extensions.md) 38 | -------------------------------------------------------------------------------- /scripting.md: -------------------------------------------------------------------------------- 1 | # Scripting 2 | 3 | **[Aseprite v1.2.10-beta2](https://www.aseprite.org/release-notes/#aseprite-v1-2-10-beta10)** 4 | introduced the possibility to write scripts with Lua: 5 | 6 | * [API Reference](https://github.com/aseprite/api#aseprite-api) 7 | * [Known issues and report bugs](https://github.com/aseprite/api/issues) 8 | 9 | Scripts are located in the [user scripts folder](https://community.aseprite.org/t/locate-user-scripts-folder/2170) 10 | that you can easily locate going to *File > Scripts > Open Script Folder*. 11 | 12 | Script Examples: 13 | 14 | * [Aseprite Script Examples](https://community.aseprite.org/t/aseprite-script-examples/2611) 15 | * [Touch Toolbar helper](https://community.aseprite.org/t/touch-toolbar-helper/2169) 16 | 17 | --- 18 | 19 | **SEE ALSO** 20 | 21 | [Extensions](extensions.md) 22 | -------------------------------------------------------------------------------- /customization.md: -------------------------------------------------------------------------------- 1 | # Customization 2 | 3 | You can change the most common Aseprite configuration from these menus: 4 | 5 | * *Edit > [Preferences](preferences.md)* (Ctrl+K key, or on macOS: ⌘K or ⌘,) 6 | * *Edit > [Keyboard Shortcuts](keyboard-shortcuts.md)* (Ctrl+Alt+Shift+K or ⌥⇧⌘K on macOS) 7 | 8 | Other ways of customization are more advanced and require downloading 9 | some file (extensions or script) and installing it from *Edit > 10 | Preferences > Extensions* or *File > Scripts > Open Scripts Folder*: 11 | 12 | * [Extensions](extensions.md) 13 | * [Keys](extensions/keys.md) 14 | * [Languages](extensions/languages.md) 15 | * [Themes](extensions/themes.md) 16 | * [Scripting](scripting.md) 17 | 18 | --- 19 | 20 | **SEE ALSO** 21 | 22 | [Overview](overview.md) 23 | -------------------------------------------------------------------------------- /ui-controls.md: -------------------------------------------------------------------------------- 1 | # UI Controls 2 | 3 | Here we show some general information about controls/fields you will 4 | find on the Aseprite User Interface (UI). 5 | 6 | * [Sprite Editor](sprite-editor.md) 7 | * [Timeline](timeline.md) 8 | * [Workspace](workspace.md) 9 | * [Color Bar](color-bar.md) 10 | 11 | ## Math in Number Fields 12 | 13 | [Numeric fields](numeric-field.md) on Aseprite can evaluate simple math expressions: 14 | 15 | ![Math demo in number fields](numeric-field/math.gif) 16 | 17 | ## Drag and Drop Workspace Tabs 18 | 19 | You can drag-and-drop tabs [in the workspace](workspace.md), duplicate 20 | them using the Ctrl or Alt keys along with the 21 | Left Mouse Button: 22 | 23 | ![Drag and drop tabs demo](workspace/drag-and-drop-tabs.gif) 24 | 25 | --- 26 | 27 | **SEE ALSO** 28 | 29 | [Workspace](workspace.md) 30 | -------------------------------------------------------------------------------- /onion-skinning.md: -------------------------------------------------------------------------------- 1 | # Onion Skinning 2 | 3 | With [onion skinning](https://en.wikipedia.org/wiki/Onion_skinning) 4 | you can see several frames at once in the [sprite editor](sprite-editor.md). 5 | In this way you can use other frames as reference to draw the current one. 6 | You can activate the onion skinning using F3 key or with the little 7 | ![onion skinning](animation/onion-skinning.png) icon in the timeline: 8 | 9 | ![Enable onion skinning](animation/enable-onion-skinning.gif) 10 | 11 | You can specify how many previous and next frames do you want to see 12 | and configure other settings from the 13 | ![Configure Timeline](animation/configure-timeline.png) icon (like red/blue tint): 14 | 15 | ![Change onion skinning settings](animation/onion-skinning-settings.gif) 16 | 17 | --- 18 | 19 | **SEE ALSO** 20 | 21 | [Animation](animation.md) | 22 | [Timeline](timeline.md) 23 | -------------------------------------------------------------------------------- /save.md: -------------------------------------------------------------------------------- 1 | # Save 2 | 3 | You can save your sprite using the *File > Save* menu or pressing Ctrl+S (⌘S on macOS). 4 | 5 | We highly recommend you to save your sprites in the 6 | [.aseprite](files.md#aseprite) format, so you keep the full sprite 7 | information intact ([layers](layers.md), [frames](frames.md), 8 | etc.). But you can save your sprite as other file types if you don't 9 | need all this information. For example, you can [open](open.md) a 10 | `.png` file, editing it, and save it again as `.png` (without using 11 | the `.aseprite` format). 12 | 13 | ## Export 14 | 15 | If you want to export your sprite as a `.png` file or a `.gif` 16 | animation, you can use the *File > Export* option. See the 17 | [Exporting](/docs/exporting/) section for more information. 18 | 19 | --- 20 | 21 | **SEE ALSO** 22 | 23 | [Open](open.md) | 24 | [Exporting](exporting.md) 25 | -------------------------------------------------------------------------------- /sprite-editor.md: -------------------------------------------------------------------------------- 1 | # Sprite Editor 2 | 3 | The sprite editor is the first thing you will see when you create a 4 | [new sprite](new-sprite.md): 5 | 6 | ![Sprite Editor](sprite-editor/sprite-editor.png) 7 | 8 | On the sprite editor you can: 9 | 10 | 1. [Draw](drawing.md) with mouse clicks or a stylus/pen, or with one 11 | finger on a Windows Surface device. 12 | 1. [Zoom](zoom.md) with the mouse wheel or with a pinch-like gesture 13 | on a MacBook trackpad or the Windows Surface screen. 14 | 1. You can also scroll/pan with the mouse wheel and Shift key, or 15 | using two fingers in the MacBook trackpad or on Windows Surface 16 | screen. 17 | 18 | ### Preferences 19 | 20 | You can customize the Sprite Editor behavior from [*Edit > Preferences > Editor*](preferences.md#editor). 21 | 22 | --- 23 | 24 | **SEE ALSO** 25 | 26 | [Sprite](sprite.md) | 27 | [Timeline](timeline.md) | 28 | [Workspace](workspace.md) | 29 | [Basics](basics.md) 30 | -------------------------------------------------------------------------------- /tags.md: -------------------------------------------------------------------------------- 1 | # Tags 2 | 3 | A tag indicates an animation of your sprite. Using several tags you 4 | can organize different animations of your sprite: 5 | 6 | Tags 7 | 8 | To create a tag you can [select a range](range.md) of frames and use the *Frame > 9 | Tags > New Tag* menu option, or right-click the range and select *New 10 | Tag*, or press the *F2* key two times, i.e. the first time will create 11 | a [*"Loop"* tag](loop.md), the second time you press F2 will show the tag 12 | properties so you can change its name, etc.: 13 | 14 | Tag Properties 15 | 16 | The most interesting property of a tag is the *"Animation Direction"*, 17 | where you can specify three different modes to play the tag: 18 | *Forward*, *Reverse*, or *Ping-pong*. 19 | 20 | --- 21 | 22 | **SEE ALSO** 23 | 24 | [Animation](animation.md) | 25 | [Sprite](sprite.md) 26 | -------------------------------------------------------------------------------- /menu-bar.md: -------------------------------------------------------------------------------- 1 | # Menu Bar 2 | 3 | The Aseprite menu bar is the menu at the top of the [main window](workspace). 4 | 5 | ![Aseprite Menu Bar](menu-bar/aseprite-menubar.png) 6 | 7 | You can access the main functionality of Aseprite from this menu. 8 | Pressing Alt+underscored letter will open the given menu, 9 | e.g. Alt+F will open the *File* menu. After that you can 10 | press an underscored key to access submenus. E.g. Alt+F and 11 | then N will access *File > New* menu option. 12 | 13 | On macOS this bar is hidden by default as you can use the macOS menu 14 | at the top of the screen: 15 | 16 | ![macOS Menu Bar](menu-bar/macos-menubar.png) 17 | 18 | Anyway you can show the Aseprite menu bar by checking the [*Edit > 19 | Preferences > General > Show Aseprite menu 20 | bar*](preferences.md#general) option. 21 | 22 | --- 23 | 24 | **SEE ALSO** 25 | 26 | [Workspace](workspace.md) | 27 | [Preferences](preferences.md) 28 | -------------------------------------------------------------------------------- /move-selection.md: -------------------------------------------------------------------------------- 1 | # Move Selection 2 | 3 | After [selecting](selecting.md) a part of the [active cel](cel.md), 4 | you can move the selected area of pixels dragging-and-dropping with 5 | the mouse or using the arrow keys: 6 | 7 | ![Move selection example](move-selection/move-selection.gif) 8 | 9 | If you are moving a region of pixels from the 10 | [background layer](layers.md#background-layer) the selection will be 11 | cleared with the active 12 | [background color](color-bar.md#background-color). If you move a 13 | transparent layer, the region will be cleared with the transparent 14 | color. 15 | 16 | When moving a selection, you can find transform options in the [context bar](context-bar.md). 17 | 18 | ![context bar example](move-selection/contextbar.png) 19 | 20 | - X-position 21 | - Y-position 22 | - Width 23 | - Height 24 | - Rotation 25 | - Skew 26 | 27 | These values can be edited through the context bar or by [transforming](transformations.md). 28 | 29 | 30 | 31 | 32 | -------------------------------------------------------------------------------- /extensions/dithering-matrices.md: -------------------------------------------------------------------------------- 1 | # Extensions: Dithering Matrices 2 | 3 | Content a `.aseprite-extension` file for a dithering matrix extension: 4 | 5 | ``` 6 | dithering-matrix-example.aseprite-extension 7 | | 8 | +-- package.json 9 | | 10 | +-- matrix1.png 11 | +-- matrix2.png 12 | +-- ... 13 | ``` 14 | 15 | Content of `package.json` file: 16 | 17 | ```json 18 | { 19 | "name": "my-matrices", 20 | "displayName": "My Dithering Matrices", 21 | "description": "Dithering matrices created by ...", 22 | "version": "1.0", 23 | "publisher": "yournickname", 24 | "contributes": { 25 | "ditheringMatrices": [ 26 | { 27 | "id": "matrix1", 28 | "name": "Matrix 1", 29 | "path": "./matrix1.png" 30 | }, 31 | { 32 | "id": "matrix2", 33 | "name": "Matrix 2", 34 | "path": "./matrix2.png" 35 | } 36 | ... 37 | ] 38 | } 39 | } 40 | ``` 41 | 42 | --- 43 | 44 | **SEE ALSO** 45 | 46 | [Extensions](extensions.md) 47 | -------------------------------------------------------------------------------- /drag-value.md: -------------------------------------------------------------------------------- 1 | # Drag Value 2 | 3 | Since **v1.3-beta12**, from *Edit > Keyboard Shortcuts > Drag Value*, 4 | you can configure a key to be pressed and move/drag the mouse in a 5 | specific direction (e.g. left/right or up/down) to change a specific 6 | value/parameter inside Aseprite until you release the key. 7 | 8 | By default, Ctrl+Alt is configured in such a way to 9 | increase/decrease the Brush Size moving the mouse from left to 10 | right/right to left: 11 | 12 | ![Drag Value Section](preferences/drag-value.png) 13 | 14 | The controls at the bottom indicates the direction of the increment 15 | (right) and the distance of pixels (4) that the mouse must travel to 16 | increment one unit (in this case one unit of the Brush Size). 17 | 18 | ![Controls](preferences/drag-options.png) 19 | 20 | --- 21 | 22 | **SEE ALSO** 23 | 24 | [Mouse Wheel](mouse-wheel.md) | 25 | [Keyboard Shortcuts](keyboard-shortcuts.md) | 26 | [Issue #3195](https://github.com/aseprite/aseprite/issues/3195) 27 | -------------------------------------------------------------------------------- /transparent-color.md: -------------------------------------------------------------------------------- 1 | # Transparent Color 2 | 3 | In [RGB](color-mode.md#rgb) and [Grayscale](color-mode.md#grayscale) 4 | sprites, transparent pixels are colors with `Alpha=0`, but in 5 | [Indexed](color-mode.md#indexed) color mode, there exist one specific 6 | and special index in the palette that will represent the transparent 7 | color for [transparent layers](layers.md#transparent-layers): 8 | 9 | ![Transparent Color](transparent-color/transparent-color-property.png) 10 | 11 | This means that pixels that refer to this specific index in the layer 12 | will not be visible (and only the background layer can show the 13 | "transparent color" as a solid color). 14 | 15 | You can change the transparent color using middle mouse button in the 16 | [color bar](color-bar.md), or 17 | going to [*Sprite > Properties*](sprite-properties.md) menu option. 18 | 19 | --- 20 | 21 | **SEE ALSO** 22 | 23 | [Color](color.md) | 24 | [Color Mode](color-mode.md) | 25 | [Sprite Properties](sprite-properties.md) 26 | -------------------------------------------------------------------------------- /new-sprite.md: -------------------------------------------------------------------------------- 1 | # New Sprite 2 | 3 | You can create a new sprite from *File > New* menu (Ctrl+N or ⌘N). 4 | 5 | ![New sprite dialog](new-sprite/newsprite.png) 6 | 7 | Here you select the sprite: 8 | 9 | * dimension (in pixels), 10 | * its [color mode](color-mode.md), and 11 | * the default background color. 12 | 13 | The sprite is created with a specific [palette by default](default-palette.md). 14 | 15 | ### Math in Numeric Fields 16 | 17 | [Numeric fields](numeric-field.md) like *Width* and *Height* can evaluate little math expressions: 18 | 19 | ![Math demo in numeric field](numeric-field/math.gif) 20 | 21 | ## New Sprite from Selection 22 | 23 | You can create a new sprite from the active selection using 24 | *Edit > New Sprite from Selection* (Ctrl+Alt+N or ⌥⌘N): 25 | 26 | ![New sprite from selection](new-sprite/new-sprite-from-selection.gif) 27 | 28 | --- 29 | 30 | **SEE ALSO** 31 | 32 | [Color Mode](color-mode.md) | 33 | [Default Palette](default-palette.md) 34 | -------------------------------------------------------------------------------- /shading.md: -------------------------------------------------------------------------------- 1 | # Shading 2 | 3 | The shading [ink](ink.md) can be used to create shadows in our sprites. We can 4 | use left and right click to move colors between a gradient (given by 5 | the selected colors in the [color bar](color-bar.md)): 6 | 7 | ![Shading reference](shading/shading_ref.png) 8 | 9 | The steps to use this ink are: 10 | 11 | First of all we draw something to add light or shadows with a base 12 | color: 13 | 14 | ![Draw base](shading/shading_step1.gif) 15 | 16 | Then we select the "Shading" ink mode, and select a set of colors from 17 | the palette, including the previously selected base color. This 18 | gradient will act as shadows and light: 19 | 20 | ![Select a gradient](shading/shading_step2.gif) 21 | 22 | You can use left click to move colors to the left of the gradient: 23 | 24 | ![Shading left click](shading/shading_step3.gif) 25 | 26 | Or you can use right click to move colors to the right: 27 | 28 | ![Shading right click](shading/shading_step4.gif) 29 | 30 | --- 31 | 32 | **SEE ALSO** 33 | 34 | [Drawing](drawing.md) | 35 | [Ink](ink.md) 36 | -------------------------------------------------------------------------------- /move-tool.md: -------------------------------------------------------------------------------- 1 | # Move Tool 2 | 3 | You can select the Move tool ![Move tool icon](tools/move-tool.png) 4 | with V key or using Ctrl key (or ⌘ on macOS). 5 | 6 | This tool is useful to move the *xy*-position of a [cel](cel.md). 7 | 8 | Notes: 9 | 10 | * You cannot move the Background layer. 11 | * Use Shift (⇧) key to lock x- or y-axis. 12 | 13 | ## Select and Move Layers 14 | 15 | When you use Ctrl (or ⌘) key and Left click, the Move tool is 16 | selected with the *Auto Select Layer* option checked: 17 | 18 | ![Autoselect option](move-tool/autoselect.png) 19 | 20 | This option allows you to select and move layers in a quickly way: 21 | 22 | ![Autoselect preview](move-tool/autoselect.gif) 23 | 24 | ## Move Multiple Cels 25 | 26 | You can move several cels at the same time using the timeline and the 27 | sprite editor together: 28 | 29 | 1. Select multiple cels in the timeline, and then 30 | 2. Move the cel in the sprite editor. 31 | 32 | ![Move multiple cels](move-tool/move-multiple-cels.gif) 33 | -------------------------------------------------------------------------------- /cel.md: -------------------------------------------------------------------------------- 1 | # Cel 2 | 3 | A cel (from [celluloid](http://en.wikipedia.org/wiki/Cel)) is one 4 | image in a specific frame and layer, at a specific *xy*-coordinate in 5 | the canvas. 6 | 7 | ![Cel on Timeline](cel/cel-on-timeline.png) 8 | 9 | The difference between a frame and a cel, is that a frame is the set of 10 | cels for all layers in a specific time: 11 | 12 | ![Frame on Timeline](cel/frame-on-timeline.png) 13 | 14 | ## Move a Cel 15 | 16 | You can use the [Move tool](move-tool.md) to drag-and-drop the current 17 | cel in the canvas. Or you can use the [Timeline to move the cel](move-cels.md) to 18 | other layer/frame position. 19 | 20 | ## Change Opacity 21 | 22 | On [RGB](color-mode.md#rgb) images each cel has its own opacity 23 | level. You can use the slider at the status bar to modify its opacity: 24 | 25 | ![Cel Opacity](cel/cel-opacity.gif) 26 | 27 | You can do the same right-clicking a cel and selecting *Properties* option (or *Frame > Cel Properties* menu): 28 | 29 | ![Cel Properties](cel/cel-properties.gif) 30 | 31 | ---- 32 | 33 | **SEE ALSO** 34 | 35 | [Linked Cels](linked-cels.md) | 36 | [Timeline](timeline.md) 37 | -------------------------------------------------------------------------------- /linked-cels.md: -------------------------------------------------------------------------------- 1 | # Linked Cels 2 | 3 | Two cels are linked when they share their image and the *xy*-coordinate. 4 | Linked cels looks as follow in the [timeline](timeline.md): 5 | 6 | ![Linked Cels](linked-cels/linked-cels.png) 7 | 8 | When you modify one of these cels, all linked cels are modified. In 9 | this way you can propagate the same change into several 10 | frames. E.g. If you have a static background, you would prefer linked 11 | cels, so you can make changes just in one cel to view the change in 12 | the whole animation. 13 | 14 | To create linked cels you have to 15 | [copy cels](copy-cels.md) 16 | in a [continuous layer](continuous-layers.md) 17 | (i.e. a layer with the Continuous icon ![Continuous icon](continuous-layers/continuous-layer.png)). 18 | 19 | ## Unlink Cels 20 | 21 | There is a way to unlink cels using right-click and *Unlink* option in 22 | the timeline: 23 | 24 | ![Unlink Cels](linked-cels/unlink-cels.gif) 25 | 26 | Unlinked cels will contain their own copy of the image. So now if you 27 | modify them the change will not be propagated to other cels. 28 | 29 | --- 30 | 31 | **SEE ALSO** 32 | 33 | [Continuous Layers](continuous-layers.md) 34 | -------------------------------------------------------------------------------- /symmetry.md: -------------------------------------------------------------------------------- 1 | # Symmetry 2 | 3 | To paint symmetrical sprites, you can use the Symmetry options available 4 | from from *View > Symmetry Options* menu. This will show you 5 | the following buttons in the [context bar](context-bar.md): 6 | 7 | ![Symmetry Options](symmetry/symmetry-buttons.png) 8 | 9 | * ![Horizontal Symmetry Icon](symmetry/horizontal-icon.png) Enables 10 | the Horizontal Symmetry 11 | * ![Vertical Symmetry Icon](symmetry/vertical-icon.png) Enables the 12 | Vertical Symmetry 13 | * ![Symmetry Options Icon](symmetry/options-icon.png) Shows a popup 14 | menu with a *Reset Symmetry to Center* option 15 | 16 | When you enable one symmetry axis (e.g. horizontal symmetry/vertical 17 | axis) you can drag-and-drop on-screen handles to configure the 18 | position of the axis: 19 | 20 | ![Drag symmetry handles](symmetry/drag-handles.gif) 21 | 22 | Then just drawing will paint in both sides of the image: 23 | 24 | ![Draw with symmetry](symmetry/draw-with-symmetry.gif) 25 | 26 | You can put the axis in the middle of a pixel if you need to: 27 | 28 | ![Symmetry in the middle of a pixel](symmetry/mid-pixel.gif) 29 | 30 | --- 31 | 32 | **SEE ALSO** 33 | 34 | [Drawing](drawing.md) 35 | -------------------------------------------------------------------------------- /zoom.md: -------------------------------------------------------------------------------- 1 | # Zoom tool 2 | 3 | You can zoom with the ![Zoom Tool](tools/zoom-tool.png) (Z 4 | key) using Left click and Right click to zoom-in 5 | and zoom-out respectively. Or pressing the left mouse button, and 6 | dragging the mouse from left to right to zoom-in, or right to left to 7 | zoom-out. 8 | 9 | You can also see/change the zoom level from the status bar slider: 10 | 11 | ![Zoom Text Field](zoom/zoom-text-field.png) 12 | ![Zoom Slider](zoom/zoom-slider.png) 13 | 14 | Or using other alternatives: 15 | 16 | * With keys 1, 2, 3, 4, 17 | 5, 6 (those above the QWERTY keys), to change the zoom to 18 | 100%, 200%, 400%, 800%, 1600%, 3200% respectively. 19 | * The mouse wheel ([details](https://github.com/aseprite/aseprite/issues/2896)). 20 | * Or since **v1.3-beta12**, you can [configure a key](drag-value.md) 21 | to zoom pressing a key (and hold it down) and move the mouse in a 22 | specific direction. 23 | 24 | --- 25 | 26 | **SEE ALSO** 27 | 28 | [Drawing](drawing.md) | 29 | [Drag Value](drag-value.md) | 30 | [Mouse Wheel Behavior](https://github.com/aseprite/aseprite/issues/2896) 31 | -------------------------------------------------------------------------------- /extensions/languages.md: -------------------------------------------------------------------------------- 1 | # Extensions: Languages 2 | 3 | This is an example of a possible extension to translate Aseprite to 4 | Spanish. The content a `.aseprite-extension` file for a language 5 | extension can be something like this: 6 | 7 | ``` 8 | spanish-language.aseprite-extension 9 | | 10 | +-- package.json 11 | +-- es.ini 12 | ``` 13 | 14 | Content of `package.json`, e.g.: 15 | 16 | ``` 17 | { 18 | "name": "spanish-language", 19 | "displayName": "Spanish Translation", 20 | "description": "Translation to Spanish Example by Full Name", 21 | "version": "1.0", 22 | "author": { "name": "Full Name", "url": "https://twitter.com/your_username_or_homepage_url" }, 23 | "categories": [ 24 | "Languages" 25 | ], 26 | "contributes": { 27 | "languages": [ 28 | { "id": "es", 29 | "path": "./es.ini", 30 | "displayName": "Español" } 31 | ] 32 | } 33 | } 34 | ``` 35 | 36 | The `contributes.languages.displayName` property was introduced in 37 | **Aseprite v1.3-rc5** to show the language instead of the language code/ID 38 | (e.g. `es`) in the *Edit > Preferences > General > Language* combobox. 39 | 40 | For the `contributes.languages.id` use an [ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). 41 | 42 | --- 43 | 44 | **SEE ALSO** 45 | 46 | [Extensions](extensions.md) 47 | -------------------------------------------------------------------------------- /workspace.md: -------------------------------------------------------------------------------- 1 | # Workspace 2 | 3 | You should become familiar with these window elements: 4 | 5 | Workspace Screenshot 6 | 7 | The most important elements are the 8 | [sprite editor](sprite-editor.md), the 9 | [timeline](timeline.md), the [color bar](color-bar.md), 10 | and the [preview window](preview-window.md). 11 | Other familiar elements are the [menu bar](menu-bar.md) and 12 | the [tool bar](tool-bar.md). The [status bar](status-bar.md) also gives you valuable 13 | information about the current sprite. 14 | 15 | The timeline is not visible by default, you can make it visible with the 16 | *View > Timeline* menu option or Tab key. (It also pops up 17 | automatically when you add a new frame or a new layer.) 18 | 19 | ## Drag and drop tabs 20 | 21 | You can drag-and-drop tabs to any side of the sprite editor window or 22 | duplicate them using the Ctrl or Alt keys along 23 | with the Left Mouse Button: 24 | 25 | ![Drag and drop tabs demo](workspace/drag-and-drop-tabs.gif) 26 | 27 | --- 28 | 29 | **SEE ALSO** 30 | 31 | [Color Bar](color-bar.md) | 32 | [Context Bar](context-bar.md) | 33 | [Sprite Editor](sprite-editor.md) | 34 | [Status Bar](status-bar.md) | 35 | [Tabs](tabs.md) | 36 | [Timeline](timeline.md) | 37 | [Tool Bar](tool-bar.md) | 38 | [Menu Bar](menu-bar.md) 39 | -------------------------------------------------------------------------------- /continuous-layers.md: -------------------------------------------------------------------------------- 1 | # Continuous Layers 2 | 3 | The continuous icon ![Broken layer icon](continuous-layers/broken-layer.png) indicates what kind 4 | of [cels](cel.md) you prefer when they are copied. 5 | It modifies the behavior of certain commands like 6 | [New Frame](new-frame.md), 7 | [Copy Frames](copy-frames.md), or [Copy Cels](copy-cels.md). 8 | 9 | There are two possible states: 10 | 11 | 1. ![Normal layer icon](continuous-layers/broken-layer.png) This layer is a normal layer (with discontinuous cels): new cels will be created unlinked (cels are copied). 12 | 1. ![Continuous layer icon](continuous-layers/continuous-layer.png) This layer is continuous: new cels are created in a [linked way](linked-cels.md). 13 | 14 | Generally you will prefer continuous cels for [background layers](layers.md#background-layer) (with static content), 15 | and discontinuous mode in layers that have a different cel on each frame: 16 | 17 | ![Continuous vs normal layer](continuous-layers/cont-vs-dis.png) 18 | 19 | This option can be switched depending on the specific situation you 20 | are working on. Modifying the option doesn't change current cels, 21 | so it only affects future operations. 22 | 23 | --- 24 | 25 | **SEE ALSO** 26 | 27 | [Linked Cels](linked-cels.md) | 28 | [Layers](layers.md) | 29 | [New Frame](new-frame.md) | 30 | [Copy Frames](copy-frames.md) | 31 | [Timeline](timeline.md) 32 | -------------------------------------------------------------------------------- /eyedropper.md: -------------------------------------------------------------------------------- 1 | # Eyedropper 2 | 3 | The Eyedropper tool ![Eyedropper Tool Icon](tools/eyedropper-tool.png) 4 | is useful to pick colors from the image itself. It can be activated 5 | moving the mouse on the Eraser icon in the toolbar: 6 | 7 | ![Eraser and Eyedropper group](eyedropper/eyedropper-group.png) 8 | 9 | Alternatively you can activate it pressing the `I` key or `Alt+click`. 10 | Using `Left click` will pick the color and store it as the 11 | [Foreground color](color-bar.md#foreground-color), using 12 | the `Right click` it will be stored as 13 | the [Background color](color-bar.md#background-color). 14 | 15 | You have some extra options in the [context bar](context-bar.md): 16 | 17 | * Options to pick HSV or HSL values instead of RGB values: 18 | 19 | ![Pick options](eyedropper/pick-options.png) 20 | 21 | * Pick colors from the *All Layers* (the composition of layers), the 22 | *Current Layer* only without composition (ignoring the layer 23 | blending modes), or *First Reference Layer* to pick colors from the 24 | first reference layer that is found. 25 | 26 | ![Sample options](eyedropper/sample-options.png) 27 | 28 | ## Pick colors with right click 29 | 30 | You can configure the `Right click` to pick colors from 31 | [Edit > Preferences > Editor](right-click.md). 32 | 33 | --- 34 | 35 | **SEE ALSO** 36 | 37 | [Color bar](color-bar.md) | 38 | [Right-click](right-click.md) 39 | -------------------------------------------------------------------------------- /extensions/keys.md: -------------------------------------------------------------------------------- 1 | # Extensions: Keys 2 | 3 | Since **Aseprite v1.2.35** you can create extensions with keyboard 4 | shortcuts. The content of a `.aseprite-extension` file for an 5 | extension with keyboard shorcuts should be something like this: 6 | 7 | ``` 8 | keys-example.aseprite-extension 9 | | 10 | +-- package.json 11 | | 12 | +-- my-keys.aseprite-keys 13 | ``` 14 | 15 | Content of `package.json`: 16 | 17 | ``` 18 | { 19 | "name": "my-keys-example", 20 | "displayName": "My Keys Example", 21 | "description": "Keys to do something", 22 | "version": "1.0", 23 | "author": { "name": "Full Name", "url": "https://twitter.com/your_username_or_homepage_url" }, 24 | "categories": [ 25 | "Keys" 26 | ], 27 | "contributes": { 28 | "keys": [ 29 | { "id": "my-keys", "path": "./my-keys.aseprite-keys" } 30 | ] 31 | } 32 | } 33 | ``` 34 | 35 | **Example** content of `my-keys.aseprite-keys` (a file similar to 36 | [user.aseprite-keys](https://www.aseprite.org/docs/files/#useraseprite-keys) 37 | in the [Preferences folder](https://www.aseprite.org/docs/preferences/) that 38 | can be created / exported from [Edit > Keyboard Shortcuts](keyboard-shortcuts.md)): 39 | 40 | ``` 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | ``` 49 | 50 | --- 51 | 52 | **SEE ALSO** 53 | 54 | [Extensions](extensions.md) 55 | -------------------------------------------------------------------------------- /sprite-properties.md: -------------------------------------------------------------------------------- 1 | # Sprite Properties 2 | 3 | You can change some sprite properties from *Sprite > Properties* menu (Ctrl+P or ⌘P): 4 | 5 | ![Sprite Properties dialog](sprite-properties/sprite-properties.png) 6 | 7 | You can: 8 | 9 | * Change [transparent color](transparent-color.md) (for [indexed color mode](color-mode.md#indexed)) 10 | * Change pixel aspect ratio 11 | * Assign or convert the color profile [color profile](color-profile.md) 12 | 13 | ## Color Profile 14 | 15 | In the *Sprite Properties* dialog you have two buttons: one to **Assign** other 16 | color profile, and other to **Convert** to other color profile: 17 | 18 | * If you **Assign** a new color profile to the sprite, pixel values 19 | will not be modified, just the new color profile is assigned to the 20 | sprite. You will notice that colors will change in the picture 21 | because now RGB values are the same, but the [color space](color-profile.md) 22 | has changed. E.g. so now, the "pure red" value (255, 0, 0), might be 23 | different that the previous "pure red"). 24 | * If you **Convert** the color profile, pixel values will be converted 25 | from one color space to the other color space, so colors should not 26 | be visually different, but each RGB value will be adjusted to the 27 | new color space (so almost all pixel values will be modified). 28 | 29 | --- 30 | 31 | **SEE ALSO** 32 | 33 | [New Sprite](new-sprite.md) | 34 | [Color Profile](color-profile.md) | 35 | [Transparent Color](transparent-color.md) 36 | -------------------------------------------------------------------------------- /extensions.md: -------------------------------------------------------------------------------- 1 | # Extensions 2 | 3 | Since **[Aseprite v1.2-beta10](https://www.aseprite.org/release-notes/#aseprite-v1-2-beta10)** 4 | you can add/remove extensions to/from Aseprite. Extensions are 5 | distributed as `.aseprite-extension` (`.zip`) files and you can 6 | manage them from *Edit > Preferences > Extensions*: 7 | 8 | ![Extensions in Preferences](extensions/extensions.png) 9 | 10 | ## Add/Remove Extensions 11 | 12 | In *Edit > Preferences > Extensions* there is a "Add Extension" 13 | button. You can use it to select a `.aseprite-extension` or `.zip` 14 | file. After installing the extension it will be uncompressed in your 15 | [configuration directory](preferences-folder.md) inside the 16 | `extensions` subfolder. 17 | 18 | ## File Content 19 | 20 | An extension/plugin is exactly the same as a `.zip` file but you can 21 | rename the file extension to `.aseprite-extension` so the user can 22 | double-click it in Windows Explorer or macOS Finder. 23 | 24 | The content of the `.zip` file varies depending on the kind of 25 | extension that you want to create, but at least they must contain one 26 | file inside: the `package.json` file. 27 | 28 | The structure of a `.aseprite-extension` file depends on the kind of extension: 29 | 30 | * [Keys](extensions/keys.md) 31 | * [Palettes](extensions/palettes.md) 32 | * [Languages](extensions/languages.md) 33 | * [Themes](extensions/themes.md) 34 | * [Dithering Matrices](extensions/dithering-matrices.md) 35 | * [Plugins with Scripts](https://github.com/aseprite/api/blob/master/api/plugin.md#plugin) 36 | -------------------------------------------------------------------------------- /preferences-folder.md: -------------------------------------------------------------------------------- 1 | # Preferences Folder 2 | 3 | Aseprite configuration is stored in several files in the personal user 4 | configuration directory: 5 | 6 | ![Files in Preferences Folder](preferences/preffiles.png) 7 | 8 | You can access this folder from *Edit > Preferences > Locate 9 | Configuration File* option. 10 | 11 | Anyway, you can manually locate that folder in different ways 12 | depending on your platform: 13 | 14 | ## On Windows 15 | 16 | You can locate the preferences folder pressing the Windows key + R 17 | key (or `Start menu > Run...` option). This will show the dialog to 18 | run a program. Then you write: 19 | 20 | %AppData%\Aseprite 21 | 22 | And press `Enter` key. 23 | 24 | ## On macOS 25 | 26 | You can open the Spotlight Search (⌘Space) and then paste the following text 27 | `~/Library/Application Support/Aseprite` with ⌘V and press Enter: 28 | 29 | ![Spotlight Search](preferences/spotlight.png) 30 | 31 | ## On Linux 32 | 33 | Open a Terminal, paste the following command and press Enter 34 | 35 | xdg-open ~/.config/aseprite 36 | 37 | ## Special Configuration 38 | 39 | Since Aseprite v1.2.16.3, and for testing purposes, you can 40 | reconfigure the location of the preferences folder using the 41 | `ASEPRITE_USER_FOLDER` [environment variable](https://en.wikipedia.org/wiki/Environment_variable) 42 | pointing to other folder. 43 | 44 | --- 45 | 46 | **SEE ALSO** 47 | 48 | [Preferences](preferences.md) | 49 | [Reset Preferences](reset-preferences.md) 50 | -------------------------------------------------------------------------------- /reset-preferences.md: -------------------------------------------------------------------------------- 1 | # Reset Preferences 2 | 3 | Aseprite preferences are stored in a `aseprite.ini` file in the 4 | [configuration folder](preferences-folder.md). You can access this folder from *Edit > 5 | Preferences > Locate Configuration File*. To reset all configuration 6 | you can close Aseprite and delete all the files where `aseprite.ini` is located: 7 | 8 | ![Files in Preferences Folder](preferences/preffiles.png) 9 | 10 | In case that you cannot start the program, here the steps on each 11 | platform to reset the preferences manually. 12 | 13 | ## On Windows 14 | 15 | 1. Close Aseprite 16 | 1. Press the `Windows key + R` (or `Start menu > Run...` option). 17 | This will show the dialog to run a program. Then you write: 18 | 19 | %AppData%\Aseprite 20 | 21 | And press `Enter` key. 22 | 1. Delete the files in that folder (mainly `aseprite.ini`) 23 | 1. Restart Aseprite 24 | 25 | ## On macOS 26 | 27 | 1. Close Aseprite 28 | 1. Open the Spotlight Search (⌘Space) 29 | 1. Paste this text `~/Library/Application Support/Aseprite` with ⌘V and press Enter: 30 | 31 | ![Spotlight Search](preferences/spotlight.png) 32 | 33 | 1. Delete the files in that folder (mainly `aseprite.ini`) 34 | 1. Restart Aseprite 35 | 36 | ## On Linux 37 | 38 | 1. Close Aseprite 39 | 1. Open a Terminal 40 | 1. Write: 41 | 42 | xdg-open ~/.config/aseprite 43 | 44 | 1. Delete the files in that folder (mainly `aseprite.ini`) 45 | 1. Restart Aseprite 46 | 47 | --- 48 | 49 | **SEE ALSO** 50 | 51 | [Troubleshooting](troubleshooting.md) | 52 | [Preferences](preferences.md) | 53 | [Preferences Folder](preferences-folder.md) 54 | -------------------------------------------------------------------------------- /.github/workflows/md-to-pdf.yml: -------------------------------------------------------------------------------- 1 | name: Markdown to PDF 2 | 3 | on: [push, workflow_dispatch] 4 | 5 | jobs: 6 | convert_via_pandoc: 7 | runs-on: ubuntu-latest 8 | steps: 9 | - uses: actions/checkout@v3 10 | - name: Create file list 11 | id: files_list 12 | run: | 13 | echo "files=$(printf '\"%s\" ' *.md | sed 's/ \"sidebar\.md\"/ /' | sed 's/ \"overview\.md\"/ /' && printf '\"%s\" ' extensions/*.md)" > $GITHUB_OUTPUT 14 | mkdir output 15 | - name: Installing Dependencies 16 | run: | 17 | sudo apt-get install -y pandoc texlive texlive-luatex fonts-dejavu 18 | - name: Running Pandoc 19 | run: | 20 | pandoc \ 21 | --output=output/aseprite-docs.pdf "overview.md" ${{ steps.files_list.outputs.files }} \ 22 | --pdf-engine=lualatex \ 23 | -f gfm \ 24 | --include-in-header ./.github/workflows/pdf/header.tex \ 25 | --include-before-body ./.github/workflows/pdf/title.tex \ 26 | --lua-filter ./.github/workflows/pdf/link-gifs.lua \ 27 | --file-scope \ 28 | --table-of-contents \ 29 | --number-sections \ 30 | -V mainfont="DejaVu Sans" \ 31 | -V mainfontoptions:"Extension=.ttf, UprightFont=*, BoldFont=*-Bold" \ 32 | -V documentclass=article \ 33 | -V colorlinks \ 34 | -V urlcolor=NavyBlue \ 35 | -V geometry:"top=2cm, bottom=1.5cm, left=2cm, right=2cm" 36 | - uses: actions/upload-artifact@v4 37 | with: 38 | name: aseprite-docs 39 | path: output/aseprite-docs.pdf 40 | -------------------------------------------------------------------------------- /transformations.md: -------------------------------------------------------------------------------- 1 | # Transformations 2 | 3 | Aseprite supports flipping, resizing, cropping, trimming, and rotating 4 | the image. You can apply any operation to the canvas, sprite, or 5 | selection. Any transformation applicable to a sprite or selection can 6 | be applied to multiple layers, frames or cels at the same time. 7 | 8 | ## Transforming Canvas 9 | 10 | You can apply all fundamental transformation to the canvas using 11 | options under the *Sprite* menu: 12 | 13 | * [Flip canvas](flip-canvas.md) 14 | * [Resize, Crop or Trim canvas](canvas.md) 15 | * [Rotate canvas](rotate-canvas.md) 16 | 17 | ## Transforming Sprite or Selection 18 | 19 | A sprite or a selection can be transformed using options mostly found 20 | under the *Edit* menu, or by using the selection handles: 21 | 22 | * [Flip sprite or selection](flip.md) 23 | * [Move complete layer/cel](move-tool.md) or [move selection](move-selection.md) 24 | * [Resize sprite or selection](resize.md) 25 | * [Rotate sprite or selection](rotate.md) 26 | 27 | ## Transforming Multiple Layers, Frames or Cels 28 | 29 | Transformations will be applied to every layer, frame, and cel 30 | selected on the [timeline](timeline.md). If there's no selection on 31 | the timeline, transformations will be applied only to the active cel. 32 | 33 | > Note: When transforming multiple layers, frames, or cels using the 34 | > selections handles, the transformation will be shown in real time 35 | > only for the active cel. The transformation will be applied to all 36 | > other cels after committing the change by clicking outside the 37 | > selection. 38 | 39 | --- 40 | 41 | **SEE ALSO** 42 | 43 | [Selecting](selecting.md) 44 | -------------------------------------------------------------------------------- /sprite-sheet.md: -------------------------------------------------------------------------------- 1 | # Sprite sheets 2 | 3 | A sprite sheet is one big image with several frames of the same sprite 4 | on it. For example, you can save this animation: 5 | 6 | ![Running Guy](sprite-sheet/running-guy.gif) 7 | 8 | Like an horizontal sprite sheet: 9 | 10 | ![Horizontal Sprite Sheet](sprite-sheet/running-guy-horz.png) 11 | 12 | A vertical one: 13 | 14 | ![Vertical Sprite Sheet](sprite-sheet/running-guy-vert.png) 15 | 16 | Or a matrix: 17 | 18 | ![Matrix Sprite Sheet](sprite-sheet/running-guy-matrix.png) 19 | 20 | In the following section you will know how to export and import this 21 | kind of images into Aseprite. 22 | 23 | ## Import 24 | 25 | To import a sprite sheet use *File > Import Sprite Sheet* option. 26 | Then you can select the file to import with an assigned offset `x`, 27 | `y` and sprite `width`, `height`. 28 | 29 | ![Import Sprite Sheet 01](sprite-sheet/running-guy-import-01.png) 30 | 31 | Padding is available if there are gaps between sprites, 32 | and the sheet type will affect the order of the sprites taken in. 33 | 34 | ![Import Sprite Sheet 02](sprite-sheet/running-guy-import-02.png) 35 | 36 | ## Export 37 | 38 | To export a sprite sheet use *File > Export Sprite Sheet* option. 39 | You can select all visible layers or a certain layer, 40 | and select the frames based on tags. 41 | 42 | ![Export Sprite Sheet](sprite-sheet/running-guy-export.png) 43 | 44 | ## Automate from Command Line 45 | 46 | (*Work-in-progress*) 47 | 48 | ## Texture Atlases 49 | 50 | A texture atlas is an huge image with all the graphics, sprites and 51 | images that a game will use. It's called "texture" because the image 52 | can be loaded into the video memory, to render graphics on screen with 53 | hardware acceleration. 54 | -------------------------------------------------------------------------------- /new-frame.md: -------------------------------------------------------------------------------- 1 | # New Frame 2 | 3 | You can add frames using: 4 | 5 | * *Frame > New Frame* (Alt+N): Creates a copy of the current frame in 6 | the next position. 7 | * *Frame > New Empty Frame* (Alt+B): Creates a new empty frame. (All 8 | [transparent layers](layers.md#transparent-layers) with an empty 9 | cel, and the [Background layer](layers.md#background-layer) is 10 | cleared with the active background color.) 11 | * *Frame > Duplicated Cels* (Alt+D): Copies the current cel, or 12 | creates a copy of the current Timeline selection, into the next 13 | position/frame. 14 | * *Frame > Duplicated Linked Cels* (Alt+Shift+D or Alt+M): Creates 15 | links to the current cel (or the current Timeline selection) into 16 | the next position/frame. 17 | 18 | The little `+` in the status bar can be used to add new frames (it's like pressing Alt+N): 19 | 20 | ![New Frame Button](new-frame/new-frame-button.png) 21 | 22 | ## New Frame 23 | 24 | Using *View > New Frame* (Alt+N key) you can create a new frame that 25 | is an exact copy of the current one. For [continuous layers](continuous-layers.md) 26 | cels will be [linked](linked-cels.md) 27 | 28 | ## New Empty Frame 29 | 30 | When a new empty frame is added with Alt+B, all 31 | [transparent layers](layers.md#transparent-layers) will not 32 | contain cels, and the [background layer](layers.md#background-layer) 33 | will be cleared with the [background color](color-bar.md#background-color). 34 | 35 | Empty frames are also created when you [move](move-cels.md) or 36 | [copy cels](copy-cels.md) beyond the end of the animation. 37 | 38 | ## Duplicated Cels 39 | 40 | Some information: https://community.aseprite.org/t/913 41 | -------------------------------------------------------------------------------- /color-mode.md: -------------------------------------------------------------------------------- 1 | # Color Mode 2 | 3 | Aseprite supports three different kinds of color modes: 4 | 5 | * RGB 6 | * Indexed 7 | * Grayscale 8 | 9 | When you create a [new sprite](new-sprite.md) you have to choose one of these color 10 | modes. In this section you will see the details of each one. 11 | 12 | ## RGB 13 | 14 | ![RGB Mode](color/rgb-mode.png) 15 | 16 | RGB, or RGBA, stands for Red-Green-Blue-Alpha. Each image pixel 17 | contains these four components. It means that a pixel is completely 18 | independent from others. 19 | 20 | The alpha component specifies how opaque the color is: 21 | `Alpha = 255` means completely opaque, and `Alpha = 0` completely 22 | transparent. 23 | 24 | Special note: Background layer doesn't have an alpha component, so 25 | it will always be opaque. 26 | 27 | ## Indexed 28 | 29 | ![Indexed Mode](color/indexed-mode.gif) 30 | 31 | In this mode each pixel has a number that references a palette 32 | color. Your palette can contain up to 256 colors, and each pixel 33 | points to one of those colors (from 0 to 255). 34 | 35 | Unlike RGBA, if you modify the palette color, all pixels that are 36 | referencing that color will change their appearance. 37 | 38 | An important concept on Indexed images is that for transparent layers, 39 | we need a special index to act as the transparent color. 40 | Generally this index is 0, but you can change it 41 | from *Sprite > Properties* menu. 42 | 43 | ## Grayscale 44 | 45 | ![Grayscale Mode](color/gray-mode.png) 46 | 47 | It's more like RGBA, just that you have two channels: Value and Alpha. 48 | Here 0 means black and 255 is white. The alpha channel behaves exactly 49 | like it does in RGBA mode. 50 | 51 | --- 52 | 53 | **SEE ALSO** 54 | 55 | [Color](color.md) | 56 | [New Sprite](new-sprite.md) 57 | -------------------------------------------------------------------------------- /workflow.md: -------------------------------------------------------------------------------- 1 | # Workflow 2 | 3 | 1. [Create a new sprite](new-sprite.md) with *File > New* menu (Ctrl+N or ⌘N), 4 | [Open an existent one](open.md) with *File > Open* menu, or drag-and-drop a file from 5 | Windows Explorer to Aseprite window. 6 | 7 | 1. [Draw](drawing.md) using Left click or Right click with the Pencil tool ![Pencil Tool Icon](tools/pencil-tool.png). 8 | Pick colors with Alt+Left click and Alt+Right click. Change 9 | [zoom](zoom.md) with 1, 2, 3, 4, 5, 6 keys, 10 | the mouse wheel, or Zoom tool ![Zoom Tool Icon](tools/zoom-tool.png) (Z key). 11 | 12 | 1. [Select](selecting.md) with Marquee tool ![Marquee Tool Icon](tools/marquee-tool.png) (M key), 13 | and drag-and-drop the selection, or [transform it](transformations.md). 14 | 15 | 1. Create new [layers](layers.md) with *Layer > New Layer* menu (Shift+N key). 16 | 17 | 1. Create new [frames](animation.md) with *Frame > New Frame* menu (Alt+N key). 18 | 19 | 1. Use the [timeline](timeline.md) (Tab key) to [copy layers](copy-layers.md), [frames](copy-frames.md), or [cels](copy-cels.md). 20 | 21 | 1. Save your work with *File > Save* menu as a `.aseprite` file to preserve 22 | all your image information (layers, frames, etc.). 23 | 24 | 1. Use [*File > Export > Export As* to export](exporting.md) your sprite as a `.gif` file to 25 | publish your image on a website, or `.png` to save a sequence of 26 | files, or as a `.png` [sprite sheet](sprite-sheet.md), etc. 27 | 28 | 1. Automate the export operation using the [command line interface](cli.md) 29 | 30 | --- 31 | 32 | **SEE ALSO** 33 | 34 | [Basics](basics.md) 35 | -------------------------------------------------------------------------------- /color.md: -------------------------------------------------------------------------------- 1 | # Color 2 | 3 | This section talks about how Aseprite manages color. 4 | 5 | First of all you need to understand that a specific sprite 6 | ([newly created](new-sprite.md) or [an existing sprite](open.md)) 7 | has three properties that modify how the sprite is edited and viewed: 8 | 9 | * The sprite [color mode](color-mode.md) 10 | * The [color profile](color-profile.md) 11 | * And the [transparent color](transparent-color.md) 12 | (only in [indexed images](color-mode.md#indexed)) 13 | 14 | Along with this, there are two active colors that can be used to paint 15 | or erase parts of the sprite: 16 | 17 | * The active [Foreground Color](color-bar.md#foreground-color) 18 | * The active [Background Color](color-bar.md#background-color) 19 | 20 | ## Color Mode 21 | 22 | Several adjustments and commands work differently depending on the 23 | active color 24 | mode. [RGB](https://en.wikipedia.org/wiki/RGB_color_model) and 25 | [Indexed](https://en.wikipedia.org/wiki/Indexed_color) are the most 26 | common modes used for Internet images. 27 | 28 | You should learn more about them in the **[Color Mode](color-mode.md)** 29 | section. 30 | 31 | ## Color Profile 32 | 33 | The color profile indicates in which [color space](https://en.wikipedia.org/wiki/Color_space) RGB values of the image 34 | are meant to live. It is used to match RGB values 35 | in one device (e.g. your monitor, where you create your image) with another 36 | device (e.g. the user that will watch your image on her/his monitor). 37 | Images on Internet generally use the [sRGB color space](https://en.wikipedia.org/wiki/SRGB). 38 | 39 | Learn more about this in the **[Color Profile](color-profile.md)** section. 40 | 41 | --- 42 | 43 | **SEE ALSO** 44 | 45 | [Color Mode](color-mode.md) | 46 | [Color Profile](color-profile.md) | 47 | [Color Bar](color-bar.md) 48 | -------------------------------------------------------------------------------- /timeline.md: -------------------------------------------------------------------------------- 1 | # Timeline 2 | 3 | This is the timeline: 4 | 5 | Timeline 6 | 7 | It shows the [layers](layers.md) and frames of the active sprite. You can use the 8 | *View > Timeline* menu option or press the Tab key to show or hide 9 | it. It also appears automatically when you create a [new Frame](new-frame.md) or 10 | [Layer](new-layer.md). (This behavior can be disable from *Edit > Options > Timeline > 11 | Show timeline automatically*.) 12 | 13 | You can use *Layer > New Layer* menu (Shift+N) to create new layers 14 | or *Frame > New Frame* menu (Alt+N) to add frames. 15 | 16 | ### Common Operations 17 | 18 | * [Layers](layers.md): 19 | * [Move layers](move-layers.md) 20 | * [Copy layers](copy-layers.md) 21 | * [Frames](animation.md): 22 | * [Move frames](move-frames.md) 23 | * [Copy frames](copy-frames.md) 24 | * [Cels](cel.md): 25 | * [Move cels](move-cels.md) 26 | * [Copy cels](copy-cels.md) 27 | * [Tags](tags.md): 28 | * [Loop section](loop.md) 29 | * [Focus tag](focus-tag.md) 30 | 31 | ## Preferences 32 | 33 | You can configure the Timeline pressing 34 | the ![Configure Timeline Icon](animation/configure-timeline.png) button. 35 | 36 | Some options: 37 | 38 | 1. [Onion Skinning](onion-skinning.md) 39 | 1. [First frame as 0](https://community.aseprite.org/t/3895/2) (or any other number) 40 | 41 | ## Copy between documents 42 | 43 | You can copy and paste layers, frames, or cels between different 44 | documents using *Edit > Copy* and *Edit > Paste*. 45 | 46 | ![Copy and Paste on Timeline](timeline/timeline-copy-and-paste.gif) 47 | 48 | --- 49 | 50 | **SEE ALSO** 51 | 52 | [Animation](animation.md) | 53 | [Onion Skinning](onion-skinning.md) | 54 | [Layers](layers.md) | 55 | [Cel](cel.md) | 56 | [Tags](tags.md) 57 | -------------------------------------------------------------------------------- /sprite.md: -------------------------------------------------------------------------------- 1 | # Sprite structure 2 | 3 | In Aseprite a document/file/sprite has the following properties: 4 | 5 | 1. It has a [size](sprite-size.md) in pixels (width and height). 6 | 1. It has a [color mode](color-mode.md), which tells you how many 7 | colors the image can handle. All images in the sprite are in one 8 | specific mode, you cannot mix RGB images with Indexed images in the 9 | same sprite. 10 | 1. A [color profile](color-profile.md) which indicates what color space the RGB values are in. 11 | 1. It contains a set of layers. You can see them in 12 | the [Timeline](timeline.md). The most important concept here is 13 | that there are two kinds of layers: 14 | the [background layer](layers.md#background-layer) for opaque sprites, and 15 | [transparent layers](layers.md#transparent-layers). 16 | A sprite can contain only one background layer, but several 17 | transparent layers. 18 | 1. It contains animation frames. Each frame has a duration, i.e. how many milliseconds 19 | the frame must be on screen when the animation is being played. 20 | 1. Each layer/frame intersection is called a [cel](cel.md), 21 | and contains the image where you finally can [paint](drawing.md). 22 | 23 | The [timeline](timeline.md) shows you the whole structure of the 24 | sprite as a grid. Rows are layers and columns are frames, each 25 | little cell of the matrix is a [cel](cel.md): 26 | 27 | Cels Matrix 28 | 29 | You can see some extra elements like [tags](tags.md) and [linked 30 | cels](linked-cels.md). These elements are useful to organize several 31 | animations of the same sprite, and to re-utilize frames along the 32 | animations (or different animations). 33 | 34 | --- 35 | 36 | **SEE ALSO** 37 | 38 | [Color Mode](color-mode.md) | 39 | [Save](save.md) | 40 | [Sprite size](sprite-size.md) 41 | -------------------------------------------------------------------------------- /animation.md: -------------------------------------------------------------------------------- 1 | # Animation 2 | 3 | Aseprite's main goal is to be a tool to create animations. The 4 | [timeline](timeline.md) gives you total control over frames, 5 | [layers](layers.md), and [cels](cel.md). 6 | 7 | The general workflow is: 8 | 9 | 1. You [draw](drawing.md) the first frame 10 | 1. Then you [add new frames](new-frame.md) (e.g. pressing Alt+N) and continue drawing them 11 | 1. You can navigate frames using Left and Right arrow keys (or , and .) to 12 | go to the previous or next frames respectively 13 | 1. You can [preview the animation](preview-window.md) using 14 | the Play button ![Play icon](animation/play-button.png) or pressing Enter key 15 | 1. You can [tag](tags.md) a range of frames for future reference or to separate 16 | different animations of the same sprite 17 | 18 | There are some extra tools like 19 | the [Preview Window](preview-window.md) and [Onion Skinning](onion-skinning.md) that 20 | will make your life a lot easier to animate. 21 | 22 | ### Common Operations 23 | 24 | 1. [Add a new frame copying the current one](new-frame.md) 25 | 1. [Add a new empty frame](new-frame.md#new-empty-frame) 26 | 1. [Copy frames](copy-frames.md) or [cels](copy-cels.md) 27 | 1. [Move frames](move-frames.md) or [cels](move-cels.md) 28 | 1. Remove frames 29 | 1. [Reuse frames](linked-cels.md) 30 | 1. [Tag several frames](tags.md) 31 | 1. [Change the duration of a specific frame](frame-duration.md) 32 | 1. [Copy layers/frames/cels between files](timeline.md#copy-between-documents) 33 | 1. [Loop a section](loop.md) 34 | 1. [Reverse frames](reverse-frames.md) 35 | 36 | ### Onion Skinning 37 | 38 | See the [Onion Skinning](onion-skinning.md) section. 39 | 40 | --- 41 | 42 | **SEE ALSO** 43 | 44 | [Timeline](timeline.md) | 45 | [Onion Skinning](onion-skinning.md) | 46 | [Continuous Layers](continuous-layers.md) | 47 | [Tags](tags.md) 48 | -------------------------------------------------------------------------------- /ink.md: -------------------------------------------------------------------------------- 1 | # Ink 2 | 3 | Inks 4 | 5 | The ink modifies the way the [active tool](tool-bar.md) paints. The 6 | default ink is the *Simple Ink*. 7 | 8 | ## Simple Ink 9 | 10 | It acts in the following way: 11 | 12 | 1. If the [foreground color](color-bar.md#foreground-color) is opaque 13 | (alpha = 255 = 100%), it paints with the given opaque color. 14 | 1. If the color has alpha (0 < alpha < 255), it composite the color 15 | with the layer surface. 16 | 1. If the color is transparent (alpha = 0, Mask color), the tool acts 17 | like an Eraser. 18 | 19 | ## Alpha Compositing 20 | 21 | It merges the [foreground color](color-bar.md#foreground-color) with 22 | the layer surface depending on the alpha value of the foreground color: 23 | 24 | 1. If alpha = 255 = 100%, the foreground color will be completely opaque. 25 | 1. If alpha = 128 = 50%, the foreground color is merged 50% with the layer surface color. 26 | 1. If alpha = 0 = 0%, the painting has no effect because the color is completely transparent. 27 | 28 | ## Copy Alpha+Color 29 | 30 | It replaces the layer surface pixels with the active foreground color 31 | with its alpha value. It doesn't make any kind of alpha compositing, 32 | it just takes the active color and put it exactly as it is in the 33 | destination pixel. 34 | 35 | E.g. In this case, if alpha = 128 = 50%, the final color will be the 36 | same as the foreground color with alpha = 128, ignoring the layer 37 | surface. 38 | 39 | ## Lock Alpha 40 | 41 | In this case the original alpha values from the layer surface are 42 | kept, and only the RGB color components are replaced from the 43 | foreground color. 44 | 45 | ## Shading 46 | 47 | See the [shading section](shading.md) for more information about this 48 | special ink for pixel-art. 49 | 50 | --- 51 | 52 | **SEE ALSO** 53 | 54 | [Drawing](drawing.md) | 55 | [Shading](shading.md) | 56 | [Context Bar](context-bar.md) 57 | -------------------------------------------------------------------------------- /color-bar.md: -------------------------------------------------------------------------------- 1 | # Color bar 2 | 3 | The color bar shows the palette for the active sprite: 4 | 5 | ![Color bar](color-bar/color-bar.png) 6 | 7 | Each color can be identified by its index, starting from 0 to 255. 8 | 9 | With Left click you can select the foreground color, and with Right click 10 | the background color. With the X key you can swap these colors. 11 | 12 | Depending on the active sprite [color mode](color-mode.md): 13 | 14 | * On Indexed images, the color bar shows all the available colors to 15 | be used in the sprite. You cannot use colors that are not present in 16 | the palette, except by modifying the palette itself with 17 | the `Edit Palette` button or F4 key. 18 | 19 | * On RGB images the color bar shows a palette of colors to pick from, 20 | but the sprite doesn't depend on the palette, you can modify it and 21 | the sprite will look the same. This means you are free to use colors 22 | inside the sprite that aren't present in the palette. 23 | 24 | ## Foreground Color 25 | 26 | Color used to draw with the Left click. If you click the button you 27 | will see a popup window to select colors using 28 | [RGB](http://en.wikipedia.org/wiki/RGB_color_model) or 29 | [HSB](http://en.wikipedia.org/wiki/HSL_and_HSV) sliders: 30 | 31 | ![Color Popup](color-bar/color-popup.png) 32 | 33 | The little warning icon ![warning icon](color-bar/color-warning-icon.png) can be 34 | pressed to add the color to the palette if it's not present: 35 | 36 | ![Color Warning](color-bar/color-warning.png) 37 | 38 | ## Background Color 39 | 40 | Color used to draw with the Right click. 41 | 42 | This color is also used to clear the `Background` layer in several situations: 43 | 44 | * When the selection is cleared (*Edit > Clear* menu), or 45 | * When a new empty frame is added (*Frame > New Empty Frame* menu) 46 | * When a transparent layer is converted to Background (*Layer > Background from Layer* menu) 47 | 48 | --- 49 | 50 | **SEE ALSO** 51 | 52 | [Color](color.md) 53 | -------------------------------------------------------------------------------- /dynamics.md: -------------------------------------------------------------------------------- 1 | # Dynamics 2 | 3 | The brush dynamics menu can dynamically change the size, shape, or gradient of a brush stroke. It is most useful when using Aseprite with a pen, but you can also use it with a mouse. 4 | 5 | When using any painting tool, you can access the dynamics menu in the [context bar](context-bar.md). 6 | 7 | ![Context bar example](dynamics/contextbar.png) 8 | 9 | Once opened, the menu looks like this: 10 | 11 | ![Dynamics menu](dynamics/dynamics.png) 12 | 13 | The left column (Pressure) is for use with a pen, and the right (Velocity) is for use with a mouse. 14 | 15 | Only one of these can be selected per row. You can have multiple rows selected at once. 16 | 17 | ## Sensor Thresholds 18 | 19 | ![Sensor thresholds example](dynamics/thresholds.png) 20 | 21 | The sensor threshold controls what an amount of pressure/velocity does to the stroke. 22 | 23 | Moving the handles to the right makes the smallest amount of pressure/velocity required greater, making the stroke less sensitive. Moving the handles to the left makes the smallest amount of pressure/velocity required smaller, making the stroke more sensitive. 24 | 25 | The spacing between the handles also affects sensitivity, with the handles being closer making the stroke more sensitive, and the handles being farther making the stroke less sensitive. 26 | 27 | ## Min/Max values 28 | 29 | ![Min/max example](dynamics/minmax.png) 30 | 31 | The minimum and maximum setting values set the bounds of the sensor threshold. For example, if the size setting was selected, and the min was `1` and the max was `16`, then the lowest amount of pressure/velocity would change the size to `1`, the highest to `16`, and any amount of pressure/velocity in between the highest and lowest would change the size to somewhere between `1` and `16`. 32 | 33 | ## Stabilizer 34 | 35 | The stabilizer toggle helps stabilize the stroke by drawing it a certain number of pixels away from the cursor. 36 | 37 | ---- 38 | 39 | **SEE ALSO** 40 | 41 | [Context Bar](context-bar.md) | 42 | [Brushes](brushes.md) 43 | 44 | 45 | -------------------------------------------------------------------------------- /mouse-wheel.md: -------------------------------------------------------------------------------- 1 | # Mouse Wheel 2 | 3 | The default mouse wheel behavior depends 4 | on the [*Edit > Preferences > Editor > Zoom with scroll wheel*](preferences.md#editor) option. 5 | Some of this behavior will change in a near future: [Issue #2896](https://github.com/aseprite/aseprite/issues/2896) 6 | 7 | As reference and only in this section, the following symbols have the given meaning: 8 | 9 | ⬆: the mouse wheel is moved up
10 | ⬇: the mouse wheel is moved down 11 | 12 | ## With *Zoom with scroll wheel* 13 | 14 | | Action | Windows | macOS | 15 | |---------------------|--------------------|--------------------| 16 | | Horz. Scroll Left | Shift+⬆ | Shift+⬇ | 17 | | Horz. Scroll Right | Shift+⬇ | Shift+⬆ | 18 | | Zoom In | ⬆ | ⬇ | 19 | | Zoom Out | ⬇ | ⬆ | 20 | | Increase Brush Size | Ctrl+⬇ | Ctrl+⬆ | 21 | | Decrease Brush Size | Ctrl+⬆ | Ctrl+⬇ | 22 | 23 | ## Without *Zoom with scroll wheel* 24 | 25 | | Action | Windows | macOS | 26 | |--------------------|--------------------|--------------------| 27 | | Scroll Up | ⬆ | ⬇ | 28 | | Scroll Down | ⬇ | ⬆ | 29 | | Horz. Scroll Left | Shift+⬆ | Shift+⬇ | 30 | | Horz. Scroll Right | Shift+⬇ | Shift+⬆ | 31 | | Zoom In | Ctrl+⬆ | Ctrl+⬇ | 32 | | Zoom Out | Ctrl+⬇ | Ctrl+⬆ | 33 | 34 | ## Customization 35 | 36 | From *Edit > Keyboard Shortcuts > Mouse Wheel* you can 37 | configure the mouse wheel behavior when some extra key is pressed: 38 | 39 | ![Mouse Wheel on Keyboard Shortcuts](keyboard-shortcuts/mouse-wheel-custom.png) 40 | 41 | --- 42 | 43 | **SEE ALSO** 44 | 45 | [Drag Value](drag-value.md) | 46 | [Keyboard Shortcuts](keyboard-shortcuts.md) | 47 | [Issue #2896](https://github.com/aseprite/aseprite/issues/2896) 48 | -------------------------------------------------------------------------------- /drawing.md: -------------------------------------------------------------------------------- 1 | # Drawing 2 | 3 | You can draw in the [sprite editor](sprite-editor.md) using tools 4 | like the Pencil ![Pencil tool icon](tools/pencil-tool.png) 5 | (B key), you can use Left click to paint with the 6 | [Foreground color](color-bar.md) and the [active brush](brushes.md), 7 | or Right click to paint with the Background color. 8 | This is true for almost all painting tools. 9 | 10 | The tool behavior is also modified by the [active ink](ink.md) 11 | and [dynamics options](dynamics.md). 12 | 13 | The following is the list of available painting tools: 14 | 15 | * ![Pencil tool icon](tools/pencil-tool.png) Pencil (B key) 16 | * ![Line tool icon](tools/line-tool.png) Line (L key) 17 | * ![Curve tool icon](tools/curve-tool.png) Curve (Shift+L key) 18 | * ![Rectangle tool icon](tools/rectangle-tool.png) Rectangle (U key) 19 | * ![Ellipse tool icon](tools/ellipse-tool.png) Ellipse (Shift+U key) 20 | * ![Countour tool icon](tools/countour-tool.png) Countour (D key) 21 | * ![Polygon tool icon](tools/polygon-tool.png) Polygon (Shift+D key) 22 | 23 | Other tools that will help you in the drawing process: 24 | 25 | * ![Eraser tool icon](tools/eraser-tool.png) [Eraser](eraser.md) (E key) 26 | * ![Eyedropper tool icon](tools/eyedropper-tool.png) [Eyedropper](eyedropper.md) (Alt or I key) 27 | * ![Selection tool icon](tools/marquee-tool.png) [Rectangular Marquee](selecting.md) (M key) 28 | * ![Move tool icon](tools/move-tool.png) [Move Cel](move-tool.md) (Ctrl or ⌘ or V key) 29 | * ![Slice tool icon](tools/slice-tool.png) [Slice](slices.md) (Shift+C key) 30 | * ![Zoom tool icon](tools/zoom-tool.png) [Zoom](zoom.md) (Z key) 31 | 32 | Some helpers for the drawing process: 33 | 34 | * [Preview Window](preview-window.md) 35 | * [Tiled Mode](tiled-mode.md) 36 | * [Symmetry](symmetry.md) 37 | 38 | --- 39 | 40 | **SEE ALSO** 41 | 42 | [Sprite Editor](sprite-editor.md) | 43 | [Brushes](brushes.md) | 44 | [Ink](ink.md) | 45 | [Dynamics](dynamics.md) | 46 | [Tool Bar](tool-bar.md) | 47 | [Move Tool](move-tool.md) | 48 | [Zoom Tool](zoom.md) 49 | -------------------------------------------------------------------------------- /slices.md: -------------------------------------------------------------------------------- 1 | # Slices 2 | 3 | With the Slice tool ![Slice tool icon](tools/slice-tool.png) 4 | (Shift+C key) you can indicate regions of your sprite and 5 | assign a name/label to that region with some extra user defined 6 | information. There is support to specify 7 | [9-slices](https://en.wikipedia.org/wiki/9-slice_scaling)/9-patches 8 | information. 9 | 10 | With this tool you can: 11 | 12 | 1. Create a new slice marking a rectangular region pressing the mouse 13 | button, dragging the mouse, and releasing the button. 14 | 1. If the marked rectangle touches existing slices, those slices will 15 | be selected. 16 | 1. You can drag-and-drop a set of selected slices to move them to 17 | other place. Or you can resize the whole set of slices dragging 18 | from the corners or edges. 19 | 1. After selecting some slices you can delete them pressing the Delete 20 | key or *Edit > Delete* menu option. 21 | 1. Double-clicking a slice you will see the [Slice 22 | Properties](#slice-properties) dialog. 23 | 24 | ## Slice Properties 25 | 26 | If you double-click a slice, you will see its properties: 27 | 28 | ![Slice Properties Dialog](slices/properties.png) 29 | 30 | Here you can specify: 31 | 32 | 1. the bounds of the slice in the canvas 33 | 1. a 9-slices property to specify an internal rectangle to sub-divide the bounds into sub-slices 34 | 1. a pivot to specify the central/base location of the sprite inside the slice 35 | 36 | ## Exporting Slices 37 | 38 | You can export each slice as a different sprite using the 39 | [--split-slice option](cli.md/#split-slices). 40 | 41 | You can also export the slice information in a sprite sheet JSON using 42 | the [--data option](cli.md/#data) or the *File > Export Sprite Sheet* 43 | menu option with the JSON output checked. This is an example of the exported data: 44 | 45 | ```json 46 | { ... 47 | "meta": { 48 | ... 49 | "slices": [ 50 | { "name": "Button-patch", 51 | "color": "#0000ffff", 52 | "keys": [{ "frame": 0, 53 | "bounds": {"x": 118, "y": 118, "w": 20, "h": 21 }, 54 | "center": {"x": 5, "y": 5, "w": 10, "h": 9 } }] } 55 | ] 56 | } 57 | ``` 58 | 59 | --- 60 | 61 | **SEE ALSO** 62 | 63 | [Drawing](drawing.md) 64 | -------------------------------------------------------------------------------- /wintab.md: -------------------------------------------------------------------------------- 1 | # Wintab 2 | 3 | Wintab (`WinTab32.dll`) is an ancient API created by Wacom to 4 | communicate tablet-like devices with Windows programs. Before Windows 8, 5 | this was the "de facto" standard used to access pressure 6 | information from tablets created by Wacom and other brands. Since 7 | Windows 8, Microsoft introduced a new official API: the Pointer 8 | API/Windows Ink. 9 | 10 | Since **Aseprite v1.2.34** (and **v1.3-beta12**), as we've received a 11 | lot of crash reports related to buggy third-party `WinTab32.dll`s, 12 | we've switched to the Windows Pointer API by default. (The Wintab 13 | option is still available from the [Tablet options](tablet.md).) 14 | 15 | In previous versions of Aseprite, we tried to load this Wintab library 16 | initially, but it could cause the program to crash randomly. Sometimes 17 | you can solve this reinstalling drivers, restarting Windows, using the 18 | Pointer API from [Tablet options](tablet.md), or just disabling Wintab 19 | usage from *Edit > Preferences > Tablet* (or from *Edit > Preferences > Experimental* in older versions): 20 | 21 | ![Don't load the WinTab driver](wintab/disable-wintab.png) 22 | 23 | ## Aseprite doesn't start 24 | 25 | If you cannot even start the program, you can execute Aseprite with 26 | the `-disable-wintab` parameter (available since Aseprite v1.2): 27 | 28 | "C:\Program Files\Aseprite\Aseprite.exe" -disable-wintab 29 | 30 | This will avoid loading `WinTab32.dll` file. Your tablet might not 31 | work correctly, but at least Aseprite can be executed and used with 32 | your mouse/trackpad (or you can try the [Windows Pointer API](tablet.md)). 33 | 34 | ## Steam 35 | 36 | On Steam you can add the `-disable-wintab` option in the Aseprite launch options: 37 | 38 | 1. Right-click Aseprite in your Steam library and open its "Properties": 39 | 40 | ![Open Aseprite Properties](steam/steam-1-open-properties.png) 41 | 42 | 2. Click the "Set Launch Options" button: 43 | 44 | ![Open launch options](steam/steam-2-launch-options.png) 45 | 46 | 3. Add the `-disable-wintab` option and press "OK": 47 | 48 | ![Add disable wintab option](steam/steam-3-disable-wintab.png) 49 | 50 | --- 51 | 52 | **SEE ALSO** 53 | 54 | [Tablet](tablet.md) | 55 | [Troubleshooting](troubleshooting.md) 56 | -------------------------------------------------------------------------------- /troubleshooting.md: -------------------------------------------------------------------------------- 1 | # Troubleshooting 2 | 3 | If you have a problem starting Aseprite (e.g. it starts and closes 4 | inmediately), you can try: 5 | 6 | 1. [Reset your preferences](reset-preferences.md) 7 | 1. Use the [debug option](debug.md), this generates a `Aseprite-v1.2-DebugOutput.txt` file 8 | 1. Windows only: Check if the last line of the generated 9 | `Aseprite-v1.2-DebugOutput.txt` file says: 10 | `PEN: Wintab library loaded`. If that is the case, try [disabling Wintab](wintab.md). 11 | 1. In other case, contact us at 12 | [support@aseprite.org](mailto:support@aseprite.org) with the 13 | `Aseprite-v1.2-DebugOutput.txt` file. 14 | 15 | You might also try to find your problem on: 16 | 17 | * [Aseprite Community](https://community.aseprite.org) 18 | * [Steam General Discussion forum](http://steamcommunity.com/app/431730/discussions/0/) 19 | * [Steam Bug Reports forum](http://steamcommunity.com/app/431730/discussions/2/) 20 | * [Closed bugs on the GitHub](https://github.com/aseprite/aseprite/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aclosed%20%20label%3Abug) 21 | 22 | ## Crash/Data Lost 23 | 24 | In case of crash, you might be able to [recover some sprites](data-recovery.md). 25 | 26 | ## Tablet Problems 27 | 28 | In case your tablet (or the pressure of your tablet) doesn't work, 29 | please check the [tablet](tablet.md) page. 30 | 31 | ## macOS Rendering Problems 32 | 33 | Aseprite uses an asynchronous rendering 34 | on macOS ([CALayer's drawsAsynchronously](https://developer.apple.com/documentation/quartzcore/calayer/1410974-drawsasynchronously?language=objc)). 35 | Since Aseprite v1.2.20 you can disable this in case that you have some 36 | problems e.g. black rectangles in the screen (anyway the performance 37 | will drop significantly if you are using 38 | a [color profile](color-profile.md) like Display P3). 39 | 40 | To disable this: 41 | 1. Close Aseprite 42 | 2. Open `aseprite.ini` file in the [preferences folder](preferences-folder.md) 43 | 3. Search the `[general]` section and add this option `osx_async_view = false` 44 | ``` 45 | [general] 46 | osx_async_view = false 47 | ``` 48 | 4. Save the file and start Aseprite 49 | 50 | --- 51 | 52 | **SEE ALSO** 53 | 54 | [Reset Preferences](reset-preferences.md) | 55 | [Data Recovery](data-recovery.md) | 56 | [Debug](debug.md) | 57 | [Tablet](tablet.md) 58 | -------------------------------------------------------------------------------- /overview.md: -------------------------------------------------------------------------------- 1 | # Aseprite Help 2 | 3 | Aseprite lets you create 2D animations for videogames. From sprites, 4 | to pixel-art, retro style graphics, and whatever you like about the 5 | [8-bit](https://en.wikipedia.org/wiki/Third_generation_of_video_game_consoles) 6 | and [16-bit](https://en.wikipedia.org/wiki/Fourth_generation_of_video_game_consoles) era. 7 | 8 | Here you will find some help, tutorials, and little tips to use 9 | Aseprite and start getting the best from it from the very 10 | beginning. If you have some questions you can start looking at the 11 | [Frequently Asked Questions](/faq/). 12 | 13 | To get started, you can print the [Quick Reference](/quickref/). It 14 | contains several keyboard shortcuts, so it could be handy to have it 15 | at your side. 16 | 17 | **[Basics](basics.md)**: General concepts, elements in the window, expected workflow, etc. 18 | 19 | * [Workspace](workspace.md) 20 | * [Workflow](workflow.md) 21 | * [Sprite](sprite.md) 22 | 23 | **[Image & Sprite](sprite.md)**: 24 | 25 | * [Create a new Sprite](new-sprite.md) or [Open an existing one](open.md) 26 | * [Resize Sprite](sprite-size.md) 27 | * [Color Mode](color-mode.md) & [Color Profile](color-profile.md) 28 | * [Save Your Work](save.md) 29 | 30 | **[Animation](animation.md)**: How to create animations & manipulate frames 31 | 32 | * [Onion Skinning](onion-skinning.md) 33 | 34 | **[Layers](layers.md)**: How to handle several layers to compose images 35 | 36 | **[Selecting](selecting.md)**: How to select 37 | 38 | **[Drawing](drawing.md)**: How to start drawing 39 | 40 | * [Zoom](zoom.md) 41 | 42 | **[Transformations](transformations.md)**: 43 | 44 | * [Flip](flip.md) 45 | * [Canvas](canvas.md) 46 | * [Resize](resize.md) 47 | * [Rotate](rotate.md) 48 | 49 | **[Exporting](exporting.md)**: 50 | 51 | * [Sprite Sheets](sprite-sheet.md) 52 | * [Command Line Interface (CLI)](cli.md) 53 | 54 | **[Customization](customization.md)** 55 | 56 | * [Preferences](preferences.md) 57 | * [Extensions](extensions.md) 58 | * [Scripting](scripting.md) 59 | 60 | **[Troubleshooting](troubleshooting.md)**: 61 | 62 | * [Data Recovery](data-recovery.md) 63 | * [Reset Preferences](reset-preferences.md) 64 | * [Debug Option](debug.md) 65 | 66 | --- 67 | 68 | **SEE ALSO** 69 | 70 | [Frequently Asked Questions](/faq/) | 71 | [Tutorial](/tutorial/) 72 | -------------------------------------------------------------------------------- /tablet.md: -------------------------------------------------------------------------------- 1 | # Tablet 2 | 3 | ## Windows 4 | 5 | Since Windows 8, Microsoft introduced a new API to use your tablet 6 | with Windows programs: the pointer API. Since Aseprite v1.2.19.1 you 7 | can configure what API do you prefer to use: 8 | 9 | ![Tablet section](tablet/tablet.png) 10 | 11 | * *Windows 8/10 Pointer API*: This option might be enough for most 12 | modern devices, you can give a try how your tablet works with this 13 | (might work better with this option than with Wintab) 14 | * *[Wintab](wintab.md)*: This is the default option at the moment to 15 | support pressure sensitivity on older systems (Windows Vista/7) and 16 | older devices. 17 | * *Wintab (direct packet processing)*: This option might not work well 18 | in some devices, but might be useful in other devices to avoid 19 | losing packets and getting smoother strokes. 20 | 21 | Pressing the *OK*/*Apply* buttons will change the tablet settings 22 | immediately, there is no need to restart the program. 23 | 24 | ## Linux/X11 25 | 26 | It looks like tablet/stylus/pen devices are detected by device 27 | name/brand name on X11, instead by device capabilities. 28 | 29 | There are some pre-defined IDs to detect a stylus, but it might not be 30 | enough (as it's indicated in 31 | [#3176](https://github.com/aseprite/aseprite/issues/3176)) 32 | 33 | If Aseprite doesn't detect the pressure of your pen, since **Aseprite 34 | v1.2.35** you can try to do these steps: 35 | 36 | 1. Close Aseprite 37 | 2. Run `xinput --list` in a terminal/console 38 | 3. Check the output and see what device could be the one related to 39 | your stylus ([output example](https://github.com/aseprite/aseprite/issues/3176#issuecomment-1111799083)) 40 | 4. Open `aseprite.ini` file in the [preferences folder](preferences-folder.md) 41 | 5. Search the `[general]` section and add the name of your stylus in a 42 | `x11_stylus_id` option (the name must appears just like in the 43 | first column of the `xinput --list` output): 44 | ``` 45 | [general] 46 | x11_stylus_id = Your Stylus Name 47 | ``` 48 | 6. Save the file and start Aseprite 49 | 50 | Please inform us if this does work for your case adding a new comment 51 | in [#3176](https://github.com/aseprite/aseprite/issues/3176) 52 | indicating the name of your device. 53 | 54 | --- 55 | 56 | **SEE ALSO** 57 | 58 | [Wintab](wintab.md) | 59 | [Troubleshooting](troubleshooting.md) 60 | -------------------------------------------------------------------------------- /debug.md: -------------------------------------------------------------------------------- 1 | # Debug 2 | 3 | In case that you are having some problem running Aseprite, you can 4 | execute it with the `-debug` option in the command line. 5 | 6 | After running Aseprite, you will see that a 7 | `Aseprite-v1.2-DebugOutput.txt` file (or with a similar name) will 8 | be created in your desktop. You can send us that file at 9 | [support@aseprite.org](mailto:support@aseprite.org) so we can help us 10 | solving your specific problem. 11 | 12 | How to add the `-debug` parameter on: 13 | 14 | * [Windows](#windows) 15 | * [macOS](#macos) 16 | * [Steam](#steam) 17 | 18 |
19 | 20 | ## Windows 21 | 22 | 1. You can press the Windows key to open the Start menu and write 23 | `Aseprite`, then expand the actions of Aseprite: 24 | 25 | ![Aseprite on Start menu](debug/win-1-start-menu.png) 26 | 27 | 2. In the actions list click "Open file location": 28 | 29 | ![Expand options](debug/win-2-actions.png) 30 | 31 | 3. Right-click the Aseprite shortcut and select the "Properties" option: 32 | 33 | ![Right click properties](debug/win-3-right-click-properties.png) 34 | 35 | 4. Finally write the `-debug` parameter in "Target" box and press "OK": 36 | 37 | ![Debug on properties](debug/win-4-debug-option.png) 38 | 39 |
40 | 41 | ## macOS 42 | 43 | 1. First you have to close Aseprite, then open the Spotlight Search 44 | pressing ⌘Space or clicking the magnifying glass in the menu bar: 45 | 46 | ![Open Spotlight](debug/macos-1-open-spotlight.png) 47 | 48 | 2. In the Spotlight Search write `Terminal` and Enter key to open the 49 | Terminal app: 50 | 51 | ![Terminal on Spotlight](debug/macos-2-open-terminal.png) 52 | 53 | 3. In the terminal write the following command and press Enter: 54 | 55 | open -a Aseprite --args -debug 56 | 57 |
58 | 59 | ## Steam 60 | 61 | On Steam you can add the `-debug` option in the Aseprite launch options: 62 | 63 | 1. Right-click Aseprite (or Ctrl+click on macOS) in your Steam library 64 | and open its "Properties": 65 | 66 | ![Open Aseprite Properties](steam/steam-1-open-properties.png) 67 | 68 | 2. Click the "Set Launch Options" button: 69 | 70 | ![Open launch options](steam/steam-2-launch-options.png) 71 | 72 | 3. Add the `-debug` option and press "OK": 73 | 74 | ![Add debug option](steam/steam-3-debug-option.png) 75 | 76 | --- 77 | 78 | **SEE ALSO** 79 | 80 | [Troubleshooting](troubleshooting.md) 81 | -------------------------------------------------------------------------------- /exporting.md: -------------------------------------------------------------------------------- 1 | # Exporting 2 | 3 | Generally you will use *File > Save* to [save your work](save.md) with full 4 | information [as an `.aseprite` file](files.md#aseprite). Then you can export 5 | your sprite for your own game, website, application, etc. using the *File > Export > Export As* 6 | menu option (Ctrl+Alt+Shift+S key or ⌥⇧⌘S on macOS) 7 | to convert your sprite into a `.gif` file or a sequence of `.png` files. 8 | 9 | *File > Export > Export As* will remember the latest options you've used in case 10 | that you want to save the copy again. 11 | 12 | ## Export as a sequence of images 13 | 14 | You can save the whole animation as a sequence specifying a file name 15 | with a number and a file type for static images. E.g. `frame1.png` 16 | where `1` specifies the number of the first frame, and `.png` the 17 | static file type used to save each frame. See how to 18 | [load a sequence of images](open.md#loading-image-sequences). 19 | 20 | If you specify other file name like `frame001.png` file names will be 21 | like `frame001.png`, `frame002.png`, `frame003.png`, etc. 22 | 23 | ## Export Just One Frame 24 | 25 | From *File > Export* you can export one frame (or one layer, or a set of selected frames, etc.) 26 | changing *Frames* field to *Selected frames*: 27 | 28 | ![File > Export > Export As > Selected Frame](exporting/file-export-sel-frame.png) 29 | 30 | ## Automatic Resize on Export 31 | 32 | The *File > Export* dialog contains a special *Resize* field so you 33 | can save your copy with other scale. E.g. It's useful to upload your 34 | animation for social networks (like Twitter), that needs higher scales 35 | (e.g. 400% of your original sprite size): 36 | 37 | ![File > Export > Resize](exporting/file-export-resize.png) 38 | 39 | ## Other Export Options 40 | 41 | There are other useful options in *File > Export*: 42 | 43 | ![File > Export menu option](exporting/file-export.png) 44 | 45 | * *Animation Direction*: You can export your animation in Forward, 46 | Backward, or Ping-Pong mode. 47 | * *Apply pixel ratio*: In case your sprite has a special pixel aspect 48 | ratio (like 2:1), checking this option will export the sprite 49 | applying the pixel aspect ratio to the final result. 50 | * *Export for Twitter*: Adjusts the animation to avoid some problems 51 | on Twitter reproducing the last frame with an invalid delay. 52 | 53 | --- 54 | 55 | **SEE ALSO** 56 | 57 | [Save](save.md) | 58 | [Sprite sheets](sprite-sheet.md) | 59 | [Command Line Interface](cli.md) 60 | -------------------------------------------------------------------------------- /color-profile.md: -------------------------------------------------------------------------------- 1 | # Color Profile 2 | 3 | We can see a pixel in the screen like a little rectangle with three 4 | specific RGB values, each value can be seen as a number from 0.0 to 5 | 1.0 (or an integer from 0 to 255). It indicates a position in a 3D 6 | space where each value is a position in each axis (Red, Green, and 7 | Blue): 8 | 9 | ![RGB Cube](color-profile/rgb-cube.png) 10 | 11 | But what does a position in this 3D cube mean? We know that 12 | *RGB=(0, 0, 0)* represents the black color, 13 | *RGB=(255, 0, 0)* represents red, *RGB=(255, 255, 255)* 14 | is white, etc. But what is [white](https://en.wikipedia.org/wiki/White_point) exactly? 15 | What was the ambient light used when your display monitor was calibrated 16 | and the manufacturer said *"OK, this is white"*? 17 | 18 | Each device that must handle color (a monitor, a printer, a camera, a 19 | scanner, etc.) must be calibrated to convert the light in the ambient environment 20 | to some specific RGB values in a picture, or viceversa, some RGB values 21 | in this cube to [lightwaves](https://en.wikipedia.org/wiki/Light). 22 | 23 | Color profiles indicate in which [color space](https://en.wikipedia.org/wiki/Color_space) 24 | these RGB values are. What does it mean to be pure red, 25 | or pure blue, or pure green, or pure white. 26 | It is used to match RGB values in one device (e.g. your monitor, where 27 | you create your image) with other device (e.g. the user that will 28 | watch your image in her/his monitor). 29 | 30 | Images on the Internet generally use the 31 | [sRGB color space](https://en.wikipedia.org/wiki/SRGB), 32 | but [PNG files](https://en.wikipedia.org/wiki/Portable_Network_Graphics) and 33 | [JPEG files](https://en.wikipedia.org/wiki/JPEG) can embed 34 | a specific [ICC color profile](https://en.wikipedia.org/wiki/ICC_profile) 35 | with its [RGB gamut](https://en.wikipedia.org/wiki/Gamut) 36 | and a [gamma correction](https://en.wikipedia.org/wiki/Gamma_correction). 37 | Since Aseprite v1.2.10-beta2, you can save 38 | [color profiles in `.aseprite` files](https://github.com/aseprite/aseprite/blob/master/docs/ase-file-specs.md#color-profile-chunk-0x2007) too. 39 | 40 | You can assign or convert the color profile of the current sprite 41 | from [Sprite Properties](sprite-properties.md). And you can configure 42 | how Aseprite manages color profiles from *Edit > Preferences > Color*: 43 | 44 | ![Color Management Preferences](color-profile/color-management-preferences.png) 45 | 46 | --- 47 | 48 | **SEE ALSO** 49 | 50 | [Color](color.md) | 51 | [Sprite Properties](sprite-properties.md) 52 | -------------------------------------------------------------------------------- /rotate.md: -------------------------------------------------------------------------------- 1 | # Rotate Sprite or Selection 2 | 3 | Any selection can be rotated using either [handles](rotate.md#handles) or [menu options](rotate.md#menu-options), both methods will rotate the selection around the [pivot point](rotate.md#rotation-pivot) using the chosen [algorithm](rotate.md#rotation-algorithms). 4 | 5 | ## Rotation Pivot 6 | 7 | ![Rotation Pivot](rotate/pivot-point-context-bar.png) 8 | 9 | The selection is rotated around a single, defined point (![Rotation Pivot](rotate/pivot-point.png)). By default the pivot point is set in the center of the selection and is not visible until you start rotating the image. 10 | 11 | Its placement and visibility settings can be changed from the context bar of any selection tool. The rotation pivot can also be moved with the mouse by holding Left click and dragging the point: 12 | 13 | ![Rotation Pivot Settings](rotate/pivot-point-settings.gif) 14 | ![Moving the Rotation Pivot with the mouse](rotate/pivot-point-mouse-move.gif) 15 | 16 |
Sprite by @ThKasparrr
17 | 18 | ## Handles 19 | 20 | The selection can be rotated by moving your mouse to the outer part of a handle (![Handle](rotate/handle.png)), holding Left click and dragging your mouse around the canvas: 21 | 22 | ![Rotate Handles](rotate/rotate-handles.gif) 23 | 24 | The mouse cursor will adapt to indicate whether dragging a handle will resize or rotate the selection: 25 | 26 | | | Resize | Rotate | 27 | | ------ | :----------------------------------------: | :----------------------------------------: | 28 | | Cursor | ![Resize Handle](cursor/resize-handle.png) | ![Rotate Handle](cursor/rotate-handle.png) | 29 | 30 | With Shift key you can snap angles (0º, 45º, 90º, etc.) 31 | 32 | ## Menu Options 33 | 34 | ![Edit > Rotate](rotate/edit-rotate.png) 35 | 36 | The selection can be rotated by 90º or 180º using menu options under _Edit > Rotate_. 37 | 38 | ![Rotate Menu Options](rotate/rotate-menu-options.gif) 39 | 40 | ## Rotation Algorithms 41 | 42 | ![Rotation Algorithms](rotate/rotation-algorithms.png) 43 | 44 | There are two rotation algorithms available: 45 | 46 | - Fast Rotation 47 | - [RotSprite](https://en.wikipedia.org/wiki/Pixel-art_scaling_algorithms#RotSprite) 48 | 49 | While RotSprite is widely accepted as an algorithm producing better results, the choice is up to your preferences. 50 | 51 | ![Fast Rotation vs RotSprite](rotate/rotation-algorithm.gif) 52 | 53 | --- 54 | 55 | **SEE ALSO** 56 | 57 | [Flip](flip.md) | 58 | [Resize](resize.md) | 59 | [Move](move-selection.md) 60 | -------------------------------------------------------------------------------- /selecting.md: -------------------------------------------------------------------------------- 1 | # Selecting 2 | 3 | You can select parts of the sprite using one of the selection tools 4 | e.g. the Marquee Tool ![Marquee Tool Icon](tools/marquee-tool.png) (M key), 5 | and then [move it](move-selection.md) or [transform it](transformations.md) 6 | ([scale](resize.md), [rotate](rotate.md), etc.). When you select a 7 | portion of the sprite, you will see a 8 | [marching ants](https://en.wikipedia.org/wiki/Marching_ants) effect: 9 | 10 | ![Marching ants](selecting/marching-ants.gif) 11 | 12 | When you make a selection, you are selecting the active [cel](cel.md), 13 | so all transformation will be made to that specific cel only. 14 | 15 | ## Add/Subtract/Intersect 16 | 17 | In the [context bar](context-bar.md) you can find a set of modifiers that 18 | change what to do with the selected region: ![Modifiers](selecting/modifiers.png) 19 | 20 | By default, when you press the left mouse button, drag it, and then 21 | release it, it will replace the whole selection. But you can modify 22 | this behavior with the other options (each option has a keyboard 23 | shortcut): 24 | 25 | * ![Replace Selection](selecting/replace-selection.png): Default operation, replace the whole selection with the new one (drag left mouse button) 26 | * ![Add Selection](selecting/add-selection.png): Creates a union between the existing selection and the new one (drag left mouse button + Shift key) 27 | * ![Subtract Selection](selecting/subtract-selection.png): Subtracts the new selection to the existing one (drag left mouse button + Alt+Shift key, or alternative: drag right mouse button) 28 | * ![Intersect Selection](selecting/intersect-selection.png): Intersects the existing selection with the new one (drag left mouse button + Ctrl+Shift) 29 | 30 | These keys can be customized from the [*Edit > Keyboard Shortcuts > Action Modifiers*](keyboard-shortcuts.md#action-modifiers). 31 | 32 | ## Select Content 33 | 34 | You can select: 35 | - Entire sprite canvas using *Select > All* (Ctrl+A 36 | or ⌘A) 37 | - Active [cel](cel.md) bounds 38 | using *Edit > Transform* (Ctrl+T or ⌘T) 39 | - Active frame content (non-transparent pixels) using Ctrl+Left click on a layer (keyboard shortcuts for Add/Subtract/Intersect modifiers can be applied) 40 | 41 | ## Deselect and reselect 42 | 43 | You can hide the current selection using *Select > Deselect* 44 | (Ctrl+D or ⌘D). Then you can make it appear again using 45 | *Select > Reselect* (Ctrl+Shift+D or ⇧⌘D). 46 | 47 | ## Invert 48 | 49 | You can invert the selection using 50 | *Select > Invert* (Ctrl+Shift+I or ⇧⌘I). 51 | 52 | --- 53 | 54 | **SEE ALSO** 55 | 56 | [Transformations](transformations.md) | 57 | [Move Selection](move-selection.md) 58 | -------------------------------------------------------------------------------- /files.md: -------------------------------------------------------------------------------- 1 | # Files 2 | 3 | Aseprite uses several file formats to save and load different 4 | information. The main thing you need to know is that your work is 5 | saved in your local computer when you use the [*File > Save* menu](save.md). 6 | There is no "cloud" or remote server funcionality involved, so keep in mind to 7 | backup your work or use a cloud-like folder service like Dropbox, 8 | Drive, OneDrive, etc. if you want to keep your work safe or shared 9 | between computers. 10 | 11 | ## .aseprite 12 | 13 | Aseprite has its own file format to [save](save.md) your work: `.aseprite` files 14 | (or `.ase`, [both are the same](/faq/#is-there-any-difference-between-ase-and-aseprite-files)). 15 | When you save your sprites in an `.aseprite` file you 16 | will be able to keep all the information intact ([color 17 | mode](color-mode.md), [layers](layers.md), [frames](frames.md), 18 | palette, [tags](tags.md), [slices](slices.md), etc.) 19 | 20 | Generally you will want to [export your work](exporting.md) to other 21 | formats (`.png`, `.gif`, etc.) for publishing purposes or to use your 22 | assets in a game. But keep the original `.aseprite` in a safe place to 23 | modify the sprite when it's required. 24 | 25 | The internal structure of these files is described in the [Aseprite 26 | File Format Specs](https://github.com/aseprite/aseprite/blob/main/docs/ase-file-specs.md). 27 | 28 | ## .aseprite-extension 29 | 30 | You can create extensions in the `.aseprite-extension` format which is 31 | a `.zip` file with a specific set of files inside, see the [File 32 | Content](extensions.md#file-content) section in the 33 | [Extensions](extensions.md) page for more information. 34 | 35 | ## .lua 36 | 37 | A script in the *File > Scripts > Open Scripts Folder* folder used for 38 | [scripting purposes](scripting.md). 39 | 40 | ## Preferences 41 | 42 | [Preferences](preferences.md) are saved inside the [preferences 43 | folder](preferences-folder.md) in several files: 44 | 45 | ### aseprite.ini 46 | 47 | The main options/configuration specified in the *Edit > Preferences* 48 | dialog are in this file. 49 | 50 | ### user.aseprite-brushes 51 | 52 | Custom brushes are stored in this file (a XML file). In the future 53 | we'll bring more options to export/import brushes between different 54 | files. 55 | 56 | ### user.aseprite-keys 57 | 58 | Your customized keyboard shortcuts are stored in this file, and when 59 | you export/import keyboard shortcuts the same `.aseprite-keys` file 60 | format is used (a XML file). 61 | 62 | ### sessions 63 | 64 | The `sessions` folder has some backup files used 65 | in [data recovery process](data-recovery.md). 66 | 67 | --- 68 | 69 | **SEE ALSO** 70 | 71 | [Save](save.md) | 72 | [Exporting](exporting.md) | 73 | [Preferences](preferences.md) | 74 | [Aseprite File Format Specs](https://github.com/aseprite/aseprite/blob/main/docs/ase-file-specs.md) 75 | -------------------------------------------------------------------------------- /tilemap.md: -------------------------------------------------------------------------------- 1 | # Tilemap 2 | 3 | Since **Aseprite v1.3** you can create *tilemaps* with *tilesets*. 4 | 5 | What is a **tilemap**? A tilemap is a special kind of layer where each grid cell on the canvas is a reference to a tile (a little image) in its *tileset*. You can create a new tilemap from *Layer > New > New Tilemap Layer* or pressing Space+N. 6 | 7 | What is a **tileset**? As its name says, it's a set of tiles, just like the color palette which is a set of colors. Each tile has an index and can be re-used in different position in the canvas on each tilemap grid cell. 8 | 9 | Example: 10 | 11 | ![Tilemap Example](tilemap/tilemap-example.png) 12 | 13 | ## Similarities with Indexed Color 14 | 15 | We can compare a tilemap with an [indexed image](color-mode.md#indexed): 16 | 17 | | Tilemaps | Indexed Color 18 | | -------- | ------------- 19 | | **Tile**: One little image that can be reused in several places of a Tilemap Layer | **Palette entry**: One RGBA color that can be reused in several places of an Indexed Image. 20 | | **Tileset**: A collection of tiles of the same size. | **Palette**: A collection of RGBA colors (palette entries). 21 | | **Tilemap Layer**: A 2D image where each pixel is a “tile index” that references a tile in the tileset. Each tilemap has a specific tileset associated. | **Indexed Image**: A 2D image where each pixel references a palette entry with an index. 22 | | **Tile Index**: A value from 0 to N (where N=number of tiles in the tileset, and 0 is the *empty tile*) | **Palette Index**: A value from 0 to N-1 (where N=number of palette entries) 23 | 24 | ## Modes 25 | 26 | When you are in a Tilemap Layer, there are 2 main modes, you can switch between these modes pressing Space+Tab: 27 | 28 | | Mode | | Description 29 | | ---- | - | ----------- 30 | | *Draw Pixels* | ![](tilemap/pixels-mode.png) | Draws pixels in each tile, i.e. modifies the tile content/pixels. This is like when you modify regular layers (you modify pixels). | 31 | | *Draw Tiles* | ![](tilemap/tiles-mode.png) | Puts/gets tiles directly (doesn't modifying tiles content, modifies the tilemap information) | 32 | 33 | When we draw pixels in a tilemap, we are modifying the content of each 34 | tile, but there are three special modes that indicate how we should 35 | handle these modifications between tiles: 36 | 37 | | Draw Pixels | | Description 38 | | ------------ | - | ----------- 39 | | ![](tilemap/manual-mode.png) | *Manual* | It will modify each tile content, without re-ordering the tileset. Useful if you have already a fixed tileset and don’t want to change the position of each tile in the tileset. Space+1 40 | | ![](tilemap/auto-mode.png) | *Auto* | It tries to create new tiles (or reuse existing tiles) when you draw, and will erase unused tiles if they are not found in any tilemap referencing the tileset. It’s the default mode because it tries to simulate a regular layer adjusting the whole tileset automatically. Space+2 41 | | ![](tilemap/stack-mode.png) | *Stack* | It will create a new tile for each modification that is done in an existing tile, without modifying existing tiles, and stacking all the new ones. Space+3 42 | 43 | --- 44 | 45 | **SEE ALSO** 46 | 47 | [Color Mode](color-mode.md) | 48 | [Layers](layers.md) 49 | -------------------------------------------------------------------------------- /brushes.md: -------------------------------------------------------------------------------- 1 | # Brushes 2 | To view available brushes, select any painting tool and click on the brush type option in the [context bar](context-bar.md). 3 | 4 | ![Context bar example](brushes/contextbar.png) 5 | 6 | ## Brush types 7 | 8 | ![Brush type menu](brushes/brushtype.png) 9 | 10 | The top three buttons are the three brush types. By default, it is set to the round type. The square and line types have a context bar option that changes the angle, in degrees. 11 | 12 | ![Brush angle option](brushes/brushangle.png) 13 | 14 | ## Custom type brushes 15 | 16 | The bottom button saves the current brush you are using as a custom brush. After you have saved a brush, the menu will display it in the brush menu. 17 | 18 | ![Custom brush shown in brush type menu](brushes/custombrush.png) 19 | 20 | If your brush is saving blank, you likely saved the brush with incomplete parameters. 21 | 22 | ## Custom pattern brushes 23 | 24 | ![Custom brush being created and used](brushes/patternbrush.gif) 25 | 26 | 27 | You can create a custom brush from a pattern by going to *Edit > New Brush* or by pressing Ctrl+B. You can then choose to copy or cut a portion of the sprite. Upon first selecting the brush, the pattern will be a direct copy of the copied portion. If you select a color, the entire brush shape will become that color. 28 | 29 | 30 | 31 | When using a pattern brush, a dropdown on the context bar can control how the pattern is drawn. 32 | 33 | | | | | 34 | |-|-|- 35 | | *Pattern aligned to source* | Aligns the pattern to the location it was copied/cut from. | ![aligned to source example](brushes/alignment1.gif) 36 | | *Pattern aligned to destination* | Aligns the pattern to where it was placed. | ![aligned to destination example](brushes/alignment2.gif) 37 | | *Paint brush* | Acts like a regular brush. | ![no alignment (paint) example](brushes/alignment3.gif) 38 | 39 | 40 | ## Brush Parameters 41 | 42 | ![Parameters menu](brushes/parameters.png) 43 | 44 | You can set the parameters a new brush is saved with by clicking on the dropdown next to the "Save Brush Here" button. To edit/overwrite a brush's individual parameters, click the dropdown next to it, unlock it, and then click "Save Brush Here" (in the dropdown) to save it and overwrite the old parameters. 45 | 46 | If a parameter is enabled, the corresponding option is saved. 47 | 48 | | Parameter | Description 49 | | -------- | ------------- 50 | | ***Brush:** Type* | Saves the brush type. 51 | | ***Brush:** Size* | Saves the brush size. 52 | | ***Brush:** Angle* | Saves the brush angle. 53 | | ***Color:** Foreground* | Saves the foreground color with the brush. The foreground color will be switched to this when the brush is selected. Only works for type brushes. 54 | | ***Color:** Background* | Saves the background color. The background color will be switched to this when the brush is selected. Only works for type brushes. 55 | | ***Color:** Image Color* | Saves the color(s) of the brush. Only works for pattern brushes. 56 | | ***Ink:** Type* | Saves the [ink](ink.md) type. 57 | | ***Ink:** Opacity* | Saves the ink opacity. 58 | | ***Extras:** Shade* | Saves the [shade](shading.md) gradient. 59 | | ***Extras:** Pixel-Perfect* | If enabled, it will save the state of pixel-perfect mode, not enable pixel-perfect mode outright. 60 | 61 | ---- 62 | 63 | **SEE ALSO** 64 | 65 | [Context Bar](context-bar.md) | 66 | [Dynamics](dynamics.md) | 67 | [Ink](ink.md) 68 | -------------------------------------------------------------------------------- /data-recovery.md: -------------------------------------------------------------------------------- 1 | # Data Recovery 2 | 3 | When Aseprite is running, it saves some temporary data to restore your 4 | sprite in case that your computer (or Aseprite) crashes, or you close 5 | Aseprite without saving your sprites. (Even if you save your sprites, 6 | the original backup is kept in your disk at least for a couple of 7 | weeks.) 8 | 9 | ## Open Sprites from Previous Sessions 10 | 11 | To restore a sprite from previous sessions you have to use the 12 | "Recover Files" option in the "Home" tab: 13 | 14 |

Home tab

15 | 16 | If Aseprite crashes (wasn't closed correctly) and some sprite wasn't 17 | saved, you will see the "Recover Files" option as a button: 18 | 19 |

Home tab

20 | 21 | This option opens the "Recover Files" tab, where you can double-click 22 | an item (or select it and press "Recover Sprite") to recover a sprite 23 | from previous sessions: 24 | 25 |

Home tab

26 | 27 | ## Preferences 28 | 29 | In the *Edit > Preferences > Files* section you can configure how the 30 | backup data is saved and for how long: 31 | 32 | ![Data Recovery Preferences](data-recovery/recover-data-preferences.png) 33 | 34 | * *Automatically save recovery data every X seconds/minutes*: 35 | Indicates that Aseprite should auto-save backup data (on disk) every 36 | X seconds or minutes for each edited sprite (2 minutes by default). 37 | * *Keep edited sprite data for Y days/weeks/months*: For each sprite 38 | that was edited, Aseprite will keep the backup data (on disk) for 39 | the given number of days/weeks/months (1 week by default). 40 | * *Keep closed sprite in memory for Z seconds/minutes/hours*: If you 41 | close a sprite by mistake, Aseprite will keep the sprite (in memory, 42 | with the undo information) for at least the given time (15 minutes 43 | by default). You can re-open a closed file 44 | with *File > Open Recent > Reopen Closed File* menu 45 | option (Ctrl+Shift+T or ⇧⌘T keyboard shortcut). 46 | 47 | ## Internals 48 | 49 | The backup data is saved in a subfolder named `sessions` inside your 50 | [Preferences Folder](preferences-folder.md): 51 | 52 | ![Sessions Folder](data-recovery/sessions-folder-focused.png) 53 | 54 | `sessions` might contain several subfolders (one for each execution of Aseprite): 55 | 56 | ![Inside Sessions Folder](data-recovery/in-sessions-folder.png) 57 | 58 | The name of these folders (e.g. `20180405-165510-1128`) has a meaning, 59 | which is `YYYYMMDD-HHMMSS-PID`: 60 | 61 | * `YYYY`, `MM`, `DD`: Date (year, month, day) when the session 62 | started (when Aseprite was launched). 63 | * `HH`, `MM`, `SS`: Time (hour, minute, second) of that day when the session started. 64 | * `PID`: Process number/identifier of the Aseprite instance that was 65 | handling that session folder. 66 | 67 | Each of these folders contain useful data to restore some sprites that 68 | you might have lost in the crash. 69 | 70 | If you aren't able to recover your sessions using the "Recover Files" 71 | option from "Home" tab, but you have one of these 72 | `sessions/YYYYMMDD-HHMMSS-PID` folder in your [Preferences Folder](preferences-folder.md), 73 | you can compress one of those folders into a `.zip` and send it to 74 | [support@aseprite.org](mailto:support@aseprite.org), and we can 75 | try to recover your data. 76 | 77 | --- 78 | 79 | **SEE ALSO** 80 | 81 | [Troubleshooting](troubleshooting.md) | 82 | [Preferences Folder](preferences-folder.md) | 83 | [Blog Article About Data Recovery Internals](https://dev.aseprite.org/2015/06/14/data-recovery/) 84 | -------------------------------------------------------------------------------- /layers.md: -------------------------------------------------------------------------------- 1 | # Layers 2 | 3 | One sprite can be subdivided into several layers. You can see them 4 | in the [timeline](timeline.md): 5 | 6 | ![Layer in timeline](layers/layer-in-timeline.png) 7 | 8 | Each layer has several options: 9 | 10 | ![Layer icons](layers/layer-options.png) 11 | 12 | *Layer Name*: Text to identify this layer. You can change the layer 13 | name by double-clicking the layer, or from the *Layer > Properties* menu (Shift+P key). 14 | 15 | *Cels*: A set of [cels](cel.md), frames that contain something 16 | visible for this specific layer in the specific frame. 17 | 18 | *Visible*: It indicates if the layer is visible ![Visible layer icon](layers/visible-layer.png) 19 | or hidden ![Hidden layer icon](layers/hidden-layer.png). You can switch the layer visibility 20 | using *Layer > Visible* menu or Shift+X key. 21 | 22 | *Locked*: If the layer is locked ![Locked layer icon](layers/locked-layer.png), you cannot draw on it. 23 | By default all layers are unlocked/editable ![Editable layer icon](layers/editable-layer.png). 24 | 25 | *Continuous*: This option is used to indicate what kind 26 | of [cels](cel.md) you prefer when they are created for this 27 | specific layer. See the [Continuous Layers](continuous-layers.md) 28 | section for more information. 29 | 30 | ### Common Operations 31 | 32 | * [Add new layer](new-layer.md) 33 | * [Move layers](move-layers.md) 34 | * [Copy layers](copy-layers.md) 35 | 36 | ## Background Layer 37 | 38 | The background layer is an opaque layer (without alpha/transparent 39 | component) that cannot be moved. It's created by default when you 40 | select an opaque color in the *File > New* window, or when you open a 41 | file (e.g. a `.png` file) that doesn't contain the alpha component. 42 | 43 | A sprite can contain only one background layer and it's always at the 44 | bottom of the layers stack in the [timeline](timeline.md). 45 | 46 | When you select a portion of the background layer and clear it (using 47 | *Edit > Clear* menu), the selection will be cleared with the active 48 | [background color](color-bar.md). 49 | 50 | ## Transparent Layers 51 | 52 | All layers with an alpha channel are called transparent layers. 53 | You can have several of these in the same sprite. 54 | You can stack them as you want using the [timeline](timeline.md). 55 | And you can displace these layers using the [Move tool](move-tool.md) ![Move tool icon](tools/move-tool.png)). 56 | 57 | When you select a portion of a transparent layer and clear it (using 58 | *Edit > Clear* menu), the selection will be cleared with 59 | [transparent color](transparent-color.md). 60 | 61 | You can use *Layer > New > New Layer* menu or Shift+N to 62 | create a new transparent layer. 63 | 64 | ## Background from Layer 65 | 66 | If there is no background layer, you can convert any transparent 67 | layer to the background using the *Layer > Convert To > Background* 68 | menu. All transparent pixels will be filled with the active 69 | [background color](color-bar.md#background-color). 70 | 71 | > Previously, on Aseprite v1.2 the option was *Layer > Background from Layer* 72 | 73 | ## Layer from Background 74 | 75 | If you want to convert the background to a transparent layer 76 | (e.g. because you want to move it with the [Move tool](move-tool.md) 77 | ![Move tool icon](tools/move-tool.png)), you can use the 78 | *Layer > Convert To > Layer* menu. 79 | 80 | > Previously, on Aseprite v1.2 the option was *Layer > Layer from Background* 81 | 82 | ## Layer Group 83 | 84 | You can [group layers](layer-group.md) to handle a set of layers as 85 | one unit. 86 | 87 | ## Tilemap Layer 88 | 89 | Since **Aseprite v1.3**, you can create [tilemap layers](tilemap.md) 90 | from *Layer > New > New Tilemap Layer* menu or using Space+N. 91 | You can also use *Layer > Convert To > Tilemap* from any regular transparent 92 | layer (the tiles will be created from the active grid settings). 93 | 94 | ## New Layers from Selection 95 | 96 | * Ctrl+J or ⌘J: Copies the [selection](selecting.md) and creates a new layer from it 97 | * Ctrl+Shift+J or ⇧⌘J: Cuts the [selection](selecting.md) and creates a new layer from it 98 | 99 | --- 100 | 101 | **SEE ALSO** 102 | 103 | [Timeline](timeline.md) | 104 | [Continuous Layers](continuous-layers.md) | 105 | [Move tool](move-tool.md) 106 | -------------------------------------------------------------------------------- /basics.md: -------------------------------------------------------------------------------- 1 | # Basics 2 | 3 | Here you can learn the basic principles behind Aseprite. 4 | 5 | In Aseprite, a [sprite](sprite.md) consists of a sequence of frames 6 | and a stack of layers. The intersection of frames and layers creates 7 | an array of editable graphic [cels](cel.md) with images/pixels that 8 | can be [edited](drawing.md) with the [sprite editor](sprite-editor.md). Layers, frames, 9 | and cels are visible in the [timeline](timeline.md): 10 | 11 | ![Timeline Overview](sprite/sprite-components.png) 12 | 13 | ## Basic Elements of a Sprite 14 | 15 | A frame is a single still image in a sprite. Adding and altering 16 | frames creates a sequence of images called an 17 | [animation](animation.md). The details of how Aseprite cycles through 18 | frames is described in greater detail in the [animation 19 | section](animation.md). Frames are represented horizontally in the 20 | timeline, from left to right. 21 | 22 | Each frame's image is produced from a stack of one or more 23 | [layers](layers.md), represented in order from bottom to top on the 24 | timeline. Layers at the bottom of the timeline are drawn first, and every 25 | subsequent layer is added over top of it. Layers assist you by dividing 26 | a single complex image into separate graphic component parts. 27 | 28 | Each frame-layer intersection is called a [cel](cel.md). The contents 29 | of any specific cel may be moved, edited, and deleted without 30 | affecting the contents of other cels, which make them ideal for 31 | isolating and editing specific elements of a graphic while preserving 32 | parts that do not change. 33 | 34 | ## Workflow 35 | 36 | The basic [workflow](workflow.md) is: 37 | 38 | * [Create a new sprite](new-sprite.md) from *File > New* menu. 39 | * [Draw](drawing.md) with pencil tool ![Pencil Tool Icon](tools/pencil-tool.png) using 40 | Left click or Right click, and pick colors from the 41 | [color bar](color-bar.md) using those same buttons. 42 | * [Save your work](save.md) from *File > Save* menu as an 43 | `.aseprite` file to preserve all your image information (layers, frames, 44 | etc.. Also stores certain [workspace](workspace.md) preferences.). 45 | * [Export your sprite](exporting.md) as a `.gif` file to publish your 46 | image on a website, as a numbered sequence of individual `.png` 47 | files (one file per frame), or as a single `.png` file with all 48 | frames arranged in a single row or column, or as a 2-D [sprite sheet](sprite-sheet.md). 49 | 50 | See the [workspace](workspace.md) to learn more about the elements of the 51 | window. See the [workflow](workflow.md) section for more details. 52 | 53 | ## A hand on the keyboard 54 | 55 | You should put your left hand on the keyboard *(or your right hand if 56 | you are left-handed)*. As there are some handy keyboard shortcuts, you 57 | can use them from the very beginning to make better use of Aseprite: 58 | 59 | * Keys 1, 2, 3, 4, 60 | 5, and 6 can be used to change the 61 | [zoom](zoom.md) (you can use the Mouse Wheel to change zoom too). 62 | * B key is the Pencil tool, and M the rectangular marquee, maybe the 63 | most common tools that you will use. 64 | * Alt+click allows you to pick colors from the active image 65 | using the Eyedropper tool ![Eyedropper Tool Icon](tools/eyedropper-tool.png): 66 | Alt+Left click samples the Foreground Color, 67 | Alt+Right click samples the Background Color. 68 | * The Ctrl key (or ⌘ on macOS) can be used to 69 | select the [Move tool](move-tool.md) ![Move Tool Icon](tools/move-tool.png). 70 | With it you can easily select or move layers. 71 | * The Tab key hides and reveals the 72 | [timeline](timeline.md). If your timeline is ever missing, this is 73 | the fastest way to reveal it! 74 | 75 | * Holding Spacebar as you Left click+Drag will 76 | pan your view of the sprite you are currently editing. This is useful when 77 | you're working on large graphics or are zoomed-in. 78 | 79 | ## Alternative functions for right-click 80 | 81 | By default, Right click paints with the [Background Color](color-bar.md#background-color), 82 | but you can change this configuration from [*Edit > Preferences > Editor*](right-click.md). 83 | 84 | --- 85 | 86 | **SEE ALSO** 87 | 88 | [Workspace](workspace.md) | 89 | [Workflow](workflow.md) | 90 | [Sprite](sprite.md) 91 | -------------------------------------------------------------------------------- /context-bar.md: -------------------------------------------------------------------------------- 1 | # Context Bar 2 | 3 | The context bar shows specific options for the active tool. It also 4 | changes depending on the state of the active document (e.g. when the selection is moved). You can find the context bar directly above the [sprite editor](sprite-editor.md) view: 5 | 6 | ![Context bar location](context-bar/contextbar.png) 7 | 8 | ## Pencil tool & other painting tools 9 | 10 | This is the context bar for the Pencil tool: 11 | 12 | ![Context bar for pencil tool](context-bar/pencil.png) 13 | 14 | The context bar for most painting tools looks similar to this, with a few options added or removed. 15 | 16 | ### Brush type, custom brushes, & brush angles 17 | 18 | See the [brushes section](brushes.md). 19 | 20 | ### Brush size 21 | 22 | The brush size (in pixels). To quickly change the size of the brush, you can use Ctrl+Alt and drag. 23 | 24 | ### Ink 25 | 26 | See the [ink section](ink.md). 27 | 28 | ### Dynamics 29 | 30 | See the [dynamics section](dynamics.md). 31 | 32 | ### Pixel-perfect mode 33 | 34 | Enables/disables pixel-perfect strokes. 35 | 36 | ![pixel-perfect mode example](context-bar/pixelperfect.png) 37 | 38 | ### Opacity 39 | 40 | ![opacity example](context-bar/opacity.png) 41 | 42 | While it isn't an option in the pencil tool, you can find the opacity option in some of the other painting tools. This changes the transparency of the tool, with `100%` being fully opaque and `0%` being fully transparent. 43 | 44 | ## Selection tools 45 | 46 | ![Context bar for selection tools](context-bar/selection.png) 47 | 48 | See the [selection section](selecting.md) for selecting and the [rotation section](rotate.md) for rotating and pivot. 49 | 50 | ### Transparent Color & Transparent Color Options 51 | 52 | The Transparent Color option allows you to change the transparent color for the selection. 53 | 54 | ![Transparent color example](context-bar/transparent.gif) 55 | 56 | In the Transparent Color Options, you can change whether the transparent color in the selection is opaque or transparent. Shown above is transparent mode. 57 | 58 | ## Moving selection 59 | 60 | ![Context bar when moving the selection](context-bar/movingselection.png) 61 | 62 | See the [move selection section](move-selection.md). 63 | 64 | ## Eyedropper tool 65 | 66 | ![Context bar for eyedropper tool](context-bar/eyedropper.png) 67 | 68 | See the [eyedropper section](eyedropper.md). 69 | 70 | ## Paint Bucket 71 | 72 | ![Context bar for paintbucket tool](context-bar/paintbucket.png) 73 | 74 | ### Tolerance 75 | 76 | ![Tolerance example](context-bar/tolerance.gif) 77 | 78 | The paint bucket tolerance adjusts if a similar color will be filled, with `0` being only the exact color will be filled and `255` being all colors will be filled. 79 | 80 | ### Contiguous mode 81 | 82 | Contiguous mode toggles between only selecting connected pixels of the same color or all pixels of the same color. 83 | 84 | ### Extra options 85 | 86 | ||| 87 | |-|-| 88 | |Stop at grid| When in Contiguous mode and when the grid is enabled, stop filling at a grid line. 89 | || 90 | 91 | ||| 92 | |-|-| 93 | |Refer active layer| Fills based on the active layer. 94 | |Refer visible layers | Fills based on the visible layers. The filled area is still on the active layer, so the visible layers act as masks. 95 | || 96 | 97 | ||| 98 | |-|-| 99 | |4-Pixel Connectivity| When in Contiguous mode, don't treat diagonal pixels as connected. 100 | |8-Pixel Connectivity| When in Contiguous mode, treat diagonal pixels as connected. 101 | || 102 | 103 | ## Gradient tool 104 | 105 | ![Context bar for gradient tool](context-bar/gradient.png) 106 | 107 | The Gradient tool has the same options the Paint Bucket has, along with these extra ones. 108 | 109 | ### Gradient type 110 | 111 | Toggles between a linear and radial gradient. 112 | 113 | ### Dithering options 114 | 115 | ![Dithering options](context-bar/dithering.png) 116 | 117 | - No dithering 118 | - Bayer Matrix 2x2 119 | - Bayer Matrix 4x4 120 | - Bayer Matrix 8x8 121 | 122 | ## Text tool 123 | 124 | ![Context bar for text tool](context-bar/text.png) 125 | 126 | ### Font selector 127 | 128 | Picks the font to use. 129 | 130 | ### Font size 131 | 132 | Changes the font size. Depending on the font, some font sizes may have the `*` symbol next to them, indicating that the size is to pixel scale with the font. 133 | 134 | ### Font formatting 135 | 136 | Changes the font formatting. Options: 137 | 138 | - Bold 139 | - Italic 140 | 141 | - Antialias - Toggles antialising, which smoothes out the text. 142 | - Hinting - Toggles hinting, which aligns the font to the pixel grid. 143 | - Ligatures - Toggles ligatures. 144 | 145 | ## Move tool 146 | 147 | ![Context bar for move tool](context-bar/move.png) 148 | 149 | Selects layers based on which layer the clicked content is on. 150 | 151 | ## Slice tool 152 | 153 | See the [slices section](slices.md). 154 | 155 | --- 156 | 157 | **SEE ALSO** 158 | 159 | [Workspace](workspace.md) | 160 | [Drawing](drawing.md) -------------------------------------------------------------------------------- /tutorial.md: -------------------------------------------------------------------------------- 1 | # Aseprite Tutorials 2 | 3 | ## Tutorials by Users 4 | 5 | Sometimes pixel-artists want to share their magical knowledge to the 6 | world. And we are grateful that they use Aseprite for this: 7 | 8 |
9 |
10 |

Thanks to Adam

11 | 12 |
13 |
14 |

Thanks to Mort

15 | 16 |
17 |
18 |
19 |
20 |

Thanks to Sadface

21 | 22 |
23 |
24 |

Thanks to Pixel Principles

25 | 26 |
27 |
28 | 29 | ## Common tasks and questions 30 | 31 | ### Animation 32 | 33 | * [Move several cels using Move tool](http://imgur.com/sG8dGbN) [(2)](http://imgur.com/jNSwKmL) 34 | * [Change Preview animation speed with right-click on Play button](http://imgur.com/wD1aoDM) 35 | * [Set loop section](http://imgur.com/Zffmgm8) 36 | * [Backward/reverse animation loop](https://www.youtube.com/watch?v=E-mI679DVBk) 37 | * [Create animation tags/tag frames](http://imgur.com/t3ZGRzw) 38 | * [Animated preview](http://imgur.com/eRmPum3) 39 | * [Copy cels with drag-and-drop](http://imgur.com/c0lpNdz) 40 | * [Copy cels with drag-and-drop outside the animation range](http://imgur.com/OcIjFXQ) 41 | * [Remove several layers and frames](http://imgur.com/VYy7oi3) 42 | * [Enable red/blue onionskin tint](http://imgur.com/qJZiq82) 43 | * [Change onionskin extension/number of frames](http://imgur.com/hZyytnc) [(2)](http://imgur.com/cKZGGrb) 44 | * [Change cel opacity in several frames](http://imgur.com/7Ntp1eY) 45 | 46 | ### Color/Palette 47 | 48 | * [Copy/cut/paste/clear colors](http://imgur.com/YUq04tF) [(2)](http://imgur.com/O35BgGs) 49 | * [Edit palette colors with relative mode/sliders](http://imgur.com/IBIgdtv) 50 | * [Create a color gradient](http://imgur.com/SEDgZ94) 51 | * [Reverse colors](http://imgur.com/GwZHckb) 52 | * [Sort colors by Luminance](http://imgur.com/MngwkmP) 53 | * [Drag-and-drop colors](http://imgur.com/wmpuVaA) 54 | * [Pin and move foreground color selection popup](http://imgur.com/zZC0SGo) 55 | * [Remap indexes after modifying the color palette](http://imgur.com/1sXGP3o) [(2)](http://imgur.com/UlBnMTE) 56 | * [Create a palette from RGB sprite](http://imgur.com/5TPFdoe) 57 | * [Load a palette preset in Aseprite v1.0](http://imgur.com/nlLvOHv) 58 | * [Painting with index 0/transparent color in a transparent layer](http://imgur.com/9enwCxe) 59 | * [Reduce a color palette](http://imgur.com/IfrVyfd) 60 | * [Dark and light a pixel color on a RGB sprite](http://imgur.com/t8Z8d2N) 61 | 62 | ### Save/Export 63 | 64 | * [Add padding/border/margin in exported Sprite Sheet](http://imgur.com/19Dl9wJ) 65 | * [Save as gif file](http://imgur.com/Rmr3P1j) 66 | 67 | ### Misc 68 | 69 | * [Create new brush from selection or using Ctrl+B](http://imgur.com/2ke4Xgw) 70 | * [Flip the whole sprite](http://imgur.com/okxOor9) 71 | * [Rotate a selection](http://imgur.com/SDcDoYW) 72 | 73 | ### User Interface 74 | 75 | * [Set colors in timeline elements](https://www.youtube.com/watch?v=YLzI0CoGrNg) 76 | * [Set grid size from selection or by numbers](http://imgur.com/7zYjw1R) [(2)](http://imgur.com/cbdZp2x) 77 | * [Set default checked background colors](http://imgur.com/CmTVmCN) 78 | * [Copy tabs using drag-and-drop with Ctrl or Alt keys](http://imgur.com/RCOjyY8) 79 | * [Drag-and-drop tabs](http://imgur.com/WiXPPgg) 80 | * [Enable 'Use native mouse cursor' experimental feature](http://imgur.com/lO0OgBl) 81 | * [Report a crash/memory dump on Windows](http://imgur.com/9MTYI9k) 82 | * [Locate configuration file](http://imgur.com/PRZ4AaZ) 83 | 84 | ## Demos 85 | 86 | * [Canvas size options/buttons](http://imgur.com/Jnkje0r) 87 | * [Brush shortcuts and modes](http://imgur.com/jyP6H7g) 88 | * [Difference between Continuous/Discontinuous layer modes](http://imgur.com/iAapATy) 89 | * [(Bezier) Curve tool with zoom in/out while drawing](http://imgur.com/uGYfPxE) 90 | * [Auto select option in Move tool](http://imgur.com/wnXpdwU) 91 | * [Zoom in/out in an huge sprite + transparent pixel grid](http://imgur.com/UdXJMPr) [(2)](http://imgur.com/osjvyJ0) 92 | * [Contour and polygon tools](http://imgur.com/5V0qOmj) 93 | * [Ink modes](http://imgur.com/Kfi2WxF) 94 | * [Selection modes](http://imgur.com/o7F4s6o) (replace, addition, subtraction) 95 | * [Pixel-perfect algorithm](http://imgur.com/uiyzvcY) 96 | * [Replace Color in indexed mode, drag-and-drop from a color selector](http://imgur.com/VAVpHUl) [(2)](http://imgur.com/yUBtO2u) 97 | * [Filter modes (in current cel, every cel in current layer, every cel in current frame, all cels)](http://imgur.com/J6L5M5Q) [(2)](http://imgur.com/Zp1gANL) 98 | * [Fill with a pattern using a custom brush an paint-bucket tool](http://imgur.com/zWaqLKJ) 99 | -------------------------------------------------------------------------------- /extensions/themes.md: -------------------------------------------------------------------------------- 1 | # Extensions: Themes 2 | 3 | A theme extension is a way to modify the look & feel of the User 4 | Interface (UI) of Aseprite. There is a set of known themes in the 5 | [themes](https://github.com/aseprite/themes) repository. 6 | 7 | Content a `.aseprite-extension` file for a theme extension: 8 | 9 | ``` 10 | theme-example.aseprite-extension 11 | | 12 | +-- package.json 13 | | 14 | +-- theme.xml 15 | | 16 | +-- sheet.png 17 | | 18 | +-- sheet.aseprite-data 19 | ``` 20 | 21 | Content of the `package.json` file: 22 | 23 | ``` 24 | { 25 | "name": "your-theme", 26 | "displayName": "Your Theme", 27 | "description": "Your Theme", 28 | "version": "1.0", 29 | "author": { "name": "Your Name", "email": "your@email.com", "url": "http://your.website/" }, 30 | "publisher": "aseprite", 31 | "license": "CC-BY-4.0", 32 | "categories": [ 33 | "Themes" 34 | ], 35 | "contributes": { 36 | "themes": [ 37 | { "id": "your-theme", "path": "." } 38 | ] 39 | } 40 | } 41 | ``` 42 | 43 | The given `"path"` property is a directory (generally `.` which means 44 | the same directory where the `package.json` file is located), and this 45 | directory must contain a set of files: 46 | 47 | * [`theme.xml`](#theme-xml) 48 | * [`sheet.png`](#sheet-png) 49 | * [`sheet.aseprite-data`](#sheet-aseprite-data) 50 | 51 | ## theme.xml 52 | 53 | This is the most complex file of the theme, it's divided in several sections: 54 | 55 | ```xml 56 | 57 | 58 | ... 59 | ... 60 | ... 61 | ... 62 | ... 63 | ... 64 | 65 | ``` 66 | 67 | For an example you can see the official default [theme.xml](https://github.com/aseprite/aseprite/blob/master/data/extensions/aseprite-theme/theme.xml). 68 | 69 | In a perfect world Aseprite should use only ` 177 | 178 | ... 179 | 180 | 181 | ``` 182 | 183 | ## sheet.png 184 | 185 | A [sprite sheet](sprite-sheet.md) with the content of each theme 186 | part. It means that for each `` element from `theme.xml`: 187 | 188 | ```xml 189 | 190 | 191 | 192 | .... 193 | 194 | 195 | ``` 196 | 197 | You will have a sprite in the ``'s area. 198 | 199 | ## sheet.aseprite-data 200 | 201 | This is an auxiliary file used by Aseprite. When we load the 202 | `sheet.png` file, if Aseprite finds this `sheet.aseprite-data` file, 203 | it will create one slice for each theme part from `theme.xml` (the 204 | same when we save the `sheet.png` from Aseprite, the theme parts will 205 | be kept in sync with the slices): 206 | 207 | ```xml 208 | 209 | 210 | 211 | 212 | ``` 213 | 214 | --- 215 | 216 | **SEE ALSO** 217 | 218 | [Extensions](extensions.md) 219 | -------------------------------------------------------------------------------- /keyboard-shortcuts.md: -------------------------------------------------------------------------------- 1 | # Keyboard Shortcuts 2 | 3 | You can customize the keyboard shortcuts or the combination of keys + 4 | [mouse wheel](mouse-wheel.md) (or [mouse movement](drag-value.md)) 5 | from *Edit > [Keyboard Shortcuts](keyboard-shortcuts.md)* 6 | menu option or Ctrl+Alt+Shift+K key (or ⌥⇧⌘K on macOS). 7 | 8 | There is a general overview of the default keyboard shortcuts in the [Quick Reference](/quickref/) page. 9 | 10 | ## Menus & Commands 11 | 12 | In these sections you will find a way to assign a key to every 13 | action/command in Aseprite that is accessible from the [menu bar](menu-bar.md) 14 | and other commands that are not part of the main menu but are still 15 | accessible for advanced users (e.g. "Set Ink Type" 16 | is not associated to any menu or has default keyboard shortcut, but 17 | you can assign a key from the "Commands" section). 18 | 19 | Remember to use the search field in this dialog to filter and find a 20 | specific command. 21 | 22 | ## Tools 23 | 24 | In the Tools section you will find a way to see and change the keys 25 | associated with each tool from the [Tool Bar](tool-bar.md). There are 26 | two main considerations: 27 | 28 | 1. Two or more tools can share the same key. In this case pressing the 29 | key multiple times will switch/go through all the tools that have 30 | the same key assigned. E.g. U key is assigned to the 31 | ![Rectangle icon](tools/rectangle-tool.png) Rectangle and 32 | ![Filled Rectangle icon](tools/filled-rectangle-tool.png) Filled Rectangle 33 | by default, so pressing one time 34 | will select the Rectangle tool, and pressing it a second time will 35 | switch to the Filled Rectangle. 36 | 2. There are two ways to select a tool: 37 | * A regular way to change the 38 | active tool, it's when you press a key and the active tool changes so 39 | all the following mouse buttons will interact with that tool. 40 | E.g. pressing the P key switches to the ![Pencil icon](tools/pencil-tool.png) Pencil 41 | tool, or the H key selects the ![Hand icon](tools/hand-tool.png) Hand 42 | tool as the active one, so then you can pan the [sprite editor](sprite-editor.md) 43 | just dragging it with the left mouse button + moving the mouse 44 | without pressing any other key. 45 | * An alternative quick way (identified as "(quick)" in the *Keyboard Shortcuts* dialog) 46 | where the tool is active while you keep the key pressed (and then Aseprite 47 | returns to the previously selected tool when you release the key). 48 | This happens with the Alt key to select the ![Eyedropper icon](tools/eyedropper-tool.png) Eyedropper tool 49 | or the Space bar key to select the ![Hand icon](tools/hand-tool.png) Hand tool temporarily. 50 | Here an example of how the ![Hand icon](tools/hand-tool.png) Hand tool 51 | looks in the configuration: 52 | 53 | ![Hand tool example](keyboard-shortcuts/hand-shortcuts.png) 54 | 55 | ## Action Modifiers 56 | 57 | These actions depend on a specific context in Aseprite, for example 58 | when you have a selection tool, or you are scaling a selection, etc. 59 | The given keys are the default options. 60 | 61 | The following is the list of contexts and the possible actions inside 62 | that context: 63 | 64 | * **Freehand Tool**: When the ![Pencil icon](tools/pencil-tool.png) Pencil tool 65 | is active. 66 | * **Straight Line from Last Point**: Use the Shift key 67 | to create a straight line from the last painted pixel with the brush. 68 | * **Angle Snap from Last Point**: Add the Ctrl key 69 | to snap the angle of that straight line. 70 | 71 | * **Move Tool**: When you are using the ![Move Tool Icon](tools/move-tool.png) Move tool. 72 | * **Auto Select Layer**: If you press the Ctrl (or ⌘ on macOS) 73 | you'll select the layer that is above the cursor with a single click. 74 | * **Shape Tool**: These keys can be used while you are drawing (after pressing & before releasing the mouse button) 75 | with a rectangular or elliptical-like tool (e.g. ![Rectangle Icon](tools/rectangle-tool.png) Rectangle, 76 | ![Ellipse Icon](tools/ellipse-tool.png) Ellipse, 77 | ![Rectangular Marquee Icon](tools/marquee-tool.png) Rectangular Marquee, etc.). 78 | * **Square Aspect**: You can use the Shift key to create a square or a circle. 79 | * **Draw From Center**: You can use the point where the mouse was 80 | pressed as the center of the shape when pressing the Ctrl key, e.g. to create an ellipse specifying the center (instead of both corners). 81 | * **Rotate Shape**: Pressing the Alt you start rotating the shape. 82 | * **Move Origin**: You can press the Space key to move the 83 | whole shape to a new position before releasing the mouse button, just in case 84 | the origin was not specified correctly. 85 | * **Selection**: When we have any selection tool we can use some keys to 86 | change what to do with the selected area. 87 | * **Add/Subtract/Intersect Selection**: These options 88 | are explained in the [Selecting](selecting.md#add/subtract/intersect) section. 89 | * **Translating Selection**: When you're moving the selection. 90 | * **Snap To Grid**: Pressing Alt the selection will snap to grid. 91 | * **Lock Axis**: You can use Shift to lock the movement in the X or Y axis only. 92 | * **Copy Selection**: With Ctrl key you can copy the 93 | selection if you press it *before* you start moving the 94 | selection. 95 | * **Fine Translating**: When you are moving the selection, pressing 96 | the Ctrl will start a fine-tuning movement (not only 97 | pixel by pixel, but by subpixels). 98 | * **Scaling Selection**: When you're scaling the selection. 99 | * **Maintain Aspect Ratio**: Press Shift key to keep the 100 | ratio between width/height intact. 101 | * **Scale From Center**: Scale from the center (or current pivot 102 | position) using the Alt key. 103 | * **Fine Scaling**: When you are scaling the selection, pressing 104 | the Ctrl will start a fine-tuning scaling (not only 105 | pixel by pixel, but by subpixels). 106 | * **Rotating Selection**: When you're rotating the selection. 107 | * **Angle Snap**: You can use the Shift key to snap the 108 | angle to angles of 26.6°, 45°, 90°, etc. 109 | 110 | * **Trigger Left/Right Mouse Button**: You can configure a specific 111 | key to simulate the left/right mouse buttons inside the [sprite 112 | editor](sprite-editor.md). 113 | 114 | ## Keyboard + Mouse 115 | 116 | You can configure to trigger some special actions when a key is 117 | pressed and the mouse wheel is moved (or the mouse itself is moved in 118 | a specific axis): 119 | 120 | * [Mouse Wheel](mouse-wheel.md) 121 | * [Drag Value](drag-value.md) 122 | 123 | --- 124 | 125 | **SEE ALSO** 126 | 127 | [Preferences](preferences.md) | 128 | [Customization](customization.md) 129 | -------------------------------------------------------------------------------- /preferences.md: -------------------------------------------------------------------------------- 1 | # Preferences 2 | 3 | You can change the configuration of Aseprite from the *Edit > 4 | Preferences* menu or pressing Ctrl+K key (or ⌘K 5 | or ⌘, on macOS). In case that you are looking to configure 6 | the keyboard shortcuts, that's done through 7 | the *[Edit > Keyboard Shortcuts](keyboard-shortcuts.md)* menu option. 8 | 9 | The Aseprite preferences are stored in `aseprite.ini` in the [preferences folder](preferences-folder.md). 10 | 11 | The Preferences dialog is divided in several sections: 12 | 13 | ## General 14 | 15 | * **User Interface**: 16 | 17 | One window mode ![ui-one](preferences/ui-one-window.png): Menus cannot be moved outside of the main Aseprite menu. 18 | 19 | Multi-window mode ![ui-multi](preferences/ui-multi-window.png): Menus can be moved outside of the main Aseprite menu. 20 | 21 | * **Light** | **Dark** options: Since v1.3, you can quickly change between 22 | a Light version of the Aseprite theme and a Dark one. 23 | * **Screen Scaling**: Changes the size of each pixel inside every 24 | window of Aseprite. It's 200% by default, which means that each 25 | pixel in the window will be represented with a 2x2 square on the 26 | screen. When using large monitors (e.g. 4K monitors), you can try 27 | changing to 300% or 400%. If you want to see each pixel of your 28 | sprite represented as one pixel on the screen, you should set this 29 | option to 100%, in this case it's highly probable that you will want 30 | to increase the next option (*UI Elements Scaling*) to 200% or more 31 | if needed. 32 | * **UI Element Scaling**: It's an extra scale applied only to elements 33 | of the User Interface (buttons, labels, etc.), but without modifying 34 | the scale of the sprite editor. It's 100% by default. 35 | * **Language**: The language of the User Interface, English by default, 36 | but you can get some translations contributed by users from: 37 | https://github.com/aseprite/languages. 38 | * **Show Aseprite menu bar** (only available on macOS): The [Aseprite 39 | menu bar](menu-bar.md) is visible by default on Windows and Linux: 40 | 41 | ![Aseprite Menu Bar](menu-bar/aseprite-menubar.png) 42 | 43 | But it's hidden by default on macOS, as in macOS you can use the 44 | system menu bar: 45 | 46 | ![macOS Menu Bar](menu-bar/macos-menubar.png) 47 | 48 | 49 | * **Show Aseprite file dialog**: Use custom Aseprite file viewer menu. 50 | * **Show Home tab when Aseprite is started**: Shows the Home tab when Aseprite is started. 51 | * **Expand menu bar items on mouseover**: With this option checked, 52 | when the mouse is above the [Aseprite menu bar](menu-bar.md), a menu 53 | will be opened automatically. By default this is disabled, so you 54 | have to click a menu to open it. 55 | * **Draw a separation between each palette entry**: Draws a black 1px line between each palette entry in the[ color bar](color-bar.md). 56 | * **Share crash data with Aseprite developers**: When Aseprite crashes 57 | (unexpectedly closes) you will be asked to share some crash 58 | information automatically in the future privately with the Aseprite 59 | team. Aseprite doesn't do this by default (this option is unchecked 60 | by default), so you have to give your consent to share this 61 | information. More details in 62 | [#2857](https://github.com/aseprite/aseprite/issues/2857). 63 | 64 | ## Tablet 65 | 66 | See the [tablet](tablet.md) section. 67 | 68 | ## Files 69 | 70 | * **Default extensions**: Pick the default file extensions for saving/exporting actions. 71 | * **Recent Items**: The number of recent file/folder items to show on the home page and *File > Open Recent* dropdown. 72 | * **Recover files options**: These options handle the intervals to save sprite recovery data. 73 | 74 | ## Color 75 | 76 | * **Alpha & Opacity Ranges**: Whether alpha/opacity color ranges use `0-255` or `0%-100%` ranges. 77 | 78 | ![ranges example](preferences/ranges.png) 79 | 80 | * **Color management**: See the [color profile](color-profile.md) section. 81 | 82 | ## Alerts 83 | 84 | Several (non-undoable) actions on Aseprite show a warning message with 85 | a *Don't show this alert again* checkbox: 86 | 87 | ![Alert example](preferences/show-alert.png) 88 | 89 | You can re-enable these dialogs from *Edit > Preferences > Alerts*. 90 | 91 | ## Editor 92 | 93 | Options to change the general behavior of the [Sprite Editor](sprite-editor.md): 94 | 95 | * **Zoom with scroll wheel**: Checked by default, you zoom with the 96 | [mouse wheel](mouse-wheel.md) (if you uncheck this, the vertical scroll will be the 97 | default action for the mouse wheel). 98 | * **Zoom sliding two fingers up or down (macOS)**: This is available on macOS 99 | only, and if you enable it you will be able to zoom using two 100 | fingers on your MacBook trackpad. 101 | * **Zoom from center with scroll wheel**: Check this if you want to 102 | [zoom](zoom.md) from the center of the sprite editor instead zooming 103 | from the mouse position when the mouse wheel is used. 104 | * **Zoom from center with keys**: Zoom from the center of the sprite 105 | instead of the mouse position when you use the keys 106 | [to zoom](zoom.md) 1, 2, 3, etc. 107 | * **Show scroll-bars in sprite editor**: Uncheck this to hide the 108 | scroll bars on all sprite editors. 109 | * **Auto-scroll on editor edges**: With this option checked, when you 110 | are [drawing](drawing.md) (have the mouse button pressed) and the 111 | mouse touches the edges of the sprite editor, it will scrolls 112 | automatically. 113 | * **Auto-fit on screen when a sprite is opened**: When it's checked, 114 | after you create a new sprite or open an existing one, the editor 115 | will show the whole image fitting it in the available space of the 116 | canvas. When this option is unchecked (the default option), the 117 | initial zoom level will be 100% by default. 118 | * **Preview straight line immediately on Pencil tool**: When you use 119 | the ![Pencil icon](tools/pencil-tool.png) Pencil tool, pressing 120 | the Shift key will draw a straight line from the last painted 121 | point. With this option checked, you will see the line preview 122 | immediately after pressing the Shift key (instead of 123 | waiting for the mouse button). If this is too annoying for you, you 124 | can uncheck the option. 125 | * **Discard custom brush when eyedropper is used**: If you create a 126 | custom brush with *Edit > New Brush* option, using the eyedropper 127 | ![Eyedropper tool icon](tools/eyedropper-tool.png) tool will change 128 | the color of your brush. Checking this option, after picking a color 129 | with the eyedropper, the custom brush will be completely discarded 130 | and a regular brush with the picked color will be selected. 131 | * **Downsampling**: The algorithm to use to show the sprite when the 132 | zoom level is <= 50%. By default it's *Bilinear mipmapping*. 133 | * **Right-click**: You can customize what specific action to do with 134 | the [right-click](right-click.md). 135 | 136 | ## Selection 137 | 138 | * **Adjust opaque/transparent mode automatically**: Adjust the opaque/transparent mode when moving over a layer, e.g: moving over a transparent layer would set the mode to transparent. 139 | * **Keep selection after "Edit > Delete" command**: Keep the selection bounds after deleting the content. 140 | 141 | ![keep selection example](preferences/keep-selection-deleted-content.gif) 142 | 143 | * **Show selection edges automatically when the selection is modified**: Automatically enables *View > Show > Selection Edges* when the selection is moved. This will override the menu setting (e.g: if *View > Show > Selection Edges* is disabled, this will enable it) 144 | * **Allow moving selection edges**: Enabling this allows moving the selection bounds. The selection can only be moved if the mouse is hovering over its edge (the marching ants). 145 | 146 | ![move selection edges example](preferences/move-selection-edges.gif) 147 | 148 | * **Disable transformation handles when key modifiers are pressed**: Disable transformation handles when key modifiers (Shift/Ctrl/Alt) are pressed. 149 | * **Move selection on Add mode**: Enables moving the selection in the [Add selection mode](selecting.md#Add/Subtract/Intersect). 150 | * **Select a grid tile with double-click**: Enables selecting grid tiles with a double-click. 151 | * **Snap To Grid when the option is enabled**: Snap To Grid when *View > Grid > Snap to Grid* is enabled. 152 | * **Force RotSprite even for right/straight angles**: Use the RotSprite rotation algorithm for right/straight angles. 153 | * **Transform cels in selected layers or frames on timeline**: Selection transformations apply to all cels of the selected layers/frames. If this option is disabled, selection transformations will only apply to all selected cels. 154 | 155 | ## Timeline 156 | 157 | * **Show timeline automatically**: Shows the timeline when a new frame or layer is added. 158 | * **Rewind on stop**: Upon stopping, the current frame is reset to the frame the animation was started at (note that it can be a frame other than the first frame). 159 | * **Default First Frame**: Sets the default first frame. 160 | * **Keep selection**: Keep the timeline selection range when the canvas is edited or the timeline loses focus. 161 | * **Select on Click**: Select frames/cels on click. 162 | * **Select on Shift + Click**: Select frames/cels on Shift + Click. 163 | * **Select on Drag**: Select frames/cels when dragging. 164 | * **Drag & drop from edges**: Enable dragging and dropping from frame/cel edges. 165 | 166 | ## Cursors 167 | 168 | * **Use native mouse cursors**: Use the OS's cursor. If disabled, use the custom theme cursor. 169 | * **Mouse cursor scale**: Scale of theme cursor. 170 | * **Crosshair Type**: Change the crosshair type when painting. 171 | 172 | ![crosshair types](preferences/crosshair-types.png) 173 | 174 | * **Brush Preview**: Change the brush preview type when painting. 175 | 176 | ![brush preview types](preferences/brush-preview-types.gif) 177 | 178 | * **Crosshair & Brush Edges Color**: Change the edge color of the crosshair and brush preview edges. 179 | 180 | ![negative black & white](preferences/edge-negative.png) ![specific color](preferences/edge-color.png) 181 | 182 | ## Background 183 | 184 | **Background for New Documents**: Edits the default background for all new documents. 185 | 186 | **Background for the Active Document**: Edits the current document background. 187 | 188 | * **Size**: Sets the background square sizes. 189 | * **Colors**: Sets the background square colors. 190 | 191 | ## Grid 192 | 193 | **Grid for New Documents**: Edits the default grid for all new documents. 194 | 195 | **Grid for the Active Document**: Edits the current document grid. 196 | 197 | * **X & Y**: X and Y grid offsets. 198 | * **Color**: Grid line color. 199 | * **Opacity**: Grid line opacity. 200 | * **Visible Pixel Grid**: Enables/disables the pixel grid. 201 | * **Color**: Pixel grid line color. 202 | * **Opacity**: Pixel grid line opacity. 203 | 204 | ## Guides & Slices 205 | 206 | * **Layer Edges Color.**: Layer edge guide color. 207 | * **Auto Guides Color**: Auto guide color. 208 | 209 | ![guides and edges example](preferences/auto-guides.png) 210 | 211 | * **Default Color**: Default slice edge color. 212 | 213 | ## Undo 214 | 215 | * **Undo Limit**: The memory limit for undo information, in megabytes, for each sprite. 216 | * **Go to modified frame/layer**: Sets the current frame/layer to the one where the undo occurred. 217 | * **Allow non-linear history**: Undo history is a list of sprite states. If non-linear undo history is disabled and undo is used (which moves the current state back one entry), the next action will overwrite the undone action/state. If it is enabled and undo is used, the next action will add the new sprite state to the list, keeping the old one intact. 218 | ![nonlinear undo history example](preferences/nonlinear-undohistory.gif) 219 | * **Show Undo Tooltip**: Show the undo tooltip in the bottom right corner of the window. 220 | 221 | ## Aseprite Format 222 | 223 | * **Cel Content Format**: Changes the cel image format. See https://github.com/aseprite/aseprite/blob/main/docs/ase-file-specs.md#cel-chunk-0x2005. 224 | 225 | ## Experimental 226 | 227 | These features are experimental, and may be removed or changed in the future, which is why they are not listed here. 228 | 229 | ## Reset 230 | 231 | The Reset section contains various editor values to reset. 232 | 233 | To reset a value, select it and press the *Reset* button. 234 | 235 | --- 236 | 237 | **SEE ALSO** 238 | 239 | [Preferences Folder](preferences-folder.md) | 240 | [Reset Preferences](reset-preferences.md) | 241 | [Keyboard Shortcuts](keyboard-shortcuts.md) | 242 | [Customization](customization.md) 243 | --------------------------------------------------------------------------------