18 Commits
Author SHA1 Message Date
stilobique b11b0c37d4 Add UI field for the shutter toggle Input Action
New "Toggle shutter Input Action" LineEdit in the Shutter settings
section, same pattern as the existing "Input Action" field for the
burst trigger. Writes/reads ToggleShutterInputActionLineEdit, which
shutter_window.gd already reads.
2026-11-05 13:31:21 +01:00
stilobique 6bbf5d4a8d Add global show/hide toggle for the Shutter window
Reads a new ToggleShutterInputActionLineEdit setting and checks it in
_process() with Input.is_action_just_pressed() instead of _input(),
since the Shutter is its own native Window: its _input() only fires
while it has OS focus, and stops entirely once hidden. Input's action
state is global to the process, so this lets the configured key show
the Shutter again from the main Play window.
2026-11-05 11:46:27 +01:00
treepumpkin c4ee699d49 Added support for different stretch modes 2025-10-22 15:47:19 +02:00
treepumpkin dfe34fb698 Code formatted using GDQuest's formatter 2025-10-17 20:11:59 +02:00
Davide Di Staso 74056af39a Ensure a default size is present 2025-10-13 21:50:22 +02:00
treepumpkin cf1c3ceba4 Bump plugin version 2025-10-13 08:00:01 +02:00
Davide Di Staso 5484be0028 Added tooltips 2025-10-12 22:25:24 +02:00
Davide Di Staso 5a06cbaf65 Do not queue_free when not in Editor 2025-10-12 22:17:11 +02:00
Davide Di Staso 34f60a1bbe Added DirectoryWatcher license 2025-10-11 19:00:52 +02:00
Davide Di Staso feec70d2ab Minor fixes 2025-10-11 16:26:03 +02:00
Davide Di Staso 141c62952c Bumped plugin version 2025-10-11 16:11:17 +02:00
Davide Di Staso 9c15ba991b Removed unused %s from string 2025-10-11 16:00:48 +02:00
Davide Di Staso ad07784366 Fixes issue with "none" locale 2025-10-11 13:21:28 +02:00
Davide Di Staso 4957c7ab47 Camera roll previews queued free on file deletion 2025-10-11 12:40:39 +02:00
Davide Di Staso dbc3e0738f Use _disable_plugin() to remove the singleton 2025-10-11 12:14:37 +02:00
Davide Di Staso c60a03228a 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 4f303f7bf0 Broken node reference 2025-10-05 18:13:56 +02:00
Davide Di Staso adea063e99 First commit 2025-10-05 18:13:56 +02:00
49 changed files with 32 additions and 312 deletions

No files matched your search

