home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 8 / boot-disc-1997-04.iso / PDA_Soft / Pilot / Apps / Scribble / SCRIB16.TXT < prev    next >
Text File  |  1997-01-05  |  4KB  |  105 lines
  1. ********************************************************************
  2. *                                                                  *
  3. *     Scribble 1.6                                                 *
  4. *                                                                  *
  5. *     by Andrew Howlett, howlett@iosphere.net                      *
  6. *     based on code by Darrin Massena                              *
  7. *                                                                  *
  8. *     Freeware, 5 January 1997                                     *
  9. *                                                                  *
  10. ********************************************************************
  11.  
  12. DESCRIPTION
  13.  
  14. Scribble turns the 160x160 pixel LCD panel into a simple notepad,
  15. upon which you can scribble names, telephone numbers, etc.  Scribble,
  16. with one page of data, occupies less than 5k of RAM.
  17.  
  18. Scribble saves the screen when you exit the app and restores it
  19. when you relauch the app.  Enter 'C' on the graffiti writing area
  20. to clear the display (or choose clear from the menu).
  21.  
  22. Scribble supports multiple pages, stored in a PalmOS database.  Enter
  23. 'N' on the graffiti writing area to create a new page.  Use the graffiti 
  24. forward stroke (space) and back stroke (backspace) to go forward or 
  25. backward a page. 'R' will remove the page.  A number in the bottom right
  26. corner tells you which page you're on.
  27.  
  28. Scribble will not tell you if an error occurs - dialog boxes cost RAM.
  29. For instance if you try to create a new page but don't have enough memory,
  30. it will just ignore you.
  31.  
  32. MEMORY REQUIREMENTS
  33.  
  34. Scribble occupies only 2048 bytes of memory, however each database
  35. record (that is, each page) uses 2840 bytes of dynamic heap.  Therefore
  36. the minimum RAM requirement is about 5k.
  37.  
  38. Pilot will load if you have 2k free, but it will crash if you have less
  39. than 5k (it has to be able to create at least one database record).
  40.  
  41. WHAT'S THE DIFFERENCE BETWEEN SCRIBBLE AND DINKY PAD
  42.  
  43. Dinky Pad is better.  Dinky Pad is bigger.  To fit Dinky Pad on my Pilot
  44. 1000 I would have to delete Chess :-(
  45.  
  46. SOURCE CODE
  47.  
  48. Source code is included for your amusement.  Source files are:
  49.  
  50.     Scribble.asm            PILA asm file
  51.     Scribble.rcp            PILRC resource file
  52.     Scribble.bmp            Icon
  53.     Make.bat                batch file to make prc
  54.  
  55. The code was formatted for a 100 column editor using 8 space tabs.
  56. Debug code was left in the asm file but commented out.
  57.  
  58. How does it work?  Scribble is very simple coding.  Scribble catches
  59. PenDownEvent, PenMoveEvent, and PenUpEvent.  For PenDownEvent, it 
  60. stores the X,Y coordinates in lastX and lastY.  For PenMoveEvent and
  61. PenUpEvent it draws a line from (lastX,lastY) to (X,Y) and then stores 
  62. X,Y in lastX,lastY.  To save the screen, scribble creates a database
  63. called ScribbleDB and stores LCD memory, from $6518 to $7030, 
  64. in a database record.  Each Scribble page shows up as a Scribble record 
  65. in the Memory ap.
  66.  
  67. Notice that it starts the LCD screen at $6518, not $63b0.  The first 18 
  68. lines (360 bytes) of the LCD display are used by the form title bar.  
  69. By starting at $6518 scribble doesn't overwrite the title bar drawn by 
  70. frmDrawForm.
  71.  
  72. When you leave Scribble it stores your current page in the application
  73. preferences database.  When you launch scribble, it gets the most recent
  74. page from the application preferences database.
  75.  
  76. The Creator ID for scribble is 'Scrb'.  It's registered to me from
  77. Palm Computing.  If you modify this code, make sure you get your own
  78. Creator ID before distributing.  You can get a Creator ID from
  79. "Developer Support <devsupp@palm.com>".
  80.  
  81. I enjoy talking about PILA coding.  Please send email if you have 
  82. questions or comments.
  83.  
  84. Merry Christmas & Happy New Year,
  85. Andrew Howlett
  86. howlett@iosphere.net
  87. 3 January 1997
  88.  
  89. **************************
  90. *                        *
  91. *     MODIFICATIONS      *
  92. *                        *
  93. **************************
  94.  
  95. 30 Dec 96, Version 1.1
  96.  
  97. Removed Graffitistateindicator 0 150 from form 1000.
  98.                    
  99. 3 Jan 97, Version 1.5
  100.  
  101. Created ScribbleDB, multipage, page number.
  102.  
  103. 5 Jan 97, Version 1.6
  104.  
  105. Fixed bottom of page random lines bug.