ruby-vips 2.1.4 → 2.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/lib/vips/methods.rb CHANGED
@@ -18,6 +18,18 @@ module Vips
18
18
  # @param opts [Hash] Set of options
19
19
  # @return [Vips::Image] Output image
20
20
 
21
+ # @!method minpair(right, **opts)
22
+ # Minimum of a pair of images.
23
+ # @param right [Vips::Image] Right-hand image argument
24
+ # @param opts [Hash] Set of options
25
+ # @return [Vips::Image] Output image
26
+
27
+ # @!method maxpair(right, **opts)
28
+ # Maximum of a pair of images.
29
+ # @param right [Vips::Image] Right-hand image argument
30
+ # @param opts [Hash] Set of options
31
+ # @return [Vips::Image] Output image
32
+
21
33
  # @!method subtract(right, **opts)
22
34
  # Subtract two images.
23
35
  # @param right [Vips::Image] Right-hand image argument
@@ -39,7 +51,7 @@ module Vips
39
51
  # @!method relational(right, relational, **opts)
40
52
  # Relational operation on two images.
41
53
  # @param right [Vips::Image] Right-hand image argument
42
- # @param relational [Vips::OperationRelational] relational to perform
54
+ # @param relational [Vips::OperationRelational] Relational to perform
43
55
  # @param opts [Hash] Set of options
44
56
  # @return [Vips::Image] Output image
45
57
 
@@ -52,21 +64,21 @@ module Vips
52
64
  # @!method boolean(right, boolean, **opts)
53
65
  # Boolean operation on two images.
54
66
  # @param right [Vips::Image] Right-hand image argument
55
- # @param boolean [Vips::OperationBoolean] boolean to perform
67
+ # @param boolean [Vips::OperationBoolean] Boolean to perform
56
68
  # @param opts [Hash] Set of options
57
69
  # @return [Vips::Image] Output image
58
70
 
59
71
  # @!method math2(right, math2, **opts)
60
72
  # Binary math operations.
61
73
  # @param right [Vips::Image] Right-hand image argument
62
- # @param math2 [Vips::OperationMath2] math to perform
74
+ # @param math2 [Vips::OperationMath2] Math to perform
63
75
  # @param opts [Hash] Set of options
64
76
  # @return [Vips::Image] Output image
65
77
 
66
78
  # @!method complex2(right, cmplx, **opts)
67
79
  # Complex binary operations on two images.
68
80
  # @param right [Vips::Image] Right-hand image argument
69
- # @param cmplx [Vips::OperationComplex2] binary complex operation to perform
81
+ # @param cmplx [Vips::OperationComplex2] Binary complex operation to perform
70
82
  # @param opts [Hash] Set of options
71
83
  # @return [Vips::Image] Output image
72
84
 
@@ -76,10 +88,11 @@ module Vips
76
88
  # @param opts [Hash] Set of options
77
89
  # @return [Vips::Image] Output image
78
90
 
79
- # @!method self.sum(im, **opts)
80
- # Sum an array of images.
81
- # @param im [Array<Image>] Array of input images
91
+ # @!method clamp(**opts)
92
+ # Clamp values of an image.
82
93
  # @param opts [Hash] Set of options
94
+ # @option opts [Float] :min Minimum value
95
+ # @option opts [Float] :max Maximum value
83
96
  # @return [Vips::Image] Output image
84
97
 
85
98
  # @!method invert(**opts)
@@ -97,7 +110,7 @@ module Vips
97
110
 
98
111
  # @!method math(math, **opts)
99
112
  # Apply a math operation to an image.
100
- # @param math [Vips::OperationMath] math to perform
113
+ # @param math [Vips::OperationMath] Math to perform
101
114
  # @param opts [Hash] Set of options
102
115
  # @return [Vips::Image] Output image
103
116
 
@@ -113,13 +126,13 @@ module Vips
113
126
 
114
127
  # @!method round(round, **opts)
115
128
  # Perform a round function on an image.
116
- # @param round [Vips::OperationRound] rounding operation to perform
129
+ # @param round [Vips::OperationRound] Rounding operation to perform
117
130
  # @param opts [Hash] Set of options
118
131
  # @return [Vips::Image] Output image
119
132
 
120
133
  # @!method relational_const(relational, c, **opts)
121
134
  # Relational operations against a constant.
122
- # @param relational [Vips::OperationRelational] relational to perform
135
+ # @param relational [Vips::OperationRelational] Relational to perform
123
136
  # @param c [Array<Double>] Array of constants
124
137
  # @param opts [Hash] Set of options
125
138
  # @return [Vips::Image] Output image
@@ -132,27 +145,33 @@ module Vips
132
145
 
133
146
  # @!method boolean_const(boolean, c, **opts)
134
147
  # Boolean operations against a constant.
135
- # @param boolean [Vips::OperationBoolean] boolean to perform
148
+ # @param boolean [Vips::OperationBoolean] Boolean to perform
136
149
  # @param c [Array<Double>] Array of constants
137
150
  # @param opts [Hash] Set of options
138
151
  # @return [Vips::Image] Output image
139
152
 
140
153
  # @!method math2_const(math2, c, **opts)
141
154
  # Binary math operations with a constant.
142
- # @param math2 [Vips::OperationMath2] math to perform
155
+ # @param math2 [Vips::OperationMath2] Math to perform
143
156
  # @param c [Array<Double>] Array of constants
144
157
  # @param opts [Hash] Set of options
145
158
  # @return [Vips::Image] Output image
146
159
 
147
160
  # @!method complex(cmplx, **opts)
148
161
  # Perform a complex operation on an image.
149
- # @param cmplx [Vips::OperationComplex] complex to perform
162
+ # @param cmplx [Vips::OperationComplex] Complex to perform
150
163
  # @param opts [Hash] Set of options
151
164
  # @return [Vips::Image] Output image
152
165
 
153
166
  # @!method complexget(get, **opts)
154
167
  # Get a component from a complex image.
155
- # @param get [Vips::OperationComplexget] complex to perform
168
+ # @param get [Vips::OperationComplexget] Complex to perform
169
+ # @param opts [Hash] Set of options
170
+ # @return [Vips::Image] Output image
171
+
172
+ # @!method self.sum(im, **opts)
173
+ # Sum an array of images.
174
+ # @param im [Array<Image>] Array of input images
156
175
  # @param opts [Hash] Set of options
157
176
  # @return [Vips::Image] Output image
158
177
 
@@ -215,7 +234,7 @@ module Vips
215
234
  # @!method hough_line(**opts)
216
235
  # Find hough line transform.
217
236
  # @param opts [Hash] Set of options
218
- # @option opts [Integer] :width horizontal size of parameter space
237
+ # @option opts [Integer] :width Horizontal size of parameter space
219
238
  # @option opts [Integer] :height Vertical size of parameter space
220
239
  # @return [Vips::Image] Output image
221
240
 
@@ -253,6 +272,7 @@ module Vips
253
272
  # @param x [Integer] Point to read
254
273
  # @param y [Integer] Point to read
255
274
  # @param opts [Hash] Set of options
275
+ # @option opts [Boolean] :unpack_complex Complex pixels should be unpacked
256
276
  # @return [Array<Double>] Array of output values
257
277
 
258
278
  # @!method find_trim(**opts)
@@ -260,6 +280,7 @@ module Vips
260
280
  # @param opts [Hash] Set of options
261
281
  # @option opts [Float] :threshold Object threshold
262
282
  # @option opts [Array<Double>] :background Color for background pixels
283
+ # @option opts [Boolean] :line_art Enable line art mode
263
284
  # @return [Array<Integer, Integer, Integer, Integer>] Left edge of image, Top edge of extract area, Width of extract area, Height of extract area
264
285
 
265
286
  # @!method copy(**opts)
@@ -303,14 +324,6 @@ module Vips
303
324
  # @option opts [Integer] :tile_height Tile height in pixels
304
325
  # @return [Vips::Image] Output image
305
326
 
306
- # @!method cache(**opts)
307
- # Cache an image.
308
- # @param opts [Hash] Set of options
309
- # @option opts [Integer] :max_tiles Maximum number of tiles to cache
310
- # @option opts [Integer] :tile_height Tile height in pixels
311
- # @option opts [Integer] :tile_width Tile width in pixels
312
- # @return [Vips::Image] Output image
313
-
314
327
  # @!method embed(x, y, width, height, **opts)
315
328
  # Embed an image in a larger image.
316
329
  # @param x [Integer] Left edge of input in output
@@ -324,7 +337,7 @@ module Vips
324
337
 
325
338
  # @!method gravity(direction, width, height, **opts)
326
339
  # Place an image within a larger image with a certain gravity.
327
- # @param direction [Vips::CompassDirection] direction to place image within width/height
340
+ # @param direction [Vips::CompassDirection] Direction to place image within width/height
328
341
  # @param width [Integer] Image width in pixels
329
342
  # @param height [Integer] Image height in pixels
330
343
  # @param opts [Hash] Set of options
@@ -396,7 +409,10 @@ module Vips
396
409
  # @param height [Integer] Height of extract area
397
410
  # @param opts [Hash] Set of options
398
411
  # @option opts [Vips::Interesting] :interesting How to measure interestingness
399
- # @return [Vips::Image] Output image
412
+ # @option opts [Boolean] :premultiplied Input image already has premultiplied alpha
413
+ # @option opts [Integer] :attention_x Output Horizontal position of attention centre
414
+ # @option opts [Integer] :attention_y Output Vertical position of attention centre
415
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
400
416
 
401
417
  # @!method extract_band(band, **opts)
402
418
  # Extract band from an image.
@@ -425,7 +441,7 @@ module Vips
425
441
 
426
442
  # @!method bandbool(boolean, **opts)
427
443
  # Boolean operation across image bands.
428
- # @param boolean [Vips::OperationBoolean] boolean to perform
444
+ # @param boolean [Vips::OperationBoolean] Boolean to perform
429
445
  # @param opts [Hash] Set of options
430
446
  # @return [Vips::Image] Output image
431
447
 
@@ -464,7 +480,7 @@ module Vips
464
480
 
465
481
  # @!method recomb(m, **opts)
466
482
  # Linear recombination with matrix.
467
- # @param m [Vips::Image] matrix of coefficients
483
+ # @param m [Vips::Image] Matrix of coefficients
468
484
  # @param opts [Hash] Set of options
469
485
  # @return [Vips::Image] Output image
470
486
 
@@ -502,9 +518,9 @@ module Vips
502
518
 
503
519
  # @!method grid(tile_height, across, down, **opts)
504
520
  # Grid an image.
505
- # @param tile_height [Integer] chop into tiles this high
506
- # @param across [Integer] number of tiles across
507
- # @param down [Integer] number of tiles down
521
+ # @param tile_height [Integer] Chop into tiles this high
522
+ # @param across [Integer] Number of tiles across
523
+ # @param down [Integer] Number of tiles down
508
524
  # @param opts [Hash] Set of options
509
525
  # @return [Vips::Image] Output image
510
526
 
@@ -569,6 +585,11 @@ module Vips
569
585
  # @option opts [Boolean] :premultiplied Images have premultiplied alpha
570
586
  # @return [Vips::Image] Output image
571
587
 
588
+ # @!method addalpha(**opts)
589
+ # Append an alpha channel.
590
+ # @param opts [Hash] Set of options
591
+ # @return [Vips::Image] Output image
592
+
572
593
  # @!method self.black(width, height, **opts)
573
594
  # Make a black image.
574
595
  # @param width [Integer] Image width in pixels
@@ -608,10 +629,10 @@ module Vips
608
629
 
609
630
  # @!method self.logmat(sigma, min_ampl, **opts)
610
631
  # Make a laplacian of gaussian image.
611
- # @param sigma [Float] Radius of Logmatian
612
- # @param min_ampl [Float] Minimum amplitude of Logmatian
632
+ # @param sigma [Float] Radius of Gaussian
633
+ # @param min_ampl [Float] Minimum amplitude of Gaussian
613
634
  # @param opts [Hash] Set of options
614
- # @option opts [Boolean] :separable Generate separable Logmatian
635
+ # @option opts [Boolean] :separable Generate separable Gaussian
615
636
  # @option opts [Vips::Precision] :precision Generate with this precision
616
637
  # @return [Vips::Image] Output image
617
638
 
@@ -623,14 +644,27 @@ module Vips
623
644
  # @option opts [Integer] :width Maximum image width in pixels
624
645
  # @option opts [Integer] :height Maximum image height in pixels
625
646
  # @option opts [Vips::Align] :align Align on the low, centre or high edge
626
- # @option opts [Boolean] :rgba Enable RGBA output
627
- # @option opts [Integer] :dpi DPI to render at
628
647
  # @option opts [Boolean] :justify Justify lines
648
+ # @option opts [Integer] :dpi DPI to render at
629
649
  # @option opts [Integer] :spacing Line spacing
630
650
  # @option opts [String] :fontfile Load this font file
651
+ # @option opts [Boolean] :rgba Enable RGBA output
652
+ # @option opts [Vips::TextWrap] :wrap Wrap lines on word or character boundaries
631
653
  # @option opts [Integer] :autofit_dpi Output DPI selected by autofit
632
654
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
633
655
 
656
+ # @!method self.sdf(width, height, shape, **opts)
657
+ # Create an sdf image.
658
+ # @param width [Integer] Image width in pixels
659
+ # @param height [Integer] Image height in pixels
660
+ # @param shape [Vips::SdfShape] SDF shape to create
661
+ # @param opts [Hash] Set of options
662
+ # @option opts [Float] :r Radius
663
+ # @option opts [Array<Double>] :a Point a
664
+ # @option opts [Array<Double>] :b Point b
665
+ # @option opts [Array<Double>] :corners Corner radii
666
+ # @return [Vips::Image] Output image
667
+
634
668
  # @!method self.eye(width, height, **opts)
635
669
  # Make an image showing the eye's spatial response.
636
670
  # @param width [Integer] Image width in pixels
@@ -697,7 +731,7 @@ module Vips
697
731
  # @param height [Integer] Image height in pixels
698
732
  # @param frequency_cutoff_x [Float] Frequency cutoff x
699
733
  # @param frequency_cutoff_y [Float] Frequency cutoff y
