Source

doom / src / djgppdos / bcd.h

Full commit
/* bcd.h -- header file for BCD, a CD-ROM audio playing library for DJGPP
   by Brennan Underwood, http://brennan.home.ml.org/ */
#ifndef _BCD_H
#define _BCD_H

#define BCD_VERSION 0x0103

/* Installation and setup functions */
/* Call this first! */
int bcd_open(void);
/* Call before exit. */
int bcd_close(void);

/* open door, unlocking first if necessary */
int bcd_open_door(void);
/* close door */
int bcd_close_door(void);

/* pass 1 to lock door, 0 to unlock */
int bcd_lock(int);

/* returns one of the following 3 #defined symbols */
int bcd_disc_changed(void);
#define BCD_DISC_CHANGED        0xff
#define BCD_DISC_NOT_CHANGED    1
#define BCD_DISC_UNKNOWN        0

/* perform a device reset */
int bcd_reset(void);

/* compare the returned status int to the following bits */
int bcd_device_status(void);
#define BCD_DOOR_OPEN           1
#define BCD_DOOR_UNLOCKED       2
#define BCD_SUPPORT_COOKED      4
#define BCD_READ_ONLY           8
#define BCD_DATA_READ_ONLY      16
#define BCD_SUPPORT_INTERLEAVE  32

/* returns 1 if audio is currently playing, 0 otherwise. -1 on error */
int bcd_audio_busy(void);
/* current head position in frames */
int bcd_audio_position(void);
/* convenience function, if audio busy, returns track# playing now */
int bcd_now_playing(void);

/* query MSCDEX for track list when disc changed or just starting up */
int bcd_get_audio_info(void);
/* get a particular track's info */
int bcd_get_track_address(int trackno, int *start, int *len);
/* check for track's audio/data status */
int bcd_track_is_audio(int trackno);
/* play a particular track from beginning to end */
int bcd_play_track(int tracknum);
/* play an arbitrary section of audio for an arbitrary length of time */
int bcd_play(int start, int len);
/* set the output volume. pass a parameter from 0-255 */
int bcd_set_volume(int);
/* stop and pause are equivalent */
int bcd_stop(void);
#define bcd_pause bcd_stop
int bcd_resume(void);

extern int num_tracks;
extern int lowest_track, highest_track;

/* Troubleshooting */
/* Returns a human readable description of the last error encountered */
char *bcd_error(void);
extern int _error_code;
/* If you are mad enough play the Rach 3, I mean parse _error_code yourself */
#define BCD_DE_WRITE_PROTECT    0
#define BCD_DE_UNKNOWN_UNIT     1
#define BCD_DE_DRIVE_NOT_READY  2
#define BCD_DE_UNKNOWN_COMMAND  3
#define BCD_DE_CRC_ERROR        4
#define BCD_DE_STRUCT_LEN       5
#define BCD_DE_SEEK_ERROR       6
#define BCD_DE_UNKNOWN_MEDIA    7
#define BCD_DE_SECTOR_NOT_FOUND 8
#define BCD_DE_OUT_OF_PAPER     9
#define BCD_DE_WRITE_FAULT      10
#define BCD_DE_READ_FAULT       11
#define BCD_DE_GENERAL_FAILURE  12
#define BCD_DE_INVALID_DISK_CHANGE      15
/* set by BCD itself, for stuff like "Out of memory" */
extern char *_bcd_error;

/* uncomment this line to force BCD to use a statically allocated
   Track array instead of using malloc */
#define STATIC_TRACKS

typedef struct {
  int is_audio;
  int start, end, len;
} Track;

extern Track tracks[99];

#endif