home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / cbm / nduk-v37.lha / V37 / include / intuition / screens.i < prev    next >
Text File  |  1991-11-27  |  12KB  |  349 lines
  1.     IFND  INTUITION_SCREENS_I
  2. INTUITION_SCREENS_I    SET  1
  3. **
  4. **    $Filename: intuition/screens.i $
  5. **    $Release: 2.04 Includes, V37.4 $
  6. **    $Revision: 36.18 $
  7. **    $Date: 91/10/07 $
  8. **
  9. **    The Screen and NewScreen structures and attributes
  10. **
  11. **    (C) Copyright 1985-1991 Commodore-Amiga, Inc.
  12. **        All Rights Reserved
  13. **
  14.     IFND EXEC_TYPES_I
  15.     INCLUDE "exec/types.i"
  16.     ENDC
  17.  
  18.     IFND GRAPHICS_GFX_I
  19.     INCLUDE "graphics/gfx.i"
  20.     ENDC
  21.  
  22.     IFND GRAPHICS_CLIP_I
  23.     INCLUDE "graphics/clip.i"
  24.     ENDC
  25.  
  26.     IFND GRAPHICS_VIEW_I
  27.     INCLUDE "graphics/view.i"
  28.     ENDC
  29.  
  30.     IFND GRAPHICS_RASTPORT_I
  31.     INCLUDE "graphics/rastport.i"
  32.     ENDC
  33.  
  34.     IFND GRAPHICS_LAYERS_I
  35.     INCLUDE "graphics/layers.i"
  36.     ENDC
  37.  
  38.     IFND UTILITY_TAGITEM_I
  39.     INCLUDE "utility/tagitem.i"
  40.     ENDC
  41.  
  42. *
  43. * NOTE:  intuition/iobsolete.i is included at the END of this file!
  44. *
  45.  
  46. ; ========================================================================
  47. ; === DrawInfo =========================================================
  48. ; ========================================================================
  49.  
  50. * This is a packet of information for graphics rendering.  It originates
  51. * with a Screen, and is gotten using GetScreenDrawInfo( screen );
  52.  
  53. * If you find dri_Version >= DRI_VERSION, you know this structure
  54. * has at least the fields defined in this version of the include file
  55.  
  56. DRI_VERSION    EQU    1
  57.  
  58.  STRUCTURE DrawInfo,0
  59.     UWORD    dri_Version     ; will be  DRI_VERSION
  60.     UWORD    dri_NumPens     ; guaranteed to be >= NUMDRIPENS
  61.     APTR    dri_Pens     ; pointer to pen array
  62.     APTR    dri_Font     ; screen default font
  63.     UWORD    dri_Depth     ; (initial) depth of screen bitmap
  64.     ; from DisplayInfo database for initial display mode
  65.     UWORD    dri_ResolutionX
  66.     UWORD    dri_ResolutionY
  67.     ULONG    dri_Flags
  68.    STRUCT    dri_longreserved,28
  69.  
  70. DRIF_NEWLOOK    EQU    $00000001 ; specified SA_Pens, full treatment
  71. DRIB_NEWLOOK    EQU    0
  72.  
  73.     ; rendering pen number indexes into DrawInfo.dri_Pens[]
  74.     ENUM
  75.     EITEM    DETAILPEN    ; compatible Intuition rendering pens
  76.     EITEM    BLOCKPEN,
  77.     EITEM    TEXTPEN        ; text on background (pen = 0)
  78.     EITEM    SHINEPEN    ; bright edge on bas-relief
  79.     EITEM    SHADOWPEN    ; dark edge
  80.     EITEM    FILLPEN        ; active window fill
  81.     EITEM    FILLTEXTPEN    ; text over FILLPEN
  82.     EITEM    BACKGROUNDPEN    ; always color 0
  83.     EITEM    HIGHLIGHTTEXTPEN  ; highlighted text, against BACKGROUNDPEN
  84.     EITEM    NUMDRIPENS
  85.  
  86.  
  87. ; ========================================================================
  88. ; === Screen =============================================================
  89. ; ========================================================================
  90.  STRUCTURE Screen,0
  91.  
  92.     APTR sc_NextScreen        ; linked list of screens
  93.     APTR sc_FirstWindow        ; linked list Screen's Windows
  94.  
  95.     WORD sc_LeftEdge        ; parameters of the screen
  96.     WORD sc_TopEdge        ; parameters of the screen
  97.  
  98.     WORD sc_Width        ; null-terminated Title text
  99.     WORD sc_Height        ; for Windows without ScreenTitle
  100.  
  101.     WORD sc_MouseY        ; position relative to upper-left
  102.     WORD sc_MouseX        ; position relative to upper-left
  103.  
  104.     WORD sc_Flags        ; see definitions below
  105.  
  106.     APTR sc_Title
  107.     APTR sc_DefaultTitle
  108.  
  109.     ; Bar sizes for this Screen and all Window's in this Screen
  110.     BYTE sc_BarHeight
  111.     BYTE sc_BarVBorder
  112.     BYTE sc_BarHBorder
  113.     BYTE sc_MenuVBorder
  114.     BYTE sc_MenuHBorder
  115.     BYTE sc_WBorTop
  116.     BYTE sc_WBorLeft
  117.     BYTE sc_WBorRight
  118.     BYTE sc_WBorBottom
  119.  
  120.     BYTE sc_KludgeFill00    ; This is strictly for word-alignment
  121.  
  122.     ; the display data structures for this Screen
  123.     APTR sc_Font            ; this screen's default font
  124.     STRUCT sc_ViewPort,vp_SIZEOF    ; describing the Screen's display
  125.     STRUCT sc_RastPort,rp_SIZEOF    ; describing Screen rendering
  126.     STRUCT sc_BitMap,bm_SIZEOF        ; auxiliary graphexcess baggage
  127.     STRUCT sc_LayerInfo,li_SIZEOF    ; each screen gets a LayerInfo
  128.  
  129.     APTR sc_FirstGadget
  130.  
  131.     BYTE sc_DetailPen        ; for bar/border/gadget rendering
  132.     BYTE sc_BlockPen        ; for bar/border/gadget rendering
  133.  
  134.     ; the following variable(s) are maintained by Intuition to support the
  135.     ; DisplayBeep() color flashing technique
  136.     WORD sc_SaveColor0
  137.  
  138.     ; This layer is for the Screen and Menu bars
  139.     APTR sc_BarLayer        ; was "BarLayer"
  140.  
  141.     APTR sc_ExtData
  142.  
  143.     APTR sc_UserData        ; general-purpose pointer to User data
  144.  
  145.     LABEL sc_SIZEOF    ; actually, you have no business talking about
  146.             ; or relying on the size of a screen structure
  147.  
  148.  
  149. ; --- FLAGS SET BY INTUITION -------------------------------------------------
  150. ; The SCREENTYPE bits are reserved for describing various Screen types
  151. ; available under Intuition.
  152. SCREENTYPE    EQU    $000F    ; all the screens types available
  153. ; --- the definitions for the Screen Type ------------------------------------
  154. WBENCHSCREEN    EQU    $0001    ; identifies the Workbench screen
  155. PUBLICSCREEN    EQU    $0002    ; public shared (custom) screen
  156. CUSTOMSCREEN    EQU    $000F    ; for that special look
  157.  
  158. SHOWTITLE    EQU    $0010    ; this gets set by a call to ShowTitle()
  159.  
  160. BEEPING    EQU    $0020    ; set when Screen is beeping
  161.  
  162. CUSTOMBITMAP    EQU    $0040    ; if you are supplying your own BitMap
  163.  
  164. SCREENBEHIND    EQU    $0080    ; if you want your screen to open behind
  165.                 ; already open screens
  166.  
  167. SCREENQUIET    EQU    $0100    ; if you do not want Intuition to render
  168.                 ; into your screen (gadgets, title)
  169.  
  170. SCREENHIRES    EQU    $0200    ; do not use lowres gadgets (set by intuition)
  171.  
  172. STDSCREENHEIGHT    EQU    -1    ; supply in NewScreen.Height
  173. STDSCREENWIDTH    EQU    -1    ; supply in NewScreen.Width
  174.  
  175. NS_EXTENDED    EQU    $1000    ; means ns_Extenion is valid
  176. AUTOSCROLL    EQU    $4000    ; automatic scrolling of large raster
  177.  
  178. * Screen attribute tag ID's.  These are used in the ti_Tag field of
  179. * TagItem arrays passed to OpenScreenTagList() (or in the
  180. * ExtNewScreen.Extension field).
  181.  
  182. * Screen attribute tags.  Please use these versions, not those in
  183. * iobsolete.h.
  184.  
  185.  ENUM TAG_USER+33
  186. * 
  187. *   these items specify items equivalent to fields in NewScreen
  188.     EITEM SA_Left    ; traditional screen positions    and dimensions
  189.     EITEM SA_Top
  190.     EITEM SA_Width
  191.     EITEM SA_Height
  192.     EITEM SA_Depth    ; screen bitmap depth
  193.     EITEM SA_DetailPen    ; serves as default for windows, too
  194.     EITEM SA_BlockPen
  195.     EITEM SA_Title    ; default screen title
  196.  
  197.     EITEM SA_Colors    ; ti_Data is an array of struct ColorSpec, 
  198.             ; terminated by ColorIndex = -1.  Specifies 
  199.             ; initial screen palette colors.
  200.  
  201.     EITEM SA_ErrorCode    ; ti_Data points to LONG error code (values below)
  202.     EITEM SA_Font    ; equiv. to NewScreen.Font
  203.     EITEM SA_SysFont    ; Selects one of the preferences system fonts:
  204.             ;    0 - old DefaultFont, fixed-width
  205.             ;    1 - WB Screen preferred font
  206.  
  207.  
  208.     EITEM SA_Type    ; equiv. to NewScreen.Type
  209.     EITEM SA_BitMap    ; ti_Data is pointer to custom BitMap.  This
  210.             ; implies type of CUSTOMBITMAP    
  211.  
  212.     EITEM SA_PubName    ; presence of this tag means that the screen
  213.             ; is to be a public screen.  Please specify
  214.             ; BEFORE the two tags below
  215.  
  216.     EITEM SA_PubSig
  217.     EITEM SA_PubTask    ; Task ID and signal for being notified that
  218.             ; the last window has closed on a public screen.
  219.  
  220.  
  221.     EITEM SA_DisplayID    ; ti_Data is new extended display ID from 
  222.             ; <graphics/displayinfo.h>.
  223.  
  224.     EITEM SA_DClip    ; ti_Data points to a rectangle which defines
  225.             ; screen display clip region
  226.  
  227.     EITEM SA_Overscan    ; was S_STDDCLIP.  Set to one of the OSCAN_
  228.             ; specifiers below to get a system standard
  229.             ; overscan region for your display clip,
  230.             ; screen dimensions (unless otherwise specified),
  231.             ; and automatically centered position (partial
  232.             ; support only so far).
  233.  
  234.     EITEM SA_Obsolete1    ; obsolete S_MONITORNAME
  235.  
  236. *   booleans *
  237.     EITEM SA_ShowTitle    ; boolean equivalent to flag SHOWTITLE
  238.     EITEM SA_Behind    ; boolean equivalent to flag SCREENBEHIND
  239.     EITEM SA_Quiet    ; boolean equivalent to flag SCREENQUIET
  240.     EITEM SA_AutoScroll    ; boolean equivalent to flag AUTOSCROLL
  241.     EITEM SA_Pens    ; array as in DrawInfo, terminated by -1
  242.     EITEM SA_FullPalette ; boolean: initialize color table to entire
  243.                 ;  preferences palette (32 for V36), rather
  244.              ; than compatible pens 0-3, 17-19, with
  245.              ; remaining palette as returned by GetColorMap()
  246.  
  247.  
  248. * OpenScreen error codes, which are returned in the (optional) LONG
  249. * pointed to by ti_Data for the SA_ErrorCode tag item
  250.  
  251. OSERR_NOMONITOR    EQU    (1)    ; named monitor spec not available
  252. OSERR_NOCHIPS    EQU    (2)    ; you need newer cu