The .WTF file specification:

The file format is a little haphazard due to modifications made and for backward compatibility's sake. Future formats will be better organized. Most of TAPEDATA's is manipulated by a derived class, which resides in the file wttape32.dll. Hopefully soon I will release the necessary .LIB and .H files so any programmers using Borland C++ (or any language capable of calling a DLL compiled by BC++) will be able to tap into the prewritten routines for tape file manipulation built into wttape32.dll. This information is taken from wttape.h. The syntax highlighting mimics that found in Borland C++ for ease of reading.

Dont forget all strings (char x[i]) are 0-terminated, thus the maximum string length for x is i-1 (then add the 0 terminator). The first record (record 0) in a .wtf file contains personal data, tape data starts with the second record (record 1). The personal data record can be left blank (set to 0's)

This preprocessor define maintains 16/32 bit compatibility by using short instead of int when compiling for Win32, since structures are read and written directly to disk and the width (bytes) of the data fields must be the same for both systems. By defining integers as shorts under Win32 we can read 16bit integers from Win3.x correctly

#ifdef __WIN32__

#define INTEGER SHORT

#else

#define INTEGER int

#endif

Basic Data Type Widths

wtLOGFONT structure

This typedef provides a wrapper around Windows' LOGFONT structure, again for 32bit compatibility. Essentially, it types LOGFONT to the 16bit flavor by using shorts instead of ints when under Win32. The class is then used in the TAPEDATA structure.

typedef struct wtLOGFONT {

INTEGER	lfHeight;	/* height in points */
INTEGER	lfWidth;	/* always set to 0 (default) */
INTEGER	lfEscapement;	/* always set to 0 (default) */
INTEGER	lfOrientation;	/* always set to 0 (default) */
INTEGER	lfWeight	/* always set to 0 (default) */
BYTE	lfItalic;	/* always set to 0 (default) */
BYTE	lfUnderline;	/* always set to 0 (default) */
BYTE	lfStrikeOut	/* always set to 0 (default) */
BYTE	lfCharSet;	/* always set to 0 (default) */
BYTE	lfOutPrecision	/* always set to 0 (default) */
BYTE	lfClipPrecision;	/* always set to 0 (default) */
BYTE	lfQuality;	/* always set to 0 (default) */
BYTE	lfPitchAndName;	/* always set to 0 (default) */
char	lfFaceName[32];	/* typeface name */

};

class onesong

This class defines a single song as a character string plus an integer representing the jam code. This allows us to use an array of onesongs later (in the TAPEDATA structure) to represent the songlist. guzinta is an integer enumeration with the values listed.

class onesong {

public:
char	songtitle[32];	/* zero-terminated character array holding the songname */
INTEGER	guzinta;	/* 0-xx= none, jams, fades, cuts, text, encore, encore2, cont'd, ending, n1, n2, n3, r1, r2, r3, ...user codes */

};

class TAPEDATA

The TAPEDATA class is where it all comes together. A WinTaper file is simply an array of these structures written to disk. Notice that class TAPEDATA contains arrays of some of the support structures listed above. Also note that some values are for future expansion and are not used. Where variables are enumerated, I have provided the corresponding values.

class TAPEDATA {

public:
char	band[21];
char	date[9];	/* stored as text: yyyymmdd ie: 19951031 = 10/31/95 */
char	location[42];
char	srcinitial;	/* internal use only (set to 0) - see "source" below */
INTEGER	source;	/* 0-13 = none, SBD, Aud, SBD+Aud, FMB, FMS, MTSB, MTS-Siml, CD, Alb, BootCD, BootAlb, studio, outtakes */
INTEGER	tape1type;	/* 0-21 = none, 1, 2, 3, 1st, 2nd, 3rd, Tape1, Tape2, Tape3, Part1, Part2, Part3, Early, Late, Matinee, Electric, Acoustic, Opener, Aritst, Encores, Conclusion */
INTEGER	gen;	/* 0-25 = none, DigMas, DigCopy, HiFiMas, HiFiCopy, AnlgMas, AnlgUnkwn, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, unknown */
INTEGER	locationfontsize;	/* size in points of location on SPINE of label */
INTEGER	sets;	/* 0 = 2tapes, 1 = tape1, 2 = tape2, 3 = OneLongTape, 4 = 1Dat2Cass */
INTEGER	tape2type;	/* 0-21 = none, 1, 2, 3, 1st, 2nd, 3rd, Tape1, Tape2, Tape3, Part1, Part2, Part3, Early, Late, Matinee, Electric, Acoustic, Opener, Aritst, Encores, Conclusion */
INTEGER	tape1time;	/* time in minutes 0-32768 */
INTEGER	tape2time;	/* time in minutes 0-32768 */
INTEGER	qualityID;	/* 0-14= 0=none, 1-14 as follows: 1=worst 14=best */
char	tapeformat[2];	/* 'C'=Cass,'D'=Dat,'V'=VHS,'8'=8mm,'B'=Beta,'R'=Reel */
onesong	songlist[34];	/* array of 34 onesongs (see above) */
char	comment1[79];
char	setinfo[2];	/* internal dynamic use only - set to 0's */
char	comment2[79];
INTEGER	dolbyinfo;	/* 0-13 = none, B, C, dbx, SP, EP, SLP, 30.5, 44.1, 48.0, 3.75, 7.5, 15, 30 */
INTEGER	flip_1;	/* 1-17 = 1st song on side B tape 1 */
INTEGER	flip_2;	/* 1-17 = 1st song on side B tape 2 */
char	extra[2];	/* internal dynamic use only - set to 0's */
wtLOGFONT	DateFont;	/* note: lfHeight is used for size in points on label's SPINE */
wtLOGFONT	LocationFont;	/* note: lfHeight is used for size in points on label's SPINE */
wtLOGFONT	SongsFont;
wtLOGFONT	CommentsFont;
wtLOGFONT	SourceFont;
wtLOGFONT	BandFont;
wtLOGFONT	ExtraFont;	/* not used yet - Set to 0's */
char	alphasort[20];	/* if blank, sorts on "band" */
INTEGER	isdeleted;	/* 0=NO, 1=YES */
INTEGER	programnumber;	/* not used yet - Set to 0 */
unsigned long	hashvalue;	/* this and the next 3 fields are used by the tape trader add-on utility coming soon. Best to leave these values alone since their operations have not been set yet */
char	isloaned;
unsigned long	trader_id;
unsigned long	add_date;
char	unusedbytes[13];	/* not used yet - Set to 0's */
INTEGER	datefontsize;	/* size in points of date on FRONT of label */

};

WTF 1.60 - FIELD OFFSETS IN BYTES

WTF 1.60 - SUPPORT CLASS FIELD OFFSETS IN BYTES

class wtLOGFONT

class onesong

©1997-2000 WinTaper Development - last updated: 12/02/2000