700
- # @param radius [Float] radius of circle
734
+ # @param radius [Float] Radius of circle
701
735
  # @param opts [Hash] Set of options
702
736
  # @option opts [Boolean] :uchar Output an unsigned char image
703
737
  # @option opts [Boolean] :nodc Remove DC component
@@ -741,7 +775,7 @@ module Vips
741
775
  # @param order [Float] Filter order
742
776
  # @param frequency_cutoff_x [Float] Frequency cutoff x
743
777
  # @param frequency_cutoff_y [Float] Frequency cutoff y
744
- # @param radius [Float] radius of circle
778
+ # @param radius [Float] Radius of circle
745
779
  # @param amplitude_cutoff [Float] Amplitude cutoff
746
780
  # @param opts [Hash] Set of options
747
781
  # @option opts [Boolean] :uchar Output an unsigned char image
@@ -783,7 +817,7 @@ module Vips
783
817
  # @param height [Integer] Image height in pixels
784
818
  # @param frequency_cutoff_x [Float] Frequency cutoff x
785
819
  # @param frequency_cutoff_y [Float] Frequency cutoff y
786
- # @param radius [Float] radius of circle
820
+ # @param radius [Float] Radius of circle
787
821
  # @param amplitude_cutoff [Float] Amplitude cutoff
788
822
  # @param opts [Hash] Set of options
789
823
  # @option opts [Boolean] :uchar Output an unsigned char image
@@ -882,6 +916,7 @@ module Vips
882
916
  # @option opts [Boolean] :memory Force open via memory
883
917
  # @option opts [Vips::Access] :access Required access pattern for this file
884
918
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
919
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
885
920
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
886
921
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
887
922
 
@@ -896,6 +931,7 @@ module Vips
896
931
  # @option opts [Boolean] :memory Force open via memory
897
932
  # @option opts [Vips::Access] :access Required access pattern for this file
898
933
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
934
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
899
935
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
900
936
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
901
937
 
@@ -906,6 +942,7 @@ module Vips
906
942
  # @option opts [Boolean] :memory Force open via memory
907
943
  # @option opts [Vips::Access] :access Required access pattern for this file
908
944
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
945
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
909
946
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
910
947
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
911
948
 
@@ -916,6 +953,7 @@ module Vips
916
953
  # @option opts [Boolean] :memory Force open via memory
917
954
  # @option opts [Vips::Access] :access Required access pattern for this file
918
955
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
956
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
919
957
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
920
958
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
921
959
 
@@ -932,6 +970,7 @@ module Vips
932
970
  # @option opts [Boolean] :memory Force open via memory
933
971
  # @option opts [Vips::Access] :access Required access pattern for this file
934
972
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
973
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
935
974
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
936
975
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
937
976
 
@@ -942,6 +981,7 @@ module Vips
942
981
  # @option opts [Boolean] :memory Force open via memory
943
982
  # @option opts [Vips::Access] :access Required access pattern for this file
944
983
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
984
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
945
985
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
946
986
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
947
987
 
@@ -952,6 +992,7 @@ module Vips
952
992
  # @option opts [Boolean] :memory Force open via memory
953
993
  # @option opts [Vips::Access] :access Required access pattern for this file
954
994
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
995
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
955
996
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
956
997
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
957
998
 
@@ -962,6 +1003,7 @@ module Vips
962
1003
  # @option opts [Boolean] :memory Force open via memory
963
1004
  # @option opts [Vips::Access] :access Required access pattern for this file
964
1005
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1006
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
965
1007
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
966
1008
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
967
1009
 
@@ -972,91 +1014,62 @@ module Vips
972
1014
  # @option opts [Boolean] :memory Force open via memory
973
1015
  # @option opts [Vips::Access] :access Required access pattern for this file
974
1016
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1017
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
975
1018
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
976
1019
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
977
1020
 
978
- # @!method self.ppmload_source(source, **opts)
979
- # Load ppm base class.
980
- # @param source [Vips::Source] Source to load from
981
- # @param opts [Hash] Set of options
982
- # @option opts [Boolean] :memory Force open via memory
983
- # @option opts [Vips::Access] :access Required access pattern for this file
984
- # @option opts [Vips::FailOn] :fail_on Error level to fail on
985
- # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
986
- # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
987
-
988
- # @!method self.radload(filename, **opts)
989
- # Load a radiance image from a file.
990
- # @param filename [String] Filename to load from
991
- # @param opts [Hash] Set of options
992
- # @option opts [Boolean] :memory Force open via memory
993
- # @option opts [Vips::Access] :access Required access pattern for this file
994
- # @option opts [Vips::FailOn] :fail_on Error level to fail on
995
- # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
996
- # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
997
-
998
- # @!method self.radload_buffer(buffer, **opts)
999
- # Load rad from buffer.
1021
+ # @!method self.ppmload_buffer(buffer, **opts)
1022
+ # Load ppm from buffer.
1000
1023
  # @param buffer [VipsBlob] Buffer to load from
1001
1024
  # @param opts [Hash] Set of options
1002
1025
  # @option opts [Boolean] :memory Force open via memory
1003
1026
  # @option opts [Vips::Access] :access Required access pattern for this file
1004
1027
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1028
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1005
1029
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1006
1030
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1007
1031
 
1008
- # @!method self.radload_source(source, **opts)
1009
- # Load rad from source.
1032
+ # @!method self.ppmload_source(source, **opts)
1033
+ # Load ppm from source.
1010
1034
  # @param source [Vips::Source] Source to load from
1011
1035
  # @param opts [Hash] Set of options
1012
1036
  # @option opts [Boolean] :memory Force open via memory
1013
1037
  # @option opts [Vips::Access] :access Required access pattern for this file
1014
1038
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1039
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1015
1040
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1016
1041
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1017
1042
 
1018
- # @!method self.pdfload(filename, **opts)
1019
- # Load pdf from file.
1043
+ # @!method self.radload(filename, **opts)
1044
+ # Load a radiance image from a file.
1020
1045
  # @param filename [String] Filename to load from
1021
1046
  # @param opts [Hash] Set of options
1022
- # @option opts [Integer] :page Load this page from the file
1023
- # @option opts [Integer] :n Load this many pages
1024
- # @option opts [Float] :dpi Render at this DPI
1025
- # @option opts [Float] :scale Scale output by this factor
1026
- # @option opts [Array<Double>] :background Background value
1027
1047
  # @option opts [Boolean] :memory Force open via memory
1028
1048
  # @option opts [Vips::Access] :access Required access pattern for this file
1029
1049
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1050
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1030
1051
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1031
1052
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1032
1053
 
1033
- # @!method self.pdfload_buffer(buffer, **opts)
1034
- # Load pdf from buffer.
1054
+ # @!method self.radload_buffer(buffer, **opts)
1055
+ # Load rad from buffer.
1035
1056
  # @param buffer [VipsBlob] Buffer to load from
1036
1057
  # @param opts [Hash] Set of options
1037
- # @option opts [Integer] :page Load this page from the file
1038
- # @option opts [Integer] :n Load this many pages
1039
- # @option opts [Float] :dpi Render at this DPI
1040
- # @option opts [Float] :scale Scale output by this factor
1041
- # @option opts [Array<Double>] :background Background value
1042
1058
  # @option opts [Boolean] :memory Force open via memory
1043
1059
  # @option opts [Vips::Access] :access Required access pattern for this file
1044
1060
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1061
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1045
1062
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1046
1063
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1047
1064
 
1048
- # @!method self.pdfload_source(source, **opts)
1049
- # Load pdf from source.
1065
+ # @!method self.radload_source(source, **opts)
1066
+ # Load rad from source.
1050
1067
  # @param source [Vips::Source] Source to load from
1051
1068
  # @param opts [Hash] Set of options
1052
- # @option opts [Integer] :page Load this page from the file
1053
- # @option opts [Integer] :n Load this many pages
1054
- # @option opts [Float] :dpi Render at this DPI
1055
- # @option opts [Float] :scale Scale output by this factor
1056
- # @option opts [Array<Double>] :background Background value
1057
1069
  # @option opts [Boolean] :memory Force open via memory
1058
1070
  # @option opts [Vips::Access] :access Required access pattern for this file
1059
1071
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1072
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1060
1073
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1061
1074
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1062
1075
 
@@ -1067,9 +1080,12 @@ module Vips
1067
1080
  # @option opts [Float] :dpi Render at this DPI
1068
1081
  # @option opts [Float] :scale Scale output by this factor
1069
1082
  # @option opts [Boolean] :unlimited Allow SVG of any size
1083
+ # @option opts [String] :stylesheet Custom CSS
1084
+ # @option opts [Boolean] :high_bitdepth Enable scRGB 128-bit output (32-bit per channel)
1070
1085
  # @option opts [Boolean] :memory Force open via memory
1071
1086
  # @option opts [Vips::Access] :access Required access pattern for this file
1072
1087
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1088
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1073
1089
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1074
1090
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1075
1091
 
@@ -1080,9 +1096,12 @@ module Vips
1080
1096
  # @option opts [Float] :dpi Render at this DPI
1081
1097
  # @option opts [Float] :scale Scale output by this factor
1082
1098
  # @option opts [Boolean] :unlimited Allow SVG of any size
1099
+ # @option opts [String] :stylesheet Custom CSS
1100
+ # @option opts [Boolean] :high_bitdepth Enable scRGB 128-bit output (32-bit per channel)
1083
1101
  # @option opts [Boolean] :memory Force open via memory
1084
1102
  # @option opts [Vips::Access] :access Required access pattern for this file
1085
1103
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1104
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1086
1105
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1087
1106
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1088
1107
 
@@ -1093,39 +1112,12 @@ module Vips
1093
1112
  # @option opts [Float] :dpi Render at this DPI
1094
1113
  # @option opts [Float] :scale Scale output by this factor
1095
1114
  # @option opts [Boolean] :unlimited Allow SVG of any size
1115
+ # @option opts [String] :stylesheet Custom CSS
1116
+ # @option opts [Boolean] :high_bitdepth Enable scRGB 128-bit output (32-bit per channel)
1096
1117
  # @option opts [Boolean] :memory Force open via memory
1097
1118
  # @option opts [Vips::Access] :access Required access pattern for this file
1098
1119
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1099
- # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1100
- # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1101
-
1102
- # @!method self.jxlload(filename, **opts)
1103
- # Load jpeg-xl image.
1104
- # @param filename [String] Filename to load from
1105
- # @param opts [Hash] Set of options
1106
- # @option opts [Boolean] :memory Force open via memory
1107
- # @option opts [Vips::Access] :access Required access pattern for this file
1108
- # @option opts [Vips::FailOn] :fail_on Error level to fail on
1109
- # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1110
- # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1111
-
1112
- # @!method self.jxlload_buffer(buffer, **opts)
1113
- # Load jpeg-xl image.
1114
- # @param buffer [VipsBlob] Buffer to load from
1115
- # @param opts [Hash] Set of options
1116
- # @option opts [Boolean] :memory Force open via memory
1117
- # @option opts [Vips::Access] :access Required access pattern for this file
1118
- # @option opts [Vips::FailOn] :fail_on Error level to fail on
1119
- # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1120
- # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1121
-
1122
- # @!method self.jxlload_source(source, **opts)
1123
- # Load jpeg-xl image.
1124
- # @param source [Vips::Source] Source to load from
1125
- # @param opts [Hash] Set of options
1126
- # @option opts [Boolean] :memory Force open via memory
1127
- # @option opts [Vips::Access] :access Required access pattern for this file
1128
- # @option opts [Vips::FailOn] :fail_on Error level to fail on
1120
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1129
1121
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1130
1122
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1131
1123
 
@@ -1134,9 +1126,11 @@ module Vips
1134
1126
  # @param filename [String] Filename to load from
1135
1127
  # @param opts [Hash] Set of options
1136
1128
  # @option opts [Integer] :page Load this page from the image
1129
+ # @option opts [Boolean] :oneshot Load images a frame at a time
1137
1130
  # @option opts [Boolean] :memory Force open via memory
1138
1131
  # @option opts [Vips::Access] :access Required access pattern for this file
1139
1132
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1133
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1140
1134
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1141
1135
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1142
1136
 
@@ -1145,9 +1139,11 @@ module Vips
1145
1139
  # @param buffer [VipsBlob] Buffer to load from
1146
1140
  # @param opts [Hash] Set of options
1147
1141
  # @option opts [Integer] :page Load this page from the image
1142
+ # @option opts [Boolean] :oneshot Load images a frame at a time
1148
1143
  # @option opts [Boolean] :memory Force open via memory
1149
1144
  # @option opts [Vips::Access] :access Required access pattern for this file
1150
1145
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1146
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1151
1147
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1152
1148
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1153
1149
 
@@ -1156,9 +1152,11 @@ module Vips
1156
1152
  # @param source [Vips::Source] Source to load from
1157
1153
  # @param opts [Hash] Set of options
1158
1154
  # @option opts [Integer] :page Load this page from the image
1155
+ # @option opts [Boolean] :oneshot Load images a frame at a time
1159
1156
  # @option opts [Boolean] :memory Force open via memory
1160
1157
  # @option opts [Vips::Access] :access Required access pattern for this file
1161
1158
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1159
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1162
1160
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1163
1161
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1164
1162
 
@@ -1166,11 +1164,12 @@ module Vips
1166
1164
  # Load gif with libnsgif.
1167
1165
  # @param filename [String] Filename to load from
1168
1166
  # @param opts [Hash] Set of options
1169
- # @option opts [Integer] :n Load this many pages
1170
- # @option opts [Integer] :page Load this page from the file
1167
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1168
+ # @option opts [Integer] :page First page to load
1171
1169
  # @option opts [Boolean] :memory Force open via memory
1172
1170
  # @option opts [Vips::Access] :access Required access pattern for this file
1173
1171
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1172
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1174
1173
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1175
1174
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1176
1175
 
@@ -1178,11 +1177,12 @@ module Vips
1178
1177
  # Load gif with libnsgif.
1179
1178
  # @param buffer [VipsBlob] Buffer to load from
1180
1179
  # @param opts [Hash] Set of options
1181
- # @option opts [Integer] :n Load this many pages
1182
- # @option opts [Integer] :page Load this page from the file
1180
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1181
+ # @option opts [Integer] :page First page to load
1183
1182
  # @option opts [Boolean] :memory Force open via memory
