diff options
Diffstat (limited to 'Src/replicant/nsapev2/nsapev2.h')
| -rw-r--r-- | Src/replicant/nsapev2/nsapev2.h | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/Src/replicant/nsapev2/nsapev2.h b/Src/replicant/nsapev2/nsapev2.h new file mode 100644 index 00000000..1b703d1e --- /dev/null +++ b/Src/replicant/nsapev2/nsapev2.h @@ -0,0 +1,75 @@ +#pragma once + +#include "foundation/types.h" +#include "nx/nxstring.h" + +#ifdef __ANDROID__ +#include "android/nsapev2.h" +#elif defined(_WIN32) +#include "windows/nsapev2.h" +#elif defined(__linux__) +#include "linux/nsapev2.h" +#elif defined (__APPLE__) +#include "osx/nsapev2.h" +#endif + +#ifdef __cplusplus +extern "C" { +#endif + + typedef struct nsapev2_header_struct_t { } *nsapev2_header_t; + typedef struct nsapev2_tag_struct_t { } *nsapev2_tag_t; + typedef struct nsapev2_item_struct_t { } *nsapev2_item_t; + + // must be exactly 32 bytes + NSAPEV2_EXPORT int NSAPEv2_Header_Valid(const void *header_data); + NSAPEV2_EXPORT int NSAPEv2_Header_Create(nsapev2_header_t *header, const void *header_data, size_t header_len); + NSAPEV2_EXPORT int NSAPEv2_Header_TagSize(const nsapev2_header_t header, uint32_t *tag_size); + NSAPEV2_EXPORT int NSAPEv2_Header_HasHeader(nsapev2_header_t header); + NSAPEV2_EXPORT int NSAPEv2_Header_Destroy(nsapev2_header_t header); + + + // currently, this function makes a copy of any necessary data. in the future, it would be better + // to make another version of this function that "borrows" your data + // if you can guarantee that the memory will outlive the nsapev2_tag_t object + NSAPEV2_EXPORT int NSAPEv2_Tag_Create(nsapev2_tag_t *tag, const nsapev2_header_t header, const void *bytes, size_t bytes_len); + NSAPEV2_EXPORT int NSAPEv2_Tag_New(nsapev2_tag_t *tag); + NSAPEV2_EXPORT int NSAPEv2_Tag_SerializedSize(const nsapev2_tag_t tag, size_t *bytes); + NSAPEV2_EXPORT int NSAPEv2_Tag_Serialize(const nsapev2_tag_t t, void *data, size_t bytes); + NSAPEV2_EXPORT int NSAPEv2_Tag_Destroy(nsapev2_tag_t tag); + + NSAPEV2_EXPORT int NSAPEv2_Tag_GetFlags(nsapev2_tag_t tag, uint32_t *flags); + NSAPEV2_EXPORT int NSAPEv2_Tag_SetFlags(nsapev2_tag_t tag, uint32_t flags, uint32_t mask); + + NSAPEV2_EXPORT int NSAPEv2_Tag_GetString(const nsapev2_tag_t tag, const char *key, unsigned int index, nx_string_t *value); + NSAPEV2_EXPORT int NSAPEv2_Tag_SetString(nsapev2_tag_t tag, const char *key, unsigned int index, nx_string_t value); + + NSAPEV2_EXPORT int NSAPEv2_Tag_GetBinary(const nsapev2_tag_t tag, const char *key, unsigned int index, const void **bytes, size_t *length); + NSAPEV2_EXPORT int NSAPEv2_Tag_SetBinary(nsapev2_tag_t tag, const char *key, unsigned int index, const void *bytes, size_t length); + NSAPEV2_EXPORT int NSAPEv2_Tag_SetArtwork(nsapev2_tag_t t, const char *key, unsigned int index, const char *filename, const void *bytes, size_t length); + /* Items */ + // flags + static const uint32_t nsapev2_item_read_write = 0; + static const uint32_t nsapev2_item_read_only = 1; + + static const uint32_t nsapev2_item_type_utf8 = 0; + static const uint32_t nsapev2_item_type_binary = 1 << 1; + static const uint32_t nsapev2_item_type_locator = 2 << 1; + + // mask flags with these to check the different fields + static const uint32_t nsapev2_item_type_mask = (1 << 2) | (1 << 1); + static const uint32_t nsapev2_item_read_mask = 1 << 0; + + NSAPEV2_EXPORT int NSAPEv2_Tag_EnumerateItems(const nsapev2_tag_t tag, const nsapev2_item_t start, nsapev2_item_t *next); + NSAPEV2_EXPORT int NSAPEv2_Tag_GetItemCount(const nsapev2_tag_t t, size_t *count); + NSAPEV2_EXPORT int NSAPEv2_Tag_GetItemAtIndex(const nsapev2_tag_t t, unsigned int index, nsapev2_item_t *item); + NSAPEV2_EXPORT int NSAPEv2_Item_GetInformation(const nsapev2_item_t item, const char **key, uint32_t *flags); + NSAPEV2_EXPORT int NSAPEv2_Item_GetString(const nsapev2_item_t item, nx_string_t *value); + NSAPEV2_EXPORT int NSAPEv2_Item_GetBinary(const nsapev2_item_t item, const void **bytes, size_t *length); + NSAPEV2_EXPORT int NSAPEv2_Item_SetKey(nsapev2_item_t item, const char *key); + NSAPEV2_EXPORT int NSAPEv2_Item_SetString(nsapev2_item_t item, nx_string_t value); + NSAPEV2_EXPORT int NSAPEv2_Tag_RemoveItem(nsapev2_tag_t tag, nsapev2_item_t item); + NSAPEV2_EXPORT int NSAPEv2_Tag_AddItem(nsapev2_tag_t tag, nsapev2_item_t *item); +#ifdef __cplusplus +} +#endif |