HibView 0.1
15 April 2003
Programmer: hibou
Mail: hibou@bonbon.net
Web: http://nico.hibou.free.fr/
________________________________________________________________
****************************************************************
Description:
****************************************************************
  HibView is a program that is enable to read text very fast and can read every formats of Txtrider, it reads the pictures too and strings.
  For those who don't konw TxtRider, HibView is a text reader: it reads the textes normaly written in the Ti-OS editor, but faster and allow text format as underline, vector, the insertion of picture, pretty-print expression and hypertext link.
  The read of PIC and STR files has nothing particular. The text reading is improved comparing to TxtRider.
  HibView have draw in a normal way exposant (we couldn't have exposant of font 3 in TxtRider): with it, there is indice #D. There is the conjugate format too : #J.
  Finaly, there is a support of hypertext link: you include the name of a text of you calculator in a text; a number will be shown at the drawing of the text; then, you tape the number of the link and HibView will open the linked text.
  HibView can support the ziplib and Komp compressions : so you can compress your files with the incorporated tools and read compressed files while getting some memory space.
  I remind you that HibView is only a viewer and not an editor. To modify or create your text, you can use the editor on the calculator, or use a software on a PC which will help you in formatting the text. You can find these editors on the web, on the site Ti-Rex (www.ti-rex.net) or www.ticalc.org, or on my site: http://nico.hibou.free.fr/cours.php?lang=eng.

________________________________________________________________
****************************************************************
Format of line:
****************************************************************
  You can chose the alignement of the text. To do that, you have to write the character '&' followed by the letter (or the number) of the format you chose.
&L : left alignement
&C : centered text
&R : right alignement
&\ : margin of 0
&, : margin of 10
&; : margin of 20
&. : margin of 30
&Mxxx : personalized margin of xxx pixcels
Exemple: &M023 : margin of 23 pixels

  You can insert a line separator, with the same syntax as previously:
&- : simple line separator
&= : double line separator

  You can insert pictures:
&Pfold\pic  The picture will be placed where you have placed the symbol &... and centered in the screen.

  You can insert mathematic expression drawn in pretty-print (like in the Home screen of the calculator):
&Eexpression  The expresion will be written centered in the screen.

  Last, to draw simply the character & at the begining of a text, or after a format of line:
&&
  Warning! In a middle of a line, the character & cannot be considered as a format of line, in consquence, only one character & is necessary to draw a &!
  A particular exemple : if you want to draw to & at the beginning of a line, you should write:
&&&

________________________________________________________________
****************************************************************
Format of character:
****************************************************************
  The format of character can be placed everywhere in the text, contrary to the previous ones.
  Then we can choose the size of the font:
#1 : little font
#2 : normal font
#3 : big font

  You can also underline:
#U : underline
#N : underline dotted

  At the opposite, there is the vector and the conjugate:
#V : vector
#J : conjugate

  And the exponent and the suffix:
#E : exponent
#D : suffix

  And more:
#I : the color is inversed (write in white on black)
#S : strikethrought
#Cxxx : draw the character number xxx : the character ^| can be displayed only in writting #C012.

  A last one is the word warp: this function permit an automatic return of line without cutting words:
#W : word warp

  Lastly, to show the symbol #, you have to write:
##

________________________________________________________________
****************************************************************
The hypertext link:
****************************************************************
  Everywhere in the text, you can insert a link: it will be displayed as un number in a special box and will open the choosen text. Its syntax is the following one:
#Lfold\text#xx#L
#xx is optional : it indicates the number of the bookmark you want to show in the linked text. Without it, the text will be shown at its beginning.
  Exemple:
/* tape in the text : */
this is the link of the explaination of the bookmarks :#Lmain/hibhelp#6#L
/* it draws : */
this is the link of the explaination of the bookmarks :[0]
/* [0] will be in fact a 0 un a special box.. The numbers of the links are attributed by order in the text */

________________________________________________________________
****************************************************************
The bookmarks:
****************************************************************
  You can indicate the most important lines of your text. To do that, in the text editor of the calculator, on the line where you want to place a bookmark, press on [F2] (Command) then on [2] (Page Break). The character ^| will be displayed in the margin.

________________________________________________________________
****************************************************************
The keys:
****************************************************************
  At any moment, you can turn off your calculator with the key [HOME] (ti89) or [HAND] (ti92).
  At any moment too, you can control the contrast with:
[+] or [-] + [DIAM]

________________________________________________________________
****************************************************************
The starting menu:
****************************************************************
  To acceed to the function on the top of the screen, just press on the function keys:

[F1] : File (unavailable)
[F2] : Favoris
[F3] : History
[F4] : ziplib or komp compression
[F5] : ? => access to options and About

  Else, select a folder, and every available file that HibView can show will appear on the right. Then select the file and press [ENTER].
  Informations about file attributes: the first letter show the type of the file. T for text, P for picture and S for STR. Near, a letter can appear : it is the mode of compresion of the file: Z for ziplib and K for Komp.

________________________________________________________________
****************************************************************
While reading the text:
****************************************************************
  The menu:
[F1] : Help
[F2] : Favoris
[F3] : History
[F4] : Search
[F5] : ? => access to log file, options and About

  The scrolling:
[UP]-[DOWN] to scroll
    + [2ND] page by page
    + [DIAM] top and bottom

  The bookmarks:
[APPS] : bookmarks

  The links:
[CATALOG] (ti89) ou [MODE] (ti92): hypertext link
=> then you tape the number with the numerique pad
	[ESC] to cancel
	[ENTER] to go to the link
	[<-] to correct
  If the multitexting option is activated, the text in reading will be saved in memory, and will be restablisheed at the end of the reading of the opened text. A disadvantage: maybe there is not enought memory to open another text.

  Some shortcuts:
[0], [1], ..., [9] : shortcuts : go directly to the bookmark n x (limited to 10)

________________________________________________________________
****************************************************************
The Favoris:
****************************************************************
  Every go by this menu. Then, when the menu appear:
 - with [ENTER], you open the coressponding text
 - with [<-], you can delete an entry
 - with [APPS], you can change of mode : normal / mooving entries. In the mooving mode, the cursor will change, et you shoul see that in mooving up and down the cursor, you moove the entry. To get off this mode, press [APPS] again.
  The first entry "Add" allow to add a file in the favoris. The file added would be the text you are reading, or the text your cursor point on in the satring menu. Naturally, we can't add a folder.

________________________________________________________________
****************************************************************
The History:
****************************************************************
  When you open a text, its name will be add at the beginnig of the history. It can create ridiculous double: you can delete it in pressing on 1.
when the menu is opened, with [<-], you can delete an entry

________________________________________________________________
****************************************************************
The options:
****************************************************************
  How to navigate:
[UP]-[DOWN] to choose the optin to change
[LEFT]-[RIGHT] to change the option
[ENTER] to save the changes
[ESC] to cancel the modifications

  Nb history max: it is the maximum number of entries that can have the history
  Speed of the menus: it is the waiting time between 2 key pressures
  Clear doubles in history: deletes the doubles in the history automaticaly
  Automatic exit: after a loading of hibview in command line ( hibview("text") ), quit automaticaly, or show the starting menu
  Confirm deleting: in the favoris and history menu, ask for deleting
  Confirm delete doubles: ask for a confirmation defore deleting the double in the history menu
  Generate log file: activated the creation of a log file on syntax error of text format
  Enable multitexting: with the opening of a link, keep in memory the previous text
