|
int | heif_context_get_number_of_items (const struct heif_context *ctx) |
| Gets the number of items. More...
|
|
LIBHEIF_API int | heif_context_get_list_of_item_IDs (const struct heif_context *ctx, heif_item_id *ID_array, int count) |
| Get the item identifiers. More...
|
|
LIBHEIF_API uint32_t | heif_item_get_item_type (const struct heif_context *ctx, heif_item_id item_id) |
| Gets the item type. More...
|
|
LIBHEIF_API int | heif_item_is_item_hidden (const struct heif_context *ctx, heif_item_id item_id) |
|
LIBHEIF_API const char * | heif_item_get_mime_item_content_type (const struct heif_context *ctx, heif_item_id item_id) |
| Gets the MIME content_type for an item. More...
|
|
LIBHEIF_API const char * | heif_item_get_mime_item_content_encoding (const struct heif_context *ctx, heif_item_id item_id) |
| Gets the content_encoding for a MIME item. More...
|
|
LIBHEIF_API const char * | heif_item_get_uri_item_uri_type (const struct heif_context *ctx, heif_item_id item_id) |
| Gets the item_uri_type for an item. More...
|
|
LIBHEIF_API const char * | heif_item_get_item_name (const struct heif_context *ctx, heif_item_id item_id) |
|
LIBHEIF_API struct heif_error | heif_item_set_item_name (struct heif_context *ctx, heif_item_id item, const char *item_name) |
|
LIBHEIF_API struct heif_error | heif_item_get_item_data (const struct heif_context *ctx, heif_item_id item_id, enum heif_metadata_compression *out_compression_format, uint8_t **out_data, size_t *out_data_size) |
| Gets the raw metadata, as stored in the HEIF file. More...
|
|
LIBHEIF_API void | heif_release_item_data (const struct heif_context *ctx, uint8_t **item_data) |
| Free the item data. More...
|
|
LIBHEIF_API size_t | heif_context_get_item_references (const struct heif_context *ctx, heif_item_id from_item_id, int index, uint32_t *out_reference_type_4cc, heif_item_id **out_references_to) |
| Get the item ids that reference the given item. More...
|
|
LIBHEIF_API void | heif_release_item_references (const struct heif_context *ctx, heif_item_id **references) |
|
LIBHEIF_API struct heif_error | heif_context_add_item_reference (struct heif_context *ctx, uint32_t reference_type, heif_item_id from_item, heif_item_id to_item) |
|
LIBHEIF_API struct heif_error | heif_context_add_item_references (struct heif_context *ctx, uint32_t reference_type, heif_item_id from_item, const heif_item_id *to_item, int num_to_items) |
|
LIBHEIF_API struct heif_error | heif_context_add_item (struct heif_context *ctx, const char *item_type, const void *data, int size, heif_item_id *out_item_id) |
|
LIBHEIF_API struct heif_error | heif_context_add_mime_item (struct heif_context *ctx, const char *content_type, enum heif_metadata_compression content_encoding, const void *data, int size, heif_item_id *out_item_id) |
|
LIBHEIF_API struct heif_error | heif_context_add_precompressed_mime_item (struct heif_context *ctx, const char *content_type, const char *content_encoding, const void *data, int size, heif_item_id *out_item_id) |
|
LIBHEIF_API struct heif_error | heif_context_add_uri_item (struct heif_context *ctx, const char *item_uri_type, const void *data, int size, heif_item_id *out_item_id) |
|
Gets the raw metadata, as stored in the HEIF file.
Data in a "mime" item with "content_encoding" can be compressed. When out_compression_format
is NULL, the decompressed data will be returned. Otherwise, the compressed data is returned and out_compression_format
will be filled with the compression format. If the compression method is not supported, an error will be returned.
It is valid to set out_data
to NULL. In that case, only the out_data_size
is filled. Note that it is inefficient to use out_data=NULL
just to get the size of compressed data. In general, this should be avoided.
If there is no data assigned to the item or there is an error, out_data_size
is set to zero.
- Parameters
-
ctx | the file context |
item_id | the item identifier for the item |
out_compression_format | how the data is compressed. If the pointer is NULL, the decompressed data will be returned. |
out_data | the corresponding raw metadata |
out_data_size | the size of the metadata in bytes |
- Returns
- whether the call succeeded, or there was an error
LIBHEIF_API const char* heif_item_get_mime_item_content_encoding |
( |
const struct heif_context * |
ctx, |
|
|
heif_item_id |
item_id |
|
) |
| |
Gets the content_encoding for a MIME item.
Only valid if the item type is mime
. If the item does not exist, or if it is not a mime
item, NULL is returned.
If the item is not encoded, the returned value will be an empty string (not null).
- Parameters
-
ctx | the file context |
item_id | the item identifier for the item |
- Returns
- the item content_type