Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cadin/panels
Build interactive comics for the Playdate console.
https://github.com/cadin/panels
comics playdate
Last synced: about 2 months ago
JSON representation
Build interactive comics for the Playdate console.
- Host: GitHub
- URL: https://github.com/cadin/panels
- Owner: cadin
- License: cc-by-4.0
- Created: 2021-08-04T20:00:53.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-26T05:07:43.000Z (about 2 months ago)
- Last Synced: 2024-07-27T05:38:05.484Z (about 2 months ago)
- Topics: comics, playdate
- Language: Lua
- Homepage:
- Size: 793 KB
- Stars: 150
- Watchers: 6
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-playdate - Panels
README
# Panels
Build interactive comics for the Playdate console.
Provide Panels with a Lua table that describes the sequences in your comic (scroll direction, panel sizes, text, animation and effects) along with your layered graphics. Panels will handle layout, scrolling, animation, and even chapter navigation for you.
Comics built with Panels can support these features:
- layered, parallax scrolling
- nested panels
- sequences with different scroll directions
- manual (crank) scrolling and auto advancing (panel-by-panel)
- panel effects like shake and blink
- animated transitions between sequences
- animations and transitions within panels based on scroll position
- animated text layers
- panels with fully custom render functions
- branching "choose-your-own-adventure" storylines
## Documentation
Check out the full set of documentation here:
### [ð Panels Documentation](//cadin.github.io/panels)
### [ðš Tutorial Videos](https://www.youtube.com/playlist?list=PLvk_cJkKCihbN4Q61lopDtSQMbx4vNLvv)
## Requirements
- [Playdate SDK](https://play.date/dev/)
- [Playdate Console](https://shop.play.date) (optional)
## Setup
### From Template Project
1. Clone the [Panels Project Template](https://github.com/cadin/panels-project-template).
This is a [Template Repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template). Click "Use this template" to create your own fresh repo with all the contents of the project template.
2. The template project includes the Panels framework as a git submodule. Be sure to properly [initialize the submodule](https://www.w3docs.com/snippets/git/how-to-clone-including-submodules.html) when cloning the repo.
3. Start editing table in `myComicData.lua`.
### Manual Setup
1. Clone this repo into your project into a `libraries` folder.
2. Inside your `main.lua` file import Panels.
3. Create or import your [`comicData`](http://cadin.github.io/panels/docs/comic-data) table.
4. Start Panels with your `comicData` table as the sole argument.
### Example `main.lua` File:
```lua
import "libraries/panels/Panels"
local comicData = {
-- comic data goes here...
}
Panels.start(comicData)
```
## Support
### Get Help
- ðš Watch these **[Tutorial Videos](https://www.youtube.com/playlist?list=PLvk_cJkKCihbN4Q61lopDtSQMbx4vNLvv)** to get up to speed quickly.
- ðĪ Chat with the **[Panels Partner custom GPT](https://chat.openai.com/g/g-QU76MOCLl-panels-partner)** to get answers to questions about your specific project.
- ðŽ Post your question in the **[Playdate Squad Discord](https://discord.com/channels/675983554655551509/1163630567393341461)**.
### Feature Requests
Add feature requests to the [Issues](https://github.com/cadin/panels/issues) page.
Include a description of the general functionality you need, along with your preferred implementation (if you have one). Please search first to see if someone else has already created an issue for your feature. If so, you can add a vote or comment to show your support.
### Bug Reports
File bug reports on the [Issues](https://github.com/cadin/panels/issues) page.
Each bug should be listed as a separate issue. Please search first to see if someone else has already filed the bug, and list all steps needed to reproduce the issue in the smallest possible project.
### Contribute
If you would like to contribute a feature or bug fix please contact me first and let me know which issue you want work on. If there isn't yet an issue for your proposed change, go ahead and write one.
## License
Panels is licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
**TLDR:** You can use this code (or modified versions) to create anything you want, public or private, free or commercial. For attribution, please retain the Panels credit (with URL and QR code) on the Credits page of your game so that others may find their way here.
---
ðĻðŧâðĶēâĪïļð