ruby-vips 2.0.16 → 2.0.17

Sign up to get free protection for your applications and to get access to all the features.
@@ -265,6 +265,7 @@ module Vips
265
265
  # @!method copy(**opts)
266
266
  # Copy an image.
267
267
  # @param opts [Hash] Set of options
268
+ # @option opts [Boolean] :swap Swap bytes in image between little and big-endian
268
269
  # @option opts [Integer] :width Image width in pixels
269
270
  # @option opts [Integer] :height Image height in pixels
270
271
  # @option opts [Integer] :bands Number of bands in image
@@ -300,7 +301,9 @@ module Vips
300
301
  # @!method sequential(**opts)
301
302
  # Check sequential access.
302
303
  # @param opts [Hash] Set of options
304
+ # @option opts [Boolean] :trace trace pixel requests
303
305
  # @option opts [Integer] :tile_height Tile height in pixels
306
+ # @option opts [Vips::Access] :access Expected access pattern
304
307
  # @return [Vips::Image] Output image
305
308
 
306
309
  # @!method cache(**opts)
@@ -381,7 +384,7 @@ module Vips
381
384
  # @param opts [Hash] Set of options
382
385
  # @return [Vips::Image] Output image
383
386
 
384
- # @!method extract_area(left, top, width, height, **opts)
387
+ # @!method crop(left, top, width, height, **opts)
385
388
  # Extract an area from an image.
386
389
  # @param left [Integer] Left edge of extract area
387
390
  # @param top [Integer] Top edge of extract area
@@ -496,6 +499,7 @@ module Vips
496
499
  # Unpremultiply image alpha.
497
500
  # @param opts [Hash] Set of options
498
501
  # @option opts [Float] :max_alpha Maximum value of alpha channel
502
+ # @option opts [Integer] :alpha_band Unpremultiply with this alpha
499
503
  # @return [Vips::Image] Output image
500
504
 
501
505
  # @!method grid(tile_height, across, down, **opts)
@@ -615,6 +619,7 @@ module Vips
615
619
  # @param min_ampl [Float] Minimum amplitude of Gaussian
616
620
  # @param opts [Hash] Set of options
617
621
  # @option opts [Boolean] :separable Generate separable Gaussian
622
+ # @option opts [Boolean] :integer Generate integer Gaussian
618
623
  # @option opts [Vips::Precision] :precision Generate with this precision
619
624
  # @return [Vips::Image] Output image
620
625
 
@@ -624,6 +629,7 @@ module Vips
624
629
  # @param min_ampl [Float] Minimum amplitude of Logmatian
625
630
  # @param opts [Hash] Set of options
626
631
  # @option opts [Boolean] :separable Generate separable Logmatian
632
+ # @option opts [Boolean] :integer Generate integer Logmatian
627
633
  # @option opts [Vips::Precision] :precision Generate with this precision
628
634
  # @return [Vips::Image] Output image
629
635
 
@@ -859,6 +865,12 @@ module Vips
859
865
  # @option opts [Boolean] :uchar Output an unsigned char image
860
866
  # @return [Vips::Image] Output image
861
867
 
868
+ # @!method self.switch(tests, **opts)
869
+ # Find the index of the first non-zero pixel in tests.
870
+ # @param tests [Array<Image>] Table of images to test
871
+ # @param opts [Hash] Set of options
872
+ # @return [Vips::Image] Output image
873
+
862
874
  # @!method self.csvload(filename, **opts)
863
875
  # Load csv from file.
864
876
  # @param filename [String] Filename to load from
@@ -869,7 +881,9 @@ module Vips
869
881
  # @option opts [String] :separator Set of separator characters
870
882
  # @option opts [Boolean] :memory Force open via memory
871
883
  # @option opts [Vips::Access] :access Required access pattern for this file
884
+ # @option opts [Boolean] :sequential Sequential read only
872
885
  # @option opts [Boolean] :fail Fail on first error
886
+ # @option opts [Boolean] :disc Open to disc
873
887
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
874
888
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
875
889
 
@@ -879,7 +893,9 @@ module Vips
879
893
  # @param opts [Hash] Set of options
880
894
  # @option opts [Boolean] :memory Force open via memory
881
895
  # @option opts [Vips::Access] :access Required access pattern for this file
896
+ # @option opts [Boolean] :sequential Sequential read only
882
897
  # @option opts [Boolean] :fail Fail on first error
898
+ # @option opts [Boolean] :disc Open to disc
883
899
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
884
900
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
885
901
 
@@ -891,9 +907,13 @@ module Vips
891
907
  # @param bands [Integer] Number of bands in image
892
908
  # @param opts [Hash] Set of options
893
909
  # @option opts [guint64] :offset Offset in bytes from start of file
910
+ # @option opts [Vips::BandFormat] :format Pixel format in image
911
+ # @option opts [Vips::Interpretation] :interpretation Pixel interpretation
894
912
  # @option opts [Boolean] :memory Force open via memory
895
913
  # @option opts [Vips::Access] :access Required access pattern for this file
914
+ # @option opts [Boolean] :sequential Sequential read only
896
915
  # @option opts [Boolean] :fail Fail on first error
916
+ # @option opts [Boolean] :disc Open to disc
897
917
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
898
918
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
899
919
 
@@ -903,7 +923,9 @@ module Vips
903
923
  # @param opts [Hash] Set of options
904
924
  # @option opts [Boolean] :memory Force open via memory
905
925
  # @option opts [Vips::Access] :access Required access pattern for this file
926
+ # @option opts [Boolean] :sequential Sequential read only
906
927
  # @option opts [Boolean] :fail Fail on first error
928
+ # @option opts [Boolean] :disc Open to disc
907
929
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
908
930
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
909
931
 
@@ -913,7 +935,9 @@ module Vips
913
935
  # @param opts [Hash] Set of options
914
936
  # @option opts [Boolean] :memory Force open via memory
915
937
  # @option opts [Vips::Access] :access Required access pattern for this file
938
+ # @option opts [Boolean] :sequential Sequential read only
916
939
  # @option opts [Boolean] :fail Fail on first error
940
+ # @option opts [Boolean] :disc Open to disc
917
941
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
918
942
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
919
943
 
@@ -923,7 +947,9 @@ module Vips
923
947
  # @param opts [Hash] Set of options
924
948
  # @option opts [Boolean] :memory Force open via memory
925
949
  # @option opts [Vips::Access] :access Required access pattern for this file
950
+ # @option opts [Boolean] :sequential Sequential read only
926
951
  # @option opts [Boolean] :fail Fail on first error
952
+ # @option opts [Boolean] :disc Open to disc
927
953
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
928
954
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
929
955
 
@@ -933,7 +959,33 @@ module Vips
933
959
  # @param opts [Hash] Set of options
934
960
  # @option opts [Boolean] :memory Force open via memory
935
961
  # @option opts [Vips::Access] :access Required access pattern for this file
962
+ # @option opts [Boolean] :sequential Sequential read only
963
+ # @option opts [Boolean] :fail Fail on first error
964
+ # @option opts [Boolean] :disc Open to disc
965
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
966
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
967
+
968
+ # @!method self.radload_buffer(buffer, **opts)
969
+ # Load rad from buffer.
970
+ # @param buffer [VipsBlob] Buffer to load from
971
+ # @param opts [Hash] Set of options
972
+ # @option opts [Boolean] :memory Force open via memory
973
+ # @option opts [Vips::Access] :access Required access pattern for this file
974
+ # @option opts [Boolean] :sequential Sequential read only
936
975
  # @option opts [Boolean] :fail Fail on first error
