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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
/*
* libMirage: utility functions and helpers
* Copyright (C) 2006-2014 Rok Mandeljc
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef __MIRAGE_UTILS_H__
#define __MIRAGE_UTILS_H__
#include <mirage/types.h>
G_BEGIN_DECLS
/* Patterns */
extern const guint8 mirage_pattern_sync[12];
extern const guint8 mirage_pattern_cd001[8];
extern const guint8 mirage_pattern_bea01[8];
/**
* MIRAGE_CAST_DATA:
* @buf: buffer to get data from
* @off: offset in buffer at which to get data
* @type: data type (i.e. 'guint64')
*
* A macro for easy retrieval of data from (unsigned integer) buffer. Mostly to
* be used in binary image parsers, for example, to retrieve guint32 or guint16
* value from buffer.
**/
#define MIRAGE_CAST_DATA(buf,off,type) (*((type *)(buf+off)))
/**
* MIRAGE_CAST_PTR:
* @buf: buffer to place pointer in
* @off: offset in buffer at which to place pointer
* @type: pointer type (i.e. 'gchar *')
*
* A macro for easy placing of pointers within (unsigned integer) buffer. Mostly
* to be used in binary image parsers, for example, to retrieve a string or a
* structure from buffer.
**/
#define MIRAGE_CAST_PTR(buf,off,type) ((type)(buf+off))
/* File finding */
gchar *mirage_helper_find_data_file (const gchar *filename, const gchar *path);
/* File suffix retrieval and matching */
const gchar *mirage_helper_get_suffix (const gchar *filename);
gboolean mirage_helper_has_suffix (const gchar *filename, const gchar *suffix);
/* Case-insensitive string comparison; works on UTF-8 strings */
gint mirage_helper_strcasecmp (const gchar *str1, const gchar *str2);
gint mirage_helper_strncasecmp (const gchar *str1, const gchar *str2, gint len);
/* MSF/LBA utility functions */
void mirage_helper_lba2msf (gint lba, gboolean diff, guint8 *m, guint8 *s, guint8 *f);
gchar *mirage_helper_lba2msf_str (gint lba, gboolean diff);
gint mirage_helper_msf2lba (guint8 m, guint8 s, guint8 f, gboolean diff);
gint mirage_helper_msf2lba_str (const gchar *msf, gboolean diff);
/* Hex/BCD utility functions */
gint mirage_helper_hex2bcd (gint hex);
gint mirage_helper_bcd2hex (gint bcd);
/* ASCII/ISRC utility functions */
guint8 mirage_helper_ascii2isrc (gchar c);
gchar mirage_helper_isrc2ascii (guint8 c);
gboolean mirage_helper_validate_isrc (const gchar *isrc);
/* CRC utility functions */
extern guint16 *crc16_1021_lut;
extern guint32 *crc32_d8018001_lut;
guint16 *mirage_helper_init_crc16_lut (guint16 genpoly);
guint32 *mirage_helper_init_crc32_lut (guint32 genpoly, guint slices);
guint16 mirage_helper_calculate_crc16 (const guint8 *data, guint length, const guint16 *crctab, gboolean reflected, gboolean invert);
guint32 mirage_helper_calculate_crc32_fast (const guint8 *data, guint length, const guint32 *crctab, gboolean reflected, gboolean invert);
guint32 mirage_helper_calculate_crc32_standard (const guint8 *data, guint length, const guint32 *crctab, gboolean reflected, gboolean invert);
/* Subchannel utility functions */
guint16 mirage_helper_subchannel_q_calculate_crc (const guint8 *data);
void mirage_helper_subchannel_q_encode_mcn (guint8 *buf, const gchar *mcn);
void mirage_helper_subchannel_q_decode_mcn (const guint8 *buf, gchar *mcn);
void mirage_helper_subchannel_q_encode_isrc (guint8 *buf, const gchar *isrc);
void mirage_helper_subchannel_q_decode_isrc (const guint8 *buf, gchar *isrc);
/**
* MirageSubChannel:
* @SUBCHANNEL_W: W subchannel data
* @SUBCHANNEL_V: V subchannel data
* @SUBCHANNEL_U: U subchannel data
* @SUBCHANNEL_T: T subchannel data
* @SUBCHANNEL_S: S subchannel data
* @SUBCHANNEL_R: R subchannel data
* @SUBCHANNEL_Q: Q subchannel data
* @SUBCHANNEL_P: P subchannel data
*
* Subchannel type for interleaving/deinterleaving.
*/
typedef enum _MirageSubChannel
{
SUBCHANNEL_W = 0,
SUBCHANNEL_V = 1,
SUBCHANNEL_U = 2,
SUBCHANNEL_T = 3,
SUBCHANNEL_S = 4,
SUBCHANNEL_R = 5,
SUBCHANNEL_Q = 6,
SUBCHANNEL_P = 7,
} MirageSubChannel;
void mirage_helper_subchannel_interleave (gint subchan, const guint8 *channel12, guint8 *channel96);
void mirage_helper_subchannel_deinterleave (gint subchan, const guint8 *channel96, guint8 *channel12);
/* EDC/ECC utility functions */
void mirage_helper_sector_edc_ecc_compute_edc_block (const guint8 *src, guint16 size, guint8 *dest);
void mirage_helper_sector_edc_ecc_compute_ecc_block (const guint8 *src, guint32 major_count, guint32 minor_count, guint32 major_mult, guint32 minor_inc, guint8 *dest);
MirageSectorType mirage_helper_determine_sector_type (const guint8 *buf);
/* Text data encoding */
const gchar *mirage_helper_encoding_from_bom (const guint8 *buffer);
/* ECMA-130 Annex B sector data scrambler */
extern guint8 *ecma_130_scrambler_lut;
guint8 *mirage_helper_init_ecma_130b_scrambler_lut (void);
/* General-purpose string formatter */
gchar *mirage_helper_format_string (const gchar *format, ...);
gchar *mirage_helper_format_stringv (const gchar *format, va_list args);
gchar *mirage_helper_format_stringd (const gchar *format, GHashTable *dictionary);
G_END_DECLS
#endif /* __MIRAGE_UTILS_H__ */
|
