Merge pull request #14 from darktable-org/development

Update to API 9.4.0 for dartkable 5.0

Author: wpferguson

.gitignore

@@ -1,2 +1,3 @@
 resources/*
 public/*
+.hugo_build.lock

content/lua.api.manual/darktable/darktable.database.md

@@ -30,7 +30,7 @@ Creates a duplicate of an image and returns it.
 * **image** - _[types.dt_lua_image_t](../../types/dt_lua_image_t)_ - the image to duplicate
 * **return** - _[types.dt_lua_image_t](../../types/dt_lua_image_t)_ - The new image object.
 
-# darktable.database.duplicate_image_with_history
+# darktable.database.duplicate_with_history
 
 ```
 function(

content/lua.api.manual/darktable/darktable.new_format.md

@@ -15,15 +15,18 @@ type : string
 Creates a new format object to export images
 
 * **type** - _string_ - The type of format object to create, one of :
+  * avif
   * copy
   * exr
   * j2k
   * jpeg
+  * jpegxl
   * pdf
   * pfm
   * png
   * ppm
   * tiff
   * webp
+  * xcf
 
 * **return** - _[types.dt_imageio_module_format_t](types.dt_imageio_module_format_t)_ - The newly created object. Exact type depends on the type passed

content/lua.api.manual/darktable/darktable.util.md

@@ -0,0 +1,26 @@
+---
+title: darktable.util
+id: darktable.util
+weight: 240
+draft: false
+author: "people"
+---
+
+darktable utility functions
+
+# darktable.util.message
+
+```
+function(
+  sender : string,
+  receiver : string,
+  message : string
+)
+```
+
+Sends a message from sender to receiver using the [inter-script-communication](../events/inter-script-communication) event.
+
+* **sender** - _string_ - The module that is sending the message.
+* **receiver** - _string_ - The module that the message is intended for or _**broadcast**_ to send to all modules.
+* **message** - _string_ - The message for the receiver.
+

content/lua.api.manual/events/inter-script-communication.md

@@ -0,0 +1,32 @@
+---
+title: inter-script-communication
+id: inter-script-communication
+weight: 45
+draft: false
+author: "people"
+---
+
+`event`
+
+This event is called to send messages back and forth between scripts.
+
+# inter-script-communication.callback
+
+```
+function(
+  event : string,
+  sender : string,
+  receiver : string,
+  message : string
+)
+```
+
+* **event** - _string_ - The name of the event that triggered the callback.
+* **sender** - _string_ - The name of the module sending the event.
+* **receiver** - _string_ - The name of the module that the event is being sent to or _**broadcast**_ for all modules.
+* **message** - _string_ - The message intended for the receiving module
+
+# inter-script-communication.extra registration parameters
+
+This event has no extra registration parameters.
+

content/lua.api.manual/types/avif_color_mode_e.md

@@ -0,0 +1,15 @@
+---
+title: avif_color_mode_e
+id: avif_color_mode_e
+weight: 22
+draft: false
+author: "people"
+---
+
+`enum`
+
+Color mode for AVIF
+
+Values:
+* AVIF_COLOR_MODE_RGB
+* AVIF_COLOR_MODE_GRAYSCALE

content/lua.api.manual/types/avif_compression_type_e.md

@@ -0,0 +1,15 @@
+---
+title: avif_compression_type_e
+id: avif_compression_type_e
+weight: 23
+draft: false
+author: "people"
+---
+
+`enum`
+
+AVIF compression mode
+
+Values:
+* AVIF_COMP_LOSSLESS
+* AVIF_COMP_LOSSY

content/lua.api.manual/types/avif_tiling_e.md

@@ -0,0 +1,15 @@
+---
+title: avif_tiling_e
+id: avif_tiling_e
+weight: 24
+draft: false
+author: "people"
+---
+
+`enum`
+
+AVIF tiling
+
+Values:
+* AVIF_TILING_ON
+* AVIF_TILING_OFF

content/lua.api.manual/types/dt_imageio_module_format_data_avif.md

@@ -0,0 +1,65 @@
+---
+title: dt_imageio_module_format_data_avif
+id: dt_imageio_module_format_data_avif
+weight: 115
+draft: false
+author: "people"
+---
+
+`dt_type`
+
+Type object describing parameters to export to avif.
+
+Attributes:
+
+* [parent](../attributes#parent) : [types.dt_imageio_module_format_t](../types/dt_imageio_module_format_t)
+
+# dt_imageio_module_format_data_avif.bit_depth
+
+`number`
+
+The number of bits per sample to use at export time (8, 10, or 12).
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_avif.quality
+
+`number`
+
+The quality to use at export time.
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_avif.compression_type
+
+[types.avif_compression_type_e](../types/avif_compression_type_e)
+
+The image compression type.
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_avif.color_mode
+
+[types.avif_color_mode_e](../types/avif_color_mode_e)
+
+The color mode to use for the image.
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_avif.tiling
+
+[types.avif_tiling_e](../types/avif_tiling_e)
+
+The tiling mode to use for the image.
+
+Attributes:
+
+* [write](../attributes#write)

content/lua.api.manual/types/dt_imageio_module_format_data_jpegxl.md

@@ -0,0 +1,79 @@
+---
+title: dt_imageio_module_format_data_jpegxl
+id: dt_imageio_module_format_data_jpegxl
+weight: 155
+draft: false
+author: "people"
+---
+
+`dt_type`
+
+Type object describing parameters to export to jpegxl.
+
+Attributes:
+
+* [parent](../attributes#parent) : [types.dt_imageio_module_format_t](../types/dt_imageio_module_format_t)
+
+# dt_imageio_module_format_data_jpegxl.bpp
+
+`number`
+
+The bits per pixel to use at export time (10, 12, 16, 32).
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_jpegxl.pixel_type
+
+`number`
+
+Type of format for pixels, 0 for integer or 1 for floating point.
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_jpegxl.quality
+
+`number`
+
+The quality to use at export time.
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_jpegxl.original
+
+`number`
+
+The color profile used by the encoder.
+
+* 0 - permit internal XYB color space conversion for more efficient lossy compression
+* 1 - ensure no conversion to keep original image color space (implied for lossless)
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_jpegxl.effort
+
+`number`
+
+Encoding effort.  The effort used to encode the image, higher efforts will have better results at the expense of longer encoding times.
+
+Attributes:
+
+* [write](../attributes#write)
+
+# dt_imageio_module_format_data_jpegxl.tier
+
+`number`
+
+Decoding speed.  The preferred decoding speed with some sacrifice of quality.
+
+Attributes:
+
+* [write](../attributes#write)
+