diff -Nru vips-8.6.4/ChangeLog vips-8.6.5/ChangeLog
--- vips-8.6.4/ChangeLog 2018-06-13 15:24:52.000000000 +0000
+++ vips-8.6.5/ChangeLog 2018-07-25 09:46:22.000000000 +0000
@@ -1,3 +1,6 @@
+22/7/18 started 8.6.5
+- fix a buffer overflow in the tiff reader [HongxuChen]
+
12/3/18 started 8.6.4
- better fitting of fonts with overhanging edges [Adrià]
- revise C++ example [fangqiao]
diff -Nru vips-8.6.4/configure vips-8.6.5/configure
--- vips-8.6.4/configure 2018-06-13 15:32:19.000000000 +0000
+++ vips-8.6.5/configure 2018-07-25 10:06:09.000000000 +0000
@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.69 for vips 8.6.4.
+# Generated by GNU Autoconf 2.69 for vips 8.6.5.
#
# Report bugs to
All VIPS operations are subclasses of VipsOperation, which in turn
- subclasses VipsObject and then GObject
. You add an operation to VIPS
+ subclasses VipsObject and then GObject
. You add an operation to VIPS
by defining a new subclass of VipsOperation and arranging for its
to be called, perhaps by calling its class_init()
get_type()
function.
@@ -80,7 +80,7 @@
operation that's actually in the library.
- GObject
has a handy macro to write some of the boilerplate for you.
+ GObject
has a handy macro to write some of the boilerplate for you.
@@ -88,8 +88,8 @@
- G_DEFINE_TYPE()
defines a function called negative_get_type()
,
- which registers this new class and returns its GType
(a
+ G_DEFINE_TYPE()
defines a function called negative_get_type()
,
+ which registers this new class and returns its GType
(a
pointer-sized integer). negative_get_type()
in turn needs two
functions, negative_init()
, to initialise a new instance, and
negative_class_init()
, to initialise a new class.
@@ -153,7 +153,7 @@
- In GObject
, it needs to set the getters and setters for this class. vips
+ In GObject
, it needs to set the getters and setters for this class. vips
has a generic get/set system, so any subclass of VipsObject needs to
use the vips ones.
Next, it creates the output image. This needs to be set with
- g_object_set()
so that vips can see that it has been assigned. vips
+ g_object_set()
so that vips can see that it has been assigned. vips
will also handle the reference counting for you.
To add the operation to vips, just call negative_get_type()
. You can
- include the source in your program, or use GModule
to make a binary
+ include the source in your program, or use GModule
to make a binary
plugin that will be loaded by libvips at startup. There are some example
plugins available.
VIPS has a set of operators each of which computes some useful image
processing operation. Each operator is
- implemented as a GObject
class, for example VipsGamma
.
+ implemented as a GObject
class, for example VipsGamma
.
Classes are identified by their unique nickname
, in this
case gamma
.
diff -Nru vips-8.6.4/doc/html/index.html vips-8.6.5/doc/html/index.html
--- vips-8.6.4/doc/html/index.html 2018-06-13 15:35:15.000000000 +0000
+++ vips-8.6.5/doc/html/index.html 2018-07-25 10:11:02.000000000 +0000
@@ -15,7 +15,7 @@
VIPS Reference Manual |
---|
- For VIPS 8.6.4. + For VIPS 8.6.5. The latest version of this documentation can be found on the VIPS website.
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
threshold
-: gdouble
, background / object threshold
gdouble
, background / object threshold
background
: VipsArrayDouble, background colour
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
The pixel values are returned in vector
, the length of the
array in n
-. You must free the array with g_free()
when you are done with
+. You must free the array with g_free()
when you are done with
it.
See also: vips_draw_point()
.
[method]
@@ -6343,7 +6343,7 @@...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
gboolean +gboolean vips_buf_appendns (@@ -626,13 +626,13 @@VipsBuf *buf
,const char *str
,int sz
);
gboolean +gboolean vips_buf_appends (VipsBuf *buf
,const char *str
);Append the whole of
str
@@ -662,13 +662,13 @@
gboolean +gboolean vips_buf_appendf (@@ -703,13 +703,13 @@VipsBuf *buf
,const char *fmt
,...
);
gboolean +gboolean vips_buf_vappendf (@@ -744,13 +744,13 @@VipsBuf *buf
,const char *fmt
,va_list ap
);
gboolean +gboolean vips_buf_appendc (VipsBuf *buf
,char ch
);Append a single character
ch
@@ -780,24 +780,24 @@
gboolean +gboolean vips_buf_appendsc (VipsBuf *buf
, -gboolean quote
, +gboolean quote
,const char *str
);
gboolean ++gboolean vips_buf_appendgv (-VipsBuf *buf
, -GValue *value
);Format and append a GValue as a printable thing. We display text line "3144 +
GValue *value
);
Format and append a GValue as a printable thing. We display text line "3144 bytes of binary data" for BLOBs like icc-profile-data.
Use vips_image_get_as_string()
to make a text representation of a field.
That will base64-encode blobs, for example.
value
GValue to format and append
GValue to format and append
gboolean +gboolean vips_buf_append_size (VipsBuf *buf
,size_t n
);Turn a number of bytes into a sensible string ... eg "12", "12KB", "12MB", @@ -860,13 +860,13 @@
gboolean +gboolean vips_buf_removec (VipsBuf *buf
,char ch
);Remove the last character, if it's
ch
@@ -895,13 +895,13 @@
gboolean +gboolean vips_buf_change (@@ -937,13 +937,13 @@VipsBuf *buf
,const char *o
,const char *n
);
the NULL
-terminated contents of the buffer. This is a pointer to
+
the NULL
-terminated contents of the buffer. This is a pointer to
the memory managed by the buffer and must not be freed.
the NULL
-terminated contents of the buffer. This is a pointer to
+
the NULL
-terminated contents of the buffer. This is a pointer to
the memory managed by the buffer and must not be freed.
gboolean +gboolean vips_buf_appendg (VipsBuf *buf
,double g
);Append a double, non-localised. Useful for config files etc.
@@ -1075,13 +1075,13 @@
gboolean +gboolean vips_buf_appendd (VipsBuf *buf
,int d
);Append a number. If the number is -ve, add brackets. Needed for @@ -1110,7 +1110,7 @@
gboolean +gboolean vips_colourspace_issupported (const VipsImage *image
);Test if
image
is in a colourspace thatvips_colourspace()
can process. For @@ -792,7 +792,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
vips_image_get_typeof()
with VIPS_META_ICC_NAME as an argument. This will
-return GType
0 if there is no profile.
+return GType
0 if there is no profile.
If embedded
is not set, the input profile is taken from
input_profile
@@ -1993,7 +1993,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
vips_image_get_typeof()
with VIPS_META_ICC_NAME as an argument. This will
-return GType
0 if there is no profile.
+return GType
0 if there is no profile.
If embedded
is not set, the input profile is taken from
input_profile
@@ -2062,7 +2062,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
width
-: gint
, set image width
gint
, set image width
height
-: gint
, set image height
gint
, set image height
bands
-: gint
, set image bands
gint
, set image bands
format
: VipsBandFormat, set image format
coding
@@ -654,13 +654,13 @@
interpretation
: VipsInterpretation, set image interpretation
xres
-: gdouble
, set image xres
gdouble
, set image xres
yres
-: gdouble
, set image yres
gdouble
, set image yres
xoffset
-: gint
, set image xoffset
gint
, set image xoffset
yoffset
-: gint
, set image yoffset
gint
, set image yoffset
Copy an image, optionally modifying the header. VIPS copies images by copying pointers, so this operation is instant, even for very large images.
@@ -691,7 +691,7 @@...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Normally, only a single thread at once is allowed to calculate tiles. If
you set threaded
- to TRUE
, vips_tilecache()
will allow many threads to
+ to TRUE
, vips_tilecache()
will allow many threads to
calculate tiles at once, and share the cache between them.
Normally the cache is dropped when computation finishes. Set persistent
to
-TRUE
to keep the cache between computations.
TRUE
to keep the cache between computations.
See also: vips_cache()
, vips_linecache()
.
[method]
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
vips_linecache()
uses. The default is 1 (a single scanline).
Normally, only a single thread at once is allowed to calculate tiles. If
you set threaded
- to TRUE
, vips_linecache()
will allow many threads to
+ to TRUE
, vips_linecache()
will allow many threads to
calculate tiles at once and share the cache between them.
See also: vips_cache()
, vips_tilecache()
.
[method]
@@ -849,7 +849,7 @@...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Normally out
shows the whole of main
. If expand
- is TRUE then out
+ is TRUE then out
is
made large enough to hold all of main
and sub
@@ -1331,7 +1331,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
expand
-: TRUE
to expand the output image to hold all of the input pixels
TRUE
to expand the output image to hold all of the input pixels
shim
: space between images, in pixels
background
@@ -1370,7 +1370,7 @@
If one is taller or wider than the
other, out
will be has high as the smaller. If expand
- is TRUE
, then
+ is TRUE
, then
the output will be expanded to contain all of the input pixels.
Use align
to set the edge that the images align on. By default, they align
@@ -1424,7 +1424,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
across
-: gint
, number of images per row
gint
, number of images per row
shim
-: gint
, space between images, in pixels
gint
, space between images, in pixels
background
: VipsArrayDouble, background ink colour
halign
@@ -1456,9 +1456,9 @@
valign
: VipsAlign, low, centre or high alignment
hspacing
-: gint
, horizontal distance between images
gint
, horizontal distance between images
vspacing
-: gint
, vertical distance between images
gint
, vertical distance between images
Lay out the images in in
in a grid. The grid is across
@@ -1519,7 +1519,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
shift
-: gboolean
, integer values are shifted
gboolean
, integer values are shiftedConvert in
to format
. You can convert between any pair of formats.
Floats are truncated (not rounded). Out of range values are clipped.
Casting from complex to real returns the real part.
If shift
- is TRUE
, integer values are shifted up and down. For example,
+ is TRUE
, integer values are shifted up and down. For example,
casting from unsigned 8 bit to unsigned 16 bit would
shift every value left by 8 bits. The bottom bit is copied into the new
bits, so 255 would become 65535.
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
band
-: gint
, msb just this band
gint
, msb just this bandTurn any integer image to 8-bit unsigned char by discarding all but the most significant byte. Signed values are converted to unsigned by adding 128.
Use band
@@ -2991,7 +2991,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
If the images differ in size, the smaller images are enlarged to match the largest by adding zero pixels along the bottom and right.
If blend
- is TRUE
, then values in out
+ is TRUE
, then values in out
are smoothly blended between in1
and in2
@@ -3777,7 +3777,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
background
: VipsArrayDouble colour for new pixels
max_alpha
-: gdouble
, maximum value for alpha
gdouble
, maximum value for alpha
Take the last band of in
as an alpha and use it to blend the
@@ -3841,7 +3841,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
max_alpha
-: gdouble
, maximum value for alpha
gdouble
, maximum value for alpha
Premultiplies any alpha channel. The final band is taken to be the alpha and the bands are transformed as:
@@ -3924,7 +3924,7 @@...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
max_alpha
-: gdouble
, maximum value for alpha
gdouble
, maximum value for alpha
Unpremultiplies any alpha channel. The final band is taken to be the alpha and the bands are transformed as:
@@ -4005,7 +4005,7 @@...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
compositing_space
: VipsInterpretation to composite in
premultiplied
-: gboolean
, images are already premultiplied
gboolean
, images are already premultiplied
Composite an array of images together.
Images are placed in a stack, with in
@@ -4093,7 +4093,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
precision
: VipsPrecision, calculation accuracy
layers
-: gint
, number of layers for approximation
gint
, number of layers for approximation
cluster
-: gint
, cluster lines closer than this distance
gint
, cluster lines closer than this distance
Convolution.
Perform a convolution of in
@@ -265,7 +265,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
Perform an approximate integer convolution of in
with mask
@@ -470,7 +470,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
layers
-: gint
, number of layers for approximation
gint
, number of layers for approximation
Approximate separable integer convolution. This is a low-level operation, see
vips_convsep()
for something more convenient.
The image is convolved twice: once with mask
@@ -607,7 +607,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
times
-: gint
, how many times to rotate and convolve
gint
, how many times to rotate and convolve
angle
: VipsAngle45, rotate mask by this much between colvolutions
combine
@@ -637,9 +637,9 @@
precision
: VipsPrecision, precision for blur, default float
layers
-: gint
, number of layers for approximation
gint
, number of layers for approximation
cluster
-: gint
, cluster lines closer than this distance
gint
, cluster lines closer than this distance
This convolves in
with mask
@@ -677,7 +677,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
font
-: gchararray
, font to render with
gchararray
, font to render with
width
-: gint
, image should be no wider than this many pixels
gint
, image should be no wider than this many pixels
height
-: gint
, image should be no higher than this many pixels
gint
, image should be no higher than this many pixels
align
: VipsAlign, left/centre/right alignment
dpi
-: gint
, render at this resolution
gint
, render at this resolution
autofit_dpi
-: gint
, read out auto-fitted DPI
gint
, read out auto-fitted DPI
spacing
-: gint
, space lines by this in points
gint
, space lines by this in points
Draw the string text
to an image. out
@@ -687,7 +687,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
bands
: number of bands to create
ushort
-: TRUE
for an unsigned short identity
TRUE
for an unsigned short identity
size
: number of LUT elements for a ushort image
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
cell_size
-: gint
, size of Worley cells
gint
, size of Worley cells
Create a one-band float image of Worley noise. See:
https://en.wikipedia.org/wiki/Worley_noise
Use cell_size
@@ -2169,7 +2169,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
cell_size
-: gint
, size of Perlin cells
gint
, size of Perlin cells
uchar
: output a uchar image
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Draws a circle on image
. If fill
- is TRUE
then the circle is filled,
+ is TRUE
then the circle is filled,
otherwise a 1-pixel-wide perimeter is drawn.
ink
is an array of double containing values to draw.
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
The domain argument most of these functions take is not localised and is supposed to indicate the component which failed.
-libvips uses g_warning()
and g_info()
to send warning and information
+
libvips uses g_warning()
and g_info()
to send warning and information
messages to the user. You can use the usual glib mechanisms to display or
divert these messages. For example, info messages are hidden by default, but
you can see them with:
void
-vips_error_g (GError **error
);
+vips_error_g (GError **error
);
This function sets the glib error pointer from the vips error buffer and clears it. It's handy for returning errors to glib functions from vips.
See vips_g_error()
for the inverse operation.
See also: g_set_error()
, vips_g_error()
.
See also: g_set_error()
, vips_g_error()
.
... |
-
|
+
|
|
... |
-
|
+
|
|
... |
-
|
+
|
|
... |
-
|
+
|
|
... |
-
|
+
|
|
... |
-
|
+
|
|
in |
-
|
+
|
[array zero-terminated=1] |
... |
-
|
+
|
|
-guint64 +guint64 | vips_format_sizeof () @@ -59,7 +59,7 @@ | ||
-guint64 +guint64 | vips_format_sizeof_unsafe () @@ -232,7 +232,7 @@ | ||
-GType +GType | vips_image_get_typeof () @@ -240,7 +240,7 @@ | ||
-gboolean +gboolean | vips_image_remove () @@ -264,7 +264,7 @@ | ||
-gchar ** +gchar ** |
vips_image_get_fields ()
@@ -449,7 +449,7 @@
These functions let you get at image header data (including metadata) in a uniform way. Use You can attach arbitrary metadata to images. Metadata is copied as images
are processed, so all images which used this image as input, directly or
indirectly, will have this same bit of metadata attached to them. Copying
@@ -468,11 +468,11 @@
below) is automatically saved for you in a block of XML at the end of the
file. When you load a VIPS image, the metadata is restored. You can use the
VIPS metadata is based on VIPS metadata is based on VIPS provides a couple of base classes which implement reference-counted areas of memory. If you base your metadata on one of @@ -482,7 +482,7 @@ Functionsvips_format_sizeof ()-guint64 +guint64 vips_format_sizeof ( |
GValue value = { 0 }; -g_value_init (&value, G_TYPE_INT); -g_value_set_int (&value, 42); +g_value_init (&value, G_TYPE_INT); +g_value_set_int (&value, 42); vips_image_set (image, name, &value); -g_value_unset (&value); |
+g_value_unset (&value);
value
the GValue
to copy into the image
the GValue
to copy into the image
int vips_image_get (+const VipsImage *image
,const char *name
, -GValue *value_copy
);
GValue *value_copy
);
Fill value_copy
with a copy of the header field. value_copy
must be zeroed
@@ -1183,17 +1183,17 @@
if (vips_image_get (image, name, &value))
return -1;
-if (G_VALUE_TYPE (&value) != G_TYPE_DOUBLE) {
+if (G_VALUE_TYPE (&value) != G_TYPE_DOUBLE) {
vips_error( "mydomain",
_("field \"%s\" is of type %s, not double"),
name,
- g_type_name (G_VALUE_TYPE (&value)));
- g_value_unset (&value);
+ g_type_name (G_VALUE_TYPE (&value)));
+ g_value_unset (&value);
return -1;
}
-d = g_value_get_double (&value);
-g_value_unset (&value);
+d = g_value_get_double (&value);
+g_value_unset (&value);
@@ -1223,7 +1223,7 @@
value_copy
the GValue
is copied into this.
the GValue
is copied into this.
out
.
This function will read any field, returning it as a printable string.
-You need to free the string with g_free()
when you are done with it.
+You need to free the string with g_free()
when you are done with it.
This will base64-encode BLOBs, for example. Use vips_buf_appendgv()
to
make a string that's for humans.
See also: vips_image_get()
, vips_image_get_typeof()
, vips_buf_appendgv()
.
GType +GType vips_image_get_typeof (-const VipsImage *image
,const char *name
);Read the
GType
for a header field. Returns zero if there is no +Read the
GType
for a header field. Returns zero if there is no field of that name.See also:
vips_image_get()
.[method]
@@ -1318,17 +1318,17 @@
the GType
of the field, or zero if there is no
+
the GType
of the field, or zero if there is no
field of that name.
gboolean +gboolean vips_image_remove (-VipsImage *image
,const char *name
);Find and remove an item of metadata. Return
FALSE
if no metadata of that +Find and remove an item of metadata. Return
FALSE
if no metadata of that name was found.See also:
vips_image_set()
,vips_image_get_typeof()
.[method]
@@ -1356,7 +1356,7 @@
TRUE
if an item of metadata of that name was found and removed
TRUE
if an item of metadata of that name was found and removed
void * (*VipsImageMapFn) (VipsImage *image
,const char *name
, -GValue *value
, +GValue *value
,void *a
);
This function calls fn
for every header field, including every item of
metadata.
Like all _map functions, the user function should return NULL
to continue
-iteration, or a non-NULL
pointer to indicate early termination.
Like all _map functions, the user function should return NULL
to continue
+iteration, or a non-NULL
pointer to indicate early termination.
See also: vips_image_get_typeof()
, vips_image_get()
.
[method]
NULL
on success, the failing pointer otherwise.
NULL
on success, the failing pointer otherwise.
[transfer none]
gchar ** +gchar ** vips_image_get_fields (-VipsImage *image
);Get a
NULL
-terminated array listing all the metadata field names onimage
+Get a
+Free the return result withNULL
-terminated array listing all the metadata field names onimage
. -Free the return result withg_strfreev()
.g_strfreev()
.This is handy for language bindings. From C, it's usually more convenient to use
vips_image_map()
.[method]
@@ -1443,7 +1443,7 @@
metadata fields in image, as a NULL
-terminated
+
metadata fields in image, as a NULL
-terminated
array.
[transfer full]
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
int vips_hist_ismonotonic (VipsImage *in
, -gboolean *out
, +gboolean *out
,...
);
Test in
for monotonicity. out
@@ -763,7 +763,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
These functions cover two main areas.
First, some simple utility functions over the underlying
-g_malloc()
/g_free()
functions. Memory allocated and freeded using these
+g_malloc()
/g_free()
functions. Memory allocated and freeded using these
functions is interchangeable with any other glib library.
Second, a pair of functions, vips_tracked_malloc()
and vips_tracked_free()
,
-which are NOT compatible. If you g_free()
memory that has been allocated
+which are NOT compatible. If you g_free()
memory that has been allocated
with vips_tracked_malloc()
you will see crashes.
The tracked functions are only suitable for large allocations internal to the library, for example @@ -228,7 +228,7 @@
OBJ
allocate memory local to OBJ
-, or NULL
for no auto-free
NULL
for no auto-free
OBJ
allocate memory local to OBJ
-, or NULL
for no auto-free
NULL
for no auto-free
g_malloc() local to object
, that is, the memory will be automatically
freed for you when the object is closed. If object
- is NULL
, you need to
-free the memory explicitly with g_free()
.
NULL
, you need to
+free the memory explicitly with g_free()
.
This function cannot fail. See vips_tracked_malloc()
if you are
allocating large amounts of memory.
See also: vips_tracked_malloc()
.
object
allocate memory local to this VipsObject, or NULL
.
allocate memory local to this VipsObject, or NULL
.
g_strdup() a string. When object
is freed, the string will be freed for
you. If object
- is NULL
, you need to
-free the memory yourself with g_free()
.
NULL
, you need to
+free the memory yourself with g_free()
.
This function cannot fail.
See also: vips_malloc()
.
object
allocate memory local to this VipsObject, or NULL
.
allocate memory local to this VipsObject, or NULL
.
int
vips_free (void *buf
);
-Frees memory with g_free()
and returns 0. Handy for callbacks.
Frees memory with g_free()
and returns 0. Handy for callbacks.
See also: vips_malloc()
.
void *s
);
Only use it to free
memory that was previously allocated with vips_tracked_malloc()
with a
-NULL
first argument.
NULL
first argument.
See also: vips_tracked_malloc()
.
size_t size
);
Allocate an area of memory that will be tracked by vips_tracked_get_mem()
and friends.
If allocation fails, vips_malloc()
returns NULL
and
+
If allocation fails, vips_malloc()
returns NULL
and
sets an error message.
You must only free the memory returned with vips_tracked_free()
.
See also: vips_tracked_free()
, vips_malloc()
.
a pointer to the allocated memory, or NULL
on error.
a pointer to the allocated memory, or NULL
on error.
[transfer full]
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
);
Optional arguments:
mblend
-: gint
, maximum blend size
gint
, maximum blend size
This operation joins two images left-right (with ref
on the left) or
up-down (with ref
@@ -223,7 +223,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
This operation joins two images left-right (with ref
on the left) or
@@ -336,7 +336,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
If search
- is TRUE
, before performing the transformation, the tie-points
+ is TRUE
, before performing the transformation, the tie-points
are improved by searching an area of sec
of size harea
for a
@@ -480,7 +480,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Scale, rotate and translate sec
so that the tie-points line up.
If search
- is TRUE
, before performing the transformation, the tie-points
+ is TRUE
, before performing the transformation, the tie-points
are improved by searching an area of sec
of size harea
for a
@@ -595,7 +595,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
gamma
: gamma of source images
int_output
-: TRUE
for integer image output
TRUE
for integer image output
vips_globalbalance() can be used to remove contrast differences in an assembled mosaic.
@@ -667,7 +667,7 @@...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
gboolean +gboolean vips_rect_isempty (const VipsRect *r
);Is
@@ -220,14 +220,14 @@r
empty? ie. zero width or height.
gboolean +gboolean vips_rect_includespoint (@@ -264,7 +264,7 @@const VipsRect *r
,int x
,int y
);
TRUE
if r
+
TRUE
if r
contains (x
, y
).
gboolean +gboolean vips_rect_includesrect (const VipsRect *r1
,const VipsRect *r2
);Is
r2
@@ -304,7 +304,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
kernel
: VipsKernel to use to interpolate (default: lanczos3)
centre
-: gboolean
use centre rather than corner sampling convention
gboolean
use centre rather than corner sampling convention
Reduce in
by a pair of factors with a pair of 1D kernels. This
@@ -440,7 +440,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
kernel
: VipsKernel to use to interpolate (default: lanczos3)
centre
-: gboolean
use centre rather than corner sampling convention
gboolean
use centre rather than corner sampling convention
Reduce in
horizontally by a float factor. The pixels in out
@@ -506,7 +506,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
kernel
: VipsKernel to use to interpolate (default: lanczos3)
centre
-: gboolean
use centre rather than corner sampling convention
gboolean
use centre rather than corner sampling convention
Reduce in
vertically by a float factor. The pixels in out
@@ -572,7 +572,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
height
-: gint
, target height in pixels
gint
, target height in pixels
size
: VipsSize, upsize, downsize, both or force
auto_rotate
-: gboolean
, rotate upright using orientation tag
gboolean
, rotate upright using orientation tag
crop
: VipsInteresting, shrink and crop to fill target
linear
-: gboolean
, perform shrink in linear light
gboolean
, perform shrink in linear light
import_profile
-: gchararray
, fallback import ICC profile
gchararray
, fallback import ICC profile
export_profile
-: gchararray
, export ICC profile
gchararray
, export ICC profile
intent
: VipsIntent, rendering intent
Normally any orientation tags on the input image (such as EXIF tags) are
interpreted to rotate the image upright. If you set auto_rotate
- to FALSE
,
+ to FALSE
,
these tags will not be interpreted.
Shrinking is normally done in sRGB colourspace. Set linear
to shrink in
@@ -685,7 +685,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
height
-: gint
, target height in pixels
gint
, target height in pixels
size
: VipsSize, upsize, downsize, both or force
auto_rotate
-: gboolean
, rotate upright using orientation tag
gboolean
, rotate upright using orientation tag
crop
: VipsInteresting, shrink and crop to fill target
linear
-: gboolean
, perform shrink in linear light
gboolean
, perform shrink in linear light
import_profile
-: gchararray
, fallback import ICC profile
gchararray
, fallback import ICC profile
export_profile
-: gchararray
, export ICC profile
gchararray
, export ICC profile
intent
: VipsIntent, rendering intent
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
height
-: gint
, target height in pixels
gint
, target height in pixels
size
: VipsSize, upsize, downsize, both or force
auto_rotate
-: gboolean
, rotate upright using orientation tag
gboolean
, rotate upright using orientation tag
crop
: VipsInteresting, shrink and crop to fill target
linear
-: gboolean
, perform shrink in linear light
gboolean
, perform shrink in linear light
import_profile
-: gchararray
, fallback import ICC profile
gchararray
, fallback import ICC profile
export_profile
-: gchararray
, export ICC profile
gchararray
, export ICC profile
intent
: VipsIntent, rendering intent
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
scale
-: gdouble
, scale by this factor
gdouble
, scale by this factor
angle
-: gdouble
, rotate by this many degrees clockwise
gdouble
, rotate by this many degrees clockwise
interpolate
: VipsInterpolate, interpolate pixels with this
idx
-: gdouble
, input horizontal offset
gdouble
, input horizontal offset
idy
-: gdouble
, input vertical offset
gdouble
, input vertical offset
odx
-: gdouble
, output horizontal offset
gdouble
, output horizontal offset
ody
-: gdouble
, output vertical offset
gdouble
, output vertical offset
ody
-: gdouble
, output vertical offset
gdouble
, output vertical offset
background
: VipsArrayDouble colour for new pixels
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
oarea
: VipsArrayInt, output rectangle
idx
-: gdouble
, input horizontal offset
gdouble
, input horizontal offset
idy
-: gdouble
, input vertical offset
gdouble
, input vertical offset
odx
-: gdouble
, output horizontal offset
gdouble
, output horizontal offset
ody
-: gdouble
, output vertical offset
gdouble
, output vertical offset
extend
: VipsExtend how to generate new pixels
background
@@ -1024,7 +1024,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
Optional arguments:
vscale
-: gdouble
vertical scale factor
gdouble
vertical scale factor
kernel
: VipsKernel to reduce with
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
A selection of GType
defintions used by VIPS.
A selection of GType
defintions used by VIPS.
VipsCallbackFn free_fn
,
void *data
);
A VipsArea wraps a chunk of memory. It adds reference counting and a free
-function. It also keeps a count and a GType
, so the area can be an array.
GType
, so the area can be an array.
This type is used for things like passing an array of double or an array of VipsObject pointers to operations, and for reference-counted immutable strings.
@@ -435,10 +435,10 @@VipsArea * -vips_area_new_array (-GType type
, +vips_area_new_array (GType type
,size_t sizeof_type
,int n
);
An area which holds an array of elements of some GType
. To set values for
+
An area which holds an array of elements of some GType
. To set values for
the elements, get the pointer and write.
See also: vips_area_unref()
.
type
GType
of elements to store
GType
of elements to store
VipsArea *
vips_area_new_array_object (int n
);
-An area which holds an array of GObject
s. See vips_area_new_array()
. When
-the area is freed, each GObject
will be unreffed.
An area which holds an array of GObject
s. See vips_area_new_array()
. When
+the area is freed, each GObject
will be unreffed.
Add an extra NULL element at the end, handy for eg.
vips_image_pipeline_array()
etc.
See also: vips_area_unref()
.
VipsArea *area
,
size_t *length
,
int *n
,
- GType *type
,
+ GType *type
,
size_t *sizeof_type
);
Return the data pointer plus optionally the length in bytes of an area,
-the number of elements, the GType
of each element and the sizeof()
each
+the number of elements, the GType
of each element and the sizeof()
each
element.
[method]
void -vips_value_set_area (GValue *value
, +vips_value_set_area (GValue *value
,VipsCallbackFn free_fn
,void *data
);
Set value to be a ref-counted area of memory with a free function.
@@ -1024,7 +1024,7 @@void * -vips_value_get_area (const GValue *value
, +vips_value_get_area (const GValue *value
,size_t *length
);
Get the pointer from an area. Don't touch count (area is static).
const char *
-vips_value_get_save_string (const GValue *value
);
+vips_value_get_save_string (const GValue *value
);
Get the C string held internally by the GValue.
void -vips_value_set_save_string (GValue *value
, +vips_value_set_save_string (GValue *value
,const char *str
);
Copies the C string into value
.
void -vips_value_set_save_stringf (GValue *value
, +vips_value_set_save_stringf (GValue *value
,const char *fmt
,...
);
Generates a string and copies it into value
@@ -1159,9 +1159,9 @@
const char * -vips_value_get_ref_string (-const GValue *value
, +vips_value_get_ref_string (const GValue *value
,size_t *length
);
Get the C string held internally by the GValue
.
Get the C string held internally by the GValue
.
value |
-
|
+
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
[out] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
[out] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
[out] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
[out] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
value |
-
|
+
|
[out] | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-gboolean +gboolean | vips_slist_equal () @@ -297,7 +297,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-GSList * +GSList * | vips_slist_filter () @@ -345,7 +345,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-gboolean +gboolean | vips_ispostfix () @@ -353,7 +353,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-gboolean +gboolean | vips_iscasepostfix () @@ -361,7 +361,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-gboolean +gboolean | vips_isprefix () @@ -409,7 +409,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-gint64 +gint64 | vips_file_length () @@ -505,7 +505,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-GValue * +GValue * | vips__gvalue_ref_string_new () @@ -521,7 +521,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-GSList * +GSList * | vips__gslist_gvalue_copy () @@ -529,7 +529,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-GSList * +GSList * | vips__gslist_gvalue_merge () @@ -691,7 +691,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-guint32 +guint32 | vips__random () @@ -699,7 +699,7 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-guint32 +guint32 |
vips__random_add ()
@@ -930,14 +930,14 @@
vips_enum_string ()const char * -vips_enum_string ( @@ -945,7 +945,7 @@ vips_enum_from_nick ()int vips_enum_from_nick ( @@ -953,21 +953,21 @@ vips_flags_from_nick ()int vips_flags_from_nick ( vips_slist_equal ()-gboolean -vips_slist_equal (+ gboolean +vips_slist_equal ( vips_slist_map2 ()void * -vips_slist_map2 (@@ -976,7 +976,7 @@ vips_slist_map2_rev ()void * -vips_slist_map2_rev (@@ -985,7 +985,7 @@ vips_slist_map4 ()void * -vips_slist_map4 ( |
void vips_image_set_progress (+VipsImage *image
, -gboolean progress
);
gboolean progress
);
vips signals evaluation progress via the “preeval”, “eval” and “posteval” signals. Progress is signalled on the most-downstream image for which @@ -1373,7 +1373,7 @@
[constructor]
[constructor]
[constructor]
Set memory
- to TRUE
to force loading via memory. The default is to load
+ to TRUE
to force loading via memory. The default is to load
large random access images via temporary disc files. See
vips_image_new_temp_file()
for an
explanation of how VIPS selects a location for the temporary file.
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
int xsize
,
int ysize
,
int bands
,
- guint64 offset
);
+ guint64 offset
);
This function maps the named file and returns a VipsImage you can use to read it.
It returns an 8-bit image with bands
@@ -1607,7 +1607,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
void vips_image_set_delete_on_close (+VipsImage *image
, -gboolean delete_on_close
);
gboolean delete_on_close
);
Sets the delete_on_close flag for the image. If this flag is set, when
image
is finalized, the filename held in image->filename
@@ -2124,7 +2124,7 @@
guint64 +guint64 vips_get_disc_threshold (void
);Return the number of bytes at which we flip between open via memory and open via disc. This defaults to 100mb, but can be changed with the @@ -2148,7 +2148,7 @@ environment variable TMPDIR. If this is not set, then on Unix systems, vips will default to /tmp. On Windows, vips uses
-GetTempPath()
to find the temporary directory.vips uses
g_mkstemp()
to make the temporary filename. They generally look +vips uses
g_mkstemp()
to make the temporary filename. They generally look something like "vips-12-EJKJFGH.v".See also:
vips_image_new()
.[constructor]
@@ -2169,7 +2169,7 @@
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
...
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named arguments
gboolean +gboolean vips_image_isMSBfirst (-VipsImage *image
);Return
TRUE
ifimage
+Return
@@ -2513,9 +2513,9 @@TRUE
ifimage
is in most-significant- byte first form. This is the byte order used on the SPARC architecture and others.
vips_image_isfile ()
-gboolean +gboolean vips_image_isfile (-VipsImage *image
);Return
TRUE
ifimage
+Return
TRUE
ifimage
represents a file on disc in some way.[method]
@@ -2537,9 +2537,9 @@@@ -689,7 +689,7 @@
diff -Nru vips-8.6.4/doc/html/VipsObject.html vips-8.6.5/doc/html/VipsObject.html --- vips-8.6.4/doc/html/VipsObject.html 2018-06-13 15:35:15.000000000 +0000 +++ vips-8.6.5/doc/html/VipsObject.html 2018-07-25 10:11:02.000000000 +0000 @@ -166,7 +166,7 @@vips_image_ispartial ()
-gboolean +gboolean vips_image_ispartial (-VipsImage *image
);Return
TRUE
ifim
+Return
TRUE
ifim
represents a partial image (a delayed calculation).[method]
@@ -2561,12 +2561,12 @@
@@ -2833,9 +2833,9 @@vips_image_hasalpha ()
-gboolean +gboolean vips_image_hasalpha (VipsImage *image
);libvips assumes an image has an alpha if it has two bands (ie. it is a monochrome image with an extra band), if it has four bands (unless it's been tagged as CMYK), or if it has more than four bands.
-Return
TRUE
ifimage
+Return
TRUE
ifimage
has an alpha channel.[method]
@@ -2617,7 +2617,7 @@
vips_band_format_isint ()
-gboolean +gboolean vips_band_format_isint (-VipsBandFormat format
);Return
TRUE
ifformat
+Return
TRUE
ifformat
is one of the integer types.-Parameters
@@ -2856,9 +2856,9 @@
vips_band_format_isuint ()
-gboolean +gboolean vips_band_format_isuint (-VipsBandFormat format
);Return
TRUE
ifformat
+Return
TRUE
ifformat
is one of the unsigned integer types.-Parameters
@@ -2879,9 +2879,9 @@
vips_band_format_is8bit ()
-gboolean +gboolean vips_band_format_is8bit (-VipsBandFormat format
);Return
TRUE
ifformat
+Return
TRUE
ifformat
is uchar or schar.-Parameters
@@ -2902,9 +2902,9 @@
vips_band_format_isfloat ()
-gboolean +gboolean vips_band_format_isfloat (-VipsBandFormat format
);Return
TRUE
ifformat
+Return
TRUE
ifformat
is one of the float types.-Parameters
@@ -2925,9 +2925,9 @@
vips_band_format_iscomplex ()
-gboolean +gboolean vips_band_format_iscomplex (-VipsBandFormat format
);Return
TRUE
iffmt
+Return
TRUE
iffmt
is one of the complex types.-Parameters
@@ -3050,7 +3050,7 @@@@ -3254,7 +3254,7 @@ - ...
+
NULL
-terminated list of optional named arguments
NULL
-terminated list of optional named argumentsvips_value_get_array_image ()
VipsImage ** -vips_value_get_array_image (const GValue *value
, +vips_value_get_array_image (const GValue *value
,int *n
);Return the start of the array of images held by
value
. @@ -3272,7 +3272,7 @@- value
+
GValue
to get from
GValue
to get from@@ -3293,7 +3293,7 @@ -vips_value_set_array_image ()
void -vips_value_set_array_image (GValue *value
, +vips_value_set_array_image (GValue *value
,int n
);Set
value
to hold an array of images. Pass in the array length inn
@@ -3310,7 +3310,7 @@- value
+
GValue
to get from.
GValue
to get from.[out] @@ -3966,12 +3966,12 @@ - + gint64
tpels
;Number of pels we expect to calculate
- @@ -3981,7 +3981,7 @@+ gint64
npels
;Number of pels calculated so far
- @@ -3994,7 +3994,7 @@+ GTimer *
start
;Start time
Property Details
The
-“bands”
property“bands” gint
+“bands” gintNumber of bands in image.
Flags: Read / Write
Allowed values: [1,10000000]
@@ -4019,7 +4019,7 @@
The
-“filename”
property“filename” gchar *
+“filename” gchar *Image filename.
Flags: Read / Write
Default value: NULL
@@ -4027,7 +4027,7 @@
@@ -4042,7 +4042,7 @@The
-“foreign-buffer”
property“foreign-buffer” gpointer
+“foreign-buffer” gpointerPointer to foreign pixels.
Flags: Read / Write
The
-“height”
property“height” gint
+“height” gintImage height in pixels.
Flags: Read / Write
Allowed values: [1,10000000]
@@ -4059,7 +4059,7 @@
The
-“kill”
property“kill” gboolean
+“kill” gbooleanBlock evaluation on this image.
Flags: Read / Write
Default value: FALSE
@@ -4067,7 +4067,7 @@
The
-“mode”
property“mode” gchar *
+“mode” gchar *Open mode.
Flags: Read / Write
Default value: "p"
@@ -4075,7 +4075,7 @@
The
-“sizeof-header”
property“sizeof-header” guint64
+“sizeof-header” guint64Offset in bytes from start of file.
Flags: Read / Write
Allowed values: <= 1000000000
@@ -4084,7 +4084,7 @@
The
-“width”
property“width” gint
+“width” gintImage width in pixels.
Flags: Read / Write
Allowed values: [1,10000000]
@@ -4093,7 +4093,7 @@
The
-“xoffset”
property“xoffset” gint
+“xoffset” gintHorizontal offset of origin.
Flags: Read / Write
Allowed values: [-10000000,10000000]
@@ -4102,7 +4102,7 @@
The
-“xres”
property“xres” gdouble
+“xres” gdoubleHorizontal resolution in pixels/mm.
Flags: Read / Write
Allowed values: [-0,1e+06]
@@ -4111,7 +4111,7 @@
The
-“yoffset”
property“yoffset” gint
+“yoffset” gintVertical offset of origin.
Flags: Read / Write
Allowed values: [-10000000,10000000]
@@ -4120,7 +4120,7 @@
The
-“yres”
property“yres” gdouble
+“yres” gdoubleVertical resolution in pixels/mm.
Flags: Read / Write
Allowed values: [-0,1e+06]
@@ -4133,8 +4133,8 @@The
“eval”
signalvoid user_function (VipsImage *image, - gpointer progress, - gpointer user_data)+ gpointer progress, + gpointer user_data)The ::eval signal is emitted once per work unit (typically a 128 x 128 area of pixels) during image computation.
You can use this signal to update user-interfaces with progress @@ -4169,14 +4169,14 @@
Flags: Run Last
+Flags: Run Last
The
“invalidate”
signalvoid user_function (VipsImage *image, - gpointer user_data)+ gpointer user_data)The ::invalidate signal is emitted when an image or one of it's upstream data sources has been destructively modified. See
@@ -4202,14 +4202,14 @@vips_image_invalidate_all()
.Flags: Action
+Flags: Action
Flags: Action
+Flags: Action
Flags: Run Last
+Flags: Run Last
Flags: Run Last
+Flags: Run Last
Flags: Action
+Flags: Action
diff -Nru vips-8.6.4/doc/html/VipsInterpolate.html vips-8.6.5/doc/html/VipsInterpolate.html --- vips-8.6.4/doc/html/VipsInterpolate.html 2018-06-13 15:35:15.000000000 +0000 +++ vips-8.6.5/doc/html/VipsInterpolate.html 2018-07-25 10:11:02.000000000 +0000 @@ -147,7 +147,7 @@Object Hierarchy
-GObject +GObject ╰── VipsObject ╰── VipsInterpolate@@ -386,7 +386,7 @@VipsInterpolate * vips_interpolate_new (const char *nickname
);Look up an interpolator from a nickname and make one. You need to free the -result with
+result withg_object_unref()
when you're done with it.g_object_unref()
when you're done with it.See also:
vips_type_find()
.[constructor]
@@ -406,7 +406,7 @@-gboolean +gboolean vips_argument_class_needsstring () @@ -182,7 +182,7 @@ -gboolean +gboolean vips_object_argument_isset () @@ -224,7 +224,7 @@ -gboolean +gboolean vips_value_is_null () @@ -320,7 +320,7 @@ -gboolean +gboolean vips_object_sanity () @@ -344,7 +344,7 @@ -gboolean +gboolean vips_object_argument_needsstring () @@ -480,7 +480,7 @@ -GType +GType vips_type_find () @@ -591,13 +591,13 @@ -gchar * +gchar *description Read / Write @@ -616,22 +616,22 @@ -gchar * +gchar *nickname Read / Write void close -Run Last +Run Last - gint +gint postbuild -Run Last +Run Last void postclose -Run Last +Run Last void preclose -Run Last +Run Last Object Hierarchy
-GObject +GObject ╰── VipsObject ├── VipsOperation ├── VipsImage @@ -721,7 +721,7 @@VipsObject s have a strictly defined lifecycle, split broadly as construct and then use. In detail, the stages are:
-
g_object_new(). The VipsObject is created with
g_object_new()
. Objects +g_object_new(). The VipsObject is created with
g_object_new()
. Objects in this state are blank slates and need to have their various parameters set.g_object_set(). You loop over the VipsArgument that the object has @@ -770,7 +770,7 @@
@@ -778,10 +778,10 @@VipsArgument
libvips has a simple mechanism for automating at least some aspects of -
GObject
properties. You add a set of macros to your_class_init()
which +GObject
properties. You add a set of macros to your_class_init()
which describe the arguments, and set the get and set functions to the vips ones.See extending for a complete example.
The VipsObject reference counting convention
VipsObject has a set of conventions to simplify reference counting.
-
All input
GObject
have a ref added to them, owned by the object. When a +- -
All input
GObject
have a ref added to them, owned by the object. When a VipsObject is unreffed, all of these refs to input objects are automatically dropped.All output
GObject
hold a ref to the object. When aGObject
which is an +- @@ -863,16 +863,16 @@
All output
GObject
hold a ref to the object. When aGObject
which is an output of a VipsObject is disposed, it must drop this reference. VipsObject which are outputs of other VipsObject will do this automatically.vips__object_set_member ()
void vips__object_set_member (+VipsObject *object
, -GParamSpec *pspec
, -GObject **member
, -GObject *argument
);GParamSpec *pspec
, +GObject **member
, +GObject *argument
);
@@ -935,7 +935,7 @@VipsArgumentMapFn ()
void * (*VipsArgumentMapFn) (VipsObject *object
, -GParamSpec *pspec
, +GParamSpec *pspec
,VipsArgumentClass *argument_class
,VipsArgumentInstance *argument_instance
,void *a
, @@ -887,7 +887,7 @@void *a
,void *b
);Loop over the vips_arguments to an object. Stop when
fn
- returns non-NULL
+ returns non-NULL
and return that value.[skip]
@@ -924,9 +924,9 @@VipsArgumentClassMapFn ()
void * (*VipsArgumentClassMapFn) (@@ -954,7 +954,7 @@VipsObjectClass *object_class
, -GParamSpec *pspec
, +GParamSpec *pspec
,VipsArgumentClass *argument_class
,void *a
,void *b
);
vips_argument_class_needsstring ()
-gboolean +gboolean vips_argument_class_needsstring (VipsArgumentClass *argument_class
);
@@ -963,7 +963,7 @@int vips_object_get_argument (VipsObject *object
,const char *name
, -GParamSpec **pspec
, +GParamSpec **pspec
,VipsArgumentClass **argument_class
,VipsArgumentInstance **argument_instance
);Look up the three things you need to work with a vips argument.
@@ -1013,7 +1013,7 @@
vips_object_argument_isset ()
-gboolean +gboolean vips_object_argument_isset (VipsObject *object
,const char *name
);Convenience: has an argument been assigned. Useful for bindings.
@@ -1041,7 +1041,7 @@
@@ -1130,27 +1130,27 @@
vips_value_is_null ()
-gboolean -vips_value_is_null (+GParamSpec *psoec
, -const GValue *value
);gboolean +vips_value_is_null (GParamSpec *psoec
, +const GValue *value
);
vips_object_set_property ()
void -vips_object_set_property (+vips_object_set_property (GObject *gobject
, -guint property_id
, -const GValue *value
, -GParamSpec *pspec
);GObject *gobject
, +guint property_id
, +const GValue *value
, +GParamSpec *pspec
);
vips_object_get_property ()
void -vips_object_get_property (+vips_object_get_property (GObject *gobject
, -guint property_id
, -GValue *value
, -GParamSpec *pspec
);GObject *gobject
, +guint property_id
, +GValue *value
, +GParamSpec *pspec
);
@@ -1284,7 +1284,7 @@
@@ -1292,10 +1292,10 @@vips_object_class_install_argument ()
void vips_object_class_install_argument (+VipsObjectClass *cls
, -GParamSpec *pspec
, +GParamSpec *pspec
,VipsArgumentFlags flags
,int priority
, -guint offset
);guint offset
);
@@ -1308,7 +1308,7 @@
@@ -1339,7 +1339,7 @@vips_object_argument_needsstring ()
-gboolean +gboolean vips_object_argument_needsstring (VipsObject *object
,const char *name
);@@ -1601,14 +1601,14 @@vips_object_new ()
VipsObject * -vips_object_new (@@ -1407,7 +1407,7 @@GType type
, +vips_object_new (GType type
,VipsObjectSetArguments set
,void *a
,void *b
);@@ -1462,7 +1462,7 @@ - ap
+
NULL
-terminated list of argument/value pairs
NULL
-terminated list of argument/value pairs@@ -1560,7 +1560,7 @@ - ...
+
NULL
-terminated list of argument/value pairs
NULL
-terminated list of argument/value pairsvoid *b
);Call a function for all alive objects. Stop when
+ returns non-fn
- returns non-NULL
and return that value.NULL
and return that value.[skip]
@@ -1623,12 +1623,12 @@VipsTypeMap2Fn ()
void * -(*VipsTypeMap2Fn) (GType type
, +(*VipsTypeMap2Fn) (GType type
,void *a
,void *b
);@@ -1675,12 +1675,12 @@vips_type_map ()
void * -vips_type_map (GType base
, +vips_type_map (GType base
,VipsTypeMap2Fn fn
,void *a
,void *b
);Map over a type's children. Stop when
fn
- returns non-NULL
+ returns non-NULL
and return that value.[skip]
@@ -1665,9 +1665,9 @@@@ -1721,16 +1721,16 @@vips_type_map_all ()
void * -vips_type_map_all (GType base
, +vips_type_map_all (GType base
,VipsTypeMapFn fn
,void *a
);Map over a type's children, direct and indirect. Stop when
+non-fn
returns -non-NULL
and return that value.NULL
and return that value.[skip]
vips_type_find ()
-GType +GType vips_type_find (const char *basename
,const char *nickname
);Search below
basename
-, return theGType
of the class whose name or +, return theGType
of the class whose name ornickname
matches, or 0 for not found. Ifbasename
@@ -1761,15 +1761,15 @@Returns
-the
+GType
of the class, or 0 if the class is not found.the
GType
of the class, or 0 if the class is not found.
-vips_nickname_find ()
const char * -vips_nickname_find (-GType type
);Return the VIPS nickname for a
+vips_nickname_find (GType
. Handy for language bindings.GType type
); +Return the VIPS nickname for a
GType
. Handy for language bindings.Parameters
@@ -1795,14 +1795,14 @@@@ -1780,7 +1780,7 @@
- type
+ GType to search for
GType to search for
@@ -1954,7 +1954,7 @@vips_class_map_all ()
void * -vips_class_map_all (GType type
, +vips_class_map_all (GType type
,VipsClassMapFn fn
,void *a
);Loop over all the subclasses of
+non-type
. Non-abstract classes only. Stop whenfn
returns -non-NULL
and return that value.NULL
and return that value.[skip]
vips_object_local_cb ()
void vips_object_local_cb (+VipsObject *vobject
, -GObject *gobject
);GObject *gobject
);
@@ -1966,7 +1966,7 @@vips_object_set_static ()
void vips_object_set_static (+VipsObject *object
, -gboolean static_object
);gboolean static_object
);
@@ -2233,7 +2233,7 @@Property Details
The
-“description”
property“description” gchar *
+“description” gchar *Class description.
Flags: Read / Write
Default value: ""
@@ -2241,7 +2241,7 @@
-The
-“nickname”
property“nickname” gchar *
+“nickname” gchar *Class nickname.
Flags: Read / Write
Default value: ""
@@ -2253,7 +2253,7 @@The
“close”
signalvoid user_function (VipsObject *object, - gpointer user_data)+ gpointer user_data)The ::close signal is emitted once during object close. The object is dying and may not work.
@@ -2278,14 +2278,14 @@Flags: Run Last
+Flags: Run Last
-The
-“postbuild”
signalgint +gint user_function (VipsObject *object, - gpointer user_data)+ gpointer user_data)The ::postbuild signal is emitted once just after successful object construction. Return non-zero to cause object construction to fail.
@@ -2310,14 +2310,14 @@Flags: Run Last
+Flags: Run Last
The
“postclose”
signalvoid user_function (VipsObject *object, - gpointer user_data)+ gpointer user_data)The ::postclose signal is emitted once after object close. The object pointer is still valid, but nothing else.
@@ -2343,14 +2343,14 @@Flags: Run Last
+Flags: Run Last
-The
“preclose”
signalvoid user_function (VipsObject *object, - gpointer user_data)+ gpointer user_data)The ::preclose signal is emitted once just before object close starts. The oject is still alive.
@@ -2375,7 +2375,7 @@Flags: Run Last
+Flags: Run Last
GObject +@@ -509,7 +509,7 @@GObject ╰── VipsObject ╰── VipsOperation ╰── VipsForeign @@ -445,16 +445,16 @@ VipsImage *t1, *t2; if (vips_invert (im, &t1, NULL)) { - g_object_unref (im); + g_object_unref (im); return -1; } -g_object_unref (im); +g_object_unref (im); if (vips_flip (t1, &t2, VIPS_DIRECTION_HORIZONTAL, NULL)) { - g_object_unref (t1); + g_object_unref (t1); return -1; } -g_object_unref (t1);+g_object_unref (t1);
...
required args, then a NULL
-terminated list of argument/value pairs
required args, then a NULL
-terminated list of argument/value pairs
void -vips_call_options (GOptionGroup *group
, +vips_call_options (GOptionGroup *group
,VipsOperation *operation
);
After calling this, operation
has the same ref count as when it went in,
and the result must be freed with vips_object_unref_outputs()
and
-g_object_unref()
.
g_object_unref()
.
dump |
-if |
+if |
void
-vips_cache_set_trace (gboolean trace
);
+vips_cache_set_trace (gboolean trace
);
Handy for debugging. Print operation cache actions to stdout as we run.
You can set the environment variable VIPS_TRACE
to turn this option on, or
use the command-line flag --vips-cache-trace
.
trace
if TRUE
, trace the operation cache
if TRUE
, trace the operation cache
“invalidate”
signalvoid user_function (VipsOperation *vipsoperation, - gpointer user_data)-
Flags: Run Last
+ gpointer user_data) +Flags: Run Last
GObject +GObject ╰── VipsObject ╰── VipsRegion@@ -222,7 +222,7 @@ other image, or part of some other region.Regions must be created, used and freed all within the same thread, since they can reference private per-thread caches. VIPS sanity-checks region -ownership in various places, so you are likely to see
g_assert()
errors if +ownership in various places, so you are likely to seeg_assert()
errors if you don't follow this rule.There is API to transfer ownership of regions between threads, but hopefully this diff -Nru vips-8.6.4/doc/html/VipsThreadState.html vips-8.6.5/doc/html/VipsThreadState.html --- vips-8.6.4/doc/html/VipsThreadState.html 2018-06-13 15:35:15.000000000 +0000 +++ vips-8.6.5/doc/html/VipsThreadState.html 2018-07-25 10:11:02.000000000 +0000 @@ -119,7 +119,7 @@
GObject +GObject ╰── VipsObject ╰── VipsThreadState@@ -165,7 +165,7 @@int (*VipsThreadpoolAllocateFn) (+VipsThreadState *state
,void *a
, -gboolean *stop
);gboolean *stop
);
This function is called to allocate a new work unit for the thread. It is always single-threaded, so it can modify per-pool state (such as a counter).
@@ -175,7 +175,7 @@ are the values supplied to the call tovips_threadpool_run()
.
It should set stop
- to TRUE
to indicate that no work could be allocated
+ to TRUE
to indicate that no work could be allocated
because the job is done.
See also: vips_threadpool_run()
.
progress
is called, so that the operation can give
progress feedback. progress
- may be NULL
.
+ may be NULL
.
The object returned by start
must be an instance of a subclass of
VipsThreadState. Use this to communicate between allocate
@@ -378,7 +378,7 @@
progress
give progress feedback about a work unit, or NULL
give progress feedback about a work unit, or NULL