14 Commits
Author SHA1 Message Date
Davide Di Staso eaa3c39b11 Minor fixes
Create Release / release (push) Successful in 27s
2025-10-11 16:26:03 +02:00
Davide Di Staso 71ba8eadb4 Update release.yml 2025-10-11 16:13:42 +02:00
Davide Di Staso 61dda6fa0d Bumped plugin version 2025-10-11 16:11:17 +02:00
Davide Di Staso 0da38fde76 Added extension to LICENSE 2025-10-11 16:11:10 +02:00
Davide Di Staso f65ad365c5 Added GitHub action 2025-10-11 16:10:58 +02:00
Davide Di Staso 94d8dc96b7 Removed unused %s from string 2025-10-11 16:00:48 +02:00
Davide Di Staso 3775bd00e1 Fixes issue with "none" locale 2025-10-11 13:21:28 +02:00
Davide Di Staso 78c925d372 Camera roll previews queued free on file deletion 2025-10-11 12:40:39 +02:00
Davide Di Staso d25aae8428 Use _disable_plugin() to remove the singleton 2025-10-11 12:14:37 +02:00
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
Davide Di Staso 8d49e3035d Removed references to missing plugins 2025-10-05 18:17:23 +02:00
Davide Di Staso 85a10d38fa Broken node reference 2025-10-05 18:13:56 +02:00
Davide Di Staso cc9e7b1c40 First commit 2025-10-05 18:13:56 +02:00
treepumpkin 3016a8f489 Initial commit 2025-10-05 18:13:47 +02:00
47 changed files with 260 additions and 5 deletions

No files matched your search