1184
1183
  # @option opts [Vips::Access] :access Required access pattern for this file
1185
1184
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1185
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1186
1186
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1187
1187
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1188
1188
 
@@ -1190,11 +1190,12 @@ module Vips
1190
1190
  # Load gif from source.
1191
1191
  # @param source [Vips::Source] Source to load from
1192
1192
  # @param opts [Hash] Set of options
1193
- # @option opts [Integer] :n Load this many pages
1194
- # @option opts [Integer] :page Load this page from the file
1193
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1194
+ # @option opts [Integer] :page First page to load
1195
1195
  # @option opts [Boolean] :memory Force open via memory
1196
1196
  # @option opts [Vips::Access] :access Required access pattern for this file
1197
1197
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1198
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1198
1199
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1199
1200
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1200
1201
 
@@ -1206,6 +1207,7 @@ module Vips
1206
1207
  # @option opts [Boolean] :memory Force open via memory
1207
1208
  # @option opts [Vips::Access] :access Required access pattern for this file
1208
1209
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1210
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1209
1211
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1210
1212
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1211
1213
 
@@ -1217,6 +1219,7 @@ module Vips
1217
1219
  # @option opts [Boolean] :memory Force open via memory
1218
1220
  # @option opts [Vips::Access] :access Required access pattern for this file
1219
1221
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1222
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1220
1223
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1221
1224
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1222
1225
 
@@ -1228,6 +1231,7 @@ module Vips
1228
1231
  # @option opts [Boolean] :memory Force open via memory
1229
1232
  # @option opts [Vips::Access] :access Required access pattern for this file
1230
1233
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1234
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1231
1235
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1232
1236
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1233
1237
 
@@ -1238,6 +1242,7 @@ module Vips
1238
1242
  # @option opts [Boolean] :memory Force open via memory
1239
1243
  # @option opts [Vips::Access] :access Required access pattern for this file
1240
1244
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1245
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1241
1246
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1242
1247
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1243
1248
 
@@ -1247,9 +1252,11 @@ module Vips
1247
1252
  # @param opts [Hash] Set of options
1248
1253
  # @option opts [Integer] :shrink Shrink factor on load
1249
1254
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1255
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1250
1256
  # @option opts [Boolean] :memory Force open via memory
1251
1257
  # @option opts [Vips::Access] :access Required access pattern for this file
1252
1258
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1259
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1253
1260
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1254
1261
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1255
1262
 
@@ -1259,9 +1266,11 @@ module Vips
1259
1266
  # @param opts [Hash] Set of options
1260
1267
  # @option opts [Integer] :shrink Shrink factor on load
1261
1268
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1269
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1262
1270
  # @option opts [Boolean] :memory Force open via memory
1263
1271
  # @option opts [Vips::Access] :access Required access pattern for this file
1264
1272
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1273
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1265
1274
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1266
1275
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1267
1276
 
@@ -1271,9 +1280,11 @@ module Vips
1271
1280
  # @param opts [Hash] Set of options
1272
1281
  # @option opts [Integer] :shrink Shrink factor on load
1273
1282
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1283
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1274
1284
  # @option opts [Boolean] :memory Force open via memory
1275
1285
  # @option opts [Vips::Access] :access Required access pattern for this file
1276
1286
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1287
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1277
1288
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1278
1289
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1279
1290
 
@@ -1281,12 +1292,13 @@ module Vips
1281
1292
  # Load webp from file.
1282
1293
  # @param filename [String] Filename to load from
1283
1294
  # @param opts [Hash] Set of options
1284
- # @option opts [Integer] :page Load this page from the file
1285
- # @option opts [Integer] :n Load this many pages
1286
- # @option opts [Float] :scale Scale factor on load
1295
+ # @option opts [Integer] :page First page to load
1296
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1297
+ # @option opts [Float] :scale Factor to scale by
1287
1298
  # @option opts [Boolean] :memory Force open via memory
1288
1299
  # @option opts [Vips::Access] :access Required access pattern for this file
1289
1300
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1301
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1290
1302
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1291
1303
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1292
1304
 
@@ -1294,12 +1306,13 @@ module Vips
1294
1306
  # Load webp from buffer.
1295
1307
  # @param buffer [VipsBlob] Buffer to load from
1296
1308
  # @param opts [Hash] Set of options
1297
- # @option opts [Integer] :page Load this page from the file
1298
- # @option opts [Integer] :n Load this many pages
1299
- # @option opts [Float] :scale Scale factor on load
1309
+ # @option opts [Integer] :page First page to load
1310
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1311
+ # @option opts [Float] :scale Factor to scale by
1300
1312
  # @option opts [Boolean] :memory Force open via memory
1301
1313
  # @option opts [Vips::Access] :access Required access pattern for this file
1302
1314
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1315
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1303
1316
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1304
1317
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1305
1318
 
@@ -1307,12 +1320,13 @@ module Vips
1307
1320
  # Load webp from source.
1308
1321
  # @param source [Vips::Source] Source to load from
1309
1322
  # @param opts [Hash] Set of options
1310
- # @option opts [Integer] :page Load this page from the file
1311
- # @option opts [Integer] :n Load this many pages
1312
- # @option opts [Float] :scale Scale factor on load
1323
+ # @option opts [Integer] :page First page to load
1324
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1325
+ # @option opts [Float] :scale Factor to scale by
1313
1326
  # @option opts [Boolean] :memory Force open via memory
1314
1327
  # @option opts [Vips::Access] :access Required access pattern for this file
1315
1328
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1329
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1316
1330
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1317
1331
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1318
1332
 
@@ -1320,13 +1334,15 @@ module Vips
1320
1334
  # Load tiff from file.
1321
1335
  # @param filename [String] Filename to load from
1322
1336
  # @param opts [Hash] Set of options
1323
- # @option opts [Integer] :page Load this page from the image
1324
- # @option opts [Integer] :subifd Select subifd index
1325
- # @option opts [Integer] :n Load this many pages
1337
+ # @option opts [Integer] :page First page to load
1338
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1326
1339
  # @option opts [Boolean] :autorotate Rotate image using orientation tag
1340
+ # @option opts [Integer] :subifd Subifd index
1341
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1327
1342
  # @option opts [Boolean] :memory Force open via memory
1328
1343
  # @option opts [Vips::Access] :access Required access pattern for this file
1329
1344
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1345
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1330
1346
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1331
1347
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1332
1348
 
@@ -1334,13 +1350,15 @@ module Vips
1334
1350
  # Load tiff from buffer.
1335
1351
  # @param buffer [VipsBlob] Buffer to load from
1336
1352
  # @param opts [Hash] Set of options
1337
- # @option opts [Integer] :page Load this page from the image
1338
- # @option opts [Integer] :subifd Select subifd index
1339
- # @option opts [Integer] :n Load this many pages
1353
+ # @option opts [Integer] :page First page to load
1354
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1340
1355
  # @option opts [Boolean] :autorotate Rotate image using orientation tag
1356
+ # @option opts [Integer] :subifd Subifd index
1357
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1341
1358
  # @option opts [Boolean] :memory Force open via memory
1342
1359
  # @option opts [Vips::Access] :access Required access pattern for this file
1343
1360
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1361
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1344
1362
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1345
1363
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1346
1364
 
@@ -1348,13 +1366,70 @@ module Vips
1348
1366
  # Load tiff from source.
1349
1367
  # @param source [Vips::Source] Source to load from
1350
1368
  # @param opts [Hash] Set of options
1351
- # @option opts [Integer] :page Load this page from the image
1352
- # @option opts [Integer] :subifd Select subifd index
1353
- # @option opts [Integer] :n Load this many pages
1369
+ # @option opts [Integer] :page First page to load
1370
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1354
1371
  # @option opts [Boolean] :autorotate Rotate image using orientation tag
1372
+ # @option opts [Integer] :subifd Subifd index
1373
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1355
1374
  # @option opts [Boolean] :memory Force open via memory
1356
1375
  # @option opts [Vips::Access] :access Required access pattern for this file
1357
1376
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1377
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1378
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1379
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1380
+
1381
+ # @!method self.fitsload(filename, **opts)
1382
+ # Load a fits image.
1383
+ # @param filename [String] Filename to load from
1384
+ # @param opts [Hash] Set of options
1385
+ # @option opts [Boolean] :memory Force open via memory
1386
+ # @option opts [Vips::Access] :access Required access pattern for this file
1387
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
1388
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1389
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1390
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1391
+
1392
+ # @!method self.fitsload_source(source, **opts)
1393
+ # Load fits from a source.
1394
+ # @param source [Vips::Source] Source to load from
1395
+ # @param opts [Hash] Set of options
1396
+ # @option opts [Boolean] :memory Force open via memory
1397
+ # @option opts [Vips::Access] :access Required access pattern for this file
1398
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
1399
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1400
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1401
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1402
+
1403
+ # @!method self.openexrload(filename, **opts)
1404
+ # Load an openexr image.
1405
+ # @param filename [String] Filename to load from
1406
+ # @param opts [Hash] Set of options
1407
+ # @option opts [Boolean] :memory Force open via memory
1408
+ # @option opts [Vips::Access] :access Required access pattern for this file
1409
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
1410
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1411
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1412
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1413
+
1414
+ # @!method self.niftiload(filename, **opts)
1415
+ # Load nifti volume.
1416
+ # @param filename [String] Filename to load from
1417
+ # @param opts [Hash] Set of options
1418
+ # @option opts [Boolean] :memory Force open via memory
1419
+ # @option opts [Vips::Access] :access Required access pattern for this file
1420
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
1421
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1422
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1423
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1424
+
1425
+ # @!method self.niftiload_source(source, **opts)
1426
+ # Load nifti volumes.
1427
+ # @param source [Vips::Source] Source to load from
1428
+ # @param opts [Hash] Set of options
1429
+ # @option opts [Boolean] :memory Force open via memory
1430
+ # @option opts [Vips::Access] :access Required access pattern for this file
1431
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
1432
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1358
1433
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1359
1434
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1360
1435
 
@@ -1362,13 +1437,15 @@ module Vips
1362
1437
  # Load file with openslide.
1363
1438
  # @param filename [String] Filename to load from
1364
1439
  # @param opts [Hash] Set of options
1365
- # @option opts [Boolean] :attach_associated Attach all associated images
1366
1440
  # @option opts [Integer] :level Load this level from the file
1367
1441
  # @option opts [Boolean] :autocrop Crop to image bounds
1368
1442
  # @option opts [String] :associated Load this associated image
1443
+ # @option opts [Boolean] :attach_associated Attach all associated images
1444
+ # @option opts [Boolean] :rgb Output RGB (not RGBA)
1369
1445
  # @option opts [Boolean] :memory Force open via memory
1370
1446
  # @option opts [Vips::Access] :access Required access pattern for this file
1371
1447
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1448
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1372
1449
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1373
1450
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1374
1451
 
@@ -1376,128 +1453,178 @@ module Vips
1376
1453
  # Load source with openslide.
1377
1454
  # @param source [Vips::Source] Source to load from
1378
1455
  # @param opts [Hash] Set of options
1379
- # @option opts [Boolean] :attach_associated Attach all associated images
1380
1456
  # @option opts [Integer] :level Load this level from the file
1381
1457
  # @option opts [Boolean] :autocrop Crop to image bounds
1382
1458
  # @option opts [String] :associated Load this associated image
1459
+ # @option opts [Boolean] :attach_associated Attach all associated images
1460
+ # @option opts [Boolean] :rgb Output RGB (not RGBA)
1383
1461
  # @option opts [Boolean] :memory Force open via memory
1384
1462
  # @option opts [Vips::Access] :access Required access pattern for this file
1385
1463
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1464
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1386
1465
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1387
1466
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1388
1467
 
1389
- # @!method self.magickload(filename, **opts)
1390
- # Load file with imagemagick.
1468
+ # @!method self.heifload(filename, **opts)
1469
+ # Load a heif image.
1391
1470
  # @param filename [String] Filename to load from
1392
1471
  # @param opts [Hash] Set of options
1393
- # @option opts [String] :density Canvas resolution for rendering vector formats like SVG
1394
- # @option opts [Integer] :page Load this page from the file
1395
- # @option opts [Integer] :n Load this many pages
1472
+ # @option opts [Integer] :page First page to load
1473
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1474
+ # @option opts [Boolean] :thumbnail Fetch thumbnail image
1475
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1396
1476
  # @option opts [Boolean] :memory Force open via memory
1397
1477
  # @option opts [Vips::Access] :access Required access pattern for this file
1398
1478
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1479
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1399
1480
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1400
1481
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1401
1482
 
1402
- # @!method self.magickload_buffer(buffer, **opts)
1403
- # Load buffer with imagemagick.
1483
+ # @!method self.heifload_buffer(buffer, **opts)
1484
+ # Load a heif image.
1404
1485
  # @param buffer [VipsBlob] Buffer to load from
1405
1486
  # @param opts [Hash] Set of options
1406
- # @option opts [String] :density Canvas resolution for rendering vector formats like SVG
1407
- # @option opts [Integer] :page Load this page from the file
1408
- # @option opts [Integer] :n Load this many pages
1487
+ # @option opts [Integer] :page First page to load
1488
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1489
+ # @option opts [Boolean] :thumbnail Fetch thumbnail image
1490
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1409
1491
  # @option opts [Boolean] :memory Force open via memory
1410
1492
  # @option opts [Vips::Access] :access Required access pattern for this file
1411
1493
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1494
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1412
1495
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1413
1496
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1414
1497
 
1415
- # @!method self.fitsload(filename, **opts)
1416
- # Load a fits image.
1498
+ # @!method self.heifload_source(source, **opts)
1499
+ # Load a heif image.
1500
+ # @param source [Vips::Source] Source to load from
1501
+ # @param opts [Hash] Set of options
1502
+ # @option opts [Integer] :page First page to load
1503
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1504
+ # @option opts [Boolean] :thumbnail Fetch thumbnail image
1505
+ # @option opts [Boolean] :unlimited Remove all denial of service limits
1506
+ # @option opts [Boolean] :memory Force open via memory
1507
+ # @option opts [Vips::Access] :access Required access pattern for this file
1508
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
1509
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1510
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1511
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1512
+
1513
+ # @!method self.jxlload(filename, **opts)
1514
+ # Load jpeg-xl image.
1417
1515
  # @param filename [String] Filename to load from
