TIGCC Tools Suite - eBookGenerator (c) TI-Chess Team
Usage Anno Domini 2000

Introduction

Making own eBooks is quite simple. The eBook Generator Tool (ttebkgen) uses a standard text file as input and will generate an ebook as output. For usage information of the eBook Generator Tool just type ttebkgen and hit enter or read the paragraph at the bottom of this document.
Examine the included example to see how the eBook Generator works. For information on possible metatags have a look into file ebook-metatags-specification.html.

NOTE: the input text file should not contain any foreign characters, because they may not rendered correctly on the calculator!!!

NOTE2: If you have any problems making eBooks, please use the message board of the TI-Chess Team HQ (Forum: TIGCC Tools Suite) at http://tict.ticalc.org to post your questions !!!!

What Do You Need

Necessary Tools from the TIGCC Tools Suite (included in this release): If you want to make own title pictures:
Image Studio v1.1 by Matt Johnson. You can download ImageStudio at:

How To Make Own Title Pictures

Each eBook will need a title picture of the size 160x100. If you doesn't support one a default title picture will be used.
To make an own picture generate a BMP file with extensions 160x100. Then start ImageStudio and open this BMP file. Use the sliders until you are pleased with the result. Set the ImageMode of ImageStudio to Standard Grayscale (4 colors) and use the export menu point to export the image data to a binary file (make sure "RLE Compressed" is NOT checked).
Afterwards use the -t option of ttebkgen to make an ebook with your own title picture.

for example if you have saved the image to file "mytitle.bin" use "-t mytitle.bin"

Usage Info from TTEbkGen (Please Read Carefully !!!)

Usage: ttebkgen [-keepfiles] [-t titlefilename] infile variablename "description"

the infile must contain the complete text of the final ebook.
split points must be marked within the inputfile with tag
<--split--> on a single line.
NOTES:
 (1) the maximum uncompressed size of a ebook part is 65518 bytes.
 (2) the final size of the ebook cannot extend 65608 bytes
     (including PC header infos)
 (3) if a part is too long, define more splitpoints in the infile
 (4) if the complete text will not fit into one ebook, split
     the text into two or more ebooks
 (5) varname is used as outfile name and as varname on the calculator
 (6) don't forget to enclose the description in quotes !!
 (7) just the first 19 character of the description are used
 (8) both versions (ti89 and ti92p) are generated automatically
 (9) the inputfile will be copied to file tictinput before processing
(11) titlefile must be a 4-grayscale pic with 160x100 pixels in binary form
     generated with ImageStudio (not compressed binary)
(12) don't name any of your files with prefix tictinput!
(13) don't name any of your files pXXX.pck where XXX is an 3 digit integer!
(14) don't use extension pck for your files!

Thomas Nussbaumer Graz,Austria 30/09/2000