sc68 file.
More...
Go to the source code of this file.
sc68 file.
- Author
- Benjamin Gerard ben@s.nosp@m.ashi.nosp@m.pa.co.nosp@m.m
- Date
- 1998/09/03
- Id
- file68.h,v 2.1 2003/08/25 20:15:51 benjihan Exp
#define SC68_IDSTR "SC68 Music-file / (c) (BeN)jamin Gerard / SasHipA-Dev " |
SC68 file identification string definition (use SC68file_idstr instead).
- See also
- SC68file_idstr
#define SC68_NOFILENAME "???" |
SC68 unknown filename or author.
#define SC68_LOADADDR 0x8000 |
Default load address in 68K memory.
#define SC68_MAX_TRACK 99 |
Maximum track per disk (display rules).
Optionnal STF/STE (not tested).
Verify SC68 file from stream.
The SC68file_verify() function opens, reads and closes given file to determine if it is a valid SC68 file. This function only checks for a valid file header, and does not perform any consistent error checking.
- Parameters
-
- Returns
- error-code
- Return values
-
0 | success, seems to be a valid SC68 file |
<0 | failure, file error or invalid SC68 file |
- See also
- SC68file_load()
-
SC68file_save()
-
SC68file_diskname()
int SC68file_verify_file |
( |
const char * |
fname | ) |
|
Verify SC68 file.
- Parameters
-
fname | path to file to verify. |
int SC68file_verify_mem |
( |
const void * |
buffer, |
|
|
int |
len |
|
) |
| |
Verify SC68 file mapped into memory buffer.
- Parameters
-
buffer | buffer address |
len | buffer length |
int SC68file_diskname |
( |
istream_t * |
is, |
|
|
char * |
dest, |
|
|
int |
max |
|
) |
| |
Get SC68 disk name.
The SC68file_diskname() function opens, reads and closes given file to determine if it is a valid SC68 file. In the same time it tries to retrieve the stored disk name into the dest buffer with a maximum length of max bytes. If the name overflows, the last byte of the dest buffer will be non zero.
- Parameters
-
is | input stream |
dest | disk name destination buffer |
max | number of bytes of dest buffer |
- Returns
- error-code
- Return values
-
0 | success, found a disk-name |
<0 | failure, file error, invalid SC68 file or disk-name not found |
- See also
- SC68file_load()
-
SC68file_save()
-
SC68file_diskname()
Load SC68 file from stream.
The SC68file_load() function allocates memory and loads an SC68 file. The function performs all necessary initializations in the returned disk68_t structure. A single buffer has been allocated including disk68_t structure followed by music data. It is user charge to free memory by calling SC68_free() function.
- Parameters
-
- Returns
- pointer to allocated disk68_t disk structure
- Return values
-
- See also
- SC68file_verify()
-
SC68file_save()
disk68_t* SC68file_load_file |
( |
const char * |
fname | ) |
|
Load SC68 file.
- Parameters
-
fname | path to file to load. |
disk68_t* SC68file_load_mem |
( |
const void * |
buffer, |
|
|
int |
len |
|
) |
| |
Load SC68 file mapped into memory buffer.
- Parameters
-
buffer | buffer address |
len | buffer length |
int SC68file_save_file |
( |
const char * |
fname, |
|
|
const disk68_t * |
mb |
|
) |
| |
Save SC68 disk into file.
- Parameters
-
fname | filename. |
mb | pointer to SC68 disk to save |
int SC68file_save_mem |
( |
const char * |
buffer, |
|
|
int |
len, |
|
|
const disk68_t * |
mb |
|
) |
| |
Save SC68 disk into memory buffer.
- Parameters
-
buffer | destination buffer. |
len | size of destination buffer. |
mb | pointer to SC68 disk to save |
const char SC68file_idstr[] |