1418
1516
  # @param opts [Hash] Set of options
1517
+ # @option opts [Integer] :page First page to load
1518
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1419
1519
  # @option opts [Boolean] :memory Force open via memory
1420
1520
  # @option opts [Vips::Access] :access Required access pattern for this file
1421
1521
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1522
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1422
1523
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1423
1524
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1424
1525
 
1425
- # @!method self.fitsload_source(source, **opts)
1426
- # Load fits from a source.
1427
- # @param source [Vips::Source] Source to load from
1526
+ # @!method self.jxlload_buffer(buffer, **opts)
1527
+ # Load jpeg-xl image.
1528
+ # @param buffer [VipsBlob] Buffer to load from
1428
1529
  # @param opts [Hash] Set of options
1530
+ # @option opts [Integer] :page First page to load
1531
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1429
1532
  # @option opts [Boolean] :memory Force open via memory
1430
1533
  # @option opts [Vips::Access] :access Required access pattern for this file
1431
1534
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1535
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1432
1536
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1433
1537
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1434
1538
 
1435
- # @!method self.openexrload(filename, **opts)
1436
- # Load an openexr image.
1437
- # @param filename [String] Filename to load from
1539
+ # @!method self.jxlload_source(source, **opts)
1540
+ # Load jpeg-xl image.
1541
+ # @param source [Vips::Source] Source to load from
1438
1542
  # @param opts [Hash] Set of options
1543
+ # @option opts [Integer] :page First page to load
1544
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1439
1545
  # @option opts [Boolean] :memory Force open via memory
1440
1546
  # @option opts [Vips::Access] :access Required access pattern for this file
1441
1547
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1548
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1442
1549
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1443
1550
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1444
1551
 
1445
- # @!method self.niftiload(filename, **opts)
1446
- # Load nifti volume.
1552
+ # @!method self.pdfload(filename, **opts)
1553
+ # Load pdf from file.
1447
1554
  # @param filename [String] Filename to load from
1448
1555
  # @param opts [Hash] Set of options
1556
+ # @option opts [Integer] :page First page to load
1557
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1558
+ # @option opts [Float] :dpi DPI to render at
1559
+ # @option opts [Float] :scale Factor to scale by
1560
+ # @option opts [Array<Double>] :background Background colour
1561
+ # @option opts [String] :password Password to decrypt with
1449
1562
  # @option opts [Boolean] :memory Force open via memory
1450
1563
  # @option opts [Vips::Access] :access Required access pattern for this file
1451
1564
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1565
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1452
1566
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1453
1567
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1454
1568
 
1455
- # @!method self.niftiload_source(source, **opts)
1456
- # Load nifti volumes.
1457
- # @param source [Vips::Source] Source to load from
1569
+ # @!method self.pdfload_buffer(buffer, **opts)
1570
+ # Load pdf from buffer.
1571
+ # @param buffer [VipsBlob] Buffer to load from
1458
1572
  # @param opts [Hash] Set of options
1573
+ # @option opts [Integer] :page First page to load
1574
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1575
+ # @option opts [Float] :dpi DPI to render at
1576
+ # @option opts [Float] :scale Factor to scale by
1577
+ # @option opts [Array<Double>] :background Background colour
1578
+ # @option opts [String] :password Password to decrypt with
1459
1579
  # @option opts [Boolean] :memory Force open via memory
1460
1580
  # @option opts [Vips::Access] :access Required access pattern for this file
1461
1581
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1582
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1462
1583
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1463
1584
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1464
1585
 
1465
- # @!method self.heifload(filename, **opts)
1466
- # Load a heif image.
1467
- # @param filename [String] Filename to load from
1586
+ # @!method self.pdfload_source(source, **opts)
1587
+ # Load pdf from source.
1588
+ # @param source [Vips::Source] Source to load from
1468
1589
  # @param opts [Hash] Set of options
1469
- # @option opts [Integer] :page Load this page from the file
1470
- # @option opts [Integer] :n Load this many pages
1471
- # @option opts [Boolean] :thumbnail Fetch thumbnail image
1590
+ # @option opts [Integer] :page First page to load
1591
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1592
+ # @option opts [Float] :dpi DPI to render at
1593
+ # @option opts [Float] :scale Factor to scale by
1594
+ # @option opts [Array<Double>] :background Background colour
1595
+ # @option opts [String] :password Password to decrypt with
1472
1596
  # @option opts [Boolean] :memory Force open via memory
1473
1597
  # @option opts [Vips::Access] :access Required access pattern for this file
1474
1598
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1599
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1475
1600
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1476
1601
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1477
1602
 
1478
- # @!method self.heifload_buffer(buffer, **opts)
1479
- # Load a heif image.
1480
- # @param buffer [VipsBlob] Buffer to load from
1603
+ # @!method self.magickload(filename, **opts)
1604
+ # Load file with imagemagick7.
1605
+ # @param filename [String] Filename to load from
1481
1606
  # @param opts [Hash] Set of options
1482
- # @option opts [Integer] :page Load this page from the file
1483
- # @option opts [Integer] :n Load this many pages
1484
- # @option opts [Boolean] :thumbnail Fetch thumbnail image
1607
+ # @option opts [String] :density Canvas resolution for rendering vector formats like SVG
1608
+ # @option opts [Integer] :page First page to load
1609
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1485
1610
  # @option opts [Boolean] :memory Force open via memory
1486
1611
  # @option opts [Vips::Access] :access Required access pattern for this file
1487
1612
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1613
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1488
1614
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1489
1615
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1490
1616
 
1491
- # @!method self.heifload_source(source, **opts)
1492
- # Load a heif image.
1493
- # @param source [Vips::Source] Source to load from
1617
+ # @!method self.magickload_buffer(buffer, **opts)
1618
+ # Load buffer with imagemagick7.
1619
+ # @param buffer [VipsBlob] Buffer to load from
1494
1620
  # @param opts [Hash] Set of options
1495
- # @option opts [Integer] :page Load this page from the file
1496
- # @option opts [Integer] :n Load this many pages
1497
- # @option opts [Boolean] :thumbnail Fetch thumbnail image
1621
+ # @option opts [String] :density Canvas resolution for rendering vector formats like SVG
1622
+ # @option opts [Integer] :page First page to load
1623
+ # @option opts [Integer] :n Number of pages to load, -1 for all
1498
1624
  # @option opts [Boolean] :memory Force open via memory
1499
1625
  # @option opts [Vips::Access] :access Required access pattern for this file
1500
1626
  # @option opts [Vips::FailOn] :fail_on Error level to fail on
1627
+ # @option opts [Boolean] :revalidate Don't use a cached result for this operation
1501
1628
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1502
1629
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1503
1630
 
@@ -1506,9 +1633,10 @@ module Vips
1506
1633
  # @param filename [String] Filename to save to
1507
1634
  # @param opts [Hash] Set of options
1508
1635
  # @option opts [String] :separator Separator characters
1509
- # @option opts [Boolean] :strip Strip all metadata from image
1636
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1510
1637
  # @option opts [Array<Double>] :background Background value
1511
1638
  # @option opts [Integer] :page_height Set page height for multipage save
1639
+ # @option opts [String] :profile Filename of ICC profile to embed
1512
1640
  # @return [nil]
1513
1641
 
1514
1642
  # @!method csvsave_target(target, **opts)
@@ -1516,71 +1644,88 @@ module Vips
1516
1644
  # @param target [Vips::Target] Target to save to
1517
1645
  # @param opts [Hash] Set of options
1518
1646
  # @option opts [String] :separator Separator characters
1519
- # @option opts [Boolean] :strip Strip all metadata from image
1647
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1520
1648
  # @option opts [Array<Double>] :background Background value
1521
1649
  # @option opts [Integer] :page_height Set page height for multipage save
1650
+ # @option opts [String] :profile Filename of ICC profile to embed
1522
1651
  # @return [nil]
1523
1652
 
1524
1653
  # @!method matrixsave(filename, **opts)
1525
1654
  # Save image to matrix.
1526
1655
  # @param filename [String] Filename to save to
1527
1656
  # @param opts [Hash] Set of options
1528
- # @option opts [Boolean] :strip Strip all metadata from image
1657
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1529
1658
  # @option opts [Array<Double>] :background Background value
1530
1659
  # @option opts [Integer] :page_height Set page height for multipage save
1660
+ # @option opts [String] :profile Filename of ICC profile to embed
1531
1661
  # @return [nil]
1532
1662
 
1533
1663
  # @!method matrixsave_target(target, **opts)
1534
1664
  # Save image to matrix.
1535
1665
  # @param target [Vips::Target] Target to save to
1536
1666
  # @param opts [Hash] Set of options
1537
- # @option opts [Boolean] :strip Strip all metadata from image
1667
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1538
1668
  # @option opts [Array<Double>] :background Background value
1539
1669
  # @option opts [Integer] :page_height Set page height for multipage save
1670
+ # @option opts [String] :profile Filename of ICC profile to embed
1540
1671
  # @return [nil]
1541
1672
 
1542
1673
  # @!method matrixprint(**opts)
1543
1674
  # Print matrix.
1544
1675
  # @param opts [Hash] Set of options
1545
- # @option opts [Boolean] :strip Strip all metadata from image
1676
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1546
1677
  # @option opts [Array<Double>] :background Background value
1547
1678
  # @option opts [Integer] :page_height Set page height for multipage save
1679
+ # @option opts [String] :profile Filename of ICC profile to embed
1548
1680
  # @return [nil]
1549
1681
 
1550
1682
  # @!method rawsave(filename, **opts)
1551
1683
  # Save image to raw file.
1552
1684
  # @param filename [String] Filename to save to
1553
1685
  # @param opts [Hash] Set of options
1554
- # @option opts [Boolean] :strip Strip all metadata from image
1686
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1555
1687
  # @option opts [Array<Double>] :background Background value
1556
1688
  # @option opts [Integer] :page_height Set page height for multipage save
1689
+ # @option opts [String] :profile Filename of ICC profile to embed
1557
1690
  # @return [nil]
1558
1691
 
1559
- # @!method rawsave_fd(fd, **opts)
1560
- # Write raw image to file descriptor.
1561
- # @param fd [Integer] File descriptor to write to
1692
+ # @!method rawsave_buffer(**opts)
1693
+ # Write raw image to buffer.
1562
1694
  # @param opts [Hash] Set of options
1563
- # @option opts [Boolean] :strip Strip all metadata from image
1695
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1564
1696
  # @option opts [Array<Double>] :background Background value
1565
1697
  # @option opts [Integer] :page_height Set page height for multipage save
1698
+ # @option opts [String] :profile Filename of ICC profile to embed
1699
+ # @return [VipsBlob] Buffer to save to
1700
+
1701
+ # @!method rawsave_target(target, **opts)
1702
+ # Write raw image to target.
1703
+ # @param target [Vips::Target] Target to save to
1704
+ # @param opts [Hash] Set of options
1705
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1706
+ # @option opts [Array<Double>] :background Background value
1707
+ # @option opts [Integer] :page_height Set page height for multipage save
1708
+ # @option opts [String] :profile Filename of ICC profile to embed
1566
1709
  # @return [nil]
1567
1710
 
1568
1711
  # @!method vipssave(filename, **opts)
1569
1712
  # Save image to file in vips format.
1570
1713
  # @param filename [String] Filename to save to
1571
1714
  # @param opts [Hash] Set of options
1572
- # @option opts [Boolean] :strip Strip all metadata from image
1715
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1573
1716
  # @option opts [Array<Double>] :background Background value
1574
1717
  # @option opts [Integer] :page_height Set page height for multipage save
1718
+ # @option opts [String] :profile Filename of ICC profile to embed
1575
1719
  # @return [nil]
1576
1720
 
1577
1721
  # @!method vipssave_target(target, **opts)
1578
1722
  # Save image to target in vips format.
1579
1723
  # @param target [Vips::Target] Target to save to
1580
1724
  # @param opts [Hash] Set of options
1581
- # @option opts [Boolean] :strip Strip all metadata from image
1725
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1582
1726
  # @option opts [Array<Double>] :background Background value
1583
1727
  # @option opts [Integer] :page_height Set page height for multipage save
1728
+ # @option opts [String] :profile Filename of ICC profile to embed
1584
1729
  # @return [nil]
1585
1730
 
1586
1731
  # @!method ppmsave(filename, **opts)
@@ -1588,11 +1733,12 @@ module Vips
1588
1733
  # @param filename [String] Filename to save to
1589
1734
  # @param opts [Hash] Set of options
1590
1735
  # @option opts [Vips::ForeignPpmFormat] :format Format to save in
1591
- # @option opts [Boolean] :ascii save as ascii
1592
- # @option opts [Integer] :bitdepth set to 1 to write as a 1 bit image
1593
- # @option opts [Boolean] :strip Strip all metadata from image
1736
+ # @option opts [Boolean] :ascii Save as ascii
1737
+ # @option opts [Integer] :bitdepth Set to 1 to write as a 1 bit image
1738
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1594
1739
  # @option opts [Array<Double>] :background Background value
1595
1740
  # @option opts [Integer] :page_height Set page height for multipage save
1741
+ # @option opts [String] :profile Filename of ICC profile to embed
1596
1742
  # @return [nil]
1597
1743
 
1598
1744
  # @!method ppmsave_target(target, **opts)
@@ -1600,92 +1746,56 @@ module Vips
1600
1746
  # @param target [Vips::Target] Target to save to
1601
1747
  # @param opts [Hash] Set of options
1602
1748
  # @option opts [Vips::ForeignPpmFormat] :format Format to save in
1603
- # @option opts [Boolean] :ascii save as ascii
1604
- # @option opts [Integer] :bitdepth set to 1 to write as a 1 bit image
1605
- # @option opts [Boolean] :strip Strip all metadata from image
1749
+ # @option opts [Boolean] :ascii Save as ascii
1750
+ # @option opts [Integer] :bitdepth Set to 1 to write as a 1 bit image
1751
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1606
1752
  # @option opts [Array<Double>] :background Background value
