Merge pull request #46 from ChaoticByte/release/v8.0

Release/v8.0

Author: ChaoticByte

README.md

@@ -3,7 +3,15 @@
 
 ![screenshot](./screenshot.png)
 
-<p align=center>Create image filters by writing shaders.</p>
+<p align=center>An image editing/compositing software for graphics programmers.</p>
+
+## Table of Contents
+
+- [Supported Platforms](#supported-platforms)
+- [Usage](#usage)
+- [Shaderlib](#shaderlib)
+- [Commandline interface](#commandline-interface)
+- [Known Issues](#known-issues)
 
 ## Supported Platforms
 
@@ -13,8 +21,12 @@ You can find the latest releases [here](https://github.com/ChaoticByte/Fragmente
 
 ## Usage
 
-The repo includes examples. You can use them as a starting-point to write your own filters.  
-Just load an image using `//!load`, edit the shader code and hit `F5` to see the changes.
+With Fragemented, you are editing images by writing GDShaders. This brings almost endless opportunities to create unique art.  
+If you want to learn GDShader, take a look at the [Godot docs](https://docs.godotengine.org/en/stable/tutorials/shaders/).
+
+The repo also includes examples. You can use them as a starting-point to write your own filters.
+
+Besides the regular GDShader stuff, Fragmented also has so-called directives. Those allow to further control the behaviour of the application. The most important directive is `//!load` to load an image.
 
 ### Load TEXTURE using the `//!load` directive
 
@@ -68,12 +80,15 @@ Here is an example:
 ```glsl
 shader_type canvas_item;
 
-#include "res://shaderlib/hsv.gdshaderinc"
+#include "res://shaderlib/oklab.gdshaderinc"
 
-//!load ./examples/images/swamp.jpg
+//!load ./images/swamp.jpg
 
 void fragment() {
-	COLOR = hsv_offset(COLOR, 0.32, 0.2, 0.0);
+	vec4 oklab = rgb2oklab(COLOR);
+	vec4 oklch = oklab2oklch(oklab);
+	oklch.z -= 2.0;
+	COLOR = oklab2rgb(oklch2oklab(oklch));
 }
 ```
 
@@ -89,14 +104,23 @@ You can run Fragmented from the commandline or scripts.
 ./Fragmented cmd --shader PATH [--load-image PATH]
 
   --shader PATH      The path to the shader
-  --output PATH      Where to write the resulting image to
+  --output PATH      Where to write the resulting image to.
+                     In batch mode, this must be a folder.
   --load-image PATH  The path to the image. This will overwrite the
-                     load directive of the shader file (optional)
+                     load directive of the shader file.
+                     Passing a folder activates batch mode.
+                     (optional)
 
 ```
 
 You can also run `./Fragmented cmd help` to show the help message.
 
+### Batch Mode
+
+Since version v8.0, you can pass a directory to `--load-image` and `--output`. This will process all images in the input directory and write the output to the output directory.
+
+> Note: You *can* use this feature for video frames, but it will take a loooong time.
+
 #### Examples
 
 ```
@@ -106,3 +130,9 @@ You can also run `./Fragmented cmd help` to show the help message.
 ```
 ./Fragmented cmd --shader ./examples/oklab.gdshader --load-image ~/Pictures/test.png --output ./output.png
 ```
+
+## Known Issues
+
+- screen scaling is unsupported; Using screen scaling could lead to an either blurry UI, or no scaling at all -> see #45
+- the shaderlib API is still unstable, this will change with version 10
+- commandline interface: `--headless` is not supported

build-template/Containerfile

@@ -18,4 +18,4 @@ RUN git clone https://github.com/godotengine/godot.git -b 4.3-stable /godot-src
 FROM clone-src
 
 WORKDIR /godot-src
-ENTRYPOINT scons platform=linuxbsd target=template_release lto=full optimize=size disable_3d=yes module_text_server_adv_enabled=no module_text_server_fb_enabled=yes module_basis_universal_enabled=no module_csg_enabled=no module_dds_enabled=no module_enet_enabled=no module_gridmap_enabled=no module_hdr_enabled=no module_jsonrpc_enabled=no module_ktx_enabled=no module_mbedtls_enabled=no module_meshoptimizer_enabled=no module_minimp3_enabled=no module_mobile_vr_enabled=no module_msdfgen_enabled=no module_multiplayer_enabled=no module_navigation_enabled=no module_ogg_enabled=no module_openxr_enabled=no module_raycast_enabled=no module_squish_enabled=no module_svg_enabled=no module_tga_enabled=no module_theora_enabled=no module_tinyexr_enabled=no module_upnp_enabled=no module_vhacd_enabled=no module_vorbis_enabled=no module_webrtc_enabled=no module_websocket_enabled=no module_webxr_enabled=no module_zip_enabled=no arch=x86_64 && strip bin/godot.linuxbsd.template_release.x86_64
+ENTRYPOINT scons platform=linuxbsd target=template_release lto=full optimize=size disable_3d=yes module_text_server_adv_enabled=no module_text_server_fb_enabled=yes module_basis_universal_enabled=no module_csg_enabled=no module_enet_enabled=no module_gridmap_enabled=no module_jsonrpc_enabled=no module_mbedtls_enabled=no module_meshoptimizer_enabled=no module_minimp3_enabled=no module_mobile_vr_enabled=no module_msdfgen_enabled=no module_multiplayer_enabled=no module_navigation_enabled=no module_ogg_enabled=no module_openxr_enabled=no module_raycast_enabled=no module_squish_enabled=no module_theora_enabled=no module_upnp_enabled=no module_vhacd_enabled=no module_vorbis_enabled=no module_webrtc_enabled=no module_websocket_enabled=no module_webxr_enabled=no arch=x86_64 && strip bin/godot.linuxbsd.template_release.x86_64

examples/color_and_pixelate.gdshader

@@ -1,7 +1,7 @@
 shader_type canvas_item;
 
-#include "res://shaderlib/colorspaces.gdshaderinc"
-#include "res://shaderlib/effects.gdshaderinc"
+#include "res://shaderlib/hsv.gdshaderinc"
+#include "res://shaderlib/pixelate.gdshaderinc"
 
 //!load ./images/swamp.jpg
 

examples/oklab.gdshader

@@ -1,6 +1,6 @@
 shader_type canvas_item;
 
-#include "res://shaderlib/colorspaces.gdshaderinc"
+#include "res://shaderlib/oklab.gdshaderinc"
 
 //!load ./images/swamp.jpg
 

examples/place_texture.gdshader

@@ -1,7 +1,7 @@
 shader_type canvas_item;
 
-#include "res://shaderlib/transform.gdshaderinc"
-#include "res://shaderlib/transparency.gdshaderinc"
+#include "res://shaderlib/place_texture.gdshaderinc"
+#include "res://shaderlib/common.gdshaderinc"
 
 //!load ./images/swamp.jpg
 //!load+ img2 ./images/grass.png

project.godot

@@ -11,7 +11,7 @@ config_version=5
 [application]
 
 config/name="Fragmented"
-config/version="v7.0"
+config/version="v8.0"
 run/main_scene="res://scenes/main.tscn"
 config/features=PackedStringArray("4.3", "Mobile")
 run/low_processor_mode=true

shaderlib/common.gdshaderinc

@@ -3,3 +3,13 @@
 float cbrt(float x) {
 	return pow(x, 1.0/3.0);
 }
+
+/*
+	Alpha Blending a over b after Bruce A. Wallace
+	source: https://en.wikipedia.org/wiki/Alpha_compositing
+*/
+vec4 alpha_blend(vec4 b, vec4 a) {
+	float alpha = a.a + (b.a * (1.0 - a.a));
+	vec3 col = ((a.rgb*a.a) + ((b.rgb*b.a) * (1.0 - a.a)) / alpha);
+	return vec4(col.r, col.g, col.b, alpha);
+}

shaderlib/hsv.gdshaderinc

@@ -0,0 +1,27 @@
+
+/*
+	rgb2hsv and hsv2rgb functions adapted
+	from https://godotshaders.com/shader/hsv-adjustment/
+	original code by https://godotshaders.com/author/al1-ce/
+
+	Color space conversion functions always work with vec4.
+	The fourth value is always alpha.
+*/
+
+// Convert RGB to HSV (hue, saturation, brightness)
+vec4 rgb2hsv(vec4 c) {
+	vec4 K = vec4(0.0, -1.0 / 3.0, 2.0 / 3.0, -1.0);
+	vec4 p = mix(vec4(c.bg, K.wz), vec4(c.gb, K.xy), step(c.b, c.g));
+	vec4 q = mix(vec4(p.xyw, c.r), vec4(c.r, p.yzx), step(p.x, c.r));
+	float d = q.x - min(q.w, q.y);
+	float e = 1.0e-10;
+	return vec4(abs(q.z + (q.w - q.y) / (6.0 * d + e)), d / (q.x + e), q.x, c.a);
+}
+
+// Convert HSV back to RGB (red, green, blue)
+vec4 hsv2rgb(vec4 c) {
+	vec4 K = vec4(1.0, 2.0 / 3.0, 1.0 / 3.0, 3.0);
+	vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
+	vec3 rgb =  c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
+	return vec4(rgb.r, rgb.g, rgb.b, c.a);
+}

shaderlib/colorspaces.gdshaderinc renamed to shaderlib/oklab.gdshaderinc

@@ -1,42 +1,16 @@
 
-/*
-	Color space conversion functions always work with vec4.
-	The fourth value is always alpha.
-*/
-
-#include "res://shaderlib/common.gdshaderinc"
-
-/*
-	rgb2hsv and hsv2rgb functions adapted
-	from https://godotshaders.com/shader/hsv-adjustment/
-	original code by https://godotshaders.com/author/al1-ce/
-*/
-
-// Convert RGB to HSV (hue, saturation, brightness)
-vec4 rgb2hsv(vec4 c) {
-	vec4 K = vec4(0.0, -1.0 / 3.0, 2.0 / 3.0, -1.0);
-	vec4 p = mix(vec4(c.bg, K.wz), vec4(c.gb, K.xy), step(c.b, c.g));
-	vec4 q = mix(vec4(p.xyw, c.r), vec4(c.r, p.yzx), step(p.x, c.r));
-	float d = q.x - min(q.w, q.y);
-	float e = 1.0e-10;
-	return vec4(abs(q.z + (q.w - q.y) / (6.0 * d + e)), d / (q.x + e), q.x, c.a);
-}
-
-// Convert HSV back to RGB (red, green, blue)
-vec4 hsv2rgb(vec4 c) {
-	vec4 K = vec4(1.0, 2.0 / 3.0, 1.0 / 3.0, 3.0);
-	vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
-	vec3 rgb =  c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
-	return vec4(rgb.r, rgb.g, rgb.b, c.a);
-}
-
 /*
 	OkLab and OkLCh
 	For more details on oklab, see
 		- https://bottosson.github.io/posts/oklab/
 		- https://en.wikipedia.org/wiki/Oklab_color_space
+
+	Color space conversion functions always work with vec4.
+	The fourth value is always alpha.
 */
 
+#include "res://shaderlib/common.gdshaderinc"
+
 vec4 rgb2oklab(vec4 c) {
 	float l = 0.4122214708f * c.r + 0.5363325363f * c.g + 0.0514459929f * c.b;
 	float m = 0.2119034982f * c.r + 0.6806995451f * c.g + 0.1073969566f * c.b;