+7
View File
@@ -0,0 +1,7 @@
# Normalize EOL for all files that Git considers text files.
* text=auto eol=lf
# Only include the addons folder when downloading from the Asset Library.
/** export-ignore
/addons !export-ignore
/addons/** !export-ignore
+52
View File
@@ -0,0 +1,52 @@
name: Create Release
on:
push:
tags:
- 'v*.*' # Triggers on version tags like v1.0
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write # Required to create releases
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Get version from tag
id: get_version
run: echo "VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
- name: Get tag message
id: tag_message
run: |
git fetch --depth=1 origin +refs/tags/*:refs/tags/*
echo "MESSAGE<<EOF" >> $GITHUB_OUTPUT
git tag -l --format='%(contents)' ${GITHUB_REF#refs/tags/} >> $GITHUB_OUTPUT
echo "EOF" >> $GITHUB_OUTPUT
- name: Create release directory
run: mkdir -p release_temp/addons/screenshots
- name: Copy plugin files
run: |
cp -r addons/screenshots/* release_temp/addons/screenshots/
cp LICENSE.md release_temp/addons/screenshots/
- name: Create ZIP archive
run: |
cd release_temp
zip -r ../godot-screenshots-${{ steps.get_version.outputs.VERSION }}.zip addons
cd ..
- name: Create Release
uses: softprops/action-gh-release@v1
with:
files: godot-screenshots-${{ steps.get_version.outputs.VERSION }}.zip
body: ${{ steps.tag_message.outputs.MESSAGE }}
draft: false
prerelease: false
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+12
View File
@@ -0,0 +1,12 @@
.godot/
.import/
# System/tool-specific ignores
.directory
.DS_Store
*~
/addons/kenyoni/plugin_reloader
/addons/explore-editor-theme
addons/screenshots/settings.cfg
+21
View File
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2025 Davide Di Staso
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
+78
View File
@@ -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
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
File renamed without changes.

Before

Width:  |  Height:  |  Size: 460 B

After

Width:  |  Height:  |  Size: 460 B

+1 -1
View File
@@ -3,5 +3,5 @@
name="Screenshots" name="Screenshots"
description="Takes screenshots of all sizes and locales with a single click." description="Takes screenshots of all sizes and locales with a single click."
author="Davide Di Staso" author="Davide Di Staso"
version="1.0" version="1.1"
script="plugin.gd" script="plugin.gd"
File renamed without changes.
File renamed without changes.
@@ -4,10 +4,6 @@ var settings: LocalFile
func _ready(): func _ready():
settings = LocalFile.new("res://addons/screenshots/settings.cfg") settings = LocalFile.new("res://addons/screenshots/settings.cfg")
settings.value_changed.connect(_on_settings_changed)
func _on_settings_changed(section: String, key: String, new_value):
print("Setting changed: [%s] %s = %s" % [section, key, new_value])
class LocalFile: class LocalFile:
signal value_changed(section: String, key: String, new_value) signal value_changed(section: String, key: String, new_value)
+23
View File
@@ -0,0 +1,23 @@
; Engine configuration file.
; It's best edited using the editor UI and not directly,
; since the parameters that go here are not all obvious.
;
; Format:
; [section] ; section goes between []
; param=value ; assign values to parameters
config_version=5
[application]
config/name="Screenshots"
config/features=PackedStringArray("4.5", "Forward Plus")
config/icon="res://store_assets/icon.svg"
[autoload]
Screenshots="*res://addons/screenshots/autoload/shutter_window/shutter_window.tscn"
[editor_plugins]
enabled=PackedStringArray("res://addons/kenyoni/plugin_reloader/plugin.cfg", "res://addons/screenshots/plugin.cfg")
+2
View File
@@ -0,0 +1,2 @@
<?xml version="1.0" encoding="utf-8"?>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 500 500" xmlns:bx="https://boxy-svg.com" width="500px" height="500px"><defs><linearGradient id="color-0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1.743002, 0, 0, 1.743002, 453.197397, -3.162562)"><stop style="stop-color: rgb(165, 237, 159);"/></linearGradient><linearGradient id="color-1" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1, 0, 0, 1, 6.29529, 20)"><stop style="stop-color: rgb(126, 215, 119);"/></linearGradient></defs><g transform="matrix(1, 0, 0, 1, -14.40535, -6.770363)" id="object-0"><g style="" transform="matrix(1, 0, 0, 1, 3.577872, -86.76339)"><rect width="257" height="216.686" x="202.857" y="120.558" rx="1.5" style="stroke-width: 26; stroke: rgb(201, 251, 196); fill-rule: nonzero; fill: rgb(216, 255, 213); opacity: 0.64;" transform="matrix(0.88294, 0.469487, -0.469487, 0.88294, 132.060254, -90.921077)"/><rect width="257" height="216.686" x="118.883" y="184.537" rx="1.5" style="stroke-width: 26; stroke: rgb(201, 251, 196); fill-rule: nonzero; fill: rgb(216, 255, 213); opacity: 0.78;" transform="matrix(0.963508, 0.267678, -0.267678, 0.963508, 87.424809, -55.531413)"/><rect width="257" height="216.686" x="40.169" y="243.572" rx="1.5" style="stroke-width: 26px; stroke: url(&quot;#color-0&quot;); fill: rgb(216, 255, 213);"/><path d="M 188.826 311.601 L 188.826 331.758 L 168.669 331.758 L 168.669 351.915 L 128.355 351.915 L 128.355 372.072 L 108.198 372.072 L 108.198 392.229 L 88.042 392.229 L 88.042 412.386 L 249.296 412.386 L 249.296 372.072 L 229.14 372.072 L 229.14 331.758 L 208.983 331.758 L 208.983 311.601 L 188.826 311.601 Z" style="stroke-width: 22px; paint-order: stroke; fill: url(&quot;#color-0&quot;); stroke: rgb(156, 221, 151);"/></g><path d="M 390.493 302.791 L 413.837 333.916 L 452.744 333.916 C 469.956 333.916 483.869 347.86 483.869 365.041 L 483.869 458.415 C 483.869 475.597 469.956 489.541 452.744 489.541 L 265.994 489.541 C 248.813 489.541 234.869 475.597 234.869 458.415 L 234.869 365.041 C 234.869 347.86 248.813 333.916 265.994 333.916 L 304.899 333.916 L 328.243 302.791 L 390.493 302.791 Z M 318.937 388.385 C 300.978 419.509 323.45 458.415 359.368 458.415 C 376.052 458.415 391.459 449.513 399.801 435.073 C 417.79 403.946 395.318 365.041 359.368 365.041 C 342.686 365.041 327.279 373.942 318.937 388.385 Z" style="stroke-width: 10px; fill: url(&quot;#color-1&quot;);"/></g><g transform="matrix(1, 0, 0, 1, 208.661346, -169.870087)"/></svg>

After

Width:  |  Height:  |  Size: 2.5 KiB

+43
View File
@@ -0,0 +1,43 @@
[remap]
importer="texture"
type="CompressedTexture2D"
uid="uid://beexo7stly40j"
path="res://.godot/imported/icon.svg-e03c482d947fcbee68178cf4fedc07b2.ctex"
metadata={
"vram_texture": false
}
[deps]
source_file="res://store_assets/icon.svg"
dest_files=["res://.godot/imported/icon.svg-e03c482d947fcbee68178cf4fedc07b2.ctex"]
[params]
compress/mode=0
compress/high_quality=false
compress/lossy_quality=0.7
compress/uastc_level=0
compress/rdo_quality_loss=0.0
compress/hdr_compression=1
compress/normal_map=0
compress/channel_pack=0
mipmaps/generate=false
mipmaps/limit=-1
roughness/mode=0
roughness/src_normal=""
process/channel_remap/red=0
process/channel_remap/green=1
process/channel_remap/blue=2
process/channel_remap/alpha=3
process/fix_alpha_border=true
process/premult_alpha=false
process/normal_map_invert_y=false
process/hdr_as_srgb=false
process/hdr_clamp_exposure=false
process/size_limit=0
detect_3d/compress_to=1
svg/scale=1.0
editor/scale_with_editor_scale=false
editor/convert_colors_with_editor_theme=false
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 MiB

+21
View File
@@ -0,0 +1,21 @@
[gd_scene load_steps=2 format=3 uid="uid://dhxwkyejss1af"]
[ext_resource type="Texture2D" uid="uid://beexo7stly40j" path="res://store_assets/icon.svg" id="1_uhqqe"]
[node name="Test" type="Control"]
layout_mode = 3
anchors_preset = 15
anchor_right = 1.0
anchor_bottom = 1.0
grow_horizontal = 2
grow_vertical = 2
[node name="TextureRect" type="TextureRect" parent="."]
layout_mode = 1
anchors_preset = 15
anchor_right = 1.0
anchor_bottom = 1.0
grow_horizontal = 2
grow_vertical = 2
texture = ExtResource("1_uhqqe")
expand_mode = 1