Welcome to the wonderful world of Enscribe 0.1.0!

Enscribe is free software, released under the General Public License. Make sure 
you read the file LICENSE which was included with this file. You should know 
that there is no warranty on theis software for any reason whatsoever. If it 
eats your dog, you're just out of luck.


What does Enscribe do?

Enscribe creates digital audio watermark images from photgraphic images. 

These images can only be seen using a third party frequency vs time display, 
such as my favorite, Baudline (http://www.baudline.com).

Images are still visible even after such audio mangling techniques as MP3/Ogg 
compression, reverb, chorus, etc. Heavy EQ and flange can stripe out vertical 
sections, but they can also ruin an otherwise good song too.


How does it work?

You give it an image file (JPG, PNG, WBMP) and it outputs an audio file.

The scanlines of the input image are converted into frequency components and 
then using an inverse Fast Fourier Transform, are converted into sound. The 
left side of the image is the low frequency end, and the right is the high end, 
up to just under the Nyquist limit if you want it to.

Supported audio formats include Microsoft WAV, Apple AIFF, Sun Microsystems AU, 
and raw output. Raw output can also be sent to stdout.

The audio images sound like high pitch buzzing or hissing.


Colors!

Because Baudline can display stereo images in two tone color (one for right, 
the other for left), color can be encoded into the audio file. It's not 
perfect, since there are only two color axes, and it is dependent upon your 
viewer, but it's still pretty cool. Baudline's default axes are green and 
purple, but I like red and cyan on my display.

Erik Olson, the author of Baudline, had an interesting idea about encoding a 
third color channel using phase lag between the left and right channels. Using 
the "-monet" switch in Baudline activates a psuedo-third color channel based on 
the differences in those signals. While I'm still having trouble with getting 
the hues right, it still looks dang cool.

Here are the relevent switches:

	enscribe -color=monet
	baudline -monet


Okay, what can I do with this software?

You can use software such as Ardour or Audacity to blend this audio file in 
with another, thereby marking the audio with secret messages or pictures of 
your dog. 

You can put copyright information in also, but it probably wouldn't be long 
before someone figures out how to erase those (C) watermarks. 


Compiling

Enscribe is distributed as source. To compile it, you need gcc and the 
following software libraries installed:

	gd
	gd-devel
	libsndfile

All are available through http://freshmeat.net

When ready, type

	make

And if you want it available system wide, as root type

	make install


Usage and Options

Enscribe has quite a few options, to see them all, type "enscribe -help"

Here's a sample:


Enscribe 0.1.0      (c) 2004-2008 Jason Downer
Homepage: http://jbd.zayda.net/enscribe/

This is ALPHA software.

Enscribe is free software, distributed under the General Public License.

There is NO warranty; not even for MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.

Usage:  enscribe [switches] input_image output_audio
Valid image formats: Jpeg, Png, WBMP, Xbm, GD, GD2

Switches:
  -inverse, -i           Inverse (negative) input image

  -color=[mode]          Sets color conversion method for the input file:
         g                 greyscale
         m                 monochrome, ugly
         rc                red and cyan (default)
         oa                orange and aqua
         yb                yellow and blue
         gp                green and purple (for Baudline(TM) )
         wb                reyscale on left, inverse on right. Weird.
         monet             pseudo 3-color for "baudline -monet" display.

  -transform-size=[size] iFFT blocksize:
  -ts=[size]               0 = 512
                           1 = 1024 (default)
                           2 = 2048
                           3 = 4096
                           4 = 8192

  -lf=[start]            Set low frequency start of image (default=0%)
  -hf=[stop]             Set high frequency stop of image (default=100%)
  -hiss, -h              Uses hissing rather than buzzing
  -oversample, -o        4X oversample audio (adds hiss)

  -mono, -m              Produce mono ouput audio file.
  -stereo, -s            Produce stereo ouput audio file (default).
  -rate=[rate]           Set audio sample rate (44100 default).

  -wav                   Output wav audio (default)
  -aiff                  Output aiff audio data
  -au                    Output au audio data
  -raw                   Output raw audio data
  -stdout                Output raw audio data to <stdout>

Subformats
  -de                    File format default endian-ness (default)
  -le                    Little Endian
  -be                    Big Endian
  -ce                    Your CPU's endian-ness

  -pcm8                  Signed 8-bit data
  -pcm16                 Signed 16-bit data (default)
  -pcm24                 Signed 24-bit data
  -pcm32                 Signed 32-bit data
  -float                 32-bit floating point
  -double                64-bit floating point
  -ulaw                  U-Law
  -alaw                  A-Law

  -mask filename         Use sound "filename" as FFT mask
  -length=[seconds]      Specify a length in seconds (may lose some detail!)
										

A typical use of this command would look like:

	enscribe -oversample -lf=5 -hf=70 -color=yb -wav north.jpg output.wav -length=20.0 -mask pianosound.wav
	lame output.wav north.mp3


MISC

Note that only greyscale and monochrome are supported in monoaural mode.

To reduced buzzing, I recommend always using the -hiss or -oversample switches. 
They do reduce image quality, but they sound better, and are more impervious to 
digital mangling.

MP3 and Ogg encoders are LOSSY encoders, and what they like to lose most are 
the upper harmonics of a file. If you are going to compress your output audio, 
I suggest you bring down your high frequency stop to around 65 or 70 like this 
"-hf=70".

If you are using your file in a lossless way, feel free to place your images 
anywhere in the spectrum, they should survive just fine.


I hope you enjoy playing around with this software. Feel free to send me 
suggestions, bugs, or links to cool files you've made.

Jason Downer
jbd@cableone.net
http://jbd.zayda.net/enscribe/
