Author SHA1 Message Date
stilobique f6e384e221 Fix dark/desaturated screenshots when HDR 2D is enabled
get_viewport().get_texture().get_image() returns a linear-encoded
image when use_hdr_2d is true, and save_png/save_jpg write it as-is
without converting to sRGB, producing a darker, desaturated result
than what's shown on screen.
2026-11-05 15:04:48 +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 9 additions and 344 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.
-88
View File
@@ -1,88 +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
- **Input Show/Hide shutter**: Easily show or hide the shutter with an action
### 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,7 +13,6 @@ signal image_captured(image: Image)
signal burst_ended
var _input_action: String
var _toggle_shutter_action: String
func _ready() -> void:
@@ -26,24 +25,14 @@ 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)
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()
@@ -130,8 +119,11 @@ func save_image() -> void:
var timestamp = Time.get_time_string_from_system()
var play_shutter_sounds = _local_data.settings.load_value("misc", "ShutterSoundsCheckBox", true)
# Save the screenshot
# var image = get_tree().root.get_viewport().get_texture().get_image()
var image = get_parent().get_viewport().get_texture().get_image()
var image = get_tree().root.get_viewport().get_texture().get_image()
if get_tree().root.get_viewport().use_hdr_2d:
if image.get_format() != Image.FORMAT_RGB8:
image.convert(Image.FORMAT_RGB8)
image.linear_to_srgb()
image_captured.emit(image)
if play_shutter_sounds:
@@ -157,7 +149,7 @@ func save_image() -> void:
var formats = {
"PNGCheckBox": ["png", image.save_png, true],
"JPGCheckBox": ["jpg", image.save_jpg, false],
"WEBPCheckBox": ["webp", image.save_webp, false]
"WEBPCheckBox": ["webp", image.save_webp, false],
}
for setting_key in formats:
@@ -182,6 +174,7 @@ func save_image() -> void:
print_rich("[Screenshots] Saved at: [url=%s]%s[/url]" % [ProjectSettings.globalize_path(file_path.get_base_dir()), file_path])
func get_unique_filepath(base_path: String) -> String:
if not FileAccess.file_exists(base_path):
return base_path
@@ -198,4 +191,3 @@ func get_unique_filepath(base_path: String) -> String:
new_path = "%s/%s_%d.%s" % [dir, filename, counter, extension]
return new_path
@@ -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/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")]
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")]
[node name="LocalData" type="Node" parent="."]
unique_name_in_owner = true
@@ -170,21 +170,6 @@ 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 = "Input Show/Hide Shutter"
[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
+1 -1
View File
@@ -3,5 +3,5 @@
name="Screenshots"
description="Takes screenshots of all sizes and locales with a single click."
author="Davide Di Staso"
version="1.3"
version="1.2"
script="plugin.gd"
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