hb_blob_create ()

hb_blob_t *
hb_blob_create (const char *data,
                unsigned int length,
                hb_memory_mode_t mode,
                void *user_data,
                hb_destroy_func_t destroy);

Creates a new "blob" object wrapping data . The mode parameter is used to negotiate ownership and lifecycle of data .

[skip]

Since: 0.9.2

hb_blob_create_or_fail ()

hb_blob_t *
hb_blob_create_or_fail (const char *data,
                        unsigned int length,
                        hb_memory_mode_t mode,
                        void *user_data,
                        hb_destroy_func_t destroy);

Creates a new "blob" object wrapping data . The mode parameter is used to negotiate ownership and lifecycle of data .

Note that this function returns a freshly-allocated empty blob even if length is zero. This is in contrast to hb_blob_create(), which returns the singleton empty blob (as returned by hb_blob_get_empty()) if length is zero.

[skip]

Since: 2.8.2

hb_blob_create_from_file ()

hb_blob_t *
hb_blob_create_from_file (const char *file_name);

Creates a new blob containing the data from the specified binary font file.

The filename is passed directly to the system on all platforms, except on Windows, where the filename is interpreted as UTF-8. Only if the filename is not valid UTF-8, it will be interpreted according to the system codepage.

Since: 1.7.7

hb_blob_create_from_file_or_fail ()

hb_blob_t *
hb_blob_create_from_file_or_fail (const char *file_name);

Creates a new blob containing the data from the specified binary font file.

The filename is passed directly to the system on all platforms, except on Windows, where the filename is interpreted as UTF-8. Only if the filename is not valid UTF-8, it will be interpreted according to the system codepage.

Since: 2.8.2

hb_blob_create_sub_blob ()

hb_blob_t *
hb_blob_create_sub_blob (hb_blob_t *parent,
                         unsigned int offset,
                         unsigned int length);

Returns a blob that represents a range of bytes in parent . The new blob is always created with HB_MEMORY_MODE_READONLY, meaning that it will never modify data in the parent blob. The parent data is not expected to be modified, and will result in undefined behavior if it is.

Makes parent immutable.

Since: 0.9.2

hb_blob_copy_writable_or_fail ()

hb_blob_t *
hb_blob_copy_writable_or_fail (hb_blob_t *blob);

Makes a writable copy of blob .

Since: 1.8.0

hb_blob_get_empty ()

hb_blob_t *
hb_blob_get_empty (void);

Returns the singleton empty blob.

See TODO:link object types for more information.

Since: 0.9.2

hb_blob_reference ()

hb_blob_t *
hb_blob_reference (hb_blob_t *blob);

Increases the reference count on blob .

See TODO:link object types for more information.

[skip]

Since: 0.9.2

hb_blob_destroy ()

void
hb_blob_destroy (hb_blob_t *blob);

Decreases the reference count on blob , and if it reaches zero, destroys blob , freeing all memory, possibly calling the destroy-callback the blob was created for if it has not been called already.

See TODO:link object types for more information.

[skip]

Since: 0.9.2

hb_blob_set_user_data ()

hb_bool_t
hb_blob_set_user_data (hb_blob_t *blob,
                       hb_user_data_key_t *key,
                       void *data,
                       hb_destroy_func_t destroy,
                       hb_bool_t replace);

Attaches a user-data key/data pair to the specified blob.

[skip]

Since: 0.9.2

hb_blob_get_user_data ()

void *
hb_blob_get_user_data (const hb_blob_t *blob,
                       hb_user_data_key_t *key);

Fetches the user data associated with the specified key, attached to the specified font-functions structure.

[skip]

Since: 0.9.2

hb_blob_make_immutable ()

void
hb_blob_make_immutable (hb_blob_t *blob);

Makes a blob immutable.

Since: 0.9.2

hb_blob_is_immutable ()

hb_bool_t
hb_blob_is_immutable (hb_blob_t *blob);

Tests whether a blob is immutable.

Since: 0.9.2

hb_blob_get_data ()

const char *
hb_blob_get_data (hb_blob_t *blob,
                  unsigned int *length);

Fetches the data from a blob.

Since: 0.9.2

hb_blob_get_data_writable ()

char *
hb_blob_get_data_writable (hb_blob_t *blob,
                           unsigned int *length);

Tries to make blob data writable (possibly copying it) and return pointer to data.

Fails if blob has been made immutable, or if memory allocation fails.

Since: 0.9.2

hb_blob_get_length ()

unsigned int
hb_blob_get_length (hb_blob_t *blob);

Fetches the length of a blob's data.

Since: 0.9.2

hb_blob_t

typedef struct hb_blob_t hb_blob_t;

Data type for blobs. A blob wraps a chunk of binary data and facilitates its lifecycle management between a client program and HarfBuzz.

enum hb_memory_mode_t

Data type holding the memory modes available to client programs.

Regarding these various memory-modes: