winamp/Src/replicant/nsapev2/nsapev2.h

#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