ByteFilter V1.20

                    Copyright (c) 1993 by Jan Hagqvist


COPYRIGHT

	Copyright (c) 1993, Jan Hagqvist, All Rights Reserved.

	This program is FREEWARE. You may freely use and distribute this
	program under the following conditions:

	1) No modifications are made into the program or this documentation
	   and all the files are spread together. However, you are allowed
	   to compress all the files into an archive for distribution.

	2) No money (other than nominal copying fees) is charged for its
	   distribution.

DISCLAIMER

	THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
	EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
	ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
	RESULTING FROM THE USE OF THE PROGRAM. THE ENTIRE RISK AS TO THE
	USE OF THIS PROGRAM IS ASSUMED BY THE USER.


What is ByteFilter?

	ByteFilter lets you to filter out any bytes from any file you choose,
	resulting a new file that lacks the filtered bytes. So you are able
	to extract the texts from a binary file, for example.

How does it work?

	Simply enough, ByteFilter only reads the source file and writes it out
	to the destination file, excluding the bytes to be filtered.

How do I use it?

	The gadgets:

	In the left you find the BYTE gadgets. They indicate which bytes are
	to be filtered. Each gadget has a hex number representing the byte.
	You can change the mode of a gadget by clicking on it. The first click
	turns the gadget (and filtering of that byte) on and another click
	turns the gadget off. None of these gadgets are selected when you
	enter the program.

	The INVERT gadget simply inverts all the byte gadgets. So if a byte
	gadget is selected, it will get deselected, whereas a deselected byte
	gadget will get selected.

	Before you begin the filtering, you must fill in the SOURCE and the
	DEST gadgets. In the SOURCE gadget you input the sourcefile name with
	its full path (unless the sourcefile is in the current directory=the
	directory where you started the program). The DEST gadget is just the
	same as SOURCE, but it's for the destination file (a new file you
	create by filtering out the desired bytes from the sourcefile).

	When you're done with the other gadgets, you can begin the filtering
	by pressing the BEGIN THE FILTERING gadget.

	The statusline:

	In the bottom of the window you find the statusline. Here you can see
	what's going on in the program.


	The modes:

	ByteFilter automatically selects one of the following modes:

	Dead slow mode:  If there is not enough memory to read the whole
			 sourcefile into the memory, ByteFilter reads the
			 sourcefile 256 bytes at a time and writes out the
			 destfile 256 bytes at the time.

	Fast mode:	 If there is enough memory to read the sourcefile
			 into the memory, but not enough memory for reading
			 the destfile into the memory, the sourcefile will
			 be completely read into the memory and the destfile
			 will be written 256 bytes at a time.

	Ultra fast mode: If there is enough memory for both the sourcefile
			 and the destfile, the sourcefile will be completely
			 read into the memory and then filtered. The destfile
			 will then be written in one go.

Notes

	When using the program, other programs may occasionally slow down,
	because of the 260 gadgets (plus the system ones) in the program.

	This program needs jhextras.library version 37 or greater. A copy of
	the library should accompany this program.


	Should any comments come to your mind, please write to:

	Jan Hagqvist
	Reinolankatu 5 A 1
	48600 KARHULA
	FINLAND


History

V1.20	(Sunday, 05-Sep-1993)
	Deadslow, fast and ultrafast-modes.
	Size = 3288 bytes