976
+ # @option opts [Boolean] :disc Open to disc
977
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
978
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
979
+
980
+ # @!method self.radload_source(source, **opts)
981
+ # Load rad from source.
982
+ # @param source [Vips::Source] Source to load from
983
+ # @param opts [Hash] Set of options
984
+ # @option opts [Boolean] :memory Force open via memory
985
+ # @option opts [Vips::Access] :access Required access pattern for this file
986
+ # @option opts [Boolean] :sequential Sequential read only
987
+ # @option opts [Boolean] :fail Fail on first error
988
+ # @option opts [Boolean] :disc Open to disc
937
989
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
938
990
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
939
991
 
@@ -948,7 +1000,9 @@ module Vips
948
1000
  # @option opts [Array<Double>] :background Background value
949
1001
  # @option opts [Boolean] :memory Force open via memory
950
1002
  # @option opts [Vips::Access] :access Required access pattern for this file
1003
+ # @option opts [Boolean] :sequential Sequential read only
951
1004
  # @option opts [Boolean] :fail Fail on first error
1005
+ # @option opts [Boolean] :disc Open to disc
952
1006
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
953
1007
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
954
1008
 
@@ -963,7 +1017,9 @@ module Vips
963
1017
  # @option opts [Array<Double>] :background Background value
964
1018
  # @option opts [Boolean] :memory Force open via memory
965
1019
  # @option opts [Vips::Access] :access Required access pattern for this file
1020
+ # @option opts [Boolean] :sequential Sequential read only
966
1021
  # @option opts [Boolean] :fail Fail on first error
1022
+ # @option opts [Boolean] :disc Open to disc
967
1023
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
968
1024
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
969
1025
 
@@ -973,9 +1029,12 @@ module Vips
973
1029
  # @param opts [Hash] Set of options
974
1030
  # @option opts [Float] :dpi Render at this DPI
975
1031
  # @option opts [Float] :scale Scale output by this factor
1032
+ # @option opts [Boolean] :unlimited Allow SVG of any size
976
1033
  # @option opts [Boolean] :memory Force open via memory
977
1034
  # @option opts [Vips::Access] :access Required access pattern for this file
1035
+ # @option opts [Boolean] :sequential Sequential read only
978
1036
  # @option opts [Boolean] :fail Fail on first error
1037
+ # @option opts [Boolean] :disc Open to disc
979
1038
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
980
1039
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
981
1040
 
@@ -985,9 +1044,12 @@ module Vips
985
1044
  # @param opts [Hash] Set of options
986
1045
  # @option opts [Float] :dpi Render at this DPI
987
1046
  # @option opts [Float] :scale Scale output by this factor
1047
+ # @option opts [Boolean] :unlimited Allow SVG of any size
988
1048
  # @option opts [Boolean] :memory Force open via memory
989
1049
  # @option opts [Vips::Access] :access Required access pattern for this file
1050
+ # @option opts [Boolean] :sequential Sequential read only
990
1051
  # @option opts [Boolean] :fail Fail on first error
1052
+ # @option opts [Boolean] :disc Open to disc
991
1053
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
992
1054
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
993
1055
 
@@ -997,9 +1059,27 @@ module Vips
997
1059
  # @param opts [Hash] Set of options
998
1060
  # @option opts [Float] :dpi Render at this DPI
999
1061
  # @option opts [Float] :scale Scale output by this factor
1062
+ # @option opts [Boolean] :unlimited Allow SVG of any size
1063
+ # @option opts [Boolean] :memory Force open via memory
1064
+ # @option opts [Vips::Access] :access Required access pattern for this file
1065
+ # @option opts [Boolean] :sequential Sequential read only
1066
+ # @option opts [Boolean] :fail Fail on first error
1067
+ # @option opts [Boolean] :disc Open to disc
1068
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1069
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1070
+
1071
+ # @!method self.svgload_source(source, **opts)
1072
+ # Load svg from source.
1073
+ # @param source [Vips::Source] Source to load from
1074
+ # @param opts [Hash] Set of options
1075
+ # @option opts [Float] :dpi Render at this DPI
1076
+ # @option opts [Float] :scale Scale output by this factor
1077
+ # @option opts [Boolean] :unlimited Allow SVG of any size
1000
1078
  # @option opts [Boolean] :memory Force open via memory
1001
1079
  # @option opts [Vips::Access] :access Required access pattern for this file
1080
+ # @option opts [Boolean] :sequential Sequential read only
1002
1081
  # @option opts [Boolean] :fail Fail on first error
1082
+ # @option opts [Boolean] :disc Open to disc
1003
1083
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1004
1084
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1005
1085
 
@@ -1011,7 +1091,9 @@ module Vips
1011
1091
  # @option opts [Integer] :n Load this many pages
1012
1092
  # @option opts [Boolean] :memory Force open via memory
1013
1093
  # @option opts [Vips::Access] :access Required access pattern for this file
1094
+ # @option opts [Boolean] :sequential Sequential read only
1014
1095
  # @option opts [Boolean] :fail Fail on first error
1096
+ # @option opts [Boolean] :disc Open to disc
1015
1097
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1016
1098
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1017
1099
 
@@ -1023,7 +1105,9 @@ module Vips
1023
1105
  # @option opts [Integer] :n Load this many pages
1024
1106
  # @option opts [Boolean] :memory Force open via memory
1025
1107
  # @option opts [Vips::Access] :access Required access pattern for this file
1108
+ # @option opts [Boolean] :sequential Sequential read only
1026
1109
  # @option opts [Boolean] :fail Fail on first error
1110
+ # @option opts [Boolean] :disc Open to disc
1027
1111
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1028
1112
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1029
1113
 
@@ -1033,7 +1117,9 @@ module Vips
1033
1117
  # @param opts [Hash] Set of options
1034
1118
  # @option opts [Boolean] :memory Force open via memory
1035
1119
  # @option opts [Vips::Access] :access Required access pattern for this file
1120
+ # @option opts [Boolean] :sequential Sequential read only
1036
1121
  # @option opts [Boolean] :fail Fail on first error
1122
+ # @option opts [Boolean] :disc Open to disc
1037
1123
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1038
1124
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1039
1125
 
@@ -1043,7 +1129,21 @@ module Vips
1043
1129
  # @param opts [Hash] Set of options
1044
1130
  # @option opts [Boolean] :memory Force open via memory
1045
1131
  # @option opts [Vips::Access] :access Required access pattern for this file
1132
+ # @option opts [Boolean] :sequential Sequential read only
1046
1133
  # @option opts [Boolean] :fail Fail on first error
1134
+ # @option opts [Boolean] :disc Open to disc
1135
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1136
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1137
+
1138
+ # @!method self.pngload_source(source, **opts)
1139
+ # Load png from source.
1140
+ # @param source [Vips::Source] Source to load from
1141
+ # @param opts [Hash] Set of options
1142
+ # @option opts [Boolean] :memory Force open via memory
1143
+ # @option opts [Vips::Access] :access Required access pattern for this file
1144
+ # @option opts [Boolean] :sequential Sequential read only
1145
+ # @option opts [Boolean] :fail Fail on first error
1146
+ # @option opts [Boolean] :disc Open to disc
1047
1147
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1048
1148
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1049
1149
 
