winamp/Src/replicant/nsapev2/nsapev2.h
2024-09-24 14:54:57 +02:00

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