Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jbunke/stipple-effect
Stipple Effect is a pixel art editor that supports animation and scripting (available on Windows, macOS and Linux)
https://github.com/jbunke/stipple-effect
animation drawing game-dev game-development game-development-workflow image-editor indie java painting pixel-art pixel-editor software sprite-animation sprite-editor
Last synced: about 1 month ago
JSON representation
Stipple Effect is a pixel art editor that supports animation and scripting (available on Windows, macOS and Linux)
- Host: GitHub
- URL: https://github.com/jbunke/stipple-effect
- Owner: jbunke
- License: other
- Created: 2023-12-09T18:14:11.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-08T14:35:44.000Z (4 months ago)
- Last Synced: 2024-09-09T08:32:59.003Z (4 months ago)
- Topics: animation, drawing, game-dev, game-development, game-development-workflow, image-editor, indie, java, painting, pixel-art, pixel-editor, software, sprite-animation, sprite-editor
- Language: Java
- Homepage: https://flinkerflitzer.itch.io/stipple-effect
- Size: 3.26 MB
- Stars: 500
- Watchers: 1
- Forks: 6
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Roadmap: roadmap.md
Awesome Lists containing this project
README
# ![Stipple Effect](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/logo-anim.gif)
[![Buy on Itch.io](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/buttons/itch.png)](https://flinkerflitzer.itch.io/stipple-effect)
[![Changelog](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/buttons/documentation.png)](https://github.com/jbunke/se-docs)
[![Changelog](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/buttons/api.png)](https://github.com/jbunke/se-api)
[![Changelog](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/buttons/changelog.png)](changelog.md)
[![Roadmap](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/buttons/roadmap.png)](roadmap.md)## About
*Stipple Effect* is a pixel art editor that supports animation and scripting. It is designed to facilitate a variety of workflows and to encourage rapid, iterative creation of video game art assets and other types of artwork.* made by a solo game developer with the needs and skill sets of other indie devs in mind
* lightweight and simple to learn and use, yet allows for considerable depth and complexity
* expressive scripting API that can be used to **automate program actions** and **create dynamic preview and color transformations with complex logic**![Preview](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/complex-preview.gif)
A preview script in action## Features
* Symbiotic relationship between layers and frames
* [Linked and unlinked layers](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/linked-layers.gif)
* [Two-color system: Stipple Effect's brush, pencil, and gradient tool allow for interesting combinations of the primary and secondary colors](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/combination-modes.gif)
* Dither mode
* Blend mode
* Noise mode
* State management
* [Granular undo and redo](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/granular-undo-redo.gif)
* Animation playback
* [Onion skinning](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/onion-skin.gif)
* Edit during playback
* [Split/stitch](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/split-stitch.gif)
* Split a project into frames
* Stitch frames together into a sprite sheet
* Palettes
* Import and export palettes
* [Palettization](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/palettization.gif)
* [Extract colors in a project to a palette](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/extract-colors.gif)
* Selection
* [Family of selection tools designed for pixel-perfect selection](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/selection-tools.gif)
* [Intuitive and powerful outlining utilities](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/outline.gif)
* [Pixel grid](https://raw.githubusercontent.com/jbunke/se-docs/master/assets/graphics/pixel-grid.gif)
* Easily enable/disable and modify the size of the pixel grid cells
* The box select tool can snap to the grid
* And much more!Find out more about the program by reading [the documentation](https://github.com/jbunke/se-docs).
## Scripting
_Stipple Effect_ supports scripts have three main uses: **automation**, **custom previews** and **color transformation**. It is highly recommended for users that want to get the most out of the program to read the API and familiarize themselves with its potential applications.
* [Scripting overview](https://github.com/jbunke/se-docs/blob/master/scripting.md)
* [API](https://github.com/jbunke/se-api)
* [Example scripts](https://github.com/jbunke/se-script-examples)I have created [a VS Code extension](https://marketplace.visualstudio.com/items?itemName=jordanbunke.deltascript-for-stipple-effect) that provides syntax highlighting for *Stipple Effect* scripts.
## External Dependencies
* [Delta Time](https://github.com/jbunke/delta-time) - my lightweight graphics library that handles GUI and execution loop boilerplate
* [ANTLR v4](https://github.com/antlr/antlr4) - lexing and parsing library that powers the _DeltaScript_ interpreter
* [Animation Encoder](https://github.com/jbunke/animation-encoder) - my wrapper for Square's [gifencoder](https://github.com/square/gifencoder) and for [jcodec](https://github.com/jcodec/jcodec)## License
*Stipple Effect* is distributed under an end-user license agreement (EULA). Read it [here](LICENSE) to understand your rights and responsibilities as a user.
## Compile from source instructions
For those who do not have the means to buy *Stipple Effect*, the program can be compiled from source for free:
### Instructions
1. Clone this repository
2. Download and configure external dependencies in your development environment
1. **Delta Time**: [download JAR - instructions in README](https://github.com/jbunke/delta-time)
2. **Animation Encoder**: [download JAR - instructions in README](https://github.com/jbunke/animation-encoder)
3. **ANTLR v4**: *Stipple Effect* uses version 4.13.1 of the ANTLR 4 Runtime. You can download the library from the Maven Repository or configure it manually. Find the artifact's dependency information [here](https://mvnrepository.com/artifact/org.antlr/antlr4-runtime/4.13.1).
3. Set up the project and run configuration with the following details:
1. **JRE / JDK / Language level**: Java 17 or later
2. **Main class**: `com.jordanbunke.stipple_effect.StippleEffect`
4. Build and run in the Java development environment of your choice!### Note:
*Please keep in mind that you are liable to the terms of the EULA whether you buy the program or compile it from source.*