FreeUef Release 3
=================

[intended for view with your editor's word wrap enabled]

INTRODUCTION
============

FreeUEF allows you to reproduce tapes from tape image UEF files via your soundcard output. It acts as a sister tool to 'MakeUEF', which goes the other way.

Not many hours have been spent on this tool, so mileage may vary.

USAGE
=====

Very simple really. Type 'freeuef <some uef file>', and follow the on-screen prompt. You might like to find some sort of tape recorder with a level meter or a semi-muted volume output if you don't want to be stuck looking at a static screen with no information as to whether the program is working or not.

Alternatively, type 'freeuef <some uef file> file' to have the raw sound data dumped into a 44100Hz, 8bit unsigned file named 'sound.raw'.

MISC. NOTES
===========

There is something a delay in the audio stream buffer, which translates to a delay between each check of the quit key and the program exit.

FreeUEF outputs exactly the tape recorded in the specified UEF file. If this does not sound identical to a given source tape you probably want to investigate the program that did the tape to UEF conversion - certainly MakeUEF 0.3 and below was guilty of just filling in default values for high tone and gap lengths. Similarly, fractured blocks of high tone and data before and after valid files is a giveaway of 'io looping' ElectrEm.

COMPILING FROM SOURCE
=====================

Anyway, to compile the DOS version, link against Allegro and ZLib and use the define 'TARGET_DOS'. The windows version will require ZLib, winmm.lib and the define 'TARGET_WIN'. A third option 'TARGET_OSS' simply requires ZLib and should work on any UNIX-like operating system with support for the Open Sound System and a sound card capable of a frequency within 5% of 44100Hz.