First commit
This commit is contained in:
1 parent
3016a8f489
commit
cc9e7b1c40
44 files changed
+1413
-2
No files matched your search
@@ -0,0 +1,78 @@
|
||||
<p align="center">
|
||||
<img src="store_assets/icon.svg" width=150>
|
||||
</p>
|
||||
|
||||
# Screenshots
|
||||
Godot addon that lets you rapidly take screenshots. Supports taking bursts in multiple resolutions, locales, and formats.
|
||||
|
||||
<p align="center">
|
||||
<img src="store_assets/taking_a_burst.gif">
|
||||
</p>
|
||||
|
||||
## Installation
|
||||
- Download the latest release and paste it into your Godot project
|
||||
- Enable the addon in the Project Settings
|
||||
|
||||
## Usage
|
||||
1. Play a scene
|
||||
2. (Optional) Adjust settings in the Debugger panel
|
||||
3. Press the shutter button
|
||||
4. View your screenshots in the Camera Roll or click on the link in the Output panel
|
||||
|
||||
## Configuration
|
||||
Configure the addon from its Debugger panel. Settings are stored at `settings.cfg`.
|
||||
### Shutter
|
||||
|
||||
- **Pauses game**: Pause execution while taking screenshots. Useful for ensuring consistency across burst captures.
|
||||
- **Show shutter**: Toggle shutter visibility
|
||||
- **Shutter sounds**: Whether to play shutter sound effect
|
||||
- **Input Action**: Configure keyboard shortcut
|
||||
|
||||
### Resolution
|
||||
- Specify one or more target sizes. The addon calls `DisplayServer.window_set_size()` for each size before capturing.
|
||||
|
||||
### Locales
|
||||
- Select locales to load before taking screenshots.
|
||||
|
||||
### Save
|
||||
- **Path**: Screenshot save location (default: `user://screenshots`)
|
||||
- **Formats**: PNG, JPG, WEBP
|
||||
- **Use subfolders**: Organize bursts into folders with this structure `$PROJECTNAME_$TIMESTAMP/$LOCALE/$RESOLUTION`
|
||||
|
||||
## API
|
||||
Accessible through the `Screenshots` singleton.
|
||||
### Methods
|
||||
|
||||
```gdscript
|
||||
take_burst()
|
||||
```
|
||||
Takes one or more screenshots (a burst) using settings specified in the Debugger panel.
|
||||
|
||||
### Signals
|
||||
```gdscript
|
||||
burst_starting
|
||||
```
|
||||
Fires before capture. Use this to hide debug UI elements.
|
||||
|
||||
```gdscript
|
||||
image_captured(image: Image)
|
||||
```
|
||||
Fires after each individual capture.
|
||||
|
||||
```gdscript
|
||||
burst_ended
|
||||
```
|
||||
Fires after the burst is completed. Use it to unhide debug UI elements.
|
||||
|
||||
## Version Compatibility
|
||||
Tested on Godot 4.5 (Linux and macOS)
|
||||
|
||||
## Support
|
||||
Questions? Email hello@pumpkintree.games
|
||||
|
||||
## Credits
|
||||
- Developed by [Davide Di Staso](http://www.pumpkintree.games)
|
||||
- Screenshots addon icon based on modified Godot Editor icons
|
||||
- Shutter icon by [Bootstrap](https://github.com/twbs/icons)
|
||||
- Shutter sound effect by [ALEXIS_GAMING_CAM](https://pixabay.com/users/alexis_gaming_cam-50011695/) from [Pixabay](https://pixabay.com/)
|
||||
- [Editor Theme Explorer](https://github.com/YuriSizov/godot-editor-theme-explorer) by Yuri Sizov and [Godot Plugin Reloader](https://github.com/kenyoni-software/godot-addons) by Iceflower have been used during development
|
||||
Reference in new issue
Block a user