rom/intuition/queryoverscan.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     Copyright © 2001-2003, The MorphOS Development Team. All Rights Reserved.
   4     $Id$
   5 */
   6
   7 #include <graphics/displayinfo.h>
   8 #include <proto/graphics.h>
   9 #include "intuition_intern.h"
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <proto/intuition.h>
  15
  16     AROS_LH3(LONG, QueryOverscan,
  17
  18 /*  SYNOPSIS */
  19          AROS_LHA(ULONG             , displayid, A0),
  20          AROS_LHA(struct Rectangle *, rect     , A1),
  21          AROS_LHA(WORD              , oscantype, D0),
  22
  23 /*  LOCATION */
  24          struct IntuitionBase *, IntuitionBase, 79, Intuition)
  25
  26 /*  FUNCTION
  27         Query overscan dimensions. The resulting rectangle can be used
  28         with SA_DisplayID.
  29
  30         Overscan types:
  31         OSCAN_TEXT: completely visible. Left/Top is always 0,0.
  32         OSCAN_STANDARD: visible bounds of monitor. Left/Top may be negative.
  33         OSCAN_MAX: The largest displayable region.
  34         OSCAN_VIDEO: The absolute largest region that the graphics.library
  35           can display.  This region must be used as-is.
  36
  37     INPUTS
  38         displayid - ID to be queried
  39         rect      - Pointer to struct Rectangle to store result
  40         oscantype - OSCAN_TEXT, OSCAN_STANDARD, OSCAN_MAX, OSCAN_VIDEO
  41
  42     RESULT
  43         TRUE  - Monitorspec exists
  44         FALSE - Monitorspec doesn't exist
  45
  46     NOTES
  47
  48     EXAMPLE
  49
  50     BUGS
  51
  52     SEE ALSO
  53
  54     INTERNALS
  55
  56     HISTORY
  57
  58 *****************************************************************************/
  59 {
  60     AROS_LIBFUNC_INIT
  61
  62     struct DimensionInfo diminfo;
  63     LONG                 retval = FALSE;
  64
  65     DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: displayid 0x%lx rect 0x%lx oscantype 0x%lx\n",
  66                                 displayid,
  67                                 rect,
  68                                 oscantype));
  69
  70     DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: %ld %ld %ld %ld\n",
  71                                 rect->MinX,
  72                                 rect->MinY,
  73                                 rect->MaxX,
  74                                 rect->MaxY));
  75     ASSERT_VALID_PTR(rect);
  76
  77     if (GetDisplayInfoData(NULL, (UBYTE *)&diminfo, sizeof(diminfo), DTAG_DIMS, displayid) > 0)
  78     {
  79         retval = TRUE;
  80
  81         switch(oscantype)
  82         {
  83             case OSCAN_TEXT:
  84                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_TEXT\n"));
  85                 memcpy(rect,&diminfo.TxtOScan,sizeof(struct Rectangle));
  86                 break;
  87
  88             case OSCAN_STANDARD:
  89                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_STANDARD\n"));
  90                 memcpy(rect,&diminfo.StdOScan,sizeof(struct Rectangle));
  91                 break;
  92
  93             case OSCAN_MAX:
  94                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_MAX\n"));
  95                 memcpy(rect,&diminfo.MaxOScan,sizeof(struct Rectangle));
  96                 break;
  97
  98             case OSCAN_VIDEO:
  99                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_VIDEO\n"));
 100                 memcpy(rect,&diminfo.VideoOScan,sizeof(struct Rectangle));
 101                 break;
 102
 103             default:
 104                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_????\n"));
 105                 /* or should we assume OSCAN_TEXT? */
 106                 retval = FALSE;
 107                 break;
 108
 109         } /* switch(oscantype) */
 110
 111     } /* if (GetDisplayInfoData(NULL, &diminfo, sizeof(diminfo), DTAG_DIMS, displayid) > 0) */
 112
 113     DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: retval %ld, %ld %ld %ld %ld\n",
 114                                 retval,
 115                                 rect->MinX,
 116                                 rect->MinY,
 117                                 rect->MaxX,
 118                                 rect->MaxY));
 119
 120     return retval;
 121
 122     AROS_LIBFUNC_EXIT
 123
 124 } /* QueryOverscan */