mirror of
https://github.com/Orama-Interactive/Pixelorama.git
synced 2025-01-18 17:19:50 +00:00
A free & open-source 2D sprite editor, made with the Godot Engine! Available on Windows, Linux, macOS and the Web!
https://orama-interactive.itch.io/pixelorama
animationartdrawgame-developmentgamedevgdscriptgodotgodot-enginegodotenginegraphicspaintpixelpixel-artpixel-art-makerpixel-editorpixelartpixeloramasprite-animationspritesspritesheet
881e53dadc
* Refactoring image_menu_id_pressed method in Main.gd (#243) * Refactoring image_menu_id_pressed method in Main.gd I've moved the code from each "match" case into a seperate method to make it more readable. Co-authored-by: OverloadedOrama <35376950+OverloadedOrama@users.noreply.github.com> * Refactoring Main.gd. Mostly cutting big methods into smaller ones. (#244) * Refactoring Main.gd. Mostly cutting big methods into smaller one. - Reduced size of _ready method in Main.gd - Moved code from certain parts of old _ready method into seperate methods - Fixed the translation bug related to CurrentFrame node in TopMenuContainer scene. The CurrentFrame node wasn't updating the language when I was changing language. I've also changed the translation file for this. - Fixed Global.palette_option_button.selected related warning. Because of some unknown reasons, git didn't push completed line there. - Moved code from file_menu_id_pressed and view_menu_id_pressed method in Main.gd to separate methods to make it more readable. * Removed window_title changes from Main.tscn Co-authored-by: OverloadedOrama <35376950+OverloadedOrama@users.noreply.github.com> * Fixed TextureRect images of the circle brushes in BrushesPopup They all had the pixel brush image in their TextureRect * Split code from PreferencesDialog.gd to HandleLanguages.gd Also moved PreferencesDialog script & scene to src/Preferences. More Preferences code splitting will follow. * Split theme related code from PreferencesDialog into HandleThemes.gd * Moved shortcuts code from PreferencesDialog * Created DrawingAlgos.gd and moved a lot of drawing code there Moved code from Global.gd and Canvas.gd to DrawingAlgos.gd. Will also move the fill_gaps and draw_brush methods of Canvas.gd next. Maybe even refactor the inside of them a bit to make them easier to read. * Connected "files_dropped" signal to a method This lets the user drag and drop files into Pixelorama, while it runs, to open them. This doesn't work properly and will crash when it can't open the files. It will get merged into master soon. * Renamed handle_running_pixelorama_with_arguments() to handle_loading_files() handle_loading_files() is also used for _on_files_dropped() * Moved draw_brush() and fill_gaps() from Canvas.gd to DrawingAlgos.gd draw_brush() is currently very ugly and probably needs inside refactoring * Removed coord clamping from fill_gaps() This should make line making behave as expected when the mouse is outside of canvas boundaries * Drawing is no longer limited by the canvas boundaries his means that, if you have a brush largen than 1px, you can draw on the edges of the canvas. All pixels that are being drawn outside of the canvas will still have no effect. * Use enums instead of strings for tools This could be a slight increase in performance * Fixed line making with Shift and don't let color picker pick colors outside of canvas * Changed Global node variables to arrays for left/right Instead of having 2 variables for left & right nodes, use an array instead. This will help with better looking code, automation and less repetitive code, as seen in ToolButtons.gd. Move related refactoring will follow. * More Global left/right variables became Arrays Global.update_left_custom_brush() and its right counterpart have also now become Global.update_custom_brush(mouse_button : int) * Use Global.Mouse_Button instead of strings for comparison This should be a slight increase in performance * Refactoring perferences dialog (#251) * Added ItemList to themes * Language and theme checkboxes are now radio buttons * Even more Global left/right variables became arrays ColorAndToolOptions has now the same code for left and right tool options, with more similar refactoring coming soon to places like Canvas and DrawingAlgos * Refactored Canvas.gd * Refactored DrawingAlgos.draw_brush(), made draw_pixel() method This also fixes alpha blending and lighting/darkening issues when drawing pixels with mirroring. * Remove draw_pixel(), use draw_pixel_blended() instead * Ignore warnings I don't know what else to do about them, they seem trivial anyway * Use enum instead of strings for Global.theme_type Another potential small performance boost when changing themes. * Use a new Layer class to handle layer information This replaces the old Global.layers nested array mess, and makes the code easier to read and to understand. * Fixed linked cel crash and layer naming * Created a new Cel class, to handle cel information Like the Layer class, it is used in place of Canvas.layers nested array mess. It hasn't been tested thoroughly yet, so there may be crashes. * Fixed issue where if you moved a frame to the start (move left), it was invisible * Added AnimationTag class Replaces nested Global.animation_tags arrays. Also replaced array.duplicate(true) with looping through the array and creating a new class for each array element, because duplicate(true) does not create new classes, unfortunately, which was causing issues with undo/redo. Co-authored-by: Igor Santarek <jegor377@gmail.com> Co-authored-by: Kinwailo <lokinwai@gmail.com> |
||
|---|---|---|
| .github | ||
| addons | ||
| assets | ||
| Misc/Linux | ||
| pixelorama | ||
| src | ||
| Translations | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| crowdin.yml | ||
| LICENSE | ||
| project.godot | ||
| README.md | ||
Pixelorama - your free and open-source sprite editor!
Made by Orama Interactive with the Godot Engine, written in GDScript!
Art by Wishdream - winner of the first Pixelorama splash screen art contest!
Make sure to visit our website for more information! https://www.orama-interactive.com/pixelorama Join our Discord community server where we can discuss about Pixelorama and all our other projects! https://discord.gg/GTMtr8s
If you like, consider helping us by sponsoring this project! It would enable us to focus more on Pixelorama, and make more projects in the future!
You can also support the development on patreon: 
Download
- Itch.io (Windows, Linux & Mac)
- GitHub Releases (Windows, Linux & Mac)
- Flathub (Linux)
- Snap Store (Linux)
Documentation
You can find Online Documentation for Pixelorama here: https://orama-interactive.github.io/Pixelorama-Docs
It's still work in progress so there are some pages missing. If you want to contribute, you can do so in Pixelorama-Docs' GitHub Repository.
Cloning Instructions
Pixelorama uses Godot 3.2, so you will need to have it in order to run the project. As of right now, most of the code is written using GDScript, so the mono version of Godot is not required, but Pixelorama should also work with it.
Pixelorama uses a GDNative addon for gif exporting, since it's not possible to do it natively with Godot. In order to ensure that your clone works properly, you will need to use the command git submodule update --init right after you clone.
Note that the addon only works in Windows and Linux platforms, for the time being. Pixelorama should run without it fine on other platforms.
Current features as of version v0.7:
- Choosing between 7 tools – pencil, eraser, fill bucket, lighten/darken, color picker, rectangle select and zoom– and mapping them to both of your left and right mouse buttons.
- Are you an animator? Pixelorama has its own animation timeline just for you! You can work at an individual cel level, where each cel refers to a unique layer and frame. Supports onion skinning, cel linking, motion drawing and frame grouping with tags.
- Different tool options for each of the mouse buttons.
- Custom brushes! Load your brushes from files or select them in your project with the selection tool, and they will get stored in
.pxofiles! - Random custom brushes! Every time you draw, expect to see a different random result!
- Create or import custom palettes!
- Pattern filling! Use the bucket tool to fill out an area with a pattern of your choosing.
- Import images and edit them inside Pixelorama. If you import multiple files, they will be added as individual animation frames. Importing spritesheets is also supported.
- Export your gorgeous art as
PNGorGIFfiles. Exporting your projects as spritesheets is also possible. - Pixel perfect mode for perfect lines, for the pencil, eraser & lighten/darken tools.
- Save and open your projects as Pixelorama's custom file format,
.pxo - Undo/Redo support!
- Autosave support, with data recovery in case of a software crash.
- Multiple theme support! Choose a theme from Dark, Gray, Blue, Caramel and Light!
- Horizontal & vertical mirrored drawing!
- Tile Mode for pattern creation!
- Split screen mode to see your masterpiece twice! And a mini canvas preview area to see it thrice!
- Create straight lines for pencil, eraser and the lighten/darken tool by pressing
Shift. If you also pressControl, you can constrain angles with a step of 15. - Generate outlines for your images!
- Υou can zoom in and out with the mouse scroll wheel or the
+and-keys respectively, and pan by clicking the middle mouse button, by holdingSpaceor with the arrow keys! - Keyboard shortcuts, and the ability to change their bindings.
- Rulers and guides!
- Scale, crop, rotate, flip, color invert, HSV-adjust and desaturate your images!
- Multi-language localization support! See our Crowdin page for more details.