1607
1753
  # @option opts [Integer] :page_height Set page height for multipage save
1754
+ # @option opts [String] :profile Filename of ICC profile to embed
1608
1755
  # @return [nil]
1609
1756
 
1610
1757
  # @!method radsave(filename, **opts)
1611
1758
  # Save image to radiance file.
1612
1759
  # @param filename [String] Filename to save to
1613
1760
  # @param opts [Hash] Set of options
1614
- # @option opts [Boolean] :strip Strip all metadata from image
1761
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1615
1762
  # @option opts [Array<Double>] :background Background value
1616
1763
  # @option opts [Integer] :page_height Set page height for multipage save
1764
+ # @option opts [String] :profile Filename of ICC profile to embed
1617
1765
  # @return [nil]
1618
1766
 
1619
1767
  # @!method radsave_buffer(**opts)
1620
1768
  # Save image to radiance buffer.
1621
1769
  # @param opts [Hash] Set of options
1622
- # @option opts [Boolean] :strip Strip all metadata from image
1770
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1623
1771
  # @option opts [Array<Double>] :background Background value
1624
1772
  # @option opts [Integer] :page_height Set page height for multipage save
1773
+ # @option opts [String] :profile Filename of ICC profile to embed
1625
1774
  # @return [VipsBlob] Buffer to save to
1626
1775
 
1627
1776
  # @!method radsave_target(target, **opts)
1628
1777
  # Save image to radiance target.
1629
1778
  # @param target [Vips::Target] Target to save to
1630
1779
  # @param opts [Hash] Set of options
1631
- # @option opts [Boolean] :strip Strip all metadata from image
1632
- # @option opts [Array<Double>] :background Background value
1633
- # @option opts [Integer] :page_height Set page height for multipage save
1634
- # @return [nil]
1635
-
1636
- # @!method jxlsave(filename, **opts)
1637
- # Save image in jpeg-xl format.
1638
- # @param filename [String] Filename to load from
1639
- # @param opts [Hash] Set of options
1640
- # @option opts [Integer] :tier Decode speed tier
1641
- # @option opts [Float] :distance Target butteraugli distance
1642
- # @option opts [Integer] :effort Encoding effort
1643
- # @option opts [Boolean] :lossless Enable lossless compression
1644
- # @option opts [Integer] :Q Quality factor
1645
- # @option opts [Boolean] :strip Strip all metadata from image
1646
- # @option opts [Array<Double>] :background Background value
1647
- # @option opts [Integer] :page_height Set page height for multipage save
1648
- # @return [nil]
1649
-
1650
- # @!method jxlsave_buffer(**opts)
1651
- # Save image in jpeg-xl format.
1652
- # @param opts [Hash] Set of options
1653
- # @option opts [Integer] :tier Decode speed tier
1654
- # @option opts [Float] :distance Target butteraugli distance
1655
- # @option opts [Integer] :effort Encoding effort
1656
- # @option opts [Boolean] :lossless Enable lossless compression
1657
- # @option opts [Integer] :Q Quality factor
1658
- # @option opts [Boolean] :strip Strip all metadata from image
1659
- # @option opts [Array<Double>] :background Background value
1660
- # @option opts [Integer] :page_height Set page height for multipage save
1661
- # @return [VipsBlob] Buffer to save to
1662
-
1663
- # @!method jxlsave_target(target, **opts)
1664
- # Save image in jpeg-xl format.
1665
- # @param target [Vips::Target] Target to save to
1666
- # @param opts [Hash] Set of options
1667
- # @option opts [Integer] :tier Decode speed tier
1668
- # @option opts [Float] :distance Target butteraugli distance
1669
- # @option opts [Integer] :effort Encoding effort
1670
- # @option opts [Boolean] :lossless Enable lossless compression
1671
- # @option opts [Integer] :Q Quality factor
1672
- # @option opts [Boolean] :strip Strip all metadata from image
1780
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1673
1781
  # @option opts [Array<Double>] :background Background value
1674
1782
  # @option opts [Integer] :page_height Set page height for multipage save
1783
+ # @option opts [String] :profile Filename of ICC profile to embed
1675
1784
  # @return [nil]
1676
1785
 
1677
1786
  # @!method jp2ksave(filename, **opts)
1678
1787
  # Save image in jpeg2000 format.
1679
- # @param filename [String] Filename to load from
1788
+ # @param filename [String] Filename to save to
1680
1789
  # @param opts [Hash] Set of options
1681
1790
  # @option opts [Integer] :tile_width Tile width in pixels
1682
1791
  # @option opts [Integer] :tile_height Tile height in pixels
1683
1792
  # @option opts [Boolean] :lossless Enable lossless compression
1684
1793
  # @option opts [Integer] :Q Q factor
1685
1794
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1686
- # @option opts [Boolean] :strip Strip all metadata from image
1795
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1687
1796
  # @option opts [Array<Double>] :background Background value
1688
1797
  # @option opts [Integer] :page_height Set page height for multipage save
1798
+ # @option opts [String] :profile Filename of ICC profile to embed
1689
1799
  # @return [nil]
1690
1800
 
1691
1801
  # @!method jp2ksave_buffer(**opts)
@@ -1696,9 +1806,10 @@ module Vips
1696
1806
  # @option opts [Boolean] :lossless Enable lossless compression
1697
1807
  # @option opts [Integer] :Q Q factor
1698
1808
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1699
- # @option opts [Boolean] :strip Strip all metadata from image
1809
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1700
1810
  # @option opts [Array<Double>] :background Background value
1701
1811
  # @option opts [Integer] :page_height Set page height for multipage save
1812
+ # @option opts [String] :profile Filename of ICC profile to embed
1702
1813
  # @return [VipsBlob] Buffer to save to
1703
1814
 
1704
1815
  # @!method jp2ksave_target(target, **opts)
@@ -1710,9 +1821,10 @@ module Vips
1710
1821
  # @option opts [Boolean] :lossless Enable lossless compression
1711
1822
  # @option opts [Integer] :Q Q factor
1712
1823
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1713
- # @option opts [Boolean] :strip Strip all metadata from image
1824
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1714
1825
  # @option opts [Array<Double>] :background Background value
1715
1826
  # @option opts [Integer] :page_height Set page height for multipage save
1827
+ # @option opts [String] :profile Filename of ICC profile to embed
1716
1828
  # @return [nil]
1717
1829
 
1718
1830
  # @!method gifsave(filename, **opts)
@@ -1722,9 +1834,15 @@ module Vips
1722
1834
  # @option opts [Float] :dither Amount of dithering
1723
1835
  # @option opts [Integer] :effort Quantisation effort
1724
1836
  # @option opts [Integer] :bitdepth Number of bits per pixel
1725
- # @option opts [Boolean] :strip Strip all metadata from image
1837
+ # @option opts [Float] :interframe_maxerror Maximum inter-frame error for transparency
1838
+ # @option opts [Boolean] :reuse Reuse palette from input
1839
+ # @option opts [Float] :interpalette_maxerror Maximum inter-palette error for palette reusage
1840
+ # @option opts [Boolean] :interlace Generate an interlaced (progressive) GIF
1841
+ # @option opts [Boolean] :keep_duplicate_frames Keep duplicate frames in the output instead of combining them
1842
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1726
1843
  # @option opts [Array<Double>] :background Background value
1727
1844
  # @option opts [Integer] :page_height Set page height for multipage save
1845
+ # @option opts [String] :profile Filename of ICC profile to embed
1728
1846
  # @return [nil]
1729
1847
 
1730
1848
  # @!method gifsave_buffer(**opts)
@@ -1733,9 +1851,15 @@ module Vips
1733
1851
  # @option opts [Float] :dither Amount of dithering
1734
1852
  # @option opts [Integer] :effort Quantisation effort
1735
1853
  # @option opts [Integer] :bitdepth Number of bits per pixel
1736
- # @option opts [Boolean] :strip Strip all metadata from image
1854
+ # @option opts [Float] :interframe_maxerror Maximum inter-frame error for transparency
1855
+ # @option opts [Boolean] :reuse Reuse palette from input
1856
+ # @option opts [Float] :interpalette_maxerror Maximum inter-palette error for palette reusage
1857
+ # @option opts [Boolean] :interlace Generate an interlaced (progressive) GIF
1858
+ # @option opts [Boolean] :keep_duplicate_frames Keep duplicate frames in the output instead of combining them
1859
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1737
1860
  # @option opts [Array<Double>] :background Background value
1738
1861
  # @option opts [Integer] :page_height Set page height for multipage save
1862
+ # @option opts [String] :profile Filename of ICC profile to embed
1739
1863
  # @return [VipsBlob] Buffer to save to
1740
1864
 
1741
1865
  # @!method gifsave_target(target, **opts)
@@ -1745,16 +1869,22 @@ module Vips
1745
1869
  # @option opts [Float] :dither Amount of dithering
1746
1870
  # @option opts [Integer] :effort Quantisation effort
1747
1871
  # @option opts [Integer] :bitdepth Number of bits per pixel
1748
- # @option opts [Boolean] :strip Strip all metadata from image
1872
+ # @option opts [Float] :interframe_maxerror Maximum inter-frame error for transparency
1873
+ # @option opts [Boolean] :reuse Reuse palette from input
1874
+ # @option opts [Float] :interpalette_maxerror Maximum inter-palette error for palette reusage
1875
+ # @option opts [Boolean] :interlace Generate an interlaced (progressive) GIF
1876
+ # @option opts [Boolean] :keep_duplicate_frames Keep duplicate frames in the output instead of combining them
1877
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1749
1878
  # @option opts [Array<Double>] :background Background value
1750
1879
  # @option opts [Integer] :page_height Set page height for multipage save
1880
+ # @option opts [String] :profile Filename of ICC profile to embed
1751
1881
  # @return [nil]
1752
1882
 
1753
1883
  # @!method dzsave(filename, **opts)
1754
1884
  # Save image to deepzoom file.
1755
1885
  # @param filename [String] Filename to save to
1756
1886
  # @param opts [Hash] Set of options
1757
- # @option opts [String] :basename Base name to save to
1887
+ # @option opts [String] :imagename Image name
1758
1888
  # @option opts [Vips::ForeignDzLayout] :layout Directory layout
1759
1889
  # @option opts [String] :suffix Filename suffix for tiles
1760
1890
  # @option opts [Integer] :overlap Tile overlap in pixels
@@ -1763,21 +1893,21 @@ module Vips
1763
1893
  # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
1764
1894
  # @option opts [Vips::Angle] :angle Rotate image during save
1765
1895
  # @option opts [Vips::ForeignDzContainer] :container Pyramid container type
1766
- # @option opts [Boolean] :properties Write a properties file to the output directory
1767
1896
  # @option opts [Integer] :compression ZIP deflate compression level
1768
1897
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1769
1898
  # @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
1770
- # @option opts [Boolean] :no_strip Don't strip tile metadata
1771
1899
  # @option opts [String] :id Resource ID
1772
- # @option opts [Boolean] :strip Strip all metadata from image
1900
+ # @option opts [Integer] :Q Q factor
1901
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1773
1902
  # @option opts [Array<Double>] :background Background value
1774
1903
  # @option opts [Integer] :page_height Set page height for multipage save
1904
+ # @option opts [String] :profile Filename of ICC profile to embed
1775
1905
  # @return [nil]
1776
1906
 
1777
1907
  # @!method dzsave_buffer(**opts)
1778
1908
  # Save image to dz buffer.
1779
1909
  # @param opts [Hash] Set of options
1780
- # @option opts [String] :basename Base name to save to
1910
+ # @option opts [String] :imagename Image name
1781
1911
  # @option opts [Vips::ForeignDzLayout] :layout Directory layout
1782
1912
  # @option opts [String] :suffix Filename suffix for tiles
1783
1913
  # @option opts [Integer] :overlap Tile overlap in pixels
@@ -1786,50 +1916,74 @@ module Vips
1786
1916
  # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
1787
1917
  # @option opts [Vips::Angle] :angle Rotate image during save
1788
1918
  # @option opts [Vips::ForeignDzContainer] :container Pyramid container type
1789
- # @option opts [Boolean] :properties Write a properties file to the output directory
1790
1919
  # @option opts [Integer] :compression ZIP deflate compression level
1791
1920
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1792
1921
  # @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
1793
- # @option opts [Boolean] :no_strip Don't strip tile metadata
1794
1922
  # @option opts [String] :id Resource ID
1795
- # @option opts [Boolean] :strip Strip all metadata from image
1923
+ # @option opts [Integer] :Q Q factor
1924
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1796
1925
  # @option opts [Array<Double>] :background Background value
1797
1926
  # @option opts [Integer] :page_height Set page height for multipage save
1927
+ # @option opts [String] :profile Filename of ICC profile to embed
1798
1928
  # @return [VipsBlob] Buffer to save to
1799
1929
 
1930
+ # @!method dzsave_target(target, **opts)
1931
+ # Save image to deepzoom target.
1932
+ # @param target [Vips::Target] Target to save to
1933
+ # @param opts [Hash] Set of options
1934
+ # @option opts [String] :imagename Image name
1935
+ # @option opts [Vips::ForeignDzLayout] :layout Directory layout
1936
+ # @option opts [String] :suffix Filename suffix for tiles
1937
+ # @option opts [Integer] :overlap Tile overlap in pixels
1938
+ # @option opts [Integer] :tile_size Tile size in pixels
1939
+ # @option opts [Boolean] :centre Center image in tile
1940
+ # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
1941
+ # @option opts [Vips::Angle] :angle Rotate image during save
1942
+ # @option opts [Vips::ForeignDzContainer] :container Pyramid container type
1943
+ # @option opts [Integer] :compression ZIP deflate compression level
1944
+ # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1945
+ # @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
1946
+ # @option opts [String] :id Resource ID
1947
+ # @option opts [Integer] :Q Q factor
1948
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1949
+ # @option opts [Array<Double>] :background Background value
1950
+ # @option opts [Integer] :page_height Set page height for multipage save
1951
+ # @option opts [String] :profile Filename of ICC profile to embed
1952
+ # @return [nil]
1953
+
1800
1954
  # @!method pngsave(filename, **opts)