@@ -1053,7 +1153,9 @@ module Vips
1053
1153
  # @param opts [Hash] Set of options
1054
1154
  # @option opts [Boolean] :memory Force open via memory
1055
1155
  # @option opts [Vips::Access] :access Required access pattern for this file
1156
+ # @option opts [Boolean] :sequential Sequential read only
1056
1157
  # @option opts [Boolean] :fail Fail on first error
1158
+ # @option opts [Boolean] :disc Open to disc
1057
1159
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1058
1160
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1059
1161
 
@@ -1065,7 +1167,9 @@ module Vips
1065
1167
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1066
1168
  # @option opts [Boolean] :memory Force open via memory
1067
1169
  # @option opts [Vips::Access] :access Required access pattern for this file
1170
+ # @option opts [Boolean] :sequential Sequential read only
1068
1171
  # @option opts [Boolean] :fail Fail on first error
1172
+ # @option opts [Boolean] :disc Open to disc
1069
1173
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1070
1174
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1071
1175
 
@@ -1077,7 +1181,23 @@ module Vips
1077
1181
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1078
1182
  # @option opts [Boolean] :memory Force open via memory
1079
1183
  # @option opts [Vips::Access] :access Required access pattern for this file
1184
+ # @option opts [Boolean] :sequential Sequential read only
1185
+ # @option opts [Boolean] :fail Fail on first error
1186
+ # @option opts [Boolean] :disc Open to disc
1187
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1188
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1189
+
1190
+ # @!method self.jpegload_source(source, **opts)
1191
+ # Load image from jpeg source.
1192
+ # @param source [Vips::Source] Source to load from
1193
+ # @param opts [Hash] Set of options
1194
+ # @option opts [Integer] :shrink Shrink factor on load
1195
+ # @option opts [Boolean] :autorotate Rotate image using exif orientation
1196
+ # @option opts [Boolean] :memory Force open via memory
1197
+ # @option opts [Vips::Access] :access Required access pattern for this file
1198
+ # @option opts [Boolean] :sequential Sequential read only
1080
1199
  # @option opts [Boolean] :fail Fail on first error
1200
+ # @option opts [Boolean] :disc Open to disc
1081
1201
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1082
1202
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1083
1203
 
@@ -1088,9 +1208,12 @@ module Vips
1088
1208
  # @option opts [Integer] :page Load this page from the file
1089
1209
  # @option opts [Integer] :n Load this many pages
1090
1210
  # @option opts [Float] :scale Scale factor on load
1211
+ # @option opts [Integer] :shrink Shrink factor on load
1091
1212
  # @option opts [Boolean] :memory Force open via memory
1092
1213
  # @option opts [Vips::Access] :access Required access pattern for this file
1214
+ # @option opts [Boolean] :sequential Sequential read only
1093
1215
  # @option opts [Boolean] :fail Fail on first error
1216
+ # @option opts [Boolean] :disc Open to disc
1094
1217
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1095
1218
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1096
1219
 
@@ -1101,9 +1224,28 @@ module Vips
1101
1224
  # @option opts [Integer] :page Load this page from the file
1102
1225
  # @option opts [Integer] :n Load this many pages
1103
1226
  # @option opts [Float] :scale Scale factor on load
1227
+ # @option opts [Integer] :shrink Shrink factor on load
1104
1228
  # @option opts [Boolean] :memory Force open via memory
1105
1229
  # @option opts [Vips::Access] :access Required access pattern for this file
1230
+ # @option opts [Boolean] :sequential Sequential read only
1106
1231
  # @option opts [Boolean] :fail Fail on first error
1232
+ # @option opts [Boolean] :disc Open to disc
1233
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1234
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1235
+
1236
+ # @!method self.webpload_source(source, **opts)
1237
+ # Load webp from source.
1238
+ # @param source [Vips::Source] Source to load from
1239
+ # @param opts [Hash] Set of options
1240
+ # @option opts [Integer] :page Load this page from the file
1241
+ # @option opts [Integer] :n Load this many pages
1242
+ # @option opts [Float] :scale Scale factor on load
1243
+ # @option opts [Integer] :shrink Shrink factor on load
1244
+ # @option opts [Boolean] :memory Force open via memory
1245
+ # @option opts [Vips::Access] :access Required access pattern for this file
1246
+ # @option opts [Boolean] :sequential Sequential read only
1247
+ # @option opts [Boolean] :fail Fail on first error
1248
+ # @option opts [Boolean] :disc Open to disc
1107
1249
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1108
1250
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1109
1251
 
@@ -1116,7 +1258,9 @@ module Vips
1116
1258
  # @option opts [Boolean] :autorotate Rotate image using orientation tag
1117
1259
  # @option opts [Boolean] :memory Force open via memory
1118
1260
  # @option opts [Vips::Access] :access Required access pattern for this file
1261
+ # @option opts [Boolean] :sequential Sequential read only
1119
1262
  # @option opts [Boolean] :fail Fail on first error
1263
+ # @option opts [Boolean] :disc Open to disc
1120
1264
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1121
1265
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1122
1266
 
@@ -1129,7 +1273,24 @@ module Vips
1129
1273
  # @option opts [Boolean] :autorotate Rotate image using orientation tag
1130
1274
  # @option opts [Boolean] :memory Force open via memory
1131
1275
  # @option opts [Vips::Access] :access Required access pattern for this file
1276
+ # @option opts [Boolean] :sequential Sequential read only
1277
+ # @option opts [Boolean] :fail Fail on first error
1278
+ # @option opts [Boolean] :disc Open to disc
1279
+ # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1280
+ # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1281
+
1282
+ # @!method self.tiffload_source(source, **opts)
1283
+ # Load tiff from source.
1284
+ # @param source [Vips::Source] Source to load from
1285
+ # @param opts [Hash] Set of options
1286
+ # @option opts [Integer] :page Load this page from the image
1287
+ # @option opts [Integer] :n Load this many pages
1288
+ # @option opts [Boolean] :autorotate Rotate image using orientation tag
1289
+ # @option opts [Boolean] :memory Force open via memory
1290
+ # @option opts [Vips::Access] :access Required access pattern for this file
1291
+ # @option opts [Boolean] :sequential Sequential read only
1132
1292
  # @option opts [Boolean] :fail Fail on first error
1293
+ # @option opts [Boolean] :disc Open to disc
1133
1294
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1134
1295
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1135
1296
 
@@ -1143,7 +1304,9 @@ module Vips
1143
1304
  # @option opts [String] :associated Load this associated image
1144
1305
  # @option opts [Boolean] :memory Force open via memory
1145
1306
  # @option opts [Vips::Access] :access Required access pattern for this file
1307
+ # @option opts [Boolean] :sequential Sequential read only
1146
1308
  # @option opts [Boolean] :fail Fail on first error
1309
+ # @option opts [Boolean] :disc Open to disc
1147
1310
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1148
1311
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1149
1312
 
@@ -1151,12 +1314,15 @@ module Vips
1151
1314
  # Load file with imagemagick.
1152
1315
  # @param filename [String] Filename to load from
1153
1316
  # @param opts [Hash] Set of options
1317
+ # @option opts [Boolean] :all_frames Read all frames from an image
1154
1318
  # @option opts [String] :density Canvas resolution for rendering vector formats like SVG
1155
1319
  # @option opts [Integer] :page Load this page from the file
