Home Download Musics Developers
API Sources Tools File Format Technicals

file68.h File Reference


Detailed Description

sc68 file header.

Author:
Benjamin Gerard <ben@sashipa.com>
Date:
1998/09/03
Id
file68.h,v 2.6 2003/11/19 00:47:08 benjihan Exp

#include "file68/istream68.h"

Go to the source code of this file.

Data Structures

struct  chunk68_t
 SC68 file chunk header. More...

union  hwflags68_t
 Hardware and features flags. More...

struct  music68_t
 SC68 music (track) structure. More...

struct  disk68_t
 SC68 music disk structure. More...


Features flag definitions for music68_t.

#define SC68_YM   1
 YM-2149 actif.

#define SC68_STE   2
 STE sound actif.

#define SC68_AMIGA   4
 AMIGA sound actif.

#define SC68_STECHOICE   8
 Optionnal STF/STE (not tested).


SC68 file chunk definitions.

#define CH68_CHUNK   "SC"
 Chunk identifier.

#define CH68_BASE   "68"
 Start of file.

#define CH68_FNAME   "FN"
 File name.

#define CH68_DEFAULT   "DF"
 Default music.

#define CH68_MUSIC   "MU"
 Music section start.

#define CH68_MNAME   "MN"
 Music name.

#define CH68_ANAME   "AN"
 Author name.

#define CH68_CNAME   "CN"
 Composer name.

#define CH68_D0   "D0"
 D0 value.

#define CH68_AT   "AT"
 Load address.

#define CH68_TIME   "TI"
 length in seconds

#define CH68_FRAME   "FR"
 length in frames

#define CH68_FRQ   "FQ"
 Main replay frequency in Hz.

#define CH68_LOOP   "LP"
 Number of loop.

#define CH68_TYP   "TY"
 Not standard st file.

#define CH68_IMG   "IM"
 Picture.

#define CH68_REPLAY   "RE"
 External replay.

#define CH68_MDATA   "DA"
 Music data.

#define CH68_EOF   "EF"
 End of file.


File verify functions.

int SC68file_verify (istream_t *is)
 Verify SC68 file from stream.

int SC68file_verify_file (const char *fname)
 Verify SC68 file.

int SC68file_verify_mem (const void *buffer, int len)
 Verify SC68 file mapped into memory buffer.

int SC68file_diskname (istream_t *is, char *dest, int max)
 Get SC68 disk name.

int SC68file_is_our_file (const char *url, const char *exts, int *is_remote)
 Check if an URL is a standard sc68 one.


File load functions.

disk68_tSC68file_load (istream_t *is)
 Load SC68 file from stream.

disk68_tSC68file_load_file (const char *fname)
 Load SC68 file.

disk68_tSC68file_load_mem (const void *buffer, int len)
 Load SC68 file mapped into memory buffer.


File save functions.

int SC68file_save (istream_t *os, const disk68_t *mb, int gzip)
 Save SC68 disk into stream.

int SC68file_save_file (const char *fname, const disk68_t *mb, int gzip)
 Save SC68 disk into file.

int SC68file_save_mem (const char *buffer, int len, const disk68_t *mb, int gzip)
 Save SC68 disk into memory buffer.


Defines

#define SC68_IDSTR   "SC68 Music-file / (c) (BeN)jamin Gerard / SasHipA-Dev "
 SC68 file identification string definition.

#define SC68_IDSTR_V2   {'S','C','6','8', 0,2,255,0xa9, 0xDF,0xEB,0xD1,0}
 SC68 file identification string definition V2.

#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).


Variables

const char SC68file_idstr []
 SC68 file identifier string.

const char SC68file_idstr_v2 [12]
 SC68 file identifier string V2.