1801
- # Save image to png file.
1955
+ # Save image to file as png.
1802
1956
  # @param filename [String] Filename to save to
1803
1957
  # @param opts [Hash] Set of options
1804
1958
  # @option opts [Integer] :compression Compression factor
1805
1959
  # @option opts [Boolean] :interlace Interlace image
1806
- # @option opts [String] :profile ICC profile to embed
1807
- # @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
1960
+ # @option opts [Vips::ForeignPngFilter] :filter libspng row filter flag(s)
1808
1961
  # @option opts [Boolean] :palette Quantise to 8bpp palette
1809
1962
  # @option opts [Integer] :Q Quantisation quality
1810
1963
  # @option opts [Float] :dither Amount of dithering
1811
- # @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
1964
+ # @option opts [Integer] :bitdepth Write as a 1, 2, 4, 8 or 16 bit image
1812
1965
  # @option opts [Integer] :effort Quantisation CPU effort
1813
- # @option opts [Boolean] :strip Strip all metadata from image
1966
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1814
1967
  # @option opts [Array<Double>] :background Background value
1815
1968
  # @option opts [Integer] :page_height Set page height for multipage save
1969
+ # @option opts [String] :profile Filename of ICC profile to embed
1816
1970
  # @return [nil]
1817
1971
 
1818
1972
  # @!method pngsave_buffer(**opts)
1819
- # Save image to png buffer.
1973
+ # Save image to buffer as png.
1820
1974
  # @param opts [Hash] Set of options
1821
1975
  # @option opts [Integer] :compression Compression factor
1822
1976
  # @option opts [Boolean] :interlace Interlace image
1823
- # @option opts [String] :profile ICC profile to embed
1824
- # @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
1977
+ # @option opts [Vips::ForeignPngFilter] :filter libspng row filter flag(s)
1825
1978
  # @option opts [Boolean] :palette Quantise to 8bpp palette
1826
1979
  # @option opts [Integer] :Q Quantisation quality
1827
1980
  # @option opts [Float] :dither Amount of dithering
1828
- # @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
1981
+ # @option opts [Integer] :bitdepth Write as a 1, 2, 4, 8 or 16 bit image
1829
1982
  # @option opts [Integer] :effort Quantisation CPU effort
1830
- # @option opts [Boolean] :strip Strip all metadata from image
1983
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1831
1984
  # @option opts [Array<Double>] :background Background value
1832
1985
  # @option opts [Integer] :page_height Set page height for multipage save
1986
+ # @option opts [String] :profile Filename of ICC profile to embed
1833
1987
  # @return [VipsBlob] Buffer to save to
1834
1988
 
1835
1989
  # @!method pngsave_target(target, **opts)
@@ -1838,16 +1992,16 @@ module Vips
1838
1992
  # @param opts [Hash] Set of options
1839
1993
  # @option opts [Integer] :compression Compression factor
1840
1994
  # @option opts [Boolean] :interlace Interlace image
1841
- # @option opts [String] :profile ICC profile to embed
1842
- # @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
1995
+ # @option opts [Vips::ForeignPngFilter] :filter libspng row filter flag(s)
1843
1996
  # @option opts [Boolean] :palette Quantise to 8bpp palette
1844
1997
  # @option opts [Integer] :Q Quantisation quality
1845
1998
  # @option opts [Float] :dither Amount of dithering
1846
- # @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
1999
+ # @option opts [Integer] :bitdepth Write as a 1, 2, 4, 8 or 16 bit image
1847
2000
  # @option opts [Integer] :effort Quantisation CPU effort
1848
- # @option opts [Boolean] :strip Strip all metadata from image
2001
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1849
2002
  # @option opts [Array<Double>] :background Background value
1850
2003
  # @option opts [Integer] :page_height Set page height for multipage save
2004
+ # @option opts [String] :profile Filename of ICC profile to embed
1851
2005
  # @return [nil]
1852
2006
 
1853
2007
  # @!method jpegsave(filename, **opts)
@@ -1855,7 +2009,6 @@ module Vips
1855
2009
  # @param filename [String] Filename to save to
1856
2010
  # @param opts [Hash] Set of options
1857
2011
  # @option opts [Integer] :Q Q factor
1858
- # @option opts [String] :profile ICC profile to embed
1859
2012
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
1860
2013
  # @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
1861
2014
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
@@ -1864,16 +2017,16 @@ module Vips
1864
2017
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1865
2018
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1866
2019
  # @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
1867
- # @option opts [Boolean] :strip Strip all metadata from image
2020
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1868
2021
  # @option opts [Array<Double>] :background Background value
1869
2022
  # @option opts [Integer] :page_height Set page height for multipage save
2023
+ # @option opts [String] :profile Filename of ICC profile to embed
1870
2024
  # @return [nil]
1871
2025
 
1872
2026
  # @!method jpegsave_buffer(**opts)
1873
2027
  # Save image to jpeg buffer.
1874
2028
  # @param opts [Hash] Set of options
1875
2029
  # @option opts [Integer] :Q Q factor
1876
- # @option opts [String] :profile ICC profile to embed
1877
2030
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
1878
2031
  # @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
1879
2032
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
@@ -1882,9 +2035,10 @@ module Vips
1882
2035
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1883
2036
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1884
2037
  # @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
1885
- # @option opts [Boolean] :strip Strip all metadata from image
2038
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1886
2039
  # @option opts [Array<Double>] :background Background value
1887
2040
  # @option opts [Integer] :page_height Set page height for multipage save
2041
+ # @option opts [String] :profile Filename of ICC profile to embed
1888
2042
  # @return [VipsBlob] Buffer to save to
1889
2043
 
1890
2044
  # @!method jpegsave_target(target, **opts)
@@ -1892,7 +2046,6 @@ module Vips
1892
2046
  # @param target [Vips::Target] Target to save to
1893
2047
  # @param opts [Hash] Set of options
1894
2048
  # @option opts [Integer] :Q Q factor
1895
- # @option opts [String] :profile ICC profile to embed
1896
2049
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
1897
2050
  # @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
1898
2051
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
@@ -1901,16 +2054,16 @@ module Vips
1901
2054
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1902
2055
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1903
2056
  # @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
1904
- # @option opts [Boolean] :strip Strip all metadata from image
2057
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1905
2058
  # @option opts [Array<Double>] :background Background value
1906
2059
  # @option opts [Integer] :page_height Set page height for multipage save
2060
+ # @option opts [String] :profile Filename of ICC profile to embed
1907
2061
  # @return [nil]
1908
2062
 
1909
2063
  # @!method jpegsave_mime(**opts)
1910
2064
  # Save image to jpeg mime.
1911
2065
  # @param opts [Hash] Set of options
1912
2066
  # @option opts [Integer] :Q Q factor
1913
- # @option opts [String] :profile ICC profile to embed
1914
2067
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
1915
2068
  # @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
1916
2069
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
@@ -1919,68 +2072,104 @@ module Vips
1919
2072
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1920
2073
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
1921
2074
  # @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
1922
- # @option opts [Boolean] :strip Strip all metadata from image
2075
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1923
2076
  # @option opts [Array<Double>] :background Background value
1924
2077
  # @option opts [Integer] :page_height Set page height for multipage save
2078
+ # @option opts [String] :profile Filename of ICC profile to embed
1925
2079
  # @return [nil]
1926
2080
 
1927
2081
  # @!method webpsave(filename, **opts)
1928
- # Save image to webp file.
2082
+ # Save as webp.
1929
2083
  # @param filename [String] Filename to save to
1930
2084
  # @param opts [Hash] Set of options
1931
2085
  # @option opts [Integer] :Q Q factor
1932
- # @option opts [Boolean] :lossless enable lossless compression
2086
+ # @option opts [Boolean] :lossless Enable lossless compression
1933
2087
  # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
1934
2088
  # @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
1935
2089
  # @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
1936
2090
  # @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
1937
- # @option opts [Boolean] :min_size Optimise for minium size
2091
+ # @option opts [Boolean] :min_size Optimise for minimum size
1938
2092
  # @option opts [Integer] :kmin Minimum number of frames between key frames
1939
2093
  # @option opts [Integer] :kmax Maximum number of frames between key frames
1940
2094
  # @option opts [Integer] :effort Level of CPU effort to reduce file size
1941
- # @option opts [String] :profile ICC profile to embed
1942
- # @option opts [Boolean] :strip Strip all metadata from image
2095
+ # @option opts [Integer] :target_size Desired target size in bytes
2096
+ # @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
2097
+ # @option opts [Boolean] :smart_deblock Enable auto-adjusting of the deblocking filter
2098
+ # @option opts [Integer] :passes Number of entropy-analysis passes (in [1..10])
2099
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1943
2100
  # @option opts [Array<Double>] :background Background value
1944
2101
  # @option opts [Integer] :page_height Set page height for multipage save
2102
+ # @option opts [String] :profile Filename of ICC profile to embed
1945
2103
  # @return [nil]
1946
2104
 
1947
2105
  # @!method webpsave_buffer(**opts)
1948
- # Save image to webp buffer.
2106
+ # Save as webp.
1949
2107
  # @param opts [Hash] Set of options
1950
2108
  # @option opts [Integer] :Q Q factor
1951
- # @option opts [Boolean] :lossless enable lossless compression
2109
+ # @option opts [Boolean] :lossless Enable lossless compression
1952
2110
  # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
1953
2111
  # @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
1954
2112
  # @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
1955
2113
  # @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
1956
- # @option opts [Boolean] :min_size Optimise for minium size
2114
+ # @option opts [Boolean] :min_size Optimise for minimum size
1957
2115
  # @option opts [Integer] :kmin Minimum number of frames between key frames
1958
2116
  # @option opts [Integer] :kmax Maximum number of frames between key frames
1959
2117
  # @option opts [Integer] :effort Level of CPU effort to reduce file size
1960
- # @option opts [String] :profile ICC profile to embed
1961
- # @option opts [Boolean] :strip Strip all metadata from image
2118
+ # @option opts [Integer] :target_size Desired target size in bytes
2119
+ # @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
2120
+ # @option opts [Boolean] :smart_deblock Enable auto-adjusting of the deblocking filter
2121
+ # @option opts [Integer] :passes Number of entropy-analysis passes (in [1..10])
2122
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1962
2123
  # @option opts [Array<Double>] :background Background value
1963
2124
  # @option opts [Integer] :page_height Set page height for multipage save
2125
+ # @option opts [String] :profile Filename of ICC profile to embed
1964
2126
  # @return [VipsBlob] Buffer to save to
1965
2127
 
1966
2128
  # @!method webpsave_target(target, **opts)
1967
- # Save image to webp target.
2129
+ # Save as webp.
1968
2130
  # @param target [Vips::Target] Target to save to
1969
2131
  # @param opts [Hash] Set of options
1970
2132
  # @option opts [Integer] :Q Q factor
1971
- # @option opts [Boolean] :lossless enable lossless compression
2133
+ # @option opts [Boolean] :lossless Enable lossless compression
1972
2134
  # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
1973
2135
  # @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
1974
2136
  # @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
1975
2137
  # @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
1976
- # @option opts [Boolean] :min_size Optimise for minium size
2138
+ # @option opts [Boolean] :min_size Optimise for minimum size
1977
2139
  # @option opts [Integer] :kmin Minimum number of frames between key frames
1978
2140
  # @option opts [Integer] :kmax Maximum number of frames between key frames
1979
2141
  # @option opts [Integer] :effort Level of CPU effort to reduce file size
1980
- # @option opts [String] :profile ICC profile to embed
1981
- # @option opts [Boolean] :strip Strip all metadata from image
2142
+ # @option opts [Integer] :target_size Desired target size in bytes
2143
+ # @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
2144
+ # @option opts [Boolean] :smart_deblock Enable auto-adjusting of the deblocking filter
2145
+ # @option opts [Integer] :passes Number of entropy-analysis passes (in [1..10])
2146
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
1982
2147
  # @option opts [Array<Double>] :background Background value
1983
2148
  # @option opts [Integer] :page_height Set page height for multipage save
2149
+ # @option opts [String] :profile Filename of ICC profile to embed
2150
+ # @return [nil]
2151
+
2152
+ # @!method webpsave_mime(**opts)
2153
+ # Save image to webp mime.
2154
+ # @param opts [Hash] Set of options
2155
+ # @option opts [Integer] :Q Q factor
2156
+ # @option opts [Boolean] :lossless Enable lossless compression
2157
+ # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
2158
+ # @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
2159
+ # @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
2160
+ # @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
2161
+ # @option opts [Boolean] :min_size Optimise for minimum size
2162
+ # @option opts [Integer] :kmin Minimum number of frames between key frames
2163
+ # @option opts [Integer] :kmax Maximum number of frames between key frames
2164
+ # @option opts [Integer] :effort Level of CPU effort to reduce file size
2165
+ # @option opts [Integer] :target_size Desired target size in bytes
2166
+ # @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
2167
+ # @option opts [Boolean] :smart_deblock Enable auto-adjusting of the deblocking filter
2168
+ # @option opts [Integer] :passes Number of entropy-analysis passes (in [1..10])
2169
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2170
+ # @option opts [Array<Double>] :background Background value
2171
+ # @option opts [Integer] :page_height Set page height for multipage save
2172
+ # @option opts [String] :profile Filename of ICC profile to embed
1984
2173
  # @return [nil]
1985
2174
 
1986
2175
  # @!method tiffsave(filename, **opts)
@@ -1990,7 +2179,6 @@ module Vips
1990
2179
  # @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
1991
2180
  # @option opts [Integer] :Q Q factor
1992
2181
  # @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
1993
- # @option opts [String] :profile ICC profile to embed
1994
2182
  # @option opts [Boolean] :tile Write a tiled tiff
1995
2183
  # @option opts [Integer] :tile_width Tile width in pixels
1996
2184
  # @option opts [Integer] :tile_height Tile height in pixels
@@ -2003,14 +2191,15 @@ module Vips
2003
2191
  # @option opts [Boolean] :bigtiff Write a bigtiff image
2004
2192
  # @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
2005
2193
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
2006
- # @option opts [Integer] :level ZSTD compression level
2194
+ # @option opts [Integer] :level Deflate (1-9, default 6) or ZSTD (1-22, default 9) compression level
2007
2195
  # @option opts [Boolean] :lossless Enable WEBP lossless mode