-7
View File
@@ -1,7 +0,0 @@
# 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
-53
View File
@@ -1,53 +0,0 @@
name: Create Release
on:
push:
tags:
- 'v*.*' # Triggers on version tags like v1.0
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
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 version without dots
id: version_no_dots
run: echo "VERSION_NO_DOTS=$(echo '${{ steps.get_version.outputs.VERSION }}' | tr -d '.')" >> $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/godot-screenshots-${{ steps.version_no_dots.outputs.VERSION_NO_DOTS }}/addons/screenshots
- name: Copy plugin files
run: |
cp -r addons/screenshots/* release_temp/godot-screenshots-${{ steps.version_no_dots.outputs.VERSION_NO_DOTS }}/addons/screenshots/
cp LICENSE.md release_temp/godot-screenshots-${{ steps.version_no_dots.outputs.VERSION_NO_DOTS }}/addons/screenshots/
- name: Create ZIP archive
run: |
cd release_temp
zip -r ../godot-screenshots-${{ steps.get_version.outputs.VERSION }}.zip godot-screenshots-${{ steps.version_no_dots.outputs.VERSION_NO_DOTS }}
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 }}
-13
View File
@@ -1,13 +0,0 @@
.godot/
.import/
# System/tool-specific ignores
.directory
.DS_Store
*~
/addons/kenyoni/plugin_reloader
/addons/explore-editor-theme
/addons/GDQuest_GDScript_formatter
addons/screenshots/settings.cfg
-21
View File
@@ -1,21 +0,0 @@
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.
-87
View File
@@ -1,87 +0,0 @@
<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 addon from [AssetLib](https://godotengine.org/asset-library/asset/4405) within the Godot Editor
- 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
- **Show shutter**: Toggle shutter visibility
- **Only run in Editor**: If the game is running outside the editor (`OS.has_feature("editor")` is `false`), hide the shutter and disable input processing
- **Pauses game**: Pause execution while taking screenshots. Useful for ensuring consistency across burst captures.
- **Shutter sounds**: Whether to play shutter sound effect
- **Input Action**: Set an Input Action to trigger a screenshot
### 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.
#### Example
```gdscript
func _ready() -> void:
Screenshots.burst_starting.connect(_hide_debug_ui)
Screenshots.burst_ended.connect(_show_debug_ui)
```
## 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)
- Uses [Directory Watcher](https://github.com/KoBeWi/Godot-Directory-Watcher) by Tomek
- 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

@@ -13,6 +13,7 @@ signal image_captured(image: Image)
signal burst_ended
var _input_action: String
var _toggle_shutter_action: String
func _ready() -> void:
@@ -25,14 +26,29 @@ func _ready() -> void:
if only_run_in_editor and not OS.has_feature("editor"):
set_process_input(false)
set_process(false)
hide()
return
_input_action = _local_data.settings.load_value("misc", "InputActionLineEdit", "")
_toggle_shutter_action = _local_data.settings.load_value("misc", "ToggleShutterInputActionLineEdit", "")
%ShutterButton.pressed.connect(take_burst)
close_requested.connect(_on_close_requested)
## Checked every frame (not via _input) because the shutter is its own native
## Window: once hidden, it stops receiving OS input entirely, and its _input()
## only ever fires while it has OS focus anyway. Input.is_action_just_pressed
## reflects global key state for the whole process, so this lets the toggle be
## pressed from the main Play window even while the shutter is hidden.
func _process(_delta: float) -> void:
if _toggle_shutter_action.is_empty() or not InputMap.has_action(_toggle_shutter_action):
return
if Input.is_action_just_pressed(_toggle_shutter_action):
visible = not visible
_local_data.settings.save("misc", "ShowShutterCheckBox", visible)
func _on_close_requested() -> void:
hide()
@@ -37,7 +37,7 @@ grow_vertical = 2
size_flags_horizontal = 3
size_flags_vertical = 3
script = ExtResource("1_7ct7k")
nodes_to_save = [NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer4/PausesGameCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer2/ShowShutterCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer3/ShutterSoundsCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer/InputActionLineEdit"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/FormatsContainers/PNGCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/FormatsContainers/JPGCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/FormatsContainers/WEBPCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/HBoxContainer/PathLineEdit"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/HBoxContainer2/UseSubFoldersCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer5/OnlyRunInEditorCheckBox")]
nodes_to_save = [NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer4/PausesGameCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer2/ShowShutterCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer3/ShutterSoundsCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer/InputActionLineEdit"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer6/ToggleShutterInputActionLineEdit"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/FormatsContainers/PNGCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/FormatsContainers/JPGCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/FormatsContainers/WEBPCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/HBoxContainer/PathLineEdit"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/SaveFolder/VBoxContainer/HBoxContainer2/UseSubFoldersCheckBox"), NodePath("HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer5/OnlyRunInEditorCheckBox")]
[node name="LocalData" type="Node" parent="."]
unique_name_in_owner = true
@@ -170,6 +170,21 @@ unique_name_in_owner = true
layout_mode = 2
size_flags_horizontal = 3
[node name="HBoxContainer6" type="HBoxContainer" parent="HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer"]
layout_mode = 2
[node name="Label" type="Label" parent="HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer6"]
custom_minimum_size = Vector2(250, 0)
layout_mode = 2
tooltip_text = "Set an Input Action to show/hide the shutter from anywhere, including the Play window, even while it's hidden"
mouse_filter = 1
text = "Toggle shutter Input Action"
[node name="ToggleShutterInputActionLineEdit" type="LineEdit" parent="HSplitContainer/VBoxContainer/ScrollContainer/Settings/Shutter/VBoxContainer/HBoxContainer6"]
unique_name_in_owner = true
layout_mode = 2
size_flags_horizontal = 3
[node name="Resolution" type="FoldableContainer" parent="HSplitContainer/VBoxContainer/ScrollContainer/Settings" node_paths=PackedStringArray("sizes_container")]
unique_name_in_owner = true
layout_mode = 2
File renamed without changes.
File renamed without changes.
File renamed without changes.
-24
View File
@@ -1,24 +0,0 @@
; 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"
run/main_scene="uid://dhxwkyejss1af"
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/screenshots/plugin.cfg")
File renamed without changes.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

-40
View File
@@ -1,40 +0,0 @@
[remap]
importer="texture"
type="CompressedTexture2D"
uid="uid://db676w16nxng0"
path="res://.godot/imported/icon.png-328cfcb6969469a4250bbb3ec82ff0ac.ctex"
metadata={
"vram_texture": false
}
[deps]
source_file="res://store_assets/icon.png"
dest_files=["res://.godot/imported/icon.png-328cfcb6969469a4250bbb3ec82ff0ac.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
-2
View File
@@ -1,2 +0,0 @@
<?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>

Before

Width:  |  Height:  |  Size: 2.5 KiB

-43
View File
@@ -1,43 +0,0 @@
[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.

Before

Width:  |  Height:  |  Size: 2.1 MiB

-21
View File
@@ -1,21 +0,0 @@
[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