Files
Godot-Screenshots-Fork/README.md
T
Davide Di Staso 7233a3ca4d Various improvements
- Improved performance by only sending the file path to the debugger
- By default, shutter window will queue free if not running in the Editor
- Remember shutter window position
- Do not remember camera roll
2025-10-11 12:12:48 +02:00

78 lines
2.6 KiB
Markdown

<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
For bugs and feature requests, please open an issue. Additional questions? Email [hello@pumpkintree.games](mailto: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