vips_thing_new ()

VipsThing *vips_thing_new (int i);

vips_area_copy ()

VipsArea *vips_area_copy (VipsArea *area);

vips_area_free_cb ()

intvips_area_free_cb (void *mem,VipsArea *area);

vips_area_unref ()

voidvips_area_unref (VipsArea *area);

vips_area_new ()

VipsArea *vips_area_new (VipsCallbackFn free_fn,void *data);

A VipsArea wraps a chunk of memory. It adds reference counting and a freefunction. It also keeps a count and aGType, so the area can be an array.

This type is used for things like passing an array of double or an array ofVipsObject pointers to operations, and for reference-counted immutablestrings.

Initial count == 1, so_unref() after attaching somewhere.

See also:vips_area_unref().

vips_area_new_array ()

VipsArea *vips_area_new_array (GType type,size_t sizeof_type,int n);

An area which holds an array of elements of someGType. To set values forthe elements, get the pointer and write.

See also:vips_area_unref().

vips_area_new_array_object ()

VipsArea *vips_area_new_array_object (int n);

An area which holds an array ofGObject s. Seevips_area_new_array(). Whenthe area is freed, eachGObject will be unreffed.

Add an extra NULL element at the end, handy for eg.vips_image_pipeline_array() etc.

See also:vips_area_unref().

[constructor]

vips_area_get_data ()

void *vips_area_get_data (VipsArea *area,size_t *length,int *n,GType *type,size_t *sizeof_type);

Return the data pointer plus optionally the length in bytes of an area,the number of elements, theGType of each element and thesizeof() eachelement.

VIPS_ARRAY_ADDR()

#define             VIPS_ARRAY_ADDR(X, I)

vips_ref_string_new ()

VipsRefString *vips_ref_string_new (constchar *str);

Create a new refstring. These are reference-counted immutable strings, usedto store string data in vips image metadata.

Strings must be valid utf-8; use blob for binary data.

See also:vips_area_unref().

vips_ref_string_get ()

constchar *vips_ref_string_get (VipsRefString *refstr,size_t *length);

Get a pointer to the private string inside a refstr. Handy for languagebindings.

See also:vips_value_get_ref_string().

vips_blob_new ()

VipsBlob *vips_blob_new (VipsCallbackFn free_fn,constvoid *data,size_t length);

Likevips_area_new(), but track a length as well. The returnedVipsBlobtakes ownership ofdata and will free it withfree_fn. PassNULL forfree_fn to not transfer ownership.

An area of mem with a free func and a length (some sort of binary object,like an ICC profile).

See also:vips_area_unref().

vips_blob_copy ()

VipsBlob *vips_blob_copy (constvoid *data,size_t length);

Likevips_blob_new(), but take a copy of the data. Useful for bindingswhich struggle with callbacks.

See also:vips_blob_new().

vips_blob_get ()

constvoid *vips_blob_get (VipsBlob *blob,size_t *length);

Get the data from aVipsBlob.

See also:vips_blob_new().

vips_blob_set ()

voidvips_blob_set (VipsBlob *blob,VipsCallbackFn free_fn,constvoid *data,size_t length);

Any old data is freed and new data attached.

It's sometimes useful to be able to create blobs as empty and then fillthem later.

See also:vips_blob_new().

vips_array_double_new ()

VipsArrayDouble *vips_array_double_new (constdouble *array,int n);

Allocate a new array of doubles and copyarray into it. Free withvips_area_unref().

See also:VipsArea.

vips_array_double_newv ()

VipsArrayDouble *vips_array_double_newv (int n,...);

Allocate a new array ofn doubles and copy @... into it. Free withvips_area_unref().

See also:vips_array_double_new()

vips_array_double_get ()

double *vips_array_double_get (VipsArrayDouble *array,int *n);

Fetch a double array from aVipsArrayDouble. Useful for language bindings.

vips_array_int_new ()

VipsArrayInt *vips_array_int_new (constint *array,int n);

Allocate a new array of ints and copyarray into it. Free withvips_area_unref().

See also:VipsArea.

vips_array_int_newv ()

VipsArrayInt *vips_array_int_newv (int n,...);

Allocate a new array ofn ints and copy @... into it. Free withvips_area_unref().