1156
1320
  # @option opts [Integer] :n Load this many pages
1157
1321
  # @option opts [Boolean] :memory Force open via memory
1158
1322
  # @option opts [Vips::Access] :access Required access pattern for this file
1323
+ # @option opts [Boolean] :sequential Sequential read only
1159
1324
  # @option opts [Boolean] :fail Fail on first error
1325
+ # @option opts [Boolean] :disc Open to disc
1160
1326
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1161
1327
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1162
1328
 
@@ -1164,12 +1330,15 @@ module Vips
1164
1330
  # Load buffer with imagemagick.
1165
1331
  # @param buffer [VipsBlob] Buffer to load from
1166
1332
  # @param opts [Hash] Set of options
1333
+ # @option opts [Boolean] :all_frames Read all frames from an image
1167
1334
  # @option opts [String] :density Canvas resolution for rendering vector formats like SVG
1168
1335
  # @option opts [Integer] :page Load this page from the file
1169
1336
  # @option opts [Integer] :n Load this many pages
1170
1337
  # @option opts [Boolean] :memory Force open via memory
1171
1338
  # @option opts [Vips::Access] :access Required access pattern for this file
1339
+ # @option opts [Boolean] :sequential Sequential read only
1172
1340
  # @option opts [Boolean] :fail Fail on first error
1341
+ # @option opts [Boolean] :disc Open to disc
1173
1342
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1174
1343
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1175
1344
 
@@ -1179,7 +1348,9 @@ module Vips
1179
1348
  # @param opts [Hash] Set of options
1180
1349
  # @option opts [Boolean] :memory Force open via memory
1181
1350
  # @option opts [Vips::Access] :access Required access pattern for this file
1351
+ # @option opts [Boolean] :sequential Sequential read only
1182
1352
  # @option opts [Boolean] :fail Fail on first error
1353
+ # @option opts [Boolean] :disc Open to disc
1183
1354
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1184
1355
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1185
1356
 
@@ -1189,7 +1360,9 @@ module Vips
1189
1360
  # @param opts [Hash] Set of options
1190
1361
  # @option opts [Boolean] :memory Force open via memory
1191
1362
  # @option opts [Vips::Access] :access Required access pattern for this file
1363
+ # @option opts [Boolean] :sequential Sequential read only
1192
1364
  # @option opts [Boolean] :fail Fail on first error
1365
+ # @option opts [Boolean] :disc Open to disc
1193
1366
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1194
1367
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1195
1368
 
@@ -1199,7 +1372,9 @@ module Vips
1199
1372
  # @param opts [Hash] Set of options
1200
1373
  # @option opts [Boolean] :memory Force open via memory
1201
1374
  # @option opts [Vips::Access] :access Required access pattern for this file
1375
+ # @option opts [Boolean] :sequential Sequential read only
1202
1376
  # @option opts [Boolean] :fail Fail on first error
1377
+ # @option opts [Boolean] :disc Open to disc
1203
1378
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1204
1379
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1205
1380
 
@@ -1213,7 +1388,9 @@ module Vips
1213
1388
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1214
1389
  # @option opts [Boolean] :memory Force open via memory
1215
1390
  # @option opts [Vips::Access] :access Required access pattern for this file
1391
+ # @option opts [Boolean] :sequential Sequential read only
1216
1392
  # @option opts [Boolean] :fail Fail on first error
1393
+ # @option opts [Boolean] :disc Open to disc
1217
1394
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1218
1395
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1219
1396
 
@@ -1227,7 +1404,9 @@ module Vips
1227
1404
  # @option opts [Boolean] :autorotate Rotate image using exif orientation
1228
1405
  # @option opts [Boolean] :memory Force open via memory
1229
1406
  # @option opts [Vips::Access] :access Required access pattern for this file
1407
+ # @option opts [Boolean] :sequential Sequential read only
1230
1408
  # @option opts [Boolean] :fail Fail on first error
1409
+ # @option opts [Boolean] :disc Open to disc
1231
1410
  # @option opts [Vips::ForeignFlags] :flags Output Flags for this file
1232
1411
  # @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
1233
1412
 
@@ -1235,94 +1414,105 @@ module Vips
1235
1414
  # Save image to csv file.
1236
1415
  # @param filename [String] Filename to save to
1237
1416
  # @param opts [Hash] Set of options
1238
- # @option opts [Integer] :page_height Set page height for multipage save
1239
1417
  # @option opts [String] :separator Separator characters
1240
1418
  # @option opts [Boolean] :strip Strip all metadata from image
1241
1419
  # @option opts [Array<Double>] :background Background value
1420
+ # @option opts [Integer] :page_height Set page height for multipage save
1242
1421
  # @return [nil]
1243
1422
 
1244
1423
  # @!method matrixsave(filename, **opts)
1245
1424
  # Save image to matrix file.
1246
1425
  # @param filename [String] Filename to save to
1247
1426
  # @param opts [Hash] Set of options
1248
- # @option opts [Integer] :page_height Set page height for multipage save
1249
1427
  # @option opts [Boolean] :strip Strip all metadata from image
1250
1428
  # @option opts [Array<Double>] :background Background value
1429
+ # @option opts [Integer] :page_height Set page height for multipage save
1251
1430
  # @return [nil]
1252
1431
 
1253
1432
  # @!method matrixprint(**opts)
1254
1433
  # Print matrix.
1255
1434
  # @param opts [Hash] Set of options
1256
- # @option opts [Integer] :page_height Set page height for multipage save
1257
1435
  # @option opts [Boolean] :strip Strip all metadata from image
1258
1436
  # @option opts [Array<Double>] :background Background value
1437
+ # @option opts [Integer] :page_height Set page height for multipage save
1259
1438
  # @return [nil]
1260
1439
 
1261
1440
  # @!method rawsave(filename, **opts)
1262
1441
  # Save image to raw file.
1263
1442
  # @param filename [String] Filename to save to
1264
1443
  # @param opts [Hash] Set of options
1265
- # @option opts [Integer] :page_height Set page height for multipage save
1266
1444
  # @option opts [Boolean] :strip Strip all metadata from image
1267
1445
  # @option opts [Array<Double>] :background Background value
1446
+ # @option opts [Integer] :page_height Set page height for multipage save
1268
1447
  # @return [nil]
1269
1448
 
1270
1449
  # @!method rawsave_fd(fd, **opts)
1271
1450
  # Write raw image to file descriptor.
1272
1451
  # @param fd [Integer] File descriptor to write to
1273
1452
  # @param opts [Hash] Set of options
1274
- # @option opts [Integer] :page_height Set page height for multipage save
1275
1453
  # @option opts [Boolean] :strip Strip all metadata from image
1276
1454
  # @option opts [Array<Double>] :background Background value
1455
+ # @option opts [Integer] :page_height Set page height for multipage save
1277
1456
  # @return [nil]
1278
1457
 
1279
1458
  # @!method vipssave(filename, **opts)
1280
1459
  # Save image to vips file.
1281
1460
  # @param filename [String] Filename to save to
1282
1461
  # @param opts [Hash] Set of options
1283
- # @option opts [Integer] :page_height Set page height for multipage save
1284
1462
  # @option opts [Boolean] :strip Strip all metadata from image
1285
1463
  # @option opts [Array<Double>] :background Background value
1464
+ # @option opts [Integer] :page_height Set page height for multipage save
1286
1465
  # @return [nil]
