76 lines
3.8 KiB
C
76 lines
3.8 KiB
C
#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
|