ruby-vips 2.0.16 → 2.0.17

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.
@@ -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