Add missing enums (#422)

* add missing flags

sine we now have proper flags support

* add missing flag and enum docs

We'd not updated these for quite a while!

I used the automatically-generated python enum docs as a guide.

* fix lint

Author: jcupitt

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 * improve NULL pointer handling [dloebl]
 * improve GFlags argument handling [jcupitt]
+* add missing flag and enum docs [jcupitt]
 
 ## Version 2.2.4 (2025-06-05)
 

lib/vips/combine.rb

@@ -0,0 +1,10 @@
+module Vips
+  # How to combine values, see for example {Image#compass}.
+  #
+  # * `:max` take the maximum of the possible values
+  # * `:sum` sum all the values
+  # * `:min` take the minimum value
+
+  class Combine < Symbol
+  end
+end

lib/vips/fail_on.rb

@@ -0,0 +1,15 @@
+module Vips
+  # How sensitive loaders are to errors, from never stop (very insensitive),
+  # to stop on the smallest warning (very sensitive).
+  #
+  # Each implies the ones before it, so `:error` implies `:truncated`, for
+  # example.
+  #
+  # *   `:none` never stop
+  # *   `:truncated` stop on image truncated, nothing else
+  # *   `:error` stop on serious error or truncation
+  # *   `:warning` stop on anything, even warnings
+
+  class FailOn < Symbol
+  end
+end

lib/vips/foreign_dz_container.rb

@@ -0,0 +1,10 @@
+module Vips
+  # The container format to use
+  #
+  # *   `:fs` write tiles to the filesystem
+  # *   `:zip` write tiles to a zip file
+  # *   `:szi` write to a szi file
+
+  class ForeignDzContainer < Symbol
+  end
+end

lib/vips/foreign_dz_depth.rb

@@ -0,0 +1,10 @@
+module Vips
+  # How many pyramid layers to create.
+  #
+  # *   `:onepixel` create layers down to 1x1 pixel
+  # *   `:onetile` create layers down to 1x1 tile
+  # *   `:one` only create a single layer
+
+  class ForeignDzDepth < Symbol
+  end
+end

lib/vips/foreign_dz_layout.rb

@@ -0,0 +1,12 @@
+module Vips
+  # What directory layout and metadata standard to use.
+  #
+  # *   `:dz` use DeepZoom directory layout
+  # *   `:zoomify` use Zoomify directory layout
+  # *   `:google` use Google maps directory layout
+  # *   `:iiif` use IIIF v2 directory layout
+  # *   `:iiif3` use IIIF v3 directory layout
+
+  class ForeignDzLayout < Symbol
+  end
+end

lib/vips/foreign_heif_compression.rb

@@ -0,0 +1,11 @@
+module Vips
+  # The compression format to use inside a HEIF container
+  #
+  # *   `:hevc` x265
+  # *   `:avc` x264
+  # *   `:jpeg` jpeg
+  # *   `:av1` aom
+
+  class ForeignHeifCompression < Symbol
+  end
+end

lib/vips/foreign_heif_encoder.rb

@@ -0,0 +1,11 @@
+module Vips
+  # The selected encoder to use.
+  #
+  # *   `:auto` auto
+  # *   `:rav1e` RAV1E
+  # *   `:svt` SVT-AV1
+  # *   `:x265` x265
+
+  class ForeignHeifEncoder < Symbol
+  end
+end

lib/vips/foreign_keep.rb

@@ -0,0 +1,13 @@
+module Vips
+  # Savers can be given a set of metadata items to keep.
+  #
+  # *   `:none` remove all metadata
+  # *   `:exif` keep EXIF metadata
+  # *   `:xmp` keep XMP metadata
+  # *   `:iptc` keep IPTC metadata
+  # *   `:icc` keep ICC profiles
+  # *   `:other` keep other metadata
+
+  class ForeignKeep < Symbol
+  end
+end

lib/vips/foreign_png_filter.rb

@@ -0,0 +1,13 @@
+module Vips
+  # The set of filters for PNG save. See http://www.w3.org/TR/PNG-Filters.html
+  #
+  # *   `:none` no filtering
+  # *   `:sub` difference to the left
+  # *   `:up` difference up
+  # *   `:avg` average of left and up
+  # *   `:paeth` pick best neighbor predictor automatically
+  # *   `:all` adaptive
+
+  class ForeignPngFilter < Symbol
+  end
+end