1287
1466
 
1288
1467
  # @!method ppmsave(filename, **opts)
1289
1468
  # Save image to ppm file.
1290
1469
  # @param filename [String] Filename to save to
1291
1470
  # @param opts [Hash] Set of options
1292
- # @option opts [Integer] :page_height Set page height for multipage save
1293
1471
  # @option opts [Boolean] :ascii save as ascii
1294
1472
  # @option opts [Boolean] :squash save as one bit
1295
1473
  # @option opts [Boolean] :strip Strip all metadata from image
1296
1474
  # @option opts [Array<Double>] :background Background value
1475
+ # @option opts [Integer] :page_height Set page height for multipage save
1297
1476
  # @return [nil]
1298
1477
 
1299
1478
  # @!method radsave(filename, **opts)
1300
1479
  # Save image to radiance file.
1301
1480
  # @param filename [String] Filename to save to
1302
1481
  # @param opts [Hash] Set of options
1303
- # @option opts [Integer] :page_height Set page height for multipage save
1304
1482
  # @option opts [Boolean] :strip Strip all metadata from image
1305
1483
  # @option opts [Array<Double>] :background Background value
1484
+ # @option opts [Integer] :page_height Set page height for multipage save
1306
1485
  # @return [nil]
1307
1486
 
1308
1487
  # @!method radsave_buffer(**opts)
1309
1488
  # Save image to radiance buffer.
1310
1489
  # @param opts [Hash] Set of options
1311
- # @option opts [Integer] :page_height Set page height for multipage save
1312
1490
  # @option opts [Boolean] :strip Strip all metadata from image
1313
1491
  # @option opts [Array<Double>] :background Background value
1492
+ # @option opts [Integer] :page_height Set page height for multipage save
1314
1493
  # @return [VipsBlob] Buffer to save to
1315
1494
 
1495
+ # @!method radsave_target(target, **opts)
1496
+ # Save image to radiance target.
1497
+ # @param target [Vips::Target] Target to save to
1498
+ # @param opts [Hash] Set of options
1499
+ # @option opts [Boolean] :strip Strip all metadata from image
1500
+ # @option opts [Array<Double>] :background Background value
1501
+ # @option opts [Integer] :page_height Set page height for multipage save
1502
+ # @return [nil]
1503
+
1316
1504
  # @!method dzsave(filename, **opts)
1317
1505
  # Save image to deepzoom file.
1318
1506
  # @param filename [String] Filename to save to
1319
1507
  # @param opts [Hash] Set of options
1508
+ # @option opts [String] :dirname Directory name to save to
1320
1509
  # @option opts [String] :basename Base name to save to
1321
1510
  # @option opts [Vips::ForeignDzLayout] :layout Directory layout
1322
- # @option opts [Integer] :page_height Set page height for multipage save
1323
1511
  # @option opts [String] :suffix Filename suffix for tiles
1324
1512
  # @option opts [Integer] :overlap Tile overlap in pixels
1325
1513
  # @option opts [Integer] :tile_size Tile size in pixels
1514
+ # @option opts [Integer] :tile_height Tile height in pixels
1515
+ # @option opts [Integer] :tile_width Tile width in pixels
1326
1516
  # @option opts [Boolean] :centre Center image in tile
1327
1517
  # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
1328
1518
  # @option opts [Vips::Angle] :angle Rotate image during save
@@ -1331,19 +1521,23 @@ module Vips
1331
1521
  # @option opts [Integer] :compression ZIP deflate compression level
1332
1522
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1333
1523
  # @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
1524
+ # @option opts [Boolean] :no_strip Don't strip tile metadata
1334
1525
  # @option opts [Boolean] :strip Strip all metadata from image
1335
1526
  # @option opts [Array<Double>] :background Background value
1527
+ # @option opts [Integer] :page_height Set page height for multipage save
1336
1528
  # @return [nil]
1337
1529
 
1338
1530
  # @!method dzsave_buffer(**opts)
1339
1531
  # Save image to dz buffer.
1340
1532
  # @param opts [Hash] Set of options
1533
+ # @option opts [String] :dirname Directory name to save to
1341
1534
  # @option opts [String] :basename Base name to save to
1342
1535
  # @option opts [Vips::ForeignDzLayout] :layout Directory layout
1343
- # @option opts [Integer] :page_height Set page height for multipage save
1344
1536
  # @option opts [String] :suffix Filename suffix for tiles
1345
1537
  # @option opts [Integer] :overlap Tile overlap in pixels
1346
1538
  # @option opts [Integer] :tile_size Tile size in pixels
1539
+ # @option opts [Integer] :tile_height Tile height in pixels
1540
+ # @option opts [Integer] :tile_width Tile width in pixels
1347
1541
  # @option opts [Boolean] :centre Center image in tile
1348
1542
  # @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
1349
1543
  # @option opts [Vips::Angle] :angle Rotate image during save
@@ -1352,8 +1546,10 @@ module Vips
1352
1546
  # @option opts [Integer] :compression ZIP deflate compression level
1353
1547
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1354
1548
  # @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
1549
+ # @option opts [Boolean] :no_strip Don't strip tile metadata
1355
1550
  # @option opts [Boolean] :strip Strip all metadata from image
1356
1551
  # @option opts [Array<Double>] :background Background value
1552
+ # @option opts [Integer] :page_height Set page height for multipage save
1357
1553
  # @return [VipsBlob] Buffer to save to
1358
1554
 
1359
1555
  # @!method pngsave(filename, **opts)
@@ -1362,7 +1558,6 @@ module Vips
1362
1558
  # @param opts [Hash] Set of options
1363
1559
  # @option opts [Integer] :compression Compression factor
1364
1560
  # @option opts [Boolean] :interlace Interlace image
1365
- # @option opts [Integer] :page_height Set page height for multipage save
1366
1561
  # @option opts [String] :profile ICC profile to embed
1367
1562
  # @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
1368
1563
  # @option opts [Boolean] :palette Quantise to 8bpp palette
@@ -1371,6 +1566,7 @@ module Vips
1371
1566
  # @option opts [Float] :dither Amount of dithering
1372
1567
  # @option opts [Boolean] :strip Strip all metadata from image
1373
1568
  # @option opts [Array<Double>] :background Background value
1569
+ # @option opts [Integer] :page_height Set page height for multipage save
1374
1570
  # @return [nil]
1375
1571
 
1376
1572
  # @!method pngsave_buffer(**opts)
@@ -1378,7 +1574,6 @@ module Vips
1378
1574
  # @param opts [Hash] Set of options
1379
1575
  # @option opts [Integer] :compression Compression factor
1380
1576
  # @option opts [Boolean] :interlace Interlace image
1381
- # @option opts [Integer] :page_height Set page height for multipage save
1382
1577
  # @option opts [String] :profile ICC profile to embed
1383
1578
  # @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
1384
1579
  # @option opts [Boolean] :palette Quantise to 8bpp palette
@@ -1387,13 +1582,30 @@ module Vips
1387
1582
  # @option opts [Float] :dither Amount of dithering
1388
1583
  # @option opts [Boolean] :strip Strip all metadata from image
1389
1584
  # @option opts [Array<Double>] :background Background value
1585
+ # @option opts [Integer] :page_height Set page height for multipage save
1390
1586
  # @return [VipsBlob] Buffer to save to
1391
1587
 
