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

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

 $Revision:   1.3  $
   $Author:   kcatlin  $
     $Date:   31 Jan 1992 08:18:06  $

 One of the simplest applications in any programming environment is one
 that prints the string "Hello World." Because PenPoint provides both
 an API to the ImagePoint imaging model and a rich collection of classes
 built on top of ImagePoint, there are two different approaches to building
 a "Hello World" application. They are:

	Create a window and draw text in it using ImagePoint calls
	Use PenPoint's UI Toolkit classes to create a label object.

 Each of these approaches is worth demonstrating in a sample application.
 The first is a good example for programs that need to do a lot of 
 their own drawing, such as free-form graphics editors. The
 second approach shows how easy it is to use the toolkit classes, and
 serves as an example for programs that need to draw forms or
 other structured collections of information.

 Therefore, there are two "Hello World" sample applications: 
 Hello World (custom window) and Hello World (toolkit). The rest of this 
 document describes Hello World (custom window).

 Hello World (custom window) demonstrates how to draw the string 
 "Hello World" by directly using ImagePoint calls. To do so, it defines a 
 descendant of clsWin. In its msgWinRepaint handler, the window determines 
 the size of the string "Hello World" and then calls msgDcDrawText to 
 actually paint the text. It also paints a large exclamation point after it, 
 using ImagePoint's ability to draw bezier curves.

 For demonstration purposes, this application's window is compiled as a 
 separate DLL. 
****************************************************************************/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Objectives					  			   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 This sample application shows how to:
	-:	create a window, and a drawing context (DC) to draw on
	-:	draw text and bezier curves
	-:	separate out part of an application into a re-useable dynamic 
		link library
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Class Overview	  						   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 Hello World (custom window) defines two classes: clsHelloWorld and 
 clsHelloWin.
 It makes use of the following classes:

	clsApp
	clsAppMgr
	clsClass
	clsSysDrwCtx
	clsWin
*/

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *									Files Used	  						   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 The code for Hello World (custom window) is in \PENPOINT\SDK\SAMPLE\HELLO. 
 The files are:

	DLL.LBC:	list of exported functions for the Watcom linker
	DLLINIT.C:		the routine to initialize the dll
	HELLO.C:		the source code for the application
	HELLO.DLC:		indicates the dependency of the application 
					upon the window dll
	HELLOWIN.C:		the source code for the window class
	HELLOWIN.H:		the header file for the window class
	HELTBL.TBL:		the method table for the application class
	HELWTBL.TBl:	the method table for the window class.
*/ 

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *								Compiling	  							   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* 
 To compile Hello World (custom window), just 
	cd \penpoint\sdk\sample\hello
	wmake
 This compiles the dynamic link library and the application, and creates 
 HELLO.DLL and HELLO.EXE in \PENPOINT\APP\HELLO. It also copies HELLO.DLC to
 \PENPOINT\APP\HELLO.
*/

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

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *									Testing	  							   *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
 Zoom the document, or resize a floating document.
*/
