aboutsummaryrefslogtreecommitdiff
path: root/Src/replicant/nsid3v1/nsid3v1.h
blob: dcd6e1559e58c77a568fde18b60ad4e5ff4a504c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
#pragma once

#include "nx/nxstring.h"

#ifdef __cplusplus
extern "C" {
#endif

#define NSID3V1_EXPORT
	typedef struct nsid3v1_tag_struct_t { } *nsid3v1_tag_t;


	
	// Basic methods
	NSID3V1_EXPORT int NSID3v1_Header_Valid(const void *data, size_t len);
	NSID3V1_EXPORT int NSID3v1_Tag_Create(const void *data, size_t len, nsid3v1_tag_t *out_tag);
	NSID3V1_EXPORT int NSID3v1_Tag_New(nsid3v1_tag_t *out_tag);
	// len must be >= 128.  ALWAYS writes 128 bytes if successful
	NSID3V1_EXPORT int NSID3v1_Tag_Serialize(const nsid3v1_tag_t t, void *data, size_t len);
	NSID3V1_EXPORT int NSID3v1_Tag_Destroy(nsid3v1_tag_t t);

	// Generic getters
	//NSID3V1_EXPORT int NSID3v1_Field_Text_Get(const nsid3v1_tag_t *t, const int field, nx_string_t *out_value);
	NSID3V1_EXPORT int NSID3v1_Field_Text_Get(const nsid3v1_tag_t t, const int field, nx_string_t *out_value);
	
	// Specific field getters as text
	NSID3V1_EXPORT int NSID3v1_Get_Title(const nsid3v1_tag_t t, nx_string_t *value);
	NSID3V1_EXPORT int NSID3v1_Get_Artist(const nsid3v1_tag_t t, nx_string_t *value);
	NSID3V1_EXPORT int NSID3v1_Get_Album(const nsid3v1_tag_t t, nx_string_t *value);
	NSID3V1_EXPORT int NSID3v1_Get_Year(const nsid3v1_tag_t t, nx_string_t *value);
	NSID3V1_EXPORT int NSID3v1_Get_Comment(const nsid3v1_tag_t t, nx_string_t *value);
	NSID3V1_EXPORT int NSID3v1_Get_Track(const nsid3v1_tag_t t, nx_string_t *value);

	// Specific field getters as integers
	NSID3V1_EXPORT int NSID3v1_Int_Get_Year(const nsid3v1_tag_t t, unsigned int *value);
	NSID3V1_EXPORT int NSID3v1_Int_Get_Track(const nsid3v1_tag_t t, uint8_t *value);
	NSID3V1_EXPORT int NSID3v1_Int_Get_Genre(const nsid3v1_tag_t t, uint8_t *value);

	// Specific field setters as text
	NSID3V1_EXPORT int NSID3v1_Set_Title(nsid3v1_tag_t t, nx_string_t value);
	NSID3V1_EXPORT int NSID3v1_Set_Artist(nsid3v1_tag_t t, nx_string_t value);
	NSID3V1_EXPORT int NSID3v1_Set_Album(nsid3v1_tag_t t, nx_string_t value);
	NSID3V1_EXPORT int NSID3v1_Set_Year(nsid3v1_tag_t t, nx_string_t value);
	NSID3V1_EXPORT int NSID3v1_Set_Comment(nsid3v1_tag_t t, nx_string_t value);
	NSID3V1_EXPORT int NSID3v1_Set_Track(nsid3v1_tag_t t, nx_string_t value);

	// Specific field setters as integers
	NSID3V1_EXPORT int NSID3v1_Int_Set_Year(nsid3v1_tag_t t, unsigned int value);
	NSID3V1_EXPORT int NSID3v1_Int_Set_Track(nsid3v1_tag_t t, uint8_t value);
	NSID3V1_EXPORT int NSID3v1_Int_Set_Genre(nsid3v1_tag_t t, uint8_t value);
	
	// field types for ID3V1.0
	enum
	{
		NSID3V1_TAG,
		NSID3V1_TITLE,
		NSID3V1_ARTIST,
		NSID3V1_ALBUM,
		NSID3V1_YEAR,
		NSID3V1_COMMENT,
		NSID3V1_TRACK,		// ID3V1.1
		NSID3V1_GENRE,
	};
	
#ifdef __cplusplus
}
#endif