2008
2196
  # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
2009
2197
  # @option opts [Boolean] :subifd Save pyr layers as sub-IFDs
2010
2198
  # @option opts [Boolean] :premultiply Save with premultiplied alpha
2011
- # @option opts [Boolean] :strip Strip all metadata from image
2199
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2012
2200
  # @option opts [Array<Double>] :background Background value
2013
2201
  # @option opts [Integer] :page_height Set page height for multipage save
2202
+ # @option opts [String] :profile Filename of ICC profile to embed
2014
2203
  # @return [nil]
2015
2204
 
2016
2205
  # @!method tiffsave_buffer(**opts)
@@ -2019,7 +2208,6 @@ module Vips
2019
2208
  # @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
2020
2209
  # @option opts [Integer] :Q Q factor
2021
2210
  # @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
2022
- # @option opts [String] :profile ICC profile to embed
2023
2211
  # @option opts [Boolean] :tile Write a tiled tiff
2024
2212
  # @option opts [Integer] :tile_width Tile width in pixels
2025
2213
  # @option opts [Integer] :tile_height Tile height in pixels
@@ -2032,57 +2220,65 @@ module Vips
2032
2220
  # @option opts [Boolean] :bigtiff Write a bigtiff image
2033
2221
  # @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
2034
2222
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
2035
- # @option opts [Integer] :level ZSTD compression level
2223
+ # @option opts [Integer] :level Deflate (1-9, default 6) or ZSTD (1-22, default 9) compression level
2036
2224
  # @option opts [Boolean] :lossless Enable WEBP lossless mode
2037
2225
  # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
2038
2226
  # @option opts [Boolean] :subifd Save pyr layers as sub-IFDs
2039
2227
  # @option opts [Boolean] :premultiply Save with premultiplied alpha
2040
- # @option opts [Boolean] :strip Strip all metadata from image
2228
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2041
2229
  # @option opts [Array<Double>] :background Background value
2042
2230
  # @option opts [Integer] :page_height Set page height for multipage save
2231
+ # @option opts [String] :profile Filename of ICC profile to embed
2043
2232
  # @return [VipsBlob] Buffer to save to
2044
2233
 
2045
- # @!method magicksave(filename, **opts)
2046
- # Save file with imagemagick.
2047
- # @param filename [String] Filename to save to
2234
+ # @!method tiffsave_target(target, **opts)
2235
+ # Save image to tiff target.
2236
+ # @param target [Vips::Target] Target to save to
2048
2237
  # @param opts [Hash] Set of options
2049
- # @option opts [String] :format Format to save in
2050
- # @option opts [Integer] :quality Quality to use
2051
- # @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
2052
- # @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
2053
- # @option opts [Boolean] :strip Strip all metadata from image
2238
+ # @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
2239
+ # @option opts [Integer] :Q Q factor
2240
+ # @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
2241
+ # @option opts [Boolean] :tile Write a tiled tiff
2242
+ # @option opts [Integer] :tile_width Tile width in pixels
2243
+ # @option opts [Integer] :tile_height Tile height in pixels
2244
+ # @option opts [Boolean] :pyramid Write a pyramidal tiff
2245
+ # @option opts [Boolean] :miniswhite Use 0 for white in 1-bit images
2246
+ # @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
2247
+ # @option opts [Vips::ForeignTiffResunit] :resunit Resolution unit
2248
+ # @option opts [Float] :xres Horizontal resolution in pixels/mm
2249
+ # @option opts [Float] :yres Vertical resolution in pixels/mm
2250
+ # @option opts [Boolean] :bigtiff Write a bigtiff image
2251
+ # @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
2252
+ # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
2253
+ # @option opts [Integer] :level Deflate (1-9, default 6) or ZSTD (1-22, default 9) compression level
2254
+ # @option opts [Boolean] :lossless Enable WEBP lossless mode
2255
+ # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
2256
+ # @option opts [Boolean] :subifd Save pyr layers as sub-IFDs
2257
+ # @option opts [Boolean] :premultiply Save with premultiplied alpha
2258
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2054
2259
  # @option opts [Array<Double>] :background Background value
2055
2260
  # @option opts [Integer] :page_height Set page height for multipage save
2261
+ # @option opts [String] :profile Filename of ICC profile to embed
2056
2262
  # @return [nil]
2057
2263
 
2058
- # @!method magicksave_buffer(**opts)
2059
- # Save image to magick buffer.
2060
- # @param opts [Hash] Set of options
2061
- # @option opts [String] :format Format to save in
2062
- # @option opts [Integer] :quality Quality to use
2063
- # @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
2064
- # @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
2065
- # @option opts [Boolean] :strip Strip all metadata from image
2066
- # @option opts [Array<Double>] :background Background value
2067
- # @option opts [Integer] :page_height Set page height for multipage save
2068
- # @return [VipsBlob] Buffer to save to
2069
-
2070
2264
  # @!method fitssave(filename, **opts)
2071
2265
  # Save image to fits file.
2072
2266
  # @param filename [String] Filename to save to
2073
2267
  # @param opts [Hash] Set of options
2074
- # @option opts [Boolean] :strip Strip all metadata from image
2268
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2075
2269
  # @option opts [Array<Double>] :background Background value
2076
2270
  # @option opts [Integer] :page_height Set page height for multipage save
2271
+ # @option opts [String] :profile Filename of ICC profile to embed
2077
2272
  # @return [nil]
2078
2273
 
2079
2274
  # @!method niftisave(filename, **opts)
2080
2275
  # Save image to nifti file.
2081
2276
  # @param filename [String] Filename to save to
2082
2277
  # @param opts [Hash] Set of options
2083
- # @option opts [Boolean] :strip Strip all metadata from image
2278
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2084
2279
  # @option opts [Array<Double>] :background Background value
2085
2280
  # @option opts [Integer] :page_height Set page height for multipage save
2281
+ # @option opts [String] :profile Filename of ICC profile to embed
2086
2282
  # @return [nil]
2087
2283
 
2088
2284
  # @!method heifsave(filename, **opts)
@@ -2090,26 +2286,32 @@ module Vips
2090
2286
  # @param filename [String] Filename to save to
2091
2287
  # @param opts [Hash] Set of options
2092
2288
  # @option opts [Integer] :Q Q factor
2289
+ # @option opts [Integer] :bitdepth Number of bits per pixel
2093
2290
  # @option opts [Boolean] :lossless Enable lossless compression
2094
2291
  # @option opts [Vips::ForeignHeifCompression] :compression Compression format
2095
2292
  # @option opts [Integer] :effort CPU effort
2096
2293
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
2097
- # @option opts [Boolean] :strip Strip all metadata from image
2294
+ # @option opts [Vips::ForeignHeifEncoder] :encoder Select encoder to use
2295
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2098
2296
  # @option opts [Array<Double>] :background Background value
2099
2297
  # @option opts [Integer] :page_height Set page height for multipage save
2298
+ # @option opts [String] :profile Filename of ICC profile to embed
2100
2299
  # @return [nil]
2101
2300
 
2102
2301
  # @!method heifsave_buffer(**opts)
2103
2302
  # Save image in heif format.
2104
2303
  # @param opts [Hash] Set of options
2105
2304
  # @option opts [Integer] :Q Q factor
2305
+ # @option opts [Integer] :bitdepth Number of bits per pixel
2106
2306
  # @option opts [Boolean] :lossless Enable lossless compression
2107
2307
  # @option opts [Vips::ForeignHeifCompression] :compression Compression format
2108
2308
  # @option opts [Integer] :effort CPU effort
2109
2309
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
2110
- # @option opts [Boolean] :strip Strip all metadata from image
2310
+ # @option opts [Vips::ForeignHeifEncoder] :encoder Select encoder to use
2311
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2111
2312
  # @option opts [Array<Double>] :background Background value
2112
2313
  # @option opts [Integer] :page_height Set page height for multipage save
2314
+ # @option opts [String] :profile Filename of ICC profile to embed
2113
2315
  # @return [VipsBlob] Buffer to save to
2114
2316
 
2115
2317
  # @!method heifsave_target(target, **opts)
@@ -2117,15 +2319,91 @@ module Vips
2117
2319
  # @param target [Vips::Target] Target to save to
2118
2320
  # @param opts [Hash] Set of options
2119
2321
  # @option opts [Integer] :Q Q factor
2322
+ # @option opts [Integer] :bitdepth Number of bits per pixel
2120
2323
  # @option opts [Boolean] :lossless Enable lossless compression
2121
2324
  # @option opts [Vips::ForeignHeifCompression] :compression Compression format
2122
2325
  # @option opts [Integer] :effort CPU effort
2123
2326
  # @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
2124
- # @option opts [Boolean] :strip Strip all metadata from image
2327
+ # @option opts [Vips::ForeignHeifEncoder] :encoder Select encoder to use
2328
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2125
2329
  # @option opts [Array<Double>] :background Background value
2126
2330
  # @option opts [Integer] :page_height Set page height for multipage save
2331
+ # @option opts [String] :profile Filename of ICC profile to embed
2127
2332
  # @return [nil]
2128
2333
 
2334
+ # @!method jxlsave(filename, **opts)
2335
+ # Save image in jpeg-xl format.
2336
+ # @param filename [String] Filename to save to
2337
+ # @param opts [Hash] Set of options
2338
+ # @option opts [Integer] :tier Decode speed tier
2339
+ # @option opts [Float] :distance Target butteraugli distance
2340
+ # @option opts [Integer] :effort Encoding effort
2341
+ # @option opts [Boolean] :lossless Enable lossless compression
2342
+ # @option opts [Integer] :Q Quality factor
2343
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2344
+ # @option opts [Array<Double>] :background Background value
2345
+ # @option opts [Integer] :page_height Set page height for multipage save
2346
+ # @option opts [String] :profile Filename of ICC profile to embed
2347
+ # @return [nil]
2348
+
2349
+ # @!method jxlsave_buffer(**opts)
2350
+ # Save image in jpeg-xl format.
2351
+ # @param opts [Hash] Set of options
2352
+ # @option opts [Integer] :tier Decode speed tier
2353
+ # @option opts [Float] :distance Target butteraugli distance
2354
+ # @option opts [Integer] :effort Encoding effort
2355
+ # @option opts [Boolean] :lossless Enable lossless compression
2356
+ # @option opts [Integer] :Q Quality factor
2357
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2358
+ # @option opts [Array<Double>] :background Background value
2359
+ # @option opts [Integer] :page_height Set page height for multipage save
2360
+ # @option opts [String] :profile Filename of ICC profile to embed
2361
+ # @return [VipsBlob] Buffer to save to
2362
+
2363
+ # @!method jxlsave_target(target, **opts)
2364
+ # Save image in jpeg-xl format.
2365
+ # @param target [Vips::Target] Target to save to
2366
+ # @param opts [Hash] Set of options
2367
+ # @option opts [Integer] :tier Decode speed tier
2368
+ # @option opts [Float] :distance Target butteraugli distance
2369
+ # @option opts [Integer] :effort Encoding effort
2370
+ # @option opts [Boolean] :lossless Enable lossless compression
2371
+ # @option opts [Integer] :Q Quality factor
2372
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2373
+ # @option opts [Array<Double>] :background Background value
2374
+ # @option opts [Integer] :page_height Set page height for multipage save
2375
+ # @option opts [String] :profile Filename of ICC profile to embed
2376
+ # @return [nil]
2377
+
2378
+ # @!method magicksave(filename, **opts)
2379
+ # Save file with imagemagick.
2380
+ # @param filename [String] Filename to save to
2381
+ # @param opts [Hash] Set of options
2382
+ # @option opts [String] :format Format to save in
2383
+ # @option opts [Integer] :quality Quality to use
2384
+ # @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
2385
+ # @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
2386
+ # @option opts [Integer] :bitdepth Number of bits per pixel
2387
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2388
+ # @option opts [Array<Double>] :background Background value
2389
+ # @option opts [Integer] :page_height Set page height for multipage save
2390
+ # @option opts [String] :profile Filename of ICC profile to embed
2391
+ # @return [nil]
2392
+
2393
+ # @!method magicksave_buffer(**opts)
2394
+ # Save image to magick buffer.
2395
+ # @param opts [Hash] Set of options
2396
+ # @option opts [String] :format Format to save in
2397
+ # @option opts [Integer] :quality Quality to use
2398
+ # @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
2399
+ # @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
2400
+ # @option opts [Integer] :bitdepth Number of bits per pixel
2401
+ # @option opts [Vips::ForeignKeep] :keep Which metadata to retain
2402
+ # @option opts [Array<Double>] :background Background value
2403
+ # @option opts [Integer] :page_height Set page height for multipage save
2404
+ # @option opts [String] :profile Filename of ICC profile to embed
2405
+ # @return [VipsBlob] Buffer to save to
2406
+
2129
2407
  # @!method self.thumbnail(filename, width, **opts)
2130
2408
  # Generate thumbnail from file.
2131
2409
  # @param filename [String] Filename to read from
@@ -2136,9 +2414,10 @@ module Vips
2136
2414
  # @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
2137
2415
  # @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
2138
2416
  # @option opts [Boolean] :linear Reduce in linear light
2139
- # @option opts [String] :import_profile Fallback import profile
2140
- # @option opts [String] :export_profile Fallback export profile
2417
+ # @option opts [String] :input_profile Fallback input profile
2418
+ # @option opts [String] :output_profile Fallback output profile
2141
2419
  # @option opts [Vips::Intent] :intent Rendering intent
2420
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
2142
2421
  # @return [Vips::Image] Output image
2143
2422
 
2144
2423
  # @!method self.thumbnail_buffer(buffer, width, **opts)
@@ -2152,9 +2431,10 @@ module Vips
2152
2431
  # @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
2153
2432
  # @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
2154
2433
  # @option opts [Boolean] :linear Reduce in linear light
2155
- # @option opts [String] :import_profile Fallback import profile
2156
- # @option opts [String] :export_profile Fallback export profile
2434
+ # @option opts [String] :input_profile Fallback input profile
2435
+ # @option opts [String] :output_profile Fallback output profile
2157
2436
  # @option opts [Vips::Intent] :intent Rendering intent
2437
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
2158
2438
  # @return [Vips::Image] Output image