1588
+ # @!method pngsave_target(target, **opts)
1589
+ # Save image to target as png.
1590
+ # @param target [Vips::Target] Target to save to
1591
+ # @param opts [Hash] Set of options
1592
+ # @option opts [Integer] :compression Compression factor
1593
+ # @option opts [Boolean] :interlace Interlace image
1594
+ # @option opts [String] :profile ICC profile to embed
1595
+ # @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
1596
+ # @option opts [Boolean] :palette Quantise to 8bpp palette
1597
+ # @option opts [Integer] :colours Max number of palette colours
1598
+ # @option opts [Integer] :Q Quantisation quality
1599
+ # @option opts [Float] :dither Amount of dithering
1600
+ # @option opts [Boolean] :strip Strip all metadata from image
1601
+ # @option opts [Array<Double>] :background Background value
1602
+ # @option opts [Integer] :page_height Set page height for multipage save
1603
+ # @return [nil]
1604
+
1392
1605
  # @!method jpegsave(filename, **opts)
1393
1606
  # Save image to jpeg file.
1394
1607
  # @param filename [String] Filename to save to
1395
1608
  # @param opts [Hash] Set of options
1396
- # @option opts [Integer] :page_height Set page height for multipage save
1397
1609
  # @option opts [Integer] :Q Q factor
1398
1610
  # @option opts [String] :profile ICC profile to embed
1399
1611
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
@@ -1401,16 +1613,16 @@ module Vips
1401
1613
  # @option opts [Boolean] :no_subsample Disable chroma subsample
1402
1614
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
1403
1615
  # @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
1404
- # @option opts [Boolean] :optimize_scans Split the spectrum of DCT coefficients into separate scans
1616
+ # @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
1405
1617
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1406
1618
  # @option opts [Boolean] :strip Strip all metadata from image
1407
1619
  # @option opts [Array<Double>] :background Background value
1620
+ # @option opts [Integer] :page_height Set page height for multipage save
1408
1621
  # @return [nil]
1409
1622
 
1410
1623
  # @!method jpegsave_buffer(**opts)
1411
1624
  # Save image to jpeg buffer.
1412
1625
  # @param opts [Hash] Set of options
1413
- # @option opts [Integer] :page_height Set page height for multipage save
1414
1626
  # @option opts [Integer] :Q Q factor
1415
1627
  # @option opts [String] :profile ICC profile to embed
1416
1628
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
@@ -1418,16 +1630,34 @@ module Vips
1418
1630
  # @option opts [Boolean] :no_subsample Disable chroma subsample
1419
1631
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
1420
1632
  # @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
1421
- # @option opts [Boolean] :optimize_scans Split the spectrum of DCT coefficients into separate scans
1633
+ # @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
1422
1634
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1423
1635
  # @option opts [Boolean] :strip Strip all metadata from image
1424
1636
  # @option opts [Array<Double>] :background Background value
1637
+ # @option opts [Integer] :page_height Set page height for multipage save
1425
1638
  # @return [VipsBlob] Buffer to save to
1426
1639
 
1640
+ # @!method jpegsave_target(target, **opts)
1641
+ # Save image to jpeg target.
1642
+ # @param target [Vips::Target] Target to save to
1643
+ # @param opts [Hash] Set of options
1644
+ # @option opts [Integer] :Q Q factor
1645
+ # @option opts [String] :profile ICC profile to embed
1646
+ # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
1647
+ # @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
1648
+ # @option opts [Boolean] :no_subsample Disable chroma subsample
1649
+ # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
1650
+ # @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
1651
+ # @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
1652
+ # @option opts [Integer] :quant_table Use predefined quantization table with given index
1653
+ # @option opts [Boolean] :strip Strip all metadata from image
1654
+ # @option opts [Array<Double>] :background Background value
1655
+ # @option opts [Integer] :page_height Set page height for multipage save
1656
+ # @return [nil]
1657
+
1427
1658
  # @!method jpegsave_mime(**opts)
1428
1659
  # Save image to jpeg mime.
1429
1660
  # @param opts [Hash] Set of options
1430
- # @option opts [Integer] :page_height Set page height for multipage save
1431
1661
  # @option opts [Integer] :Q Q factor
1432
1662
  # @option opts [String] :profile ICC profile to embed
1433
1663
  # @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
@@ -1435,17 +1665,17 @@ module Vips
1435
1665
  # @option opts [Boolean] :no_subsample Disable chroma subsample
1436
1666
  # @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
1437
1667
  # @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
1438
- # @option opts [Boolean] :optimize_scans Split the spectrum of DCT coefficients into separate scans
1668
+ # @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
1439
1669
  # @option opts [Integer] :quant_table Use predefined quantization table with given index
1440
1670
  # @option opts [Boolean] :strip Strip all metadata from image
1441
1671
  # @option opts [Array<Double>] :background Background value
1672
+ # @option opts [Integer] :page_height Set page height for multipage save
1442
1673
  # @return [nil]
1443
1674
 
1444
1675
  # @!method webpsave(filename, **opts)
1445
1676
  # Save image to webp file.
1446
1677
  # @param filename [String] Filename to save to
1447
1678
  # @param opts [Hash] Set of options
1448
- # @option opts [Integer] :page_height Set page height for multipage save
1449
1679
  # @option opts [Integer] :Q Q factor
1450
1680
  # @option opts [Boolean] :lossless enable lossless compression
1451
1681
  # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
@@ -1458,12 +1688,12 @@ module Vips
1458
1688
  # @option opts [Integer] :reduction_effort Level of CPU effort to reduce file size
1459
1689
  # @option opts [Boolean] :strip Strip all metadata from image
1460
1690
  # @option opts [Array<Double>] :background Background value
1691
+ # @option opts [Integer] :page_height Set page height for multipage save
1461
1692
  # @return [nil]
1462
1693
 
1463
1694
  # @!method webpsave_buffer(**opts)
1464
1695
  # Save image to webp buffer.
1465
1696
  # @param opts [Hash] Set of options
1466
- # @option opts [Integer] :page_height Set page height for multipage save
1467
1697
  # @option opts [Integer] :Q Q factor
1468
1698
  # @option opts [Boolean] :lossless enable lossless compression
1469
1699
  # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
@@ -1476,8 +1706,28 @@ module Vips
1476
1706
  # @option opts [Integer] :reduction_effort Level of CPU effort to reduce file size
1477
1707
  # @option opts [Boolean] :strip Strip all metadata from image
1478
1708
  # @option opts [Array<Double>] :background Background value
1709
+ # @option opts [Integer] :page_height Set page height for multipage save
1479
1710
  # @return [VipsBlob] Buffer to save to
1480
1711
 
1712
+ # @!method webpsave_target(target, **opts)
1713
+ # Save image to webp target.
1714
+ # @param target [Vips::Target] Target to save to
1715
+ # @param opts [Hash] Set of options
1716
+ # @option opts [Integer] :Q Q factor
1717
+ # @option opts [Boolean] :lossless enable lossless compression
1718
+ # @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
1719
+ # @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
1720
+ # @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
1721
+ # @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
1722
+ # @option opts [Boolean] :min_size Optimise for minium size
1723
+ # @option opts [Integer] :kmin Minimum number of frames between key frames
1724
+ # @option opts [Integer] :kmax Maximum number of frames between key frames
1725
+ # @option opts [Integer] :reduction_effort Level of CPU effort to reduce file size
1726
+ # @option opts [Boolean] :strip Strip all metadata from image
1727
+ # @option opts [Array<Double>] :background Background value
1728
+ # @option opts [Integer] :page_height Set page height for multipage save
1729
+ # @return [nil]
1730
+
1481
1731
  # @!method tiffsave(filename, **opts)
