Archive Contents:

TSE.dll     -- Texture Speech Engine DLL
TSE.wdl     -- Texture Speech Engine C-Script
Facepak.dll -- Texture Speech Resource DLL

Facepak.zip -- Texture Speech Resource DLL Source / example images.
Face.mdl    -- Example model.
hello.wav   -- Example sound file for use with the TSESpeech2 action and face.mdl.


Use:
Free for all GameStudio projects without restrictions.


Disclaimer:  If it blows up your machine it's not my fault.


Information:

None of the functions will work in 8bit mode. They may work on 8bit textures
but will most likely be converted to 24bit (16bit internally). I don't know
how the alpha transparency will be handled from TGA based textures. If you
change from windowed to fullscreen or fullscreen to windowed mode the textures
will revert to their A5 original. It is probably a good idea to only run
one Texture Speech Engine at a time for speed considerations. Any more than
that will probably kill your framerate.


Installation:
Unzip TSE.wdl into your templates directory.
Unzip TSE.dll, facepak.dll, and face.mdl into your work directory.
You will have to copy the DLL's manually to your .cd directory when
you publish.

Place this line at the end of your include list in your main project WDL file:

include ;

Versions:

9/9/2002 -- v1.0 -- Released.


Creating your own facepak:

If you have Delphi you can unzip facepak.zip, edit it to your liking (change the images),
and compile it. Makeres.bat will read the facepak.rc information and your images and create
a resource file (facepak.res) which will be included in facepak.dll when you compile the
projetc.

If you don't have Delphi you can use Resource Hacker to change the images in facepak.dll
to any images you want.

You can download Resource Hacker here ->
http://www.users.on.net/johnson/resourcehacker/

Follow the example images on how the mouth should be positions for that letter.


Usage:

// String to say
string hello_there = "Hello there.";

// pass the DLL filename as the parameter (no path info) returns 0 if successful
// use a different resource dll for each model
// use facepak.dll as an example
dllfunction OpenDLL(string);

// returns the frame for the letter
dllfunction TSESetLetter(speech,letter);

// Draw the mouth/face onto the texture
// x,y is the top left of the "mouth" image
dllfunction TSEDrawLetter(speaker_mdl,x,y,frame);

// Utility function returns the length of the string
dllfunction TSEGetLength(speech);

// Make sure to close the DLL when you are done.
dllfunction CloseDLL(x); // returns 0 if successful