/****************************************************************************
 File: readme.txt

 (C) Copyright 1992 by GO Corporation, All Rights Reserved.

 $Revision:   1.4  $
   $Author:   kcatlin  $
     $Date:   31 Jan 1992 08:34:32  $

 Paint is a simple painting application. The user can choose different nibs
 (square, circle, or italic) and different paint colors (white, light gray,
 dark gray, and black) with which to paint. The user can easily clear the
 window to start painting all over again.
****************************************************************************/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Objectives					  			   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 This sample application shows how to:

	-:	read and write data and strings to a file
	-:	provide a totally application-specific menu bar (no SAMS)
	-:	place a button on a menu line
	-:	create a scroll win, and have a gray border displayed around its 
		client window
	-:	use pixelmaps, drawing contexts, and image devices
	-:	handle pen input events.

 While Paint does demonstrate these topics, it is far from being a perfect
 sample application, for these reasons:

	-: 	pixelmaps are inherently device dependent, so Paint documents are
		also device dependent
	-: 	when the user changes the screen orientation, Paint does not flush
		and rebuild its pixelmaps 
	-: 	Paint's pixelmaps cannot be printed (which is why the Print menu item
		and the "P" gesture are not supported).

 Within the field of sampled image programming, there are well-understood 
 ways to overcome these problems. However, Paint does not implement them.
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Class Overview	  						   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 Paint defines three classes: clsPaintApp, clsPaintWin, and clsPixWin.
 It makes use of the following classes:

	clsApp
 	clsAppMgr
	clsChoice
	clsClass
	clsFileHandle
	clsImgDev
	clsMenu
	clsScrollWin
	clsSysDrwCtx
	clsToggleTable
	clsWin
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *									Files Used	  						   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 The code for Paint is in \PENPOINT\SDK\SAMPLE\PAINT. The files are:

	BITMAP.RES:		resource file for the document icon
	CUTIL.C:		utility routines for reading & writing data and strings
	CUTIL.H:		header file for reading/writing utility routines
	METHODS.TBL:	method table for the paint classes
	PAPP.C:			source code for the paint application class
	PIXELMAP.C:		utility routines for using pixel maps
	PIXELMAP.H:		header file for pixel map utility routines
	PIXWIN.C:		source code for the PixWin class
	PIXWIN.H:		header file for the PixWin class
	PWIN.C:			source code for the PaintWin class
	PWIN.H:			header file for the PaintWin class.
*/ 

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Compiling	  							   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 To compile Paint, just 
	cd \penpoint\sdk\sample\paint
	wmake
 This compiles the application and creates PAINT.EXE and APP.RES in 
 \PENPOINT\APP\PAINT. 
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Running	  								   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 After compiling Paint, you can run it by
	1) Adding \\boot\penpoint\app\Paint Demo App to \PENPOINT\BOOT\APP.INI
    2) Booting PenPoint
	3) Creating a new Paint document, and turning to it.
 Alternatively, you can boot PenPoint and then install Paint Demo App
 via the Connections Notebook.
*/
