home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_c / suplib.lzh / SUPLIB / DOC / INTUITION.DOC < prev    next >
Text File  |  1991-08-16  |  3KB  |  67 lines
  1.  
  2.                   INTUITION.DOC
  3.             (SUP32.LIB and DRES.LIBRARY)
  4.  
  5. SetNewScreen                             SetNewScreen
  6.  
  7.     (void) SetNewScreen(ns, type, scr)
  8.     NS *ns;        D0   D1    A0
  9.     ulong type;
  10.     SCR *scr;
  11.  
  12.     This function fills in the Width, Height, and Depth fields of the
  13.     passed NewScreen structure according to the specified standard screen
  14.     (ala GetScreenData()).  If you pass WBENCHSCREEN for the type you
  15.     should pass NULL in scr.  If you pass CUSTOMSCREEN for the type you
  16.     should pass a pointer to the custom screen in scr.
  17.  
  18.     Only those fields in the NewScreen which are ZERO (0) will be modified.
  19.  
  20.     ns->Width is set according to the specified standard screen and adjusted
  21.     if the ns->ViewModes differs from the standard screen's viewmodes.  That
  22.     is, if the standard screen is HIRES and the ns->ViewModes is not, the
  23.     ns->Width will be set to half the standard screen's width.  The other
  24.     side of the coin (standard screen is not HIRES and NewScreen is),
  25.     ns->Width will be set double the standard screen's width.  If the
  26.     viewmodes match the width is set exactly.
  27.  
  28.     ns->Height is set according to the specified standard screen and adjusted
  29.     if the ns->ViewModes differs from the standard screen's viewmodes.  If
  30.     ns->ViewModes specifies LACE and the standard screen is not, ns->Height
  31.     will set to doubled the standard screen's height and vise versa (ns
  32.     is not LACE and standard screen is, ns->Height is set to half).  If the
  33.     viewmodes match the width is set exactly.
  34.  
  35.     If ns->Depth is zero and the CUSTOMBITMAP flag is set and the
  36.     CustomBitMap pointer is not NULL, the depth will be set to the bitmap's
  37.     depth.  Otherwise, if the ns->Depth is still zero it will be set to the
  38.     specified standard screen's depth.
  39.  
  40.     This function calls GetScreenData()
  41.  
  42.  
  43. GetStdWidth                              GetStdWidth
  44.  
  45.     short GetStdWidth()
  46.  
  47.     This function returns the width of the workbench screen in HIRES PIXELS.
  48.     I.E. if you workbench screen is 702 across, 702 will be returned.  If
  49.     you somehow have got a LOW-RES workbench screen which is, say, 320 pixels
  50.     across, 640 will be returned.
  51.  
  52.     This function calls GetScreenData()
  53.  
  54.  
  55. GetStdHeight                             GetStdHeight
  56.  
  57.     short GetStdHeight()
  58.  
  59.     This function returns the height of the workbench screen in
  60.     NON-INTERLACED PIXELS.  I.E. if you have a non-interlaced workbench
  61.     screen 320 pixels high 320 will be returned.  If you have an interlaced
  62.     workbench screen 640 pixels high 320 will still be returned.
  63.  
  64.     This function calls GetScreenData()
  65.  
  66.  
  67.