@database "TB3.3 Guide" @author "Stuart Kelly" @(c) "Copyright 1996 ©" @$VER: TB3.3 Guide @index in @node Main "Telephone Book V 3.3 Guide By Stuart Kelly Copyright 1996 ©" @{" About " link 1} @{" Copyright " link 2} @{" Install? How? " link install} @{" How To Load It " link loadit} @{" The Buttons " link 3} @{" The Menus " link menu} @{" TB Extras " link TBE} @{" Other Programs " link op} @{" My Address " link address} @{" Index " link in} @{" Suggestions " link suggest} @ENDNODE @node 1 "About" Telephone Book V 3.3 By Stuart Kelly Copyright 1996 © Written in C. I use @{" DCC " link dcc } to compile my programs. Telephone Book only works with Workbench 2.0 and above. If you have any comments or suggestions, write a letter to me at the following @{" Address " link address}. FREEWARE @{" About Me " link stu} @{" Suggestions " link suggest} @{" Thank You " link thanks} @{" Contents " link Main} @ENDNODE @node install "Install? How? To install double click on the install.TB icon. A file requester will apper asking you where you wish to put TB3.3. Press Install to install or Don`t Install to quit install.TB. @{" Contents " link Main} @ENDNODE @node thanks "Thank you" I would like to say Thank You to the following people:- Matthew Dillon - For @{" DCC " link dcc}. Sarah Kelly - For testing TB3.3. Alex Robinson - For testing TB3.3. David Kelly - For his @{" idea " link suggest}. Nicola Innes - For her @{" idea " link suggest}. And also, Thank You for using my program. Send your comments to this @{" address " link address}. @{" Contents " link main} @{" Index " link in} @{" About " link 1} @ENDNODE @node dcc "DCC" DCC stands for Dillon`s C Compiler. It was written by Matthew Dillon. If you don`t use it and want to get into C programing get a copy from any good PC library. eg PDSOFT. It is a cut-down version. I think it is the best C compiler around. DCC is Copyright of Matthew Dillon. This program was created and tested on an:- Amiga 1200 with:- 2 MB Chip Mem. 2 MB Fast Ram. 81 MB SCSI Hard Drive. 1 Extra Disk Drive. (DF1). @{" Contents " link Main} @ENDNODE @node stu "About Stuart Kelly" This part of the guide is all about me. I am 16 years old and go to Cardinal Newman Collage in preston. I am studing:- Maths with Stats (2 Years) - A Level. Business Studies (2 Years) - A Level. English (1 Year) - GCSE. Geography (1 Year) - GCSE. I have only wrote 2 major programs so far (TB3.3 & LockupV4.0), and the other 3 are just little projects I wrote for my own use. In the end I decided to give them away with my major programs. Telephone Book V 3.3 comes with EDel V 1.03. & TBPrint V 1.02. Lockup V 4.0 comes with Timer V 2.2. I don`t know what my next program will be, but it will be good and easy to use. If you have any ideas for me to think about, please write to me at this @{" address " link address}. SK 12/12/1995 19:39:22 @{" My Other Programs " link op } @{" Go Back " link 1} @{" Contents " link Main} @ENDNODE @node 2 "Copyright" Telephone Book By Stuart Kelly Copyright 1994 - 1996 © Telephone Book V 3.3 is Copyrighted by 'Stuart Kelly' ( the Author ). It is Freely Distributable ( FREEWARE ) as long as the following copyright restrictions are met:- 1. You may NOT change the program in any way without the written permission from the Author. 2. All the documents that are on this disk must be given when you copy it. ( See Below ). 3. You may not disassemble or decompile it in any way (See Point 1). 4. You may use it as many times as you wish, it is FREEWARE. 5. If you copy or use the program you accept and agree to all the points above and below. 6. Other programs may not support ( Load ) TB3.3 files without written permission form the Author. 7. You can not alter this guide or any script on this disk. 8. tbmessage_def.h contains 3 functions you may use them in your programs as long as you credit me for it. You may NOT alter tbmessage_def.h as I own the copyright. 9. tbm.o is the object file that you must link with your program to use the functions in tbmessage_def.h. You may NOT alter tbm.o. 10. You may not copy the look of TB`s @{" Screen Mode Window " link SMS} because I created it. It is not an ASL screen mode requester. 11. You may not alter MODS/EC.IFF or MODS/TBT.IFF as it is needed by this guide. It is a picture of what Edit Colours and TBTools looks like. 12. TBView may be used on any disk as long as you do not alter the program, or say it is your own work. 13. TBTools may not be moved as it is set only to work from its drawer. The above points also apply to all programs and docs on this disk:- TB3.3 TB3.3-Guide Install -- Needs Install.TB Install.TB -- install and you don`t need to use CLITB. TBT - Needed by TBTools. TBPrint/TBPrint MODS/New ----\ MODS/into ---| MODS/Edit ----| MODS/Colour -|--- Needed by TB3.3. MODS/EDC ----| MODS/Menu3 --| MODS/EDel ---/ MODS/EC.IFF -- Needed by this guide. See point 11. MODS/TBT.IFF -- Needed by this guide. See point 11. TBTalk/TBPort -- Needed by TB3.3. TBTalk/TBTalk -- TBPort example program. TBTalk/TBTalk.c -- C Code for TBTalk. TBTalk/tbmessage_def.h -- for TBPort. See point 8. TBTalk/tbm.o -- Object file for the above. See point 9. TBTalk/TBTest -- Test TBPort. TBTools/TBTools - Runs TBTools. TBTools/TBView - Needed by TBTools. See point 12. TBTools/RunIt - Neede by TBTools. CLITB -- Needs CLITB_RUN. CLITB_RUN -- Don`t have to use this if installed. NOTE MODS/AppIcon my not be deleted, but may be altered. - Needed by TB3.3. NOTE The EDEL drawer contains the same version as the one in the MODS drawer. This drawer also contains full instructions on how to use EDEL V 1.03. Disclaimer If TB3.3 damages your computer in any way I can`t take any blame. If you read this guide then you should have no problems. Don`t Print Unless Your Printer Is On Or The Program Will Crash! Don`t Delete files unless you really know they are no go. I can`t take any blame for files that are deleted by accident. @{" Contents " link Main} @{" My Address " link address} @{" Commodore-Amiga Copyright " link cac} @ENDNODE @node cac "Commodore-Amiga Copyright notice" Amiga:- is a registered trade mark of Commodore-Amiga inc. Workbench:- is a trade mark of Commodore-Amiga inc. Asl:- is a trade mark of Commodore-Amiga inc. Intuition:- is a trade mark of Commodore-Amiga inc. The above are all:- © Copyright 1985 - 1992 Commodore-Amiga, inc. All Rights Reserved Note that copyright is now owned by Amiga Technologies Germany. @{" Go Back " link 2} @{" Contents " link main} @endnode @node loadit "How To Load TB3.3" You can load TB3.3 from its icon. Double Click on it and the program loads. A window will apper telling you about Telephone Book V 3.3, close this and the main screen will apper. NOTE: You can load TB3.3 by using @{" CLITB " link bugs} @{" The Menus " link menu} @{" The Buttons " link 3} @{" Contents " link Main} @ENDNODE @node 3 "The Buttons" @{" File " link 4} @{" Lockup " link 7} @{" About " link 5} @{" Help " link 8} @{" Quit " link q} @{" ????? " link 9} @{" Contents " link Main} @{" Suggestions " link suggest} @ENDNODE @node 9 "Empty Button" NOTE: EDC is in the MODS/ drawer and must stay here for Menu3 to work. What this button does is up to you. Use EDC on this disk to edit TB3.3 config file ( TB.Config ) to change what this button does. Save is the arrow pointing to the disk. disk<- Load is the arrow pointing away from the disk. disk-> Use EDC before using TB3.3 if you want your option to be used. Press @{" Me " System "MODS/EDC"} to run EDC. @{" The Buttons " link 3} @ENDNODE @node 4 "File" @{" Load " link n1} @{" New " link n4} @{" " link 4} @{" Save " link n2} @{" Export " link n7} @{" Display " link n6} @{" Delete " link n3} @{" Print " link n5} @{" Edit " link n8} Note: When you close the file window all data in memory will be lost. If you have created some new data Save it before closeing the file window. @{" The Buttons " link 3} @ENDNODE @node n8 "Edit" Edit lets you edit a TB file in memory if there is no file in memory then the Edit button is disabled. When the window appers you can edit the info. Press OK to update the file. Press Cancel to use the old data. @{" New Functions " link new} @{" File " link 4} @endnode @node n7 "Export" This will Export any TB3.3 file in memory. The file will be save as a text file which can be changed using ED. @{" File " link 4} @ENDNODE @node n1 "Load" Load a file. When the file requester appers select the file you wish to load and press Load. Press Cancel if you don`t wish to load. @{" File " link 4} @ENDNODE @node n2 "Save" Save a file. When the file requester appers select the place you wish to save the file, and a name for the file in the requester if it is wrong. Then press Save on the requester. Press Cancel if you don`t wish to save. NOTE:- The name for the file will be the current name & surname. Eg:- 'Stuart-Kelly' ( with out the ' marks ). The file will be saved with a project icon, with the default tool set to TB3.3. NOTE:- If you double click on the icon of the file you saved and it is in the same directory as TB3.3. TB3.3 will run. But you will still have to load the file using @{" Load " link n1} in the file window. @{" File " link 4} @ENDNODE @node n3 "Delete" Delete a file. Follow the message on the window. How to enter the filename:- Just click in the box, delete what it contains, and enter the path and filename of the file to be deleted. Then Press Return. - This will delete the filename entered. Close the window to Cancel. - This will not delete any files. NOTE: Delete will not accept wild cards ( eg #? ). @{" File " link 4} @ENDNODE @node n4 "New" When you press 'New' then:- 1. A window will apper called New File. 2. Enter your data. 3. Press OK or Cancel. What data is needed:- Telephone Number - eg 123456 Name - eg Stuart Surname - eg Kelly Door Number - eg 8 First Part Of Road Name - eg Squires Second Part Of Road Name - eg Wood Area - eg Fulwood Town / City - eg Preston Post Code - eg PR2 5QA DCode - eg 01772 @{" File " link 4} @{" New Functions " link new} @ENDNODE @node n5 "Print" Print a file. When the requester appers read the message. The Buttons:- Press Cancel to Quit ( Don`t Print ). Press Print to Print. Don`t Print if your printer is off or is not connected. This may cause TB3.3 to crash. @{" TBPrint V 1.03 " link TBPrint} @{" File " link 4} @ENDNODE @node TBPrint "TBPrint V 1.03" NOTE TBPrint needs @{" CLITB " link bugs}. Don`t Print without the printer on or TBPrint will crash! TBPrint is an extra utility I made. It loads TB3.1 and above files, and displays all the data in the file. TBPrint as 2 windows each with buttons. Window 1 (TBPrint) :- Shows the file loaded and has a button in the top right corner saying `Print As Text`, this lets you save the file as a text file. When you press this button it displays a file requester asking you where to save the file. Save saves the file, Cancel does not save the file. Also Window 1 has a string gadget called PCode. Enter the postcode of the file you loaded if it is wrong or does not have one. Window 2 (Print) :- This has 3 Buttons:- 1. Print As TB3.3 - Prints as TB3.1 would. no Post Code. 2. Print Label - Prints the file as an address label. has the PostCode. 3. Help - Loads help. To Install TBPrint:- 1. Open Shell. 2. Type `copy df0:TBPrint to C:' To Use: C:TBPrint The filename is the TB3.1 and above file you wish to load. Now you can load TB3.3 files without using this disk. @{" New Functions " link new} @{" Go Back " link n5} @ENDNODE @node n6 "Display" This displays the current file. Close the window to continue. @{" File " link 4} @ENDNODE @node 5 "About" This button tells you about TB3.3. @{" The Buttons " link 3} @endnode @node q "Quit" This quits TB3.3. NOTE All extra windows must be closed before quiting. Eg TimerV2.2 can open on most screens. TimerV2.2 must have been removed from TB3.3`s screen or TB3.3 will crash. @{" TimerV2.2 " link op} comes with LockupV4.0. @{" The Menus " link menu} @{" The Buttons " link 3} @ENDNODE @node 7 "Lockup" This opens a window asking for the current Lockup password in memory. If you have not used Edit Lockup Password the password is 'password'. Read the instructions on the window for help. This function only locks Telephone Book. Lockup V 4.0 is another one of my programs which locks Workbench. @{" Other Programs " link op} @{" The Menus " link menu} @{" The Buttons " link 3} @ENDNODE @node 8 "Help" What this button does, depends on what version of Telephone Book you are using. TB3.3 :- A requester will apper asking you what to use to view help (this guide). It has 3 options:- 1. Multiview - Workbench 3.0 Needed. 2. AmigaGuide - Workbench 2.0 Needed. 3. Cancel - Don't View Help. If you have Workbench 3.0 press Multiview or if you have Workbench 2.0 press AmigaGuide. @{" Contents "link 3} @ENDNODE @node in "Index" @{" About TB3.3 " link 1} @{" Load " link n1} @{" Copyright " link 2} @{" Save " link n2} @{" The Buttons " link 3} @{" Delete " link n3} @{" File " link 4} @{" New " link n4} @{" About " link 5} @{" Print " link n5} @{" Quit " link q} @{" Display " link n6} @{" User Button " link 9} @{" Export " link n7} @{" Contents " link Main} @{" Suggestions " link suggest} @{" Other Programs " link op} @{" Address " link address} @{" The Menus " link menu} @{" Lockup " link 7} @{" Edit Lockup Password " link ELP} @{" Menu3 " link menu3} @{" Iconify " link icon} @{" Install? How? " link install} @{" CLITB " link bugs} @{" TBPrint " link TBPrint} @{" How To Load TB3.3 " link loadit} @{" Who Is Stuart Kelly? " link stu} @{" Dillon`s C Compiler " link dcc} @{" Thank You " link thanks} @{" Future " link future} @{" New Functions " link new} @{" Help " link 8} @{" Colours " link colour} @{" Colours Window " ,link "MODS/EC.IFF/MAIN" 0} @{" TBPort " link TBPort} @{" TB_GetScreen() " link tbgs} @{" TB_Finish() " link tbgs} @{" TB_Wait(number) " link tbgs} @{" Note " link NOTE} @{" TBM.o " link tbmo} @{" Screen Mode Select " link SMS} @{" Commodore-Amiga " link cac} @{" Edit " link n8} @{" TBExtras " link TBE} @{" TBView " link TBV} @{" TBTools " link TBT} @{" To Do " link, "ToDo/MAIN" 0} @{" " link in} Index For:- TB3.3-Guide. @ENDNODE @node address "My Address" My address:- Stuart Kelly 8 Squires Wood Fulwood Preston Lancashire PR2 5QA Send me anything to the above address. @{" Contents " link Main} @ENDNODE @node bugs "Problems in the program" 1. Help. 2. Custom Button. 3. Menu 3. 4. New. 5. Colours. 6. TBPort. TB3.3 does not need CLITB. To make the above functions work, either:- * Double click on CLITB_RUN. * Double click on TB3.3. How to use CLITB:- A window will apper called CLITB V 2.0. The window has 4 gadgets:- 1. The one that looks like a printer will load TBPrint. It needs a filename to be entered. See 4. 2. The one that looks like a phone loads TB3.3. 3. The one that says `QUIT` quits CLITB. 4. This one is a string gadget into which you will enter the full path & filename of the file you wish TBPrint to load. If you find any bugs please write to me @{" at "link address}. @{" TBPrint " link TBPrint} @{" Contents " link Main} @ENDNODE @node op "Other Programs" Other Programs:- Lockup Version 4.0 -- Locks up Workbench with a password. Timer Version 2.2 -- Tells you how long you have been on the computer, and the Amiga's time. EDel Version 1.03 -- Delete files. Full name is Easy Delete. Versions Of Telephone Book:- 1.0 -- First Version. 2.0 -- More options added, with a new file format. 3.0 -- More options added, especially the Print option. 3.1 -- GUI added, most of the old code scraped. Sent To PD. 3.2 -- Some more options and some problems solved. Sent To PD. 3.3 -- Works form Icon! TBPort added, TBTools added. Sent To PD. @{" Future " link future} @{" New Functions " link new} @{" Contents " link Main} @ENDNODE @node future "Future" Things that I could do add to a future version of Telephone Book:- 1. Be able to add a copper list to the screen. 2. View any file ( would use multiview ). 3. Auto save file. 4. More User Buttons. Please send me any ideas of your own to this @{" address " link address}. @{" To Do ", link "ToDo/MAIN"} @{" TBPrint " link TBPrint} @{" Suggestions " link suggest} @{" Contents " link Main} @ENDNODE @node suggest "Suggestions" These are the suggestions people have sent in for after V3 was made:- 1. Add a GUI to your program. - David Kelly. -> Good Idea. -> Done. - TB3.1. 2. Make it print. - Nicola Innes. -> Why didn't I think of that. -> Done. - TB3.1. Adding the postcode took a long time as I have to rewrite the Load, Save, Export, Display, New, and Print. I also had to rewrite most of TBPrint. If you can write programs in C they you can send me some code for a menu option. It will be added to the Extras menu or given a menu of its own if it is good. If you do send me some code send me a bit of text about what the function does. I compile my programs using @{" DCC " link dcc}. You could write a program that uses @{" TBPort " link TBPort}. @{" My Address " link address} @{" Future " link future} @{" Contents " link Main} @ENDNODE @node menu "The Menus" @{" TB3.3 " link menu} @{" File Window " link 4} @{" Quit " link q} @{" Extras " link menu } @{" Lockup " link 7} @{" Edit Lockup Password " link ELP} @{" ~~~~~~~~~~~~~~~~~~~~ " link menu } @{" Menu3 " link menu3} @{" Iconify " link icon} @{" TBPort " link tbport} @{" Config " link menu} @{" Colours " link colour} @{" Screen " link SMS} @{" Contents " link main} @ENDNODE @node icon "Iconify" Iconify closes TB3.3 down and places an icon on Workbench`s window. If you double click on this icon TB3.3 will apper. If another program is runing on the screen this will not work. To edit the icon load IconEdit or and icon editing program. 1. Load -> Mods/AppIcon. 2. SaveAs -> Mods/AppIcon. 3. It must be saved as Mods/AppIcon. Type :- Menu. Short Cut :- Right Amiga key and i. Name Of Icon:- TB3.3. @{" The Menus " link menu} @{" New Functions " link new} @ENDNODE @node ELP "Edit Lockup Password" This opens a window like the one that opens when you select Lockup, but it lets you edit the password in memory. Read the instructions on the window for help. @{" The Menus " link menu} @ENDNODE @node menu3 "How To Use Menu3" NOTE: Menu3 must be in The MODS/ drawer to use it! If another program is running on the screen this will not work. Menu3 is a program that needs TB3.3 to run it. It has lots of options to choose from and it even lets you edit TB3.3`s config file. Buttons:- Some buttons requires somthing to be in the From: and To: string gadgets. eg Diskcopy needs From: and To:. Config:- Load @{" EDC " link 9} so that you can edit TB3.3 config file. Run:- Run any program needs From: ( program to run). Delete:- Delete command needs From: ( eg ram:#?). ED:- Edit a file needs From: ( filename ). Diskcopy:- Needs From: ( Drive eg DF0:) and To: ( Drive eg DF0:). Format:- Needs From: ( Drive eg DF0:) and To: ( Name eg Empty). Calc:- Loads a calculator. Clock:- Loads Clock. Copy:- Needs From: ( ram:#?) and To: ( df0:). EDel:- Delete Files. @{" LockupV4.0 " link op}:- Needs From: ( where it is eg SYS:WBStartup/). @{" The Menus " link menu} @{" New Functions " link new} @ENDNODE @node new "New Functions" The new functions are from TB3.2 if not otherwise stated. New functions:- 1. Can now store your Post Code. 2. @{" Iconify " link icon} 3. @{" Menu 3 " link menu3} 4. @{" User Button " link 9} 5. @{" Export " link n7} 6. @{" Help " link 8} 7. @{" Colours V2 " link colour} - TB3.3 8. @{" TBPort " link TBPort} - TB3.3 9. @{" Screen " link SMS} - TB3.3 10. @{" Edit " link n8} - TB3.3 11. Can now strore dilling codes. Eg 01772. - TB3.3 Other things I have added:- 1. @{" TBPrint V 1.03 " link TBPrint} 2. Improved Display. - TB3.3 3. Use Workbench 3 black on white menus if you have Workbench 3 or above. 4. @{" CLITB " link bugs} 5. @{" Install " link install} 6. Improved @{" New " link n4}. 7. Don`t have to use CLITB ( Load from Workbench ). - TB3.3. 8. Improved @{" Print " link n5}. 9. @{" TBTools " link TBT} - Use TB3.3 functions from a GUI. - TB3.3. 10. @{" TBView2 " link TBV} - View TB3.3 files - TB3.3 @{" Suggestions " link suggest} @{" To Do " link, "ToDo/MAIN" 0} @{" Contents " link main} @ENDNODE @node colour "Colours" MODS/Colour ( Version 2 ) This lets you alter TB3.3 colours. NOTE: TB3.3 will open on the last screen if TB3.3 is not running or will open on Workbench if it is the only screen. The @{" Window ", link "MODS/EC.IFF/MAIN" 0}, which has these functions:- NOTE: Colour 0 is the background colour. A - Shows what colour 1 looks like. H - Shows what colour 2 looks like. C - Shows what colour 3 looks like. D - Alter chosen colour using values in R, G & B. E - QUIT but use built in colours. F - Quit but use changed colours. G - Set Green Colour Value 0 - 15. Can use the slider under the gadget. R - Set Red Colour Value 0 - 15. Can use the slider under the gadget. B - Set Blue Colur Value 0 - 15. Can use the slider under the gadget. I - Work on Colour 1. J - Work on Colour 2. K - Work on Colour 3. L - Work on Back Ground Colour (Colour 0). Type:- Menu. Short cut:- Right Amiga key and C. What I Do:- Change colours of TB3.3. @{" Menus " link menu} @{" New Functions " link new} @{" Contents " link Main} @ENDNODE @ENDNODE @node tbport "TBPort" For: TBPort V 2. Type:- Menu. Short Cut:- Right Amiga key and T. What I Do:- Lets Programs written by other programmers to get access to TB Screen. The Buttons:- ???:- About TBPort2. -- Version 2 Only. Quit Now:- Quit. -- Version 2 Only. Run:- Lets you run any program that uses TBPort (eg TBTalk). -- Version 2 Only. The windows Close Gadget also lets you quit. Close all the windows of other programs before quiting. The number of windows should be 0. TBPort V 1 - Not supplied as is not as good as TBPort2. ------------------------------------------------------------------------- TBtest:- To use TBTest press run on TBPort2 and select TBTest. Read all the requesters and press Ok on them. TBTest will tell you what kickstart version you have, and will test TBPort2. ------------------------------------------------------------------------- TBTalk:- This program shows you what you can do with TBPort. TBTalk has 3 options:- 1. Press the Close Gadget to Quit. 2. Press the Left Mouse Button to draw an ellipse. 3. Press the Right Mouse Button to change the colour of the ellipse drawn. NOTE: the 'EC' button at the bottom of the window lets you edit the @{" colours " link colour} you are using. Just press it and Edit Colours will apper. The full source code is included so you can see how to use TBPorts functions. @{" TBTalk.c - Source Code ", link "TBTalk/TBTalk.c/MAIN" 0} ------------------------------------------------------------------------- Programmers:- TBPort is an easy and simple way for a program to get the address of TB`s screen. The next version will have more commands, that will also be easy to use. @{" TBM.o " link tbmo} must be linked with your program if you are to use the functions in tbmesssage_def.h. The current version only gives you access to the screen. The tbmessage_def.h file contains 4 functions:- @{" struct Screen *TB_GetTBScreen() " link tbgs} @{" BOOL TB_FinishNow() " link tbgs} @{" TB_Wait(number) " link tbgs} @{" TB_SayM(char *tb_text) " link tbgs} Here is the tbmessage_def.h file:- @{" tbmessage_def.h ", link "TBTalk/tbmessage_def.h/MAIN" 0} TBTalk is an example of how you would use the tbmessage_def.h file, I have included the source code so you can see how to use the 3 functions. See above to see how to use it. @{" TBM.o " link tbmo} @{" NOTE " link NOTE} @{" TBTalk.c ", link "TBTalk/TBTalk.c/MAIN" 0} @{" New Functions " link new} @{" The Menus " link menu} @{" Contents " link main} @endnode @node tbgs "The functions of tbmessage_def.h" Functions of tbmessage_def.h that programmers can use ( C only ):- TB_Wait(number); - Like Delay except waits in seconds. ---------------------------------------------------------------------- struct Screen *TB_GetScreen(); :- This will return a pointer to TB`s screen if TB is runing else it will return NULL. If it does return NULL your program must exit or run on Workbench. ---------------------------------------------------------------------- BOOL TB_Finish(); :- You MUST do this at the end of your program ( after you have closed any windows you have opened ), if you have used TB_GetScreen();. If you don`t get the screen you must still use TB_FinishNow(); See TBTalk.c for example code. If you don`t TBPort will not be able to exit! Returns TRUE if it works. --------------------------------------------------------------------- BOOL TB_SayM(char *tb_text); :- Lets you display messages on TB's Screen. How to use it:- TB_SayM(" TBTalk By Stuart Kelly \n" " Copyright 1996 © \n" "------------------------ "); Code from TBTalk.c @{" NOTE " link NOTE} @{" TBPort " link TBPort} @endnode @node NOTE "Note" NOTE: While TBPort is working you will not be albe to use any of TB`s functions. If you press the close gadget then TBPort will exit and you will be able to use TB3.3 in the normal way. If the number of windows is not 0 TBPort will not be able to exit. If this is the case and you want to quit, close all the windows on the screen that are from other programs. If the number of windows is then 0 you will be able to quit. Programmers MUST tell TBPort that they have finished using TB3.3`s screen using @{" TB_FinishNow() " link tbgs}. @{" TBPort " link TBPort} @endnode @node tbmo "TBM.o" 'tbm.o' is an object file. It contains the functions defined in 'tbmessage_def.h'. Example of how to link tbm.o with any program. Using Dice:- dcc:bin/dcc TBTalk.c tbm.o -o TBTalk This would link TBTalk.c with tbm.o and compile it as TBTalk. I don`t know if tbm.o will work with other C compilers. If it does or does not work, please send me a letter telling me if it does work with other C compilers. @{" TBPort " link TBPort} @endnode @node SMS "Select Screen Mode" Select Screen Mode ( SSM ) Window by Stuart Kelly. @{" Copyright 1996 © " link 2} Type:- Menu Function Short Cut:- Right Amiga key and S. What I Do:- Change the screen mode of TB. When you select this function a window will apper asking you to select a screen mode. Availble Modes:- Hires 640 x 256 Lores 640 x 256 Hires InterLace 640 x 512 Lores InterLace 640 x 512 The above list is what will apper in the list gadget. Pick one of the modes by pressing the right mouse button. The one you pick will have a bule border when you press the mouse button. The Buttons:- OK:- Use the selected screen mode. Cancel:- Go Back to TB`s screen and use the old screen mode. DON`T press OK until you have selected a screen mode. Why Dose the Screen Mode Select Window only have 4 modes? It only has 4 modes because I created the Window. It is not an ASL screen mode requester. I didn`t use ASL as I don`t know how to use the screen mode requster. In the future I may use ASL`s screen mode requester as it has more modes. In the future I will add some more modes. Also I may give away some files that will let you use SSM Requesters in your programs. @{" The Menus " link menu} @{" New Functions " link new} @{" Contents " link Main} @endnode @node TBE "TB Extras" @{" TBTools " link TBT} @{" TBView " link TBV} @{" New Functions " link new} @{" Suggestions " link suggest} @{" Contents " link main} @endnode @node TBT "TBTools" TBTools is a program that lets you access some of the programs that come with TB3.3 TBTools has the following buttons:- TB3.3 - Run Telephone Book V 3.3 @{" TBView " link TBV} - Run TBView. Help - View this guide (Uses Multiview). @{" Menu 3 " link Menu3} - Run Menu 3. QUIT - Quit TBTools. About - About TBTools. @{" Colours " link colour} - Edit colours. EDel - Deletes files. @{" TBTools Menus " link TBM} @{" Press me ", link "MODS/TBT.IFF/MAIN"} to view the window; To run TBTools double click on the TBTools icon in the TBTools drawer. @{" TBExtras " link TBE} @{" New Functions " link new} @endnode @node TBV "TBView" Name of program:- TBView. Where is it? :- TBTools/TBView. What is it for?:- To view TB3.3 files with out using TB3.3. TBView lets you view TB3.3 files with out using TB3.3 in anyway. To use it you can use @{" TBTools " link TBT} which has a file requester or you can use it from shell:- 'TBView [filename]' The filename must be a TB file or the program may not work. @{" TBExtras " link TBE} @{" New Functions " link new} @endnode @node TBM "TBTools Menus" TBTools Progs | | About - About TBTools. TB3.3 - Run TB3.3. Help - View This Guide. @{" TBView " link TBV } @{" Menu 3 " link Menu3} ~~~~~~~ @{" Colours " link colour} Quit - Quit TBTools. @{" RunIt " link RI} @{" TBTools " link TBT} @endnode @node RI "RunIt" RunIt lets you run any program. Usage:- 1. Click in the string gadget. 2. Enter the path and name of the program you want to run. Eg:- 'Multiview'. 3. Press Run. Note:- If you change the window size the gadgets will also change size. @{" TBTools Menus " link TBM} @endnode ; @{" text", link "file/file/MAIN" 0} ; @toc a - make a the contents.