2159
2439
 
2160
2440
  # @!method thumbnail_image(width, **opts)
@@ -2166,9 +2446,10 @@ module Vips
2166
2446
  # @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
2167
2447
  # @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
2168
2448
  # @option opts [Boolean] :linear Reduce in linear light
2169
- # @option opts [String] :import_profile Fallback import profile
2170
- # @option opts [String] :export_profile Fallback export profile
2449
+ # @option opts [String] :input_profile Fallback input profile
2450
+ # @option opts [String] :output_profile Fallback output profile
2171
2451
  # @option opts [Vips::Intent] :intent Rendering intent
2452
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
2172
2453
  # @return [Vips::Image] Output image
2173
2454
 
2174
2455
  # @!method self.thumbnail_source(source, width, **opts)
@@ -2182,9 +2463,10 @@ module Vips
2182
2463
  # @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
2183
2464
  # @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
2184
2465
  # @option opts [Boolean] :linear Reduce in linear light
2185
- # @option opts [String] :import_profile Fallback import profile
2186
- # @option opts [String] :export_profile Fallback export profile
2466
+ # @option opts [String] :input_profile Fallback input profile
2467
+ # @option opts [String] :output_profile Fallback output profile
2187
2468
  # @option opts [Vips::Intent] :intent Rendering intent
2469
+ # @option opts [Vips::FailOn] :fail_on Error level to fail on
2188
2470
  # @return [Vips::Image] Output image
2189
2471
 
2190
2472
  # @!method mapim(index, **opts)
@@ -2192,6 +2474,9 @@ module Vips
2192
2474
  # @param index [Vips::Image] Index pixels with this
2193
2475
  # @param opts [Hash] Set of options
2194
2476
  # @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
2477
+ # @option opts [Array<Double>] :background Background value
2478
+ # @option opts [Boolean] :premultiplied Images have premultiplied alpha
2479
+ # @option opts [Vips::Extend] :extend How to generate the extra pixels
2195
2480
  # @return [Vips::Image] Output image
2196
2481
 
2197
2482
  # @!method shrink(hshrink, vshrink, **opts)
@@ -2199,18 +2484,21 @@ module Vips
2199
2484
  # @param hshrink [Float] Horizontal shrink factor
2200
2485
  # @param vshrink [Float] Vertical shrink factor
2201
2486
  # @param opts [Hash] Set of options
2487
+ # @option opts [Boolean] :ceil Round-up output dimensions
2202
2488
  # @return [Vips::Image] Output image
2203
2489
 
2204
2490
  # @!method shrinkh(hshrink, **opts)
2205
2491
  # Shrink an image horizontally.
2206
2492
  # @param hshrink [Integer] Horizontal shrink factor
2207
2493
  # @param opts [Hash] Set of options
2494
+ # @option opts [Boolean] :ceil Round-up output dimensions
2208
2495
  # @return [Vips::Image] Output image
2209
2496
 
2210
2497
  # @!method shrinkv(vshrink, **opts)
2211
2498
  # Shrink an image vertically.
2212
2499
  # @param vshrink [Integer] Vertical shrink factor
2213
2500
  # @param opts [Hash] Set of options
2501
+ # @option opts [Boolean] :ceil Round-up output dimensions
2214
2502
  # @return [Vips::Image] Output image
2215
2503
 
2216
2504
  # @!method reduceh(hshrink, **opts)
@@ -2218,6 +2506,7 @@ module Vips
2218
2506
  # @param hshrink [Float] Horizontal shrink factor
2219
2507
  # @param opts [Hash] Set of options
2220
2508
  # @option opts [Vips::Kernel] :kernel Resampling kernel
2509
+ # @option opts [Float] :gap Reducing gap
2221
2510
  # @return [Vips::Image] Output image
2222
2511
 
2223
2512
  # @!method reducev(vshrink, **opts)
@@ -2225,6 +2514,7 @@ module Vips
2225
2514
  # @param vshrink [Float] Vertical shrink factor
2226
2515
  # @param opts [Hash] Set of options
2227
2516
  # @option opts [Vips::Kernel] :kernel Resampling kernel
2517
+ # @option opts [Float] :gap Reducing gap
2228
2518
  # @return [Vips::Image] Output image
2229
2519
 
2230
2520
  # @!method reduce(hshrink, vshrink, **opts)
@@ -2233,6 +2523,7 @@ module Vips
2233
2523
  # @param vshrink [Float] Vertical shrink factor
2234
2524
  # @param opts [Hash] Set of options
2235
2525
  # @option opts [Vips::Kernel] :kernel Resampling kernel
2526
+ # @option opts [Float] :gap Reducing gap
2236
2527
  # @return [Vips::Image] Output image
2237
2528
 
2238
2529
  # @!method quadratic(coeff, **opts)
@@ -2261,7 +2552,7 @@ module Vips
2261
2552
  # Similarity transform of an image.
2262
2553
  # @param opts [Hash] Set of options
2263
2554
  # @option opts [Float] :scale Scale by this factor
2264
- # @option opts [Float] :angle Rotate anticlockwise by this many degrees
2555
+ # @option opts [Float] :angle Rotate clockwise by this many degrees
2265
2556
  # @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
2266
2557
  # @option opts [Array<Double>] :background Background value
2267
2558
  # @option opts [Float] :odx Horizontal output displacement
@@ -2272,7 +2563,7 @@ module Vips
2272
2563
 
2273
2564
  # @!method rotate(angle, **opts)
2274
2565
  # Rotate an image by a number of degrees.
2275
- # @param angle [Float] Rotate anticlockwise by this many degrees
2566
+ # @param angle [Float] Rotate clockwise by this many degrees
2276
2567
  # @param opts [Hash] Set of options
2277
2568
  # @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
2278
2569
  # @option opts [Array<Double>] :background Background value
@@ -2287,6 +2578,7 @@ module Vips
2287
2578
  # @param scale [Float] Scale image by this factor
2288
2579
  # @param opts [Hash] Set of options
2289
2580
  # @option opts [Vips::Kernel] :kernel Resampling kernel
2581
+ # @option opts [Float] :gap Reducing gap
2290
2582
  # @option opts [Float] :vscale Vertical scale image by this factor
2291
2583
  # @return [Vips::Image] Output image
2292
2584
 
@@ -2394,6 +2686,17 @@ module Vips
2394
2686
  # @param opts [Hash] Set of options
2395
2687
  # @return [Vips::Image] Output image
2396
2688
 
2689
+ # @!method sRGB2scRGB(**opts)
2690
+ # Convert an srgb image to scrgb.
2691
+ # @param opts [Hash] Set of options
2692
+ # @return [Vips::Image] Output image
2693
+
2694
+ # @!method scRGB2BW(**opts)
2695
+ # Convert scrgb to bw.
2696
+ # @param opts [Hash] Set of options
2697
+ # @option opts [Integer] :depth Output device space depth in bits
2698
+ # @return [Vips::Image] Output image
2699
+
2397
2700
  # @!method sRGB2HSV(**opts)
2398
2701
  # Transform srgb to hsv.
2399
2702
  # @param opts [Hash] Set of options
@@ -2404,6 +2707,12 @@ module Vips
2404
2707
  # @param opts [Hash] Set of options
2405
2708
  # @return [Vips::Image] Output image
2406
2709
 
2710
+ # @!method scRGB2sRGB(**opts)
2711
+ # Convert scrgb to srgb.
2712
+ # @param opts [Hash] Set of options
2713
+ # @option opts [Integer] :depth Output device space depth in bits
2714
+ # @return [Vips::Image] Output image
2715
+
2407
2716
  # @!method icc_import(**opts)
2408
2717
  # Import from device with icc profile.
2409
2718
  # @param opts [Hash] Set of options
@@ -2454,23 +2763,6 @@ module Vips
2454
2763
  # @param opts [Hash] Set of options
2455
2764
  # @return [Vips::Image] Output image
2456
2765
 
2457
- # @!method sRGB2scRGB(**opts)
2458
- # Convert an srgb image to scrgb.
2459
- # @param opts [Hash] Set of options
2460
- # @return [Vips::Image] Output image
2461
-
2462
- # @!method scRGB2BW(**opts)
2463
- # Convert scrgb to bw.
2464
- # @param opts [Hash] Set of options
2465
- # @option opts [Integer] :depth Output device space depth in bits
2466
- # @return [Vips::Image] Output image
2467
-
2468
- # @!method scRGB2sRGB(**opts)
2469
- # Convert an scrgb image to srgb.
2470
- # @param opts [Hash] Set of options
2471
- # @option opts [Integer] :depth Output device space depth in bits
2472
- # @return [Vips::Image] Output image
2473
-
2474
2766
  # @!method CMYK2XYZ(**opts)
2475
2767
  # Transform cmyk to xyz.
2476
2768
  # @param opts [Hash] Set of options
@@ -2491,7 +2783,7 @@ module Vips
2491
2783
  # Map an image though a lut.
2492
2784
  # @param lut [Vips::Image] Look-up table image
2493
2785
  # @param opts [Hash] Set of options
2494
- # @option opts [Integer] :band apply one-band lut to this band of in
2786
+ # @option opts [Integer] :band Apply one-band lut to this band of in
2495
2787
  # @return [Vips::Image] Output image
2496
2788
 
2497
2789
  # @!method case(cases, **opts)
@@ -2604,7 +2896,7 @@ module Vips
2604
2896
  # @return [Vips::Image] Output image
2605
2897
 
2606
2898
  # @!method convsep(mask, **opts)
2607
- # Seperable convolution operation.
2899
+ # Separable convolution operation.
2608
2900
  # @param mask [Vips::Image] Input matrix image
2609
2901
  # @param opts [Hash] Set of options
2610
2902
  # @option opts [Vips::Precision] :precision Convolve with this precision
@@ -2650,6 +2942,21 @@ module Vips
2650
2942
  # @option opts [Vips::Precision] :precision Convolve with this precision
2651
2943
  # @return [Vips::Image] Output image
2652
2944
 
2945
+ # @!method sobel(**opts)
2946
+ # Sobel edge detector.
2947
+ # @param opts [Hash] Set of options
2948
+ # @return [Vips::Image] Output image
2949
+
2950
+ # @!method scharr(**opts)
2951
+ # Scharr edge detector.
2952
+ # @param opts [Hash] Set of options
2953
+ # @return [Vips::Image] Output image
2954
+
2955
+ # @!method prewitt(**opts)
2956
+ # Prewitt edge detector.
2957
+ # @param opts [Hash] Set of options
2958
+ # @return [Vips::Image] Output image
2959
+
2653
2960
  # @!method canny(**opts)
2654
2961
  # Canny edge detector.
2655
2962
  # @param opts [Hash] Set of options
@@ -2657,11 +2964,6 @@ module Vips
2657
2964
  # @option opts [Vips::Precision] :precision Convolve with this precision
2658
2965
  # @return [Vips::Image] Output image
2659
2966
 
2660
- # @!method sobel(**opts)
2661
- # Sobel edge detector.
2662
- # @param opts [Hash] Set of options
2663
- # @return [Vips::Image] Output image
2664
-
2665
2967
  # @!method fwfft(**opts)
2666
2968
  # Forward fft.
2667
2969
  # @param opts [Hash] Set of options
@@ -2714,7 +3016,7 @@ module Vips
2714
3016
  # @!method labelregions(**opts)
2715
3017
  # Label regions in an image.
2716
3018
  # @param opts [Hash] Set of options
2717
- # @option opts [Integer] :segments Output Number of discrete contigious regions
3019
+ # @option opts [Integer] :segments Output Number of discrete contiguous regions
2718
3020
  # @return [Vips::Image, Hash<Symbol => Object>] Mask of region labels, Hash of optional output items
2719
3021
 
2720
3022
  # @!method fill_nearest(**opts)
@@ -2772,9 +3074,9 @@ module Vips
2772
3074
  # @option opts [Vips::Image] :test Test pixels in this image
2773
3075
  # @option opts [Boolean] :equal DrawFlood while equal to edge
2774
3076
  # @option opts [Integer] :left Output Left edge of modified area
2775
- # @option opts [Integer] :top Output top edge of modified area
2776
- # @option opts [Integer] :width Output width of modified area
2777
- # @option opts [Integer] :height Output height of modified area
3077
+ # @option opts [Integer] :top Output Top edge of modified area
3078
+ # @option opts [Integer] :width Output Width of modified area
3079
+ # @option opts [Integer] :height Output Height of modified area
2778
3080
  # @return [Vips::Image, Hash<Symbol => Object>] Image to draw on, Hash of optional output items
2779
3081
 
2780
3082
  # @!method draw_image(sub, x, y, **opts)
@@ -2844,11 +3146,16 @@ module Vips
2844
3146
  # @option opts [Boolean] :search Search to improve tie-points
2845
3147
  # @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
2846
3148
  # @option opts [Integer] :mblend Maximum blend size
2847
- # @option opts [Integer] :bandno Band to search for features on
2848
3149
  # @return [Vips::Image] Output image
2849
3150
 
2850
3151
  # @!method matrixinvert(**opts)
2851
- # Invert an matrix.
3152
+ # Invert a matrix.
3153
+ # @param opts [Hash] Set of options
3154
+ # @return [Vips::Image] Output matrix
3155
+
3156
+ # @!method matrixmultiply(right, **opts)
3157
+ # Multiply two matrices.
3158
+ # @param right [Vips::Image] Second matrix to multiply
2852
3159
  # @param opts [Hash] Set of options
2853
3160
  # @return [Vips::Image] Output matrix
2854
3161
 
@@ -2875,6 +3182,13 @@ module Vips
2875
3182
  # @param opts [Hash] Set of options
2876
3183
  # @option opts [Float] :gamma Image gamma
2877
3184
  # @option opts [Boolean] :int_output Integer output
3185
+ # @return [Vips::Image] Output image
3186
+
3187
+ # @!method remosaic(old_str, new_str, **opts)
3188
+ # Rebuild an mosaiced image.
3189
+ # @param old_str [String] Search for this string
3190
+ # @param new_str [String] And swap for this string
3191
+ # @param opts [Hash] Set of options
2878
3192
  # @return [Vips::Image] Output image
2879
3193
 
2880
3194
  end