1482
1732
  # Save image to tiff file.
1483
1733
  # @param filename [String] Filename to save to
@@ -1485,7 +1735,6 @@ module Vips
1485
1735
  # @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
1486
1736
  # @option opts [Integer] :Q Q factor
1487
1737
  # @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
1488
- # @option opts [Integer] :page_height Set page height for multipage save
1489
1738
  # @option opts [String] :profile ICC profile to embed
1490
1739
  # @option opts [Boolean] :tile Write a tiled tiff
1491
1740
  # @option opts [Integer] :tile_width Tile width in pixels
@@ -1497,10 +1746,14 @@ module Vips
1497
1746
  # @option opts [Float] :xres Horizontal resolution in pixels/mm
1498
1747
  # @option opts [Float] :yres Vertical resolution in pixels/mm
1499
1748
  # @option opts [Boolean] :bigtiff Write a bigtiff image
1749
+ # @option opts [Boolean] :rgbjpeg Output RGB JPEG rather than YCbCr
1500
1750
  # @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
1501
1751
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1752
+ # @option opts [Integer] :level ZSTD compression level
1753
+ # @option opts [Boolean] :lossless Enable WEBP lossless mode
1502
1754
  # @option opts [Boolean] :strip Strip all metadata from image
1503
1755
  # @option opts [Array<Double>] :background Background value
1756
+ # @option opts [Integer] :page_height Set page height for multipage save
1504
1757
  # @return [nil]
1505
1758
 
1506
1759
  # @!method tiffsave_buffer(**opts)
@@ -1509,7 +1762,6 @@ module Vips
1509
1762
  # @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
1510
1763
  # @option opts [Integer] :Q Q factor
1511
1764
  # @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
1512
- # @option opts [Integer] :page_height Set page height for multipage save
1513
1765
  # @option opts [String] :profile ICC profile to embed
1514
1766
  # @option opts [Boolean] :tile Write a tiled tiff
1515
1767
  # @option opts [Integer] :tile_width Tile width in pixels
@@ -1521,10 +1773,14 @@ module Vips
1521
1773
  # @option opts [Float] :xres Horizontal resolution in pixels/mm
1522
1774
  # @option opts [Float] :yres Vertical resolution in pixels/mm
1523
1775
  # @option opts [Boolean] :bigtiff Write a bigtiff image
1776
+ # @option opts [Boolean] :rgbjpeg Output RGB JPEG rather than YCbCr
1524
1777
  # @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
1525
1778
  # @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
1779
+ # @option opts [Integer] :level ZSTD compression level
1780
+ # @option opts [Boolean] :lossless Enable WEBP lossless mode
1526
1781
  # @option opts [Boolean] :strip Strip all metadata from image
1527
1782
  # @option opts [Array<Double>] :background Background value
1783
+ # @option opts [Integer] :page_height Set page height for multipage save
1528
1784
  # @return [VipsBlob] Buffer to save to
1529
1785
 
1530
1786
  # @!method magicksave(filename, **opts)
@@ -1533,9 +1789,11 @@ module Vips
1533
1789
  # @param opts [Hash] Set of options
1534
1790
  # @option opts [String] :format Format to save in
1535
1791
  # @option opts [Integer] :quality Quality to use
1536
- # @option opts [Integer] :page_height Set page height for multipage save
1792
+ # @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
1793
+ # @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
1537
1794
  # @option opts [Boolean] :strip Strip all metadata from image
1538
1795
  # @option opts [Array<Double>] :background Background value
1796
+ # @option opts [Integer] :page_height Set page height for multipage save
1539
1797
  # @return [nil]
1540
1798
 
1541
1799
  # @!method magicksave_buffer(**opts)
@@ -1543,59 +1801,52 @@ module Vips
1543
1801
  # @param opts [Hash] Set of options
1544
1802
  # @option opts [String] :format Format to save in
1545
1803
  # @option opts [Integer] :quality Quality to use
1546
- # @option opts [Integer] :page_height Set page height for multipage save
1804
+ # @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
1805
+ # @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
1547
1806
  # @option opts [Boolean] :strip Strip all metadata from image
1548
1807
  # @option opts [Array<Double>] :background Background value
1808
+ # @option opts [Integer] :page_height Set page height for multipage save
1549
1809
  # @return [VipsBlob] Buffer to save to
1550
1810
 
1551
1811
  # @!method fitssave(filename, **opts)
1552
1812
  # Save image to fits file.
1553
1813
  # @param filename [String] Filename to save to
1554
1814
  # @param opts [Hash] Set of options
1555
- # @option opts [Integer] :page_height Set page height for multipage save
1556
1815
  # @option opts [Boolean] :strip Strip all metadata from image
1557
1816
  # @option opts [Array<Double>] :background Background value
1817
+ # @option opts [Integer] :page_height Set page height for multipage save
1558
1818
  # @return [nil]
1559
1819
 
1560
1820
  # @!method niftisave(filename, **opts)
1561
1821
  # Save image to nifti file.
1562
1822
  # @param filename [String] Filename to save to
1563
1823
  # @param opts [Hash] Set of options
1564
- # @option opts [Integer] :page_height Set page height for multipage save
1565
1824
  # @option opts [Boolean] :strip Strip all metadata from image
1566
1825
  # @option opts [Array<Double>] :background Background value
1567
- # @return [nil]
1568
-
1569
- # @!method heifsave(filename, **opts)
1570
- # Save image in heif format.
1571
- # @param filename [String] Filename to load from
1572
- # @param opts [Hash] Set of options
1573
1826
  # @option opts [Integer] :page_height Set page height for multipage save
1574
- # @option opts [Integer] :Q Q factor
1575
- # @option opts [Boolean] :lossless Enable lossless compression
1576
- # @option opts [Boolean] :strip Strip all metadata from image
1577
- # @option opts [Array<Double>] :background Background value
1578
1827
  # @return [nil]
1579
1828
 
1580
1829
  # @!method heifsave(filename, **opts)
1581
1830
  # Save image in heif format.
1582
1831
  # @param filename [String] Filename to load from
1583
1832
  # @param opts [Hash] Set of options
1584
- # @option opts [Integer] :page_height Set page height for multipage save
1585
1833
  # @option opts [Integer] :Q Q factor
1586
1834
  # @option opts [Boolean] :lossless Enable lossless compression
1835
+ # @option opts [Vips::ForeignHeifCompression] :compression Compression format
1587
1836
  # @option opts [Boolean] :strip Strip all metadata from image
1588
1837
  # @option opts [Array<Double>] :background Background value
1838
+ # @option opts [Integer] :page_height Set page height for multipage save
1589
1839
  # @return [nil]
1590
1840
 
1591
1841
  # @!method heifsave_buffer(**opts)
1592
1842
  # Save image in heif format.
1593
1843
  # @param opts [Hash] Set of options
1594
- # @option opts [Integer] :page_height Set page height for multipage save
1595
1844
  # @option opts [Integer] :Q Q factor
1596
1845
  # @option opts [Boolean] :lossless Enable lossless compression
