home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / HP95_100 / PIMS / TREE / TREE.DOC next >
Encoding:
Text File  |  1995-04-08  |  10.2 KB  |  258 lines
  1. ===============================================================================
  2.  
  3.                        TREE for HP 100LX Version 1.20E
  4.  
  5.                 English  Manual Copyright (C) 1995       Shozo Ito
  6.        Original Japanese Manual Copyright (C) 1991/92/93 Rey Kinoshita
  7.                                 Copyright (C) 1994/95    Shozo Ito
  8.  
  9. ===============================================================================
  10.  
  11.  
  12. 1. What is the use of this program?
  13.   If you want to enjoy a relaxing moment, needs rest from hard work, or
  14.   want to enjoy easy drawing with a few pressing of keys, then this 
  15.   program is for you. Have a good time!
  16.  
  17.  
  18.  
  19. 2. It's so easy.
  20.   If you do not feel like reading this document, just register this program
  21.   in the system manager and run it. It looks and works just like built-in
  22.   PIMs, so you should have no problem. Come back to this document when you
  23.   want to know more about it. But any user must read and follow "Section 5:
  24.   Copyright & Agreement".
  25.  
  26.  
  27.  
  28. 3.  How to use
  29. 3.1 Installing
  30.   Put TREE.EXM and TREE.ICN in the same directory. Register TREE.EXM
  31.   in the system manager. (Please read the manual of HP100/200LX
  32.   if you do not know how.)
  33.  
  34. 3.2 Notice to Users of Former Versions
  35.   When you first run this program, you will see the message that TREE.ENV
  36.   is illegal. Please ignore this error and press ENTER. You will not see
  37.   the message again.
  38.  
  39. 3.3 Operation
  40.   The program has a menu system that is very similar to built-in PIMs
  41.   except a few minor differences.
  42.  
  43.   Function keys:
  44.   [Parameters]  Sets parameters.
  45.   [Draw]        Draws trees without erasing.
  46.   [Draw New]    Erases the screen and draws new trees.
  47.   [Erase]       Erases the screen.
  48.   [Open]        Reads a file.
  49.   [Save]        Saves the current image in a file.
  50.  
  51.   By choosing [Menu][Help][Japanese Help] you can see a Japanese help
  52.   if your HP100/200LX supports Japanese.
  53.   If it doesn't, all you see is meaningless characters.
  54.  
  55. 3.4 Setting Parameters (Values inside < > are defaults.)
  56.   [Variety]  < OFF >
  57.   Branches usually spread within a fixed angle that is the same for
  58.   all the trees. If this option is on, the angle is determined
  59.   randomly for each tree and the setting for [Branches] is ignored.
  60.  
  61.   [Gradation] < ON >
  62.   Uses gray scale.
  63.  
  64.   [Boulevard] < OFF >
  65.   Draws a boulevard. The larger value of [Height] is ignored.
  66.  
  67.   [Number=32] < ON >
  68.   The number of trees are forced to 32, when [Boulevard] is on.
  69.  
  70.   [Light] < 4 >
  71.   Brightness of trees. The larger the value, the darker the trees.
  72.  
  73.   [Number] < 7 >
  74.   Number of trees. No trees are drawn when this is set to 0.
  75.  
  76.   [Trunks] < 6 >
  77.   Specifies the biggness of trunks. The larger value means thinner trees.
  78.   Numbers from 1 to 999 are accepted, but there is no sense in
  79.   specifing a vaue greater than about 70, at which point, no trees are drawn.
  80.  
  81.   [Branches] < 1 - 45 >
  82.   Controls how wide branches spread. The larger the value, the wider 
  83.   the branches spread. Specify both the minimum and the maximum values.
  84.   The width is determined randomly for each tree within this range.
  85.   The values should be from 1 to 70.
  86.  
  87.   [Height]  < 1 - 35 >
  88.   Specify the minimum and the maximum heights of the trees. The height of 
  89.   each tree varies randomly within this range. The values from 1 to 40
  90.   are allowed.  The larger the value, the higher the trees.
  91.  
  92.   [Area] < 0 - 639 >
  93.   Specify the left and right ends of the area that you want to use.
  94.   The left end of the screen is 0. The right end is 639.
  95.  
  96. 3.5 Setting Advanced Parameters(The values in < > are defaults.)
  97.   [Auto Open] <OFF>
  98.   Automatically reads the file that was last saved or read when this progem
  99.   is invoked.
  100.  
  101.   [Auto Start]  <OFF>
  102.   Automatically starts drawing when this program is run.
  103.  
  104.   [Auto Repeat]  <OFF>
  105.   Automatically redraws the trees at an interval specified in [Interval].
  106.  
  107.   [Drawing/Task Switch] <Medium/Medium>
  108.   As you draw trees faster, the response to 'alarms' and 'Stopwatch'
  109.   becomes slower. Choose a balance. Note that the reponse to
  110.   blue keys is the same for all the choices.
  111.   Quick/Slow: 
  112.     Drawing is the fastest. Alarms do not go off until all the trees
  113.     are drawn.
  114.   Medium/Medium:
  115.     Drawing speed of each tree is the same as Quck/Slow, but the program
  116.     waits a little longer before each tree is drawn.
  117.     Alarms go off after a tree is drawn.
  118.   Slow/Quick:
  119.     The drawing speed is the slowest. Alarms go off even when a tree is
  120.     being drawn.
  121.  
  122.   [Interval] < 10 >
  123.   Specifies the interval for [Auto Redraw]. The unit is in seconds.
  124.   New trees are automatically drawn at this interval.
  125.  
  126.   [Delay] < 0 - 0 >
  127.   Specifies how fast(or how slow) trees are drawn. The number 0 means 
  128.   the fastest drawing. The larger value means slower drawing.
  129.   Specify the minimum and maximum speeds. The speed fluctuates within 
  130.   this range. If you do not like the fluctuation, use the same number
  131.   for the two values.
  132.   The values are only estimates. The speed for 10, for example, is NOT
  133.   twice as fast as that for 20.
  134.  
  135. 3.6 Full Screen Mode
  136.   [Full Screen]
  137.   Usually trees are not drawn at the top and the buttom parts of the screen,
  138.   where the program title, date and time, and the function key labels are 
  139.   displayed. When this option is on, trees are drawn on the whole screen.
  140.  
  141.   [Hide Frame]
  142.   When this option is on, the title bar at the top of the screen and the 
  143.   function key labels are not displayed. Use this option to see the whole 
  144.   screen. Valid only when [Full Screen] is on.
  145.  
  146. 3.7 Reading and Writing a File
  147.   The top card(business card) of HP100/200LX uses a format called PCX. 
  148.   This program can read and write files of this format. When a file is 
  149.   read or written, the name of the file is remembered. When you use 
  150.   the [Save] command, this name is used to save the image. If you want to 
  151.   cancel this name, select [New]. This will erase the name and the screen.
  152.   [Open]    Reads a PCX file.
  153.   [Save]    Saves the current image as a PCX file. The current image is
  154.             saved with the same name as the last file you read or wrote.
  155.             If no file has been read or written, this command works
  156.             in the same way as [Save As].
  157.   [Save As] Saves the current image as a PCX file with a new name.
  158.   [New]     Erases the current image. The file name is also erased
  159.             and you have to input a file name again, to save the image.
  160.  
  161. 3.8 Two Ways to Erase the Screen
  162.   There are two different ways to erase the screen, selecting [New] and 
  163.   selecting [Erase]. When a file is read or written, the name is 
  164.   remembered and used when [Save] is selected. If you select [New] to
  165.   erase the screen, this name is also erased. If you use [Erase], this
  166.   name is not erased.
  167.  
  168. 3.9 Notice
  169.   When you leave the program, a file TREE.ENV is created in C:\_DAT\.
  170.   This file records the parameters and these are retrieved next time
  171.   you run this program. You may delete this file, but the parameters are
  172.   reset to default values.
  173.  
  174.  
  175.  
  176. 4.  Use of Source Files
  177.   Source files are included in this package. To make the executable file,
  178.   however, you need E2M.EXE, INClude and OBJect files for EXM programs,
  179.   as well as the menu and dialogue library for HP100LX written by the author.
  180.   The source files for this library are not included in this package.
  181.  
  182.  
  183.  
  184. 5.  Copyright & Agreement
  185.   <Copyright>
  186.   All the files in this package are copyright.
  187.   The execution file is copyright by Rey Kinoshita and Shozo Ito. 
  188.   This document is copyright by Shozo Ito.
  189.   The source files are copyright either by Rey Kinoshita or Shozo Ito
  190.   as indicated in each file.
  191.   The icon file is copyright by Padorappa.
  192.  
  193.   <Agreement about this package>
  194.   This software is provided AS IS without any warranty of any kind.
  195.   The authors are in no way liable to any damage arising from the use of
  196.   or inability to use this software.
  197.   The use and redistribution of this package is allowed only when all of
  198.   the following conditions are met:
  199.     1. You may not make a profit out of the use or distribution
  200.        of this software.
  201.     2. You may not modify any files in the package.
  202.     3. No files may be added to or deleted from the original package.
  203.   No report to the authors about redistribition is needed as long as 
  204.   all the conditions above are met.
  205.   Any other things that are not explicitly permitted in this document 
  206.   are prohibited.
  207.  
  208.   <Agreement about the icon file>
  209.   You may make a change to the icon file.
  210.   Distribution of the origianl or changed icon file including
  211.   uploading it to BBSes is allowed as long as no charge is made
  212.   for the distribution other than shipping and handling charges.
  213.   The changed file, however, may not be included in
  214.   the original package of TREE.
  215.  
  216.  
  217.  
  218. 6.  Acknowledgement
  219.   My sincerest thanks goes to Rey, who wrote the original TREE
  220.   and kindly permitted the porting to HP100/200LX. If this program makes
  221.   people happy, that is largely because of his effort.
  222.   I am also obliged to Padorappa, who added to the attractiveness of this
  223.   program by making a beautiful icon.
  224.                                                        Shozo
  225.  
  226.  
  227. 7.  History
  228.   1.00   The first release(Beta test)
  229.   1.10   The first complete version.
  230.          Can call other EXMs while drawing. Can stop drawing.
  231.          Support of auto redraw and speed control features.
  232.          Addition of buttons to reset parameters to defaults.
  233.   1.15   A test version for 1.20.
  234.   1.20   Can read and write PCX files.
  235.          Option [Full Screen] is added.
  236.          Support of ALT for menu operation.
  237.   1.20E  The same as 1.20 except that the document is revised
  238.          and written in English.
  239.  
  240.   - Origin -
  241.   This program is based on a program written by Rey for NEC PC9801 series.
  242.   The original program is called 'Shokujuyasan 4-go'(version 4.2).
  243.  
  244.  
  245.  
  246. 8. Contact Address
  247.  
  248.    NiftyServe: GCH04604
  249.    Internet:   GCH04604@niftyserve.or.jp
  250.    CompuServe: 100225,1543 (Avoid if possible)
  251.  
  252.                                            Shozo Ito
  253.  
  254.    Note: The author do not access CompuServe very often,
  255.          so contact NiftyServe or the Internet addresses.
  256.  
  257. ===============================================================================
  258.