home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / desqview / dvcal.arc / DVCAL.DOC < prev   
Encoding:
Text File  |  1987-11-15  |  10.3 KB  |  215 lines
  1.  
  2.  
  3.                                  DVCAL
  4.                            Desqview Calendar
  5.                     (c) Daniel T. Travison Jr., 1987
  6.  
  7.                          GEnie Email: D.TRAVISON
  8.  
  9.                   Hotel Henge 518-399-3073 (10pm-10am)
  10.  
  11.                           Non-Electronic Mail:
  12.                               P.O. Box 165
  13.                          Burnt Hills, NY  12027
  14.  
  15.       DVCAL is a simple calendar display written for Desqview 2.0+. 
  16.       The program has the capability to display a range starting with 
  17.       January, 1592 to December, 9999.  Three key groups are provided 
  18.       for moving by month, year, and century.  This is the third 
  19.       addition to a series of 'desq-top' utilities for Desqview and 
  20.       follows the same basic ideas as the previous programs by being 
  21.       simple to use, quick to respond, and requiring a minimum of system
  22.       overhead.
  23.  
  24.       You are granted permission to distribute this program with the
  25.       stipulation that NO remittance is accepted for either the program
  26.       or handling and distribution charges.  This program may not be
  27.       distributed with other programs on disk if a charge is incurred
  28.       for any program or for the medium.  In other words, if there is
  29.       a charge involved then you do not have permission to include this
  30.       program, period!
  31.  
  32.   ╒══════════════════════════════════════════════════════════════════════════╕
  33.   │ The author makes no warranties expressed or implied as to the quality or │
  34.   │ performance of this program.  The author will not be held liable for any │
  35.   │ direct, indirect,  incidental or consequential  damages  resulting  from │
  36.   │ the use of this program.   Your use of  this  program  constitutes  your │
  37.   │ agreement to this disclaimer and your releasing the author from any form │
  38.   │ of liability or litigation.                                              │
  39.   ╘══════════════════════════════════════════════════════════════════════════╛
  40.  
  41.  
  42.  
  43.  
  44.       I am slowly but surely learning assembler and this is my most 
  45.       ambitious to date.  I believe I have put together a compact
  46.       calendar that is both simple to use as well as being fairly 
  47.       quick.  The program is capable of displaying a monthly calendar 
  48.       for the years 1592 through 9999.  Three modes are provided for
  49.       moving through the calendar,  month, year, and century.
  50.  
  51.       Desqview routines used:
  52.  
  53.          1: Checks for the presence of Desqview and exits with an error
  54.             if Desqview is not found.
  55.  
  56.          2: The program writes directly to the screen buffer provided by
  57.             Desqview.
  58.  
  59.          3: The program releases the rest of the time slice when ever it
  60.             finishes a screen and also after determining that no
  61.             key has been pressed.
  62.  
  63.       Requirements:
  64.  
  65.          Desqview 2.0  :You MUST have this version or later
  66.  
  67.          Dvcal.com     :the executable program
  68.  
  69.          Dc-pif.dvp    :the program information file used by desqview
  70.                         (see next section)
  71.  
  72.          Reasonable compatability with the 'standard' IBM is assumed when
  73.          running this program.  I use interupt 16h to check for key
  74.          strokes pending and to retrieve the same.
  75.  
  76.       Program information file: 
  77.       
  78.          I have provided the 2 screens from change a program to illustrate the
  79.          required settings should the Dc-pif.dvp be missing or incorrect.
  80.          Five points should be noted:
  81.  
  82.             1: Memory size is set to 4k. More is not needed, less will
  83.                produce an error message.
  84.  
  85.             2: Maximum and starting screen size is set to 16 for the height
  86.                and 34 for the width.  Increasing values will distort the
  87.                display.  Decreasing these values can cause serious problems
  88.                when the program tries to write to memory that is not
  89.                allocated to it.
  90.  
  91.             3: All memory options on the Advanced screen are set to zero.
  92.                changing this will only allocate memory to the program
  93.                that will not be used and is therefore wasted.
  94.  
  95.             4: The close on exit to DOS option is set to yes.  This
  96.                allows Desqview to use its own shell.com instead of
  97.                command.com to load the program.  This saves a nice
  98.                chunk of memory that would otherwise be wasted. In 
  99.                addition, the escape key will close the window as well 
  100.                as exiting the program.
  101.  
  102.             5: The program will appear on the Add a program (other)
  103.                menu as Desqview Calendar.  Keep this in mind in case
  104.                you have a problem finding it.
  105.  
  106.  
  107.  
  108.  
  109. ┌─────────────────────────────────────────────────────────────────────────────┐
  110. │                              Change a Program                               │
  111. │                                                                             │
  112. │Program Name............: Desqview Calendar                                  │
  113. │                                                                             │
  114. │Keys to Use on Open Menu: DC                         Memory Size (in K):   4 │
  115. │─────────────────────────────────────────────────────────────────────────────│
  116. │Program...: DVCAL.COM                                                        │
  117. │                                                                             │
  118. │Parameters:                                                                  │
  119. │                                                                             │
  120. │Directory.: C:\UTILITY\GENERAL                                               │
  121. │─────────────────────────────────────────────────────────────────────────────│
  122. │Options:                                                                     │
  123. │                    Writes directly to screen......: [N]                     │
  124. │                    Displays graphics information..: [N]                     │
  125. │                    Can be swapped out of memory...: [Y]                     │
  126. │                    Requires floppy diskette.......: [N]                     │
  127. │                                                                             │
  128. │  Press F1 for advanced options                  Press ─┘ when you are DONE  │
  129. └─────────────────────────────────────────────────────────────────────────────┘
  130.  
  131.  
  132. ┌─────────────────────────────────────────────────────────────────────────────┐
  133. │                     Change a Program Advanced Options                       │
  134. │                                                                             │
  135. │System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:     │
  136. │                                                                             │
  137. │Script Buffer Size.......:     0   Maximum Expanded Memory Size (in K):      │
  138. │                                                                             │
  139. │Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF │
  140. │─────────────────────────────────────────────────────────────────────────────│
  141. │Window Position:                                                             │
  142. │   Maximum Height:  16       Starting Height:  16       Starting Row...:   1 │
  143. │   Maximum Width.:  34       Starting Width.:  34       Starting Column:  45 │
  144. │─────────────────────────────────────────────────────────────────────────────│
  145. │                               Shared Program                                │
  146. │Pathname..:                                                                  │
  147. │                                                                             │
  148. │Data......:                                                                  │
  149. │─────────────────────────────────────────────────────────────────────────────│
  150. │Options:                                                                     │
  151. │   Close on exit to DOS.........: [Y]      Uses its own colors.........: [N] │
  152. │   Allow Close Window command...: [Y]      Runs only in foreground.....: [Y] │
  153. │   Uses math coprocessor........: [N]      Keyboard conflict (0-4).....: [0] │
  154. │                                                                             │
  155. │ Press F1 for standard options                  Press ─┘ when you are DONE   │
  156. └─────────────────────────────────────────────────────────────────────────────┘
  157.  
  158.  
  159.       Display Control:
  160.  
  161.          Three keys are used to control the program function.
  162.  
  163.             1: Page Up: Displays the previous month
  164.  
  165.             2: Page Down: Displays the next month
  166.  
  167.             3: Ctrl-Page Up: Displays the previous year
  168.  
  169.             4: Ctrl-Page Down: Displays the next year
  170.  
  171.             5: Ctrl-Home: Display the previous century
  172.  
  173.             6: Ctrl-End: Display the next century
  174.  
  175.             7: Home: display calendar for current system date
  176.  
  177.             8: F1: Toggles a quick reference display of the above
  178.                7 keys.
  179.  
  180.             9: Escape: Exits the program.  Close the window when
  181.                the 'Close on exit to DOS' option is set to Y.
  182.  
  183.  
  184.       Compatability:
  185.  
  186.             This program has been successfully run on the following
  187.             three machines:
  188.  
  189.                1: Compaq 386   (color)
  190.  
  191.                2: IBM 8mhz AT  (monochrome graphics)
  192.  
  193.                3: My 8mhz XT.  (color)  This machine is an example 
  194.                   of the extreme in that the parts were purchased 
  195.                   from at least 7 different manufactures, none of
  196.                   which are known for their large market share.
  197.                   The CPU is a NEC V20 and the BIOS is by PHEONIX
  198.                   (version 2.26)
  199.  
  200.       The End:
  201.  
  202.          I have written this program because I have not found a
  203.          satisfactory alternative.  I have learned a little more
  204.          about assembler along the way and consider that sufficient
  205.          compensation for the time and effort spent on this
  206.          program.  I do have an EGO so feel free to send comments
  207.          using one of the methods provided above.  Users that are
  208.          in the same stages of learning assembler as myself may
  209.          have a copy of the source as an example of actual uses
  210.          for the routines Quarterdeck provides.  Experienced
  211.          assembler programmer's will be bored and only point out
  212.          all the different areas where my ignorance of assembler.
  213.  
  214.  
  215.