1846
+ # @option opts [Vips::ForeignHeifCompression] :compression Compression format
1597
1847
  # @option opts [Boolean] :strip Strip all metadata from image
1598
1848
  # @option opts [Array<Double>] :background Background value
1849
+ # @option opts [Integer] :page_height Set page height for multipage save
1599
1850
  # @return [VipsBlob] Buffer to save to
1600
1851
 
1601
1852
  # @!method self.thumbnail(filename, width, **opts)
@@ -1611,6 +1862,7 @@ module Vips
1611
1862
  # @option opts [String] :import_profile Fallback import profile
1612
1863
  # @option opts [String] :export_profile Fallback export profile
1613
1864
  # @option opts [Vips::Intent] :intent Rendering intent
1865
+ # @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
1614
1866
  # @return [Vips::Image] Output image
1615
1867
 
1616
1868
  # @!method self.thumbnail_buffer(buffer, width, **opts)
@@ -1627,6 +1879,7 @@ module Vips
1627
1879
  # @option opts [String] :import_profile Fallback import profile
1628
1880
  # @option opts [String] :export_profile Fallback export profile
1629
1881
  # @option opts [Vips::Intent] :intent Rendering intent
1882
+ # @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
1630
1883
  # @return [Vips::Image] Output image
1631
1884
 
1632
1885
  # @!method thumbnail_image(width, **opts)
@@ -1641,6 +1894,24 @@ module Vips
1641
1894
  # @option opts [String] :import_profile Fallback import profile
1642
1895
  # @option opts [String] :export_profile Fallback export profile
1643
1896
  # @option opts [Vips::Intent] :intent Rendering intent
1897
+ # @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
1898
+ # @return [Vips::Image] Output image
1899
+
1900
+ # @!method self.thumbnail_source(source, width, **opts)
1901
+ # Generate thumbnail from source.
1902
+ # @param source [Vips::Source] Source to load from
1903
+ # @param width [Integer] Size to this width
1904
+ # @param opts [Hash] Set of options
1905
+ # @option opts [String] :option_string Options that are passed on to the underlying loader
1906
+ # @option opts [Integer] :height Size to this height
1907
+ # @option opts [Vips::Size] :size Only upsize, only downsize, or both
1908
+ # @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
1909
+ # @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
1910
+ # @option opts [Boolean] :linear Reduce in linear light
1911
+ # @option opts [String] :import_profile Fallback import profile
1912
+ # @option opts [String] :export_profile Fallback export profile
1913
+ # @option opts [Vips::Intent] :intent Rendering intent
1914
+ # @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
1644
1915
  # @return [Vips::Image] Output image
1645
1916
 
1646
1917
  # @!method mapim(index, **opts)
@@ -1655,24 +1926,29 @@ module Vips
1655
1926
  # @param hshrink [Float] Horizontal shrink factor
1656
1927
  # @param vshrink [Float] Vertical shrink factor
1657
1928
  # @param opts [Hash] Set of options
1929
+ # @option opts [Float] :xshrink Horizontal shrink factor
1930
+ # @option opts [Float] :yshrink Vertical shrink factor
1658
1931
  # @return [Vips::Image] Output image
1659
1932
 
1660
1933
  # @!method shrinkh(hshrink, **opts)
1661
1934
  # Shrink an image horizontally.
1662
1935
  # @param hshrink [Integer] Horizontal shrink factor
1663
1936
  # @param opts [Hash] Set of options
1937
+ # @option opts [Integer] :xshrink Horizontal shrink factor
1664
1938
  # @return [Vips::Image] Output image
1665
1939
 
1666
1940
  # @!method shrinkv(vshrink, **opts)
1667
1941
  # Shrink an image vertically.
1668
1942
  # @param vshrink [Integer] Vertical shrink factor
1669
1943
  # @param opts [Hash] Set of options
1944
+ # @option opts [Integer] :yshrink Vertical shrink factor
1670
1945
  # @return [Vips::Image] Output image
1671
1946
 
1672
1947
  # @!method reduceh(hshrink, **opts)
1673
1948
  # Shrink an image horizontally.
1674
1949
  # @param hshrink [Float] Horizontal shrink factor
1675
1950
  # @param opts [Hash] Set of options
1951
+ # @option opts [Float] :xshrink Horizontal shrink factor
1676
1952
  # @option opts [Vips::Kernel] :kernel Resampling kernel
1677
1953
  # @option opts [Boolean] :centre Use centre sampling convention
1678
1954
  # @return [Vips::Image] Output image
@@ -1681,6 +1957,7 @@ module Vips
1681
1957
  # Shrink an image vertically.
1682
1958
  # @param vshrink [Float] Vertical shrink factor
1683
1959
  # @param opts [Hash] Set of options
1960
+ # @option opts [Float] :yshrink Vertical shrink factor
1684
1961
  # @option opts [Vips::Kernel] :kernel Resampling kernel
1685
1962
  # @option opts [Boolean] :centre Use centre sampling convention
1686
1963
  # @return [Vips::Image] Output image
@@ -1692,6 +1969,8 @@ module Vips
1692
1969
  # @param opts [Hash] Set of options
1693
1970
  # @option opts [Vips::Kernel] :kernel Resampling kernel
1694
1971
  # @option opts [Boolean] :centre Use centre sampling convention
1972
+ # @option opts [Float] :xshrink Horizontal shrink factor
1973
+ # @option opts [Float] :yshrink Vertical shrink factor
1695
1974
  # @return [Vips::Image] Output image
1696
1975
 
1697
1976
  # @!method quadratic(coeff, **opts)
@@ -1744,8 +2023,12 @@ module Vips
1744
2023
  # Resize an image.
1745
2024
  # @param scale [Float] Scale image by this factor
1746
2025
  # @param opts [Hash] Set of options
2026
+ # @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
1747
2027
  # @option opts [Vips::Kernel] :kernel Resampling kernel
2028
+ # @option opts [Boolean] :centre Use centre sampling convention
1748
2029
  # @option opts [Float] :vscale Vertical scale image by this factor
2030
+ # @option opts [Float] :idx Horizontal input displacement
2031
+ # @option opts [Float] :idy Vertical input displacement
1749
2032
  # @return [Vips::Image] Output image
1750
2033
 
1751
2034
  # @!method colourspace(space, **opts)
@@ -1949,6 +2232,12 @@ module Vips
1949
2232
  # @option opts [Integer] :band apply one-band lut to this band of in
1950
2233
  # @return [Vips::Image] Output image
1951
2234
 
2235
+ # @!method case(cases, **opts)
2236
+ # Use pixel values to pick cases from an array of images.
2237
+ # @param cases [Array<Image>] Array of case images
2238
+ # @param opts [Hash] Set of options
2239
+ # @return [Vips::Image] Output image
2240
+
1952
2241
  # @!method percent(percent, **opts)
1953
2242
  # Find threshold for percent of pixels.
1954
2243
  # @param percent [Float] Percent of pixels
@@ -2083,6 +2372,7 @@ module Vips
2083
2372
  # @!method sharpen(**opts)
2084
2373
  # Unsharp masking for print.
2085
2374
  # @param opts [Hash] Set of options
2375
+ # @option opts [Integer] :radius radius of Gaussian
2086
2376
  # @option opts [Float] :sigma Sigma of Gaussian
2087
2377
  # @option opts [Float] :x1 Flat/jaggy threshold
2088
2378
  # @option opts [Float] :y2 Maximum brightening