See also:vips_array_int_new()

vips_array_int_get ()

int *vips_array_int_get (VipsArrayInt *array,int *n);

Fetch an int array from aVipsArrayInt. Useful for language bindings.

vips_value_set_area ()

voidvips_value_set_area (GValue *value,VipsCallbackFn free_fn,void *data);

Set value to be a ref-counted area of memory with a free function.

vips_value_get_area ()

void *vips_value_get_area (constGValue *value,size_t *length);

Get the pointer from an area. Don't touch count (area is static).

vips_value_get_save_string ()

constchar *vips_value_get_save_string (constGValue *value);

Get the C string held internally by the GValue.

vips_value_set_save_string ()

voidvips_value_set_save_string (GValue *value,constchar *str);

Copies the C string intovalue.

str should be a valid utf-8 string.

vips_value_set_save_stringf ()

voidvips_value_set_save_stringf (GValue *value,constchar *fmt,...);

Generates a string and copies it intovalue.

vips_value_get_ref_string ()

constchar *vips_value_get_ref_string (constGValue *value,size_t *length);

Get the C string held internally by theGValue.

vips_value_set_ref_string ()

voidvips_value_set_ref_string (GValue *value,constchar *str);

Copies the C stringstr intovalue.

vips_ref_string are immutable C strings that are copied between images bycopying reference-counted pointers, making them much more efficient thanregularGValue strings.

str should be a valid utf-8 string.

vips_value_get_blob ()

void *vips_value_get_blob (constGValue *value,size_t *length);

Returns the data pointer from a blob. Optionally returns the length too.

blobs are things like ICC profiles or EXIF data. They are relocatable, andare saved to VIPS files for you coded as base64 inside the XML. They arecopied by copying reference-counted pointers.

See also:vips_value_set_blob()

vips_value_set_blob ()

voidvips_value_set_blob (GValue *value,VipsCallbackFn free_fn,constvoid *data,size_t length);

Setsvalue to hold adata. Whenvalue is freed,data will befreed withfree_fn.value also holds a note of the size of the memoryarea.

blobs are things like ICC profiles or EXIF data. They are relocatable, andare saved to VIPS files for you coded as base64 inside the XML. They arecopied by copying reference-counted pointers.

See also:vips_value_get_blob()

vips_value_set_blob_free ()

voidvips_value_set_blob_free (GValue *value,void *data,size_t length);

Just likevips_value_set_blob(), but whenvalue is freed,data will befreed withg_free().

This can be easier to call for language bindings.

See also:vips_value_set_blob()

vips_value_set_array ()

voidvips_value_set_array (GValue *value,int n,GType type,size_t sizeof_type);

Setvalue to be an array of things.

This allocates memory but does notinitialise the contents: get the pointer and write instead.

vips_value_get_array ()

void *vips_value_get_array (constGValue *value,int *n,GType *type,size_t *sizeof_type);

Return the pointer to the array held byvalue.Optionally return the other properties of the array inn,type,sizeof_type.

See also:vips_value_set_array().

vips_value_get_array_double ()

double *vips_value_get_array_double (constGValue *value,int *n);

Return the start of the array of doubles held byvalue.optionally return the number of elements inn.

See also:vips_array_double_new().

vips_value_set_array_double ()

voidvips_value_set_array_double (GValue *value,constdouble *array,int n);

Setvalue to hold a copy ofarray. Pass in the array length inn.

See also:vips_array_double_get().

vips_value_get_array_int ()

int *vips_value_get_array_int (constGValue *value,int *n);

Return the start of the array of ints held byvalue.optionally return the number of elements inn.

See also:vips_array_int_new().

vips_value_set_array_int ()

voidvips_value_set_array_int (GValue *value,constint *array,int n);

Setvalue to hold a copy ofarray. Pass in the array length inn.

See also:vips_array_int_get().

vips_value_get_array_object ()

GObject **vips_value_get_array_object (constGValue *value,int *n);

Return the start of the array ofGObject held byvalue.Optionally return the number of elements inn.

See also:vips_area_new_array_object().

[skip]

vips_value_set_array_object ()

voidvips_value_set_array_object (GValue *value,int n);

Setvalue to hold an array ofGObject. Pass in the array length inn.

See also:vips_value_get_array_object().