home *** CD-ROM | disk | FTP | other *** search
/ InterCD 1999 July / july_1999.iso / Palm / Applications / TealPaint / TEALPNT.DOC < prev    next >
Encoding:
Text File  |  1999-06-20  |  20.6 KB  |  539 lines
  1.  
  2. -------------------------------------------------------------------------
  3.  
  4. TealPaint User's Manual
  5.  
  6. By Vince Lee, Tex Tennison, and Amanda Epume
  7. Version 3.31
  8. Last Updated: Jun 20, 1999 
  9.  
  10. -------------------------------------------------------------------------
  11.  
  12. Description
  13.  
  14. Thank you for trying "TealPaint". This is full-featured and easy-to-use
  15. paint, sketch, and now an animation program too. 
  16.  
  17. "TealPaint" offers a host of easily-accesible features, including:
  18.  
  19.  
  20.  * Multiple annotated records 
  21.  * Dithered thumbnail images 
  22.  * Multiple image databases 
  23.  * Animation capabilities (New) 
  24.  * Image compression (New) 
  25.  * Horizontally and Vertically oversized images (New) 
  26.  * Magnified draw mode (fat bits) 
  27.  * Freehand draw tool 
  28.  * Spotty draw tool (New) 
  29.  * Smoothed draw tool 
  30.  * Line draw tool 
  31.  * Constrained line tool 
  32.  * Box, filled box draw 
  33.  * Rounded box, filled rounded box 
  34.  * Circle, filled circle 
  35.  * Oval draw tool 
  36.  * Snap to grid 
  37.  * Erase tool 
  38.  * Paint bucket 
  39.  * Text tool with selectable fonts, color 
  40.  * Selector tool (rect lasso) 
  41.  * 16 Draw patterns 
  42.  * 12 Brushes 
  43.  * Cut/Copy/Paste images 
  44.  * Undo 
  45.  * Horizonal and vertical flipping 
  46.  * Image scaling (New) 
  47.  * Image rotation (New) 
  48.  * Screen-grabbing import function 
  49.  * "TealPaint Image Manager", a Windows 95 import, export, and print
  50.    utility 
  51.  
  52.  
  53. -------------------------------------------------------------------------
  54.  
  55. Installing
  56.  
  57. This archive contains the files: 
  58.  
  59.  * TEALPNT.DOC
  60.    This document in text format 
  61.  
  62.  * TEALPNT.HTM
  63.    This document in HTML format 
  64.  
  65.  * TEALPNT.PRC
  66.    The "TealPaint" program file 
  67.  
  68.  * PAINTDOC.PRC
  69.    This document in TealDoc format 
  70.  
  71.  * PAINTMGR.EXE
  72.    Image Database import/export/print utility (Win95) 
  73.  
  74.  * PICUTIL.EXE 
  75.    Image Database import/export utility (DOS) 
  76.  
  77.  * REGISTER.HTM 
  78.    TealPoint Registration form in HTML format 
  79.  
  80.  * REGISTER.DOC 
  81.    TealPoint Registration form in text format 
  82.  
  83.  * PAINTDOC.PRC 
  84.    This manual in TealDoc document format 
  85.  
  86. Use the Pilot application installer to install the program file "TEALPNT.PRC".
  87.  
  88. -------------------------------------------------------------------------
  89.  
  90. Using the Program
  91.  
  92. "TealPaint's" intuitive interface is largely self-explanatory for
  93. anyone with experience using a traditional PC-based drawing package.
  94. It consists of two main interface screens: the drawing page and the
  95. index page. 
  96.  
  97. The Index pages lists all the pictures in a single image database.
  98. From the index page you can create, delete, or goto other image databases.
  99. The current database is shown in the upper right-half corner of the
  100. screen. Click on it to bring up a list of all active databases. Menu
  101. selections are available to create or delete databases. 
  102.  
  103. The images stored in a database are shown as small dithered thumbnail
  104. representations, and are accompanied by optional descriptive text.
  105. Up to four images in the list can be shown at any one time, with the
  106. rest accessible by the up and down scroll buttons. To create an image,
  107. click on the "New" button. To view, edit, or animate an image, click
  108. on its thumbnail representation to go to the drawing page. Choose
  109. which of these to do by selecting one of these three options from
  110. the pushbuttons on the bottom of the screen. When you animate, all
  111. the pictures in the database will cyclicly play in sequence until
  112. you press a button or tap on the screen. To delete, sort, or replicate
  113. an image, select it by clicking in its descriptive text and choosing
  114. an appropriate item from the "Recs" menu. 
  115.  
  116. The drawing page provides an interface for creating or modifying images.
  117. At the top of the display is is the viewing window which shows the
  118. current image. If the image is larger than the display area, the page
  119. may be scrolled using the "Hand" tool or using the hardware buttons
  120. if they are mapped to the scrolling controls. By default, the page-up
  121. and page-down buttons are mapped to vertical scrolling. 
  122.  
  123. At the bottom of the display are the drawing tools and options. On
  124. the left hand side are three selection buttons, all of which show
  125. the current item and bring up a popup window of choices when pressed.
  126. The first of these is the tool button, which allows selection of the
  127. current drawing tool. These include various line, freeform, and shape
  128. tools, along with a text tool, selector tool, magnify tool, and paint
  129. can tool. The second button is the pattern selector which selects
  130. the current pattern or color (black or white) used by the current
  131. tool. The last button is the brush selector, which determines the
  132. pen tip shape used by the current drawing tool. 
  133.  
  134. Two final buttons appear on the drawing screen: "Undo" and "Done".
  135. The "Undo" button reverts the image back to before its last change.
  136. Pressing it twice undoes the last "Undo", reinstating the image to
  137. the way it was before. The "Done" button saves all changes and returns
  138. to the index page. 
  139.  
  140. -------------------------------------------------------------------------
  141.  
  142. Special Drawing Functions
  143.  
  144.  
  145.  
  146. Magnifying Glass
  147.  
  148. The magnifying glass operates in two modes, viewing and editing. The
  149. viewing mode allows you to preview the magnified area in normal size
  150. and drag the around the box defining the magnified area. In edit mode,
  151. the magnified area can be drawn on using the pen tool, but appears
  152. at 4x size. All patterns and brushes operate in magnified mode too.
  153. When the magnifying tool is active, it can be switched from one mode
  154. to the other using the EYE button which appears in the lower right
  155. hand corner of the drawing area. To erase in magnify mode, simply
  156. draw with the white drawing pattern 
  157.  
  158.  
  159. Screen Grab
  160.  
  161. The "Grab Screen" menu item is available on the index page. The Screen
  162. Grabber can capture the screen image from most any program and import
  163. it into "TealPaint" as an editable image record. This is particularly
  164. useful for, say, importing images drawn in other drawing programs.
  165.  
  166. To use it, select "Grab Screen" from the "Edit" menu and choose an
  167. elapsed time. Then, switch applications to the one you wish to grab
  168. and wait. When the elapsed time passes, an alert will appear informing
  169. you that the image has been capture. When you return to "TealPaint",
  170. the image will appear as a new record in your image list.
  171.  
  172. If you grab an image from a greyscale screen, the image will be automatically
  173. dithered (converted to patterns) when imported. 
  174.  
  175. Text Tool
  176.  
  177. The Text tool allow entry of text onto an image. To use it, select
  178. the text item ('T') using the popup tool button, click on the display
  179. area at the location to type text, and enter text and numbers using
  180. Graffiti. To change fonts, use the "Set Text Font" item from the "Options"
  181. menu. Here you can also select white text on black instead of the
  182. default black on white. 
  183.  
  184. Grid Snap
  185.  
  186. The Grid snap selector, present in the lower left corner of the drawing
  187. screen, constrains the tools to starting and ending onto an 8x8-pixel
  188. grid, when selected. It allows easy lining-up of shapes drawn on the
  189. drawing surface. It has not effect on freehand, curve, or fill tools,
  190. or when drawing in magnified mode. 
  191.  
  192. Selector Tool
  193.  
  194. To use the selector tool, activate it and drag the pen diagonally
  195. across the drawing surface to highlight a rectangular region. Then,
  196. click and drag within the highlighted region to copy the selected
  197. pixels to another location on the screen. To move the region and delete
  198. the area below, use the "Cut" command below in conjunction with the
  199. selector Tool. 
  200.  
  201. Cut/Copy/Paste
  202.  
  203. When the selector tool is active, the "Copy" and "Paste" menu items
  204. are available. The "Copy" item saves the current selected area to
  205. a temporary buffer. The Paste menu, in turn, draws the current contents
  206. of the temporary buffer into the selected area. If no area is selected,
  207. the "Paste" menu will draw into the upper left corner of the display.
  208. The "Copy" and "Paste" menus can be used to duplicate regions of an
  209. image or copy pixels from one image to another. Normally, the selector
  210. tool copies the area below to wherever you drag it. The "Cut" menu
  211. item erases the area below a selected region so when you drag it away,
  212. the area below is blank. 
  213.  
  214. Paste with scaling
  215.  
  216. When the selector tool is active and an image has previously been
  217. copied to the clipboard, you can use this menu to paste the image
  218. into the selected region. The image will be scaled up or down to fit
  219. the dimensions of the selected area. 
  220.  
  221. Rotate Copy Buffer
  222.  
  223. This menu rotates imagery in the copy buffer clockwise by 90 degrees.
  224. It can be repeatedly called to perform a 180 or 270 degree rotation.
  225.  
  226. Nudge Menu Items
  227.  
  228. The "Nudge" menu items allow you to finely move a selected region
  229. up, down, left or right, a single pixel at a time. It is ideal for
  230. fine-tuning the placement of items on screen.
  231.  
  232.  
  233. Clear/Fill/Flip Menu Items
  234.  
  235. Use the Clear, Fill, and Flip menu items in conjunction with the selector
  236. tool to erase a selected area, fill it with the current drawing pattern,
  237. or vertically or horizontally mirror the pixels in the selected region.
  238.  
  239. Abandon Changes
  240.  
  241. The "Abandon Changes" menu item returns one to the List Page without
  242. saving any changes made to the image since entering the Drawing Page
  243. or the last page scroll. 
  244.  
  245. -------------------------------------------------------------------------
  246.  
  247. Special Animation Functions
  248.  
  249. New to "TealPaint" are simple animation tools that let you use the
  250. program as a simple paintbox for testing character animations or creating
  251. animated storyboards. All the images in a single animation database
  252. can be treated as consecutive frames in a linear animation flipbook.
  253. The following functions help you to draw the individual frames in
  254. a flipbook animation. 
  255.  
  256. Previous/Next Image
  257.  
  258. These menu items appear both under the "Edit" and "Anim" menus. They
  259. allow you to conveniently move to the next or last image in the database.
  260. Often, it's convenient to map hardware buttons to these features (see
  261. below for more info on how to do this). 
  262.  
  263. Replicate Frame
  264.  
  265. This makes a duplicate of the current frame after the current image
  266. and moves forward to this image. This is useful for doing cell animation.
  267.  
  268. Junk Current Frame
  269.  
  270. Deletes the current frame and moves forward to the next 
  271.  
  272. Go Play
  273.  
  274. Animates the images in the current database by cyclically stepping
  275. forward through them until you press a button or tap on the screen.
  276. You cannot currently adjust the speed or direction of the animation.
  277.  
  278. -------------------------------------------------------------------------
  279.  
  280. Button Mappings
  281.  
  282. The "Button Mappings" Options menu item allows you to map a variety
  283. of functions to any of the four hardware applications buttons or to
  284. the up or down scrolling buttons. This allows you to customize the
  285. buttons for quick access to commonly-needed functions. When an application
  286. button is not mapped, it switches applications normally. You may create
  287. separate mappings for when you are in "Edit" mode or "View" mode.
  288. The following function mappings are available. 
  289.  
  290. Scroll Up/Down/Left/Right
  291.  
  292. Scrolls the image around on screen. The screen defaults to the upper-left-hand
  293. corner of a canvas limited in size only by memory. The canvas expands
  294. as you use it. By default, the page-up and page-down buttons are mapped
  295. to the vertical scrolling controls while in "Edit" mode. 
  296.  
  297. Prev/Next Image
  298.  
  299. Moves forward or backwards through the list of images in the current
  300. database. By default, the page-up and page-down buttons are mapped
  301. to the Prev/Next controls when in "View" moding. 
  302.  
  303. Prev/Next Tool/Pattern/Brush
  304.  
  305. Moves forward or backwards through the list of available brushes,
  306. tools, or patterns. 
  307.  
  308. Draw/Erase/Hand Tool
  309.  
  310. Selects the indicated tool if it is not the current one, or switches
  311. back to the last-selected one if the button is pressed again. 
  312.  
  313. Black/White
  314.  
  315. Selects the indicated color if it is not the current one, or switches
  316. back to the last-selected pattern if the button is pressed again.
  317.  
  318. Undo/Done
  319.  
  320. Functions the same as the on screen buttons. 
  321.  
  322. Replicate Frame/Junk Frame/Go Animation
  323.  
  324. These commands allow you to easily access animation tools when using
  325. "TealPaint" as a simple animation-test drawing tablet. 
  326.  
  327. -------------------------------------------------------------------------
  328.  
  329. Notes
  330.  
  331. When using OS 1.0, the Graffiti state (Caps) indicator overwrites
  332. the left-hand side of the "Undo" button on the menu screen due to
  333. the older, large "Caps" symbol. This does not affect the functionality
  334. of the program. 
  335.  
  336. -------------------------------------------------------------------------
  337.  
  338. Using "TealPaint Image Manager"
  339.  
  340. When you hotsync your pilot, the most current "TealPaint" image databases
  341. are stored on the PC in a directory called "BACKUP\", which resides
  342. in a directory named after your User ID. These files are named the
  343. same as the databases and have a '.PDB' extension, like "PICTURES.PDB".
  344.  
  345. Use "PAINTMGR.EXE" under Windows 95 to manage your database files.
  346. You can view images in each database, print them, or export them as
  347. Windows Bitmap (.BMP) files. You can also create new database files,
  348. or add to existing ones by importing .BMP files into them.
  349.  
  350. To run "TealPaint Image Manager", double-click on its icon. Open a
  351. database by choosing the "Open Database" menu selection and finding
  352. a path to the .PDB file containing the images you wish to view. Use
  353. the vertical scroll bar to go up and down the list of images. Click
  354. on an image's name to view that image. Choose the "Print" menu item
  355. to print the current selection, or "Export to .BMP" to convert the
  356. currently-selected image to a Windows .BMP file.
  357.  
  358. To add an image to the current database, choose the "Import .BMP"
  359. menu item. The .BMP files must be Version 3 .BMP files (ie not Windows
  360. 3.x or Win 95 files). **To see the changes on your PalmPilot, you
  361. must use the PalmPilot Install tool to reinstall the database file
  362. back onto the PalmPilot
  363.  
  364. To create a new database, select the "New Database" menu selection.
  365. You will be prompted for the name of a new .PDB file to create. Note
  366. that the name of the file you select will also be the name of the
  367. database as it appears on the PalmPilot. Do not choose a name that
  368. already exists on your PalmPilot, as it will overwrite any database
  369. of the same name. Use the PalmPilot Install tool that came with your
  370. PalmPilot to upload any databases you create to your PalmPilot. 
  371.  
  372. -------------------------------------------------------------------------
  373.  
  374. Revision History
  375.  
  376. Updates to Version 3.31: 
  377.  * Fixed crash on registration screen 
  378.  * Fixed functionality of database menu 
  379.  * Added EVEdit/Encrypt compatibility 
  380.  
  381. Updates to Version 3.30: 
  382.  * Added 'select all' and 'select none' menu function 
  383.  * Added 'Invert Area' menu function 
  384.  
  385. Updates to Version 3.20: 
  386.  * Added support for new larger font when running under OS 3.0 or higher
  387.  * Added screen grab support for greyscale images--they're automatically
  388.    dithered to b/w. 
  389.  * Added checkbox to details screen for setting database backup status.
  390.  * Added vertical auto-alignment to 4-pixel bounds to maintain pattern
  391.    matching 
  392.  * Fixed missing text cursor bug. 
  393.  * Fixed errant read from low memory. 
  394.  * Fixed read from unallocated memory leaving edit screen with cursor
  395.    active. 
  396.  
  397. Updates to Version 3.12e: 
  398.  * Fixed import bug in PicUtil DOS import utility 
  399.  
  400. Updates to Version 3.12: 
  401.  * Fixed TealPaint Image Manager preview of oversized images 
  402.  * Changed Details menu 'Edit' button to read 'Open' 
  403.  * Fixed Animation exit with pen tap in OS 3.1 
  404.  
  405. Updates to Version 3.09b: 
  406.  * Improved image Scaling of oversized images in PaintManager 
  407.  * Fixed PaintManager export of oversized images 
  408.  
  409. Updates to Version 3.09: 
  410.  * Added image Scaling of oversized images in PaintManager 
  411.  * Fixed Low memory read for emulator compatibility 
  412.  * Fixed PaintManager export of oversized images 
  413.  * Fixed PicUtil export of oversized images 
  414.  
  415. Updates to Version 3.07: 
  416.  * Added horizontal scrolling 
  417.  * Added basic animation capabilities 
  418.  * Added picture compression 
  419.  * Added database-to-database image transfer 
  420.  * Added configurable hardware button mapping 
  421.  * Added Hand page-movement tool 
  422.  * Added spotty free-draw tool 
  423.  * Added 90-degree copy-buffer image rotation 
  424.  * Added paste-to-fit image scaling 
  425.  * Added view-only browsing mode 
  426.  * Added coordinate-based lasso adjust 
  427.  * Fixed toolbar corruption using menu tools 
  428.  * Updated Paint Manager to support compression and oversized pics 
  429.  * Updated Paint Manager to import 8-bit and 24-bit images with dithering.
  430.  * New PicUtil 3.0 PC Command-line import/export utility 
  431.  * Fixed registration crash 
  432.  * Fixed crash on screen grab 
  433.  * Fixed clipping on paste operations to protect toolbar 
  434.  * Created separate button prefs for view and edit modes 
  435.  
  436. Updates to Version 2.22: 
  437.  * Faster Popup Menu selection responsiveness 
  438.  * Fixed menu updating when using graffiti nudge shortcuts 
  439.  * Lasso rect now moves with nudge functions 
  440.  
  441. Updates to Version 2.20: 
  442.  * Added Oval drawing tool 
  443.  * Added Smoothed drawing tool 
  444.  * Added Grid-Snap functionality 
  445.  * Added option for white-on-black text 
  446.  * Added instant trial registration key 
  447.  * Added support for databases in Flash Memory (view only) 
  448.  * Updated keyboard shortcuts 
  449.  * Fixed "lost cursor" text bug 
  450.  * Fixed "lost selection" bug 
  451.  * Fixed graphic bug dragging selection area into tools 
  452.  * Fixed bug using magnified draw in scrolled screen 
  453.  * Fixed bug dragging selected area in scrolled screen 
  454.  
  455. Updates to Version 2.01: 
  456.  * Fixed crash when deleting databases under PalmOS 2.x 
  457.  * Fixed screen corruption when using shortcuts for nudge options with
  458.    menus up 
  459.  * Removed registration icon from obscuring database name 
  460.  
  461. Updates to Version 2.00: 
  462.  * "PaintMgr", Windows 95 import/export/print utility 
  463.  * Added Support for Multiple image databases 
  464.  * Added Magnifying draw mode (fat bits) 
  465.  * Added Constrained line tool 
  466.  * Added "Fill Selection" menu item 
  467.  * Added "Erase Selection" menu item 
  468.  * Added Up, Down, Left, and Right "Nudge Selection" menu items 
  469.  * Added Horizonal and Vertical "Flip Selection" menu items 
  470.  * Added "Cut" Menu item to clip Selected Areaa to Floating selection
  471.  * Added Multiple memory card support 
  472.  * Made draggable selection (lasso) floating 
  473.  * Changed lasso position to be restored with UNDO 
  474.  * Changed lasso mode to be automatically selected on PASTE 
  475.  * Fixed misc crash bug 
  476.  
  477.  
  478. -------------------------------------------------------------------------
  479.  
  480. Contact Info
  481.  
  482. "TealPaint" is by TealPoint Software 
  483. (c) 1997-1998 All Rights Reserved. 
  484. TealPoint Software 
  485.    454 Las Gallinas Ave, Suite #318
  486.    San Rafael, CA 94903-3618 
  487.    We look forward to hearing from you. 
  488.  
  489. Please visit us at www.tealpoint.com, or 
  490. email us at contact@tealpoint.com. 
  491.  
  492. Thank you. 
  493.  
  494. -------------------------------------------------------------------------
  495.  
  496. Registering
  497.  
  498. Currently, you may register by snail mail, electronically through
  499. our website with a credit card and a secured server, or through PilotGear
  500. HQ at 1-800-741-9070. For the first option, the enclosed registration
  501. form is provided for your convenience. You may use this form or simply
  502. send the following to the address above. 
  503.  * Product Name 
  504.  * E-Mail Address 
  505.  * HotSync User ID ( Pilot Name Required for Passkey generation, it
  506.    can be found on the main screen of the HotSync application on the
  507.    Pilot as "Welcome ________." or in the corner on a PalmIII ) 
  508.  * Check or Money Order for ($17.95 US) to TealPoint Software 
  509.  
  510. When you register, you will be sent an email containing a registration
  511. code you can enter into TealPaint to turn off the "Please Register"
  512. messages. 
  513.  
  514. Disclaimer
  515.  
  516. We at TealPoint Software are committed to providing quality, easy-to-use
  517. software. However, this product is provided without warranty and the
  518. user accepts full resposibility for any damages, consequential or
  519. otherwise, resulting from its use. 
  520.  
  521. This archive is freely redistributable, provided it is made available
  522. only in its complete, unmodified form with no additional files and
  523. for noncommercial purposes only. Any other use must have prior written
  524. authorization from TealPoint Software. 
  525.  
  526. Unauthorized commercial use includes, but is not limited to: 
  527.  * A product for sale. 
  528.  * Accompanying a product for sale. 
  529.  * Accompanying a magazine, book or other publication for sale. 
  530.  * Distribution with 'Media', 'Copying' or other incidental costs. 
  531.  * Available for download with access or download fees. 
  532.  
  533. This program may be used on a trial basis for 30 days. The program
  534. will continue to function afterwards. However, if after this time
  535. you wish to continue using it, please register with us for the nominal
  536. fee listed in the program. 
  537.  
  538. Thank you. 
  539.