Add the standard vips GOptionEntry
to a GOptionGroup
.
Convenience function — make a NULL
-terminated array of input images. Use with vips_start_many()
.
Set the block state on all untrusted operations.
break_token cache_drop_allDrop the whole operation cache, handy for leak tracking. Also called automatically on vips_shutdown()
.
Get the maximum number of operations we keep in cache.
cache_get_max_filesGet the maximum number of tracked files we allow before we start dropping cached operations. See vips_tracked_get_files()
.
Get the maximum amount of tracked memory we allow before we start dropping cached operations. See vips_tracked_get_mem()
.
Get the current number of operations in cache.
cache_operation_buildA binding-friendly version of vips_cache_operation_buildp()
.
Look up operation
in the cache. If we get a hit, unref operation
, ref the old one and return that through the argument pointer.
Print the whole operation cache to stdout. Handy for debugging.
cache_set_dumpHandy for debugging. Print the operation cache to stdout just before exit.
cache_set_maxSet the maximum number of operations we keep in cache.
cache_set_max_filesSet the maximum number of tracked files we allow before we start dropping cached operations. See vips_tracked_get_files()
.
Set the maximum amount of tracked memory we allow before we start dropping cached operations. See vips_tracked_get_mem()
.
Handy for debugging. Print operation cache actions to stdout as we run.
callvips_call()
calls the named operation, passing in required arguments and then setting any optional ones from the remainder of the arguments as a set of name/value pairs.
This is the main entry point for the C and C++ varargs APIs. operation
is executed, supplying required
and optional
arguments.
Check that the image is 8 or 16-bit integer, signed or unsigned. Otherwise set an error message and return non-zero.
check_bandnobandno
should be a valid band number (ie. 0 to im->Bands - 1), or can be -1, meaning all bands. If not, set an error message and return non-zero.
Check that the image has bands
bands. Otherwise set an error message and return non-zero.
Check that the image has either one or three bands. Otherwise set an error message and return non-zero.
check_bands_1ornCheck that the images have the same number of bands, or that one of the images has just 1 band. If not, set an error message and return non-zero.
check_bands_1orn_unaryCheck that an image has 1 or n
bands. Handy for unary operations, cf. vips_check_bands_1orn()
. If not, set an error message and return non-zero.
Check that the image has at least bands
bands. Otherwise set an error message and return non-zero.
Check that the images have the same number of bands. If not, set an error message and return non-zero.
check_codingCheck that the image has the required coding
. If not, set an error message and return non-zero.
Check that the image is uncoded, LABQ coded or RAD coded. If not, set an error message and return non-zero.
check_coding_noneorlabqCheck that the image is uncoded or LABQ coded. If not, set an error message and return non-zero.
check_coding_sameCheck that the images have the same coding. If not, set an error message and return non-zero.
check_complexCheck that the image is complex. Otherwise set an error message and return non-zero.
check_formatCheck that the image has the specified format. Otherwise set an error message and return non-zero.
check_format_sameCheck that the images have the same format. If not, set an error message and return non-zero.
check_histHistogram images must have width or height 1, and must not have more than 65536 elements. Return 0 if the image will pass as a histogram, or -1 and set an error message otherwise.
check_intCheck that the image is in one of the integer formats. Otherwise set an error message and return non-zero.
check_matrixMatrix images must have width and height less than 100000 and have 1 band.
check_monoCheck that the image has exactly one band. Otherwise set an error message and return non-zero.
check_noncomplexCheck that the image is not complex. Otherwise set an error message and return non-zero.
check_oddsquareCheck that the image is square and that the sides are odd. If not, set an error message and return non-zero.
check_precision_intfloatCheck that prec
image is either float or int. If not, set an error message and return non-zero.
Separable matrix images must have width or height 1. Return 0 if the image will pass, or -1 and set an error message otherwise.
check_size_sameCheck that the images have the same size. If not, set an error message and return non-zero.
check_twocomponentsCheck that the image is has two “components”, ie. is a one-band complex or a two-band non-complex. Otherwise set an error message and return non-zero.
check_u8or16Check that the image is 8 or 16-bit unsigned integer. Otherwise set an error message and return non-zero.
check_u8or16orfCheck that the image is 8 or 16-bit unsigned integer, or float. Otherwise set an error message and return non-zero.
check_uintCheck that the image is in one of the unsigned integer formats. Otherwise set an error message and return non-zero.
check_uintorfCheck that the image is unsigned int or float. Otherwise set an error message and return non-zero.
check_uncodedCheck that the image is not coded. If not, set an error message and return non-zero.
check_vectorOperations with a vector constant need a 1-element vector, or a vector with the same number of elements as there are bands in the image, or a 1-band image and a many-element vector.
check_vector_lengthCheck that n
== len
.
Search below basename
, return the first class whose name or nickname
matches.
Loop over all the subclasses of type
. Non-abstract classes only. Stop when fn
returns non-NULL
and return that value.
Calculate Ccmc from C.
col_Ccmc2CCalculate C from Ccmc using a table. Call vips_col_make_tables_CMC()
at least once before using this function.
Calculate ab from Ch, h in degrees.
col_Ch2hcmcCalculate hcmc from C and h.
col_Chcmc2hCalculate h from C and hcmc, using a table. Call vips_col_make_tables_CMC()
at least once before using this function.
CIEDE2000, from:.
col_L2LcmcCalculate Lcmc from L.
col_Lab2XYZCalculate XYZ from Lab, D65.
col_Lcmc2LCalculate L from Lcmc using a table. Call vips_col_make_tables_CMC()
at least once before using this function.
Make the lookup tables for cmc.
col_scRGB2BW_16 col_scRGB2BW_8 col_scRGB2sRGB_16 col_scRGB2sRGB_8 col_scRGB2XYZTurn scRGB into XYZ.
col_sRGB2scRGB_16 col_sRGB2scRGB_16_noclip col_sRGB2scRGB_8 col_sRGB2scRGB_8_noclip col_XYZ2LabCalculate XYZ from Lab, D65.
col_XYZ2scRGBTurn XYZ into scRGB.
concurrency_getReturns the number of worker threads that vips should use when running vips_threadpool_run()
.
Sets the number of worker threads that vips should use when running vips_threadpool_run()
.
Format the string in the style of printf()
and append to the error buffer.
Get a pointer to the start of the error buffer as a C string. The string is owned by the error system and must not be freed.
error_buffer_copyReturn a copy of the vips error buffer, and clear it.
error_clearClear and reset the error buffer. This is typically called after presenting an error to the user.
error_exitSends a formatted error message to stderr, then sends the contents of the error buffer, if any, then shuts down vips and terminates the program with an error code.
error_freezeStop errors being logged. Use vips_error_thaw()
to unfreeze. You can nest freeze/thaw pairs.
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.
error_systemFormat the string in the style of printf()
and append to the error buffer. Then create and append a localised message based on the system error code, usually the value of errno.
Re-enable error logging.
existsf file_length filename_get_filenameGiven a vips filename like “fred.jpg[Q=90]”, return a new string of just the filename part, “fred.jpg” in this case.
filename_get_optionsGiven a vips filename like “fred.jpg[Q=90]”, return a new string of just the options part, “[Q=90]” in this case.
filename_suffix_match flags_from_nick foreign_flagsReturn the flags for filename
using loader
. loader
is something like “tiffload” or “VipsForeignLoadTiff”.
A fast but dangerous version of vips_format_sizeof()
. You must have previously range-checked format
or you’ll crash.
This function adds the GError
to the vips error buffer and clears it. It’s the opposite of vips_error_g()
.
Create a new GInputStream
wrapping a VipsSource
. This is useful for loaders like SVG and PDF which support GInputStream
methods.
Wrapper for g_thread_try_new()
.
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 VIPS_DISC_THRESHOLD
environment variable or the --vips-disc-threshold
command-line flag. See vips_image_new_from_file()
.
Return the program name.
guess_libdirvips_guess_libdir()
tries to guess the install directory (usually the configure libdir, or $prefix/lib). You should pass in the value of argv[0] (the name your program was run as) as a clue to help it out, plus the name of the environment variable you let the user override your package install area with (eg. “VIPSHOME”).
vips_guess_prefix()
tries to guess the install directory. You should pass in the value of argv[0] (the name your program was run as) as a clue to help it out, plus the name of the environment variable you let the user override your package install area with (eg. “VIPSHOME”).
Like slist map, but for a hash table.
icc_is_compatible_profile icc_presentVIPS can optionally be built without the ICC library. Use this function to test for its availability.
initThis function starts up libvips, see VIPS_INIT()
.
Look up the interpolate
method in the class and call it. Use vips_interpolate_get_method()
to get a direct pointer to the function and avoid the lookup overhead.
Turn on or off vips leak checking. See also --vips-leak
, vips_add_option_entries()
and the VIPS_LEAK
environment variable.
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()
.
Return the maximum coordinate value. This can be the default, a value set set by the --vips-max-coord
CLI arg, or a value set in the VIPS_MAX_COORD
environment variable.
Return the VIPS nickname for a GType
. Handy for language bindings.
If a source does not support mmap or seek and the source is used with a loader that can only work from memory, then the data will be automatically read into memory to EOF before the loader starts. This can produce high memory use if the descriptor represents a large object.
profile_setIf set, vips will record profiling information, and dump it on program exit. These profiles can be analysed with the vipsprofile
program.
Pythagorean distance between two points in colour space. Lab/XYZ/CMC etc.
realpath rename rmdirf shutdownCall this to drop caches, close plugins, terminate background threads, and finalize any internal library testing.
sink_memoryLoops over im
, generating it to a memory buffer attached to im
. It is used by vips to implement writing to a memory buffer.
Test two lists for equality.
slist_filterRemove all occurrences of an item from a list. Returns the new head of the list.
slist_fold2Fold over a slist, applying fn
to each element.
Free a GSList
of things which need g_free()
ing.
Map over a slist. _copy() the list in case the callback changes it.
slist_map2_revMap backwards. We _reverse() rather than recurse and unwind to save stack.
slist_map4Map over a slist. _copy() the list in case the callback changes it.
start_manyStart function for many images in. a
is a pointer to a NULL
-terminated array of input images.
Start function for one image in. Input image is a
.
Stop function for many images in. a
is a pointer to a NULL
-terminated array of input images.
Stop function for one image in. Input image is a
.
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()
.
A newly created or reused thread will execute func
with the argument data
.
Free any thread-private data and flush any profiling information.
threadpool_runThis function runs a set of threads over an image. Each thread first calls start
to create new per-thread state, then runs allocate
to set up a new work unit (perhaps the next tile in an image, for example), then work
to process that work unit. After each unit is processed, progress
is called, so that the operation can give progress feedback. progress
may be NULL
.
Allocate an area of memory aligned on a boundary specified by align
that will be tracked by vips_tracked_get_mem()
and friends.
Only use it to free memory that was previously allocated with vips_tracked_aligned_alloc()
with a NULL
first argument.
Exactly as close()
, but update the number of files currently open via vips_tracked_get_files()
. This is used by the vips operation cache to drop cache when the number of files available is low.
Only use it to free memory that was previously allocated with vips_tracked_malloc()
with a NULL
first argument.
Returns the number of active allocations.
tracked_get_filesReturns the number of open files.
tracked_get_memReturns the number of bytes currently allocated via vips_malloc()
and friends. vips uses this figure to decide when to start dropping cache, see VipsOperation
.
Returns the largest number of bytes simultaneously allocated via vips_tracked_malloc()
. Handy for estimating max memory requirements for a program.
Allocate an area of memory that will be tracked by vips_tracked_get_mem()
and friends.
Exactly as open()
, but the number of files currently open via vips_tracked_open()
is available via vips_tracked_get_files()
. This is used by the vips operation cache to drop cache when the number of files available is low.
Search below basename
, return the GType
of the class whose name or nickname
matches, or 0 for not found. If basename
is NULL
, the whole of VipsObject
is searched.
Map over a type’s children. Stop when fn
returns non-NULL
and return that value.
Map over a type’s children, direct and indirect. Stop when fn
returns non-NULL
and return that value.
Get the pointer from an area. Don’t touch count (area is static).
value_get_arrayReturn the pointer to the array held by value
. Optionally return the other properties of the array in n
, type
, sizeof_type
.
Return the start of the array of doubles held by value
. optionally return the number of elements in n
.
Return the start of the array of images held by value
. optionally return the number of elements in n
.
Return the start of the array of ints held by value
. optionally return the number of elements in n
.
Return the start of the array of GObject
held by value
. Optionally return the number of elements in n
.
Returns the data pointer from a blob. Optionally returns the length too.
value_get_ref_stringGet the C string held internally by the GValue
.
Get the C string held internally by the GValue.
value_is_null value_set_areaSet value to be a ref-counted area of memory with a free function.
value_set_arraySet value
to be an array of things.
Set value
to hold a copy of array
. Pass in the array length in n
.
Set value
to hold an array of images. Pass in the array length in n
.
Set value
to hold a copy of array
. Pass in the array length in n
.
Set value
to hold an array of GObject
. Pass in the array length in n
.
Sets value
to hold a data
. When value
is freed, data
will be freed with free_fn
. value
also holds a note of the size of the memory area.
Just like vips_value_set_blob()
, but when value
is freed, data
will be freed with g_free()
.
Copies the C string str
into value
.
Copies the C string into value
.
Generates a string and copies it into value
.
Takes a bitfield of targets to disable on the runtime platform. Handy for testing and benchmarking purposes.
vector_get_builtin_targetsGets a bitfield of builtin targets that libvips was built with.
vector_get_supported_targetsGets a bitfield of enabled targets that are supported on this CPU. The targets returned may change after calling vips_vector_disable_targets()
.
Generates a human-readable ASCII string descriptor for a specific target.
verrorAppend a message to the error buffer.
verror_systemFormat the string in the style of printf()
and append to the error buffer. Then create and append a localised message based on the system error code, usually the value of errno.
Get the major, minor or micro library version, with flag
values 0, 1 and 2.
Get the VIPS version as a static string, including a build date and time. Do not free.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4