home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / povsrc.sit / MACHINE / MAC.SIT / printf2window.h / printf2window.h
Encoding:
C/C++ Source or Header  |  1992-04-25  |  3.7 KB  |  123 lines  |  [TEXT/KAHL]
  1. /*
  2. ==============================================================================
  3. Copyright 1992, esp, All Rights Reserved
  4. ------------------------------------------------------------------------------
  5. Project:    POV
  6.  
  7. File Name:    printf2window.h
  8.  
  9. Description:
  10.     General-purpose printf-capturing routines that allow a console-like
  11.     output window for c programs that otherwise prefer to use printf/fprintf.
  12.     This code was "inspired heavily" from sources such as MacDTS'es TESample,
  13.     MacApp's Transcript window, and previous code of mine.  It is fairly well
  14.     self-contained, and works in MPW C 3.2 and Think C 5.0.
  15.  
  16.     This file contains global definitions used by the p2w routines.
  17.     It is expected to be included only by source files that are
  18.     Macintosh-toolbox-aware.
  19.  
  20. Related Files:
  21.     stdio_p2w.h        - generic header for sources that would otherwise use <stdio.h>
  22.     printf2window.h    - Mac-specific header for p2w routines
  23.     printf2window.c    - the main source for the p2w routines
  24. ------------------------------------------------------------------------------
  25. Author:
  26.     Eduard [esp] Schwan
  27. ------------------------------------------------------------------------------
  28. Copyright 1992 POV-Team.
  29.     This source code is distributed exclusively with POV, and is subject to
  30.     the same distribution restrictions as the rest of the source code.
  31.  
  32. *  Copying, distribution and legal info is in the file povlegal.doc which
  33. *  should be distributed with this file. If povlegal.doc is not available
  34. *  or for more information please contact:
  35. *
  36. *       Drew Wells [POV-Team Leader] 
  37. *       CIS: 73767,1244  Internet: 73767.1244@compuserve.com
  38. *       Phone: (213) 254-4041
  39. * 
  40. ------------------------------------------------------------------------------
  41. Change History:
  42.     920318    [esp]    Created.
  43.     920325    [esp]    Added prototypes for Std C routines
  44.     920330    [esp]    Updated file header with copyright & related files info
  45.     920401    [esp]    Added p2wSignature to window record for safety checking
  46. ==============================================================================
  47. */
  48.  
  49. #ifndef __printf2window__
  50. #define __printf2window__
  51.  
  52.  
  53. // include our minimal stuff
  54.  
  55. #include "stdio_p2w.h"
  56.  
  57.  
  58. // ==== Extended p2w window record
  59.  
  60. typedef struct
  61.     {
  62.     WindowRecord    p2wWindowRec;        // our window/grafport record
  63.     OSType            p2wSignature;        // Magic value that identifies this as a true p2w window
  64.     Boolean            p2wOpenedOK;        // true if p2wWindowRec is valid, for p2w_DisposeWindow
  65.     TEHandle        p2wTEHandle;        // the TE record we use
  66.     ControlHandle    p2wVScroller;        // the vertical scrollbar in the window
  67.     ControlHandle    p2wHScroller;        // the horizontal scrollbar in the window
  68.     ProcPtr            p2wClickHandler;    // the autoscroll routine (not yet)
  69.     short            p2wMaxDocWidth;        // TE record's max wrap width
  70.     Boolean            p2wAlwaysScrollToBottom;    // true means always stay scrolled to bottom of TE
  71.     }
  72.     p2w_WindowRecord,
  73.     *p2w_WindowPtr,
  74.     **p2w_WindowHandle;
  75.  
  76.  
  77.  
  78. // ==== Public p2w library routines
  79.  
  80. OSErr p2w_Init(void);
  81.  
  82. OSErr p2w_Terminate(void);
  83.  
  84. p2w_WindowPtr p2w_NewWindow
  85.                     (const    Rect            *windBounds,
  86.                     const    Str255            windTitle,
  87.                     const    Boolean            windIsVisible,
  88.                     const    int                windFont,
  89.                     const    short            windFontSize,
  90.                             OSErr            *anError);
  91.  
  92. void p2w_DisposeWindow
  93.                     (        p2w_WindowPtr    the_p2wPtr);
  94.  
  95. OSErr p2w_AddCString
  96.                     (        p2w_WindowPtr    the_p2wPtr,
  97.                     const    char            *theCStrPtr);
  98.  
  99. void p2w_DrawWindow
  100.                     (const    p2w_WindowPtr    the_p2wPtr);
  101.  
  102. void p2w_DoUpdate
  103.                     (const    p2w_WindowPtr    thep2wWindow);
  104.  
  105. void p2w_DoActivate
  106.                     (const    p2w_WindowPtr    thep2wWindow,
  107.                             Boolean            becomingActive);
  108.  
  109. void p2w_DoGrow
  110.                     (const    p2w_WindowPtr    thep2wWindow,
  111.                             EventRecord        *theEvent);
  112.  
  113. void p2w_DoZoom
  114.                     (const    p2w_WindowPtr    thep2wWindow,
  115.                             short            part);
  116.  
  117. void p2w_DoContentClick
  118.                     (const    p2w_WindowPtr    thep2wWindow,
  119.                             EventRecord        *theEvent);
  120.  
  121.  
  122. #endif __printf2window__
  123.