rom/intuition/queryoverscan.c

   1 /*
   2     Copyright © 1995-2013, 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 *****************************************************************************/
  57 {
  58     AROS_LIBFUNC_INIT
  59
  60     struct GfxBase      *GfxBase = GetPrivIBase(IntuitionBase)->GfxBase;
  61     struct DimensionInfo diminfo;
  62     LONG                 retval = FALSE;
  63
  64     DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: displayid 0x%lx rect 0x%lx oscantype 0x%lx\n",
  65                                 displayid,
  66                                 rect,
  67                                 oscantype));
  68
  69     DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: %ld %ld %ld %ld\n",
  70                                 rect->MinX,
  71                                 rect->MinY,
  72                                 rect->MaxX,
  73                                 rect->MaxY));
  74     ASSERT_VALID_PTR(rect);
  75
  76     if (GetDisplayInfoData(NULL, (UBYTE *)&diminfo, sizeof(diminfo), DTAG_DIMS, displayid) > 0)
  77     {
  78         retval = TRUE;
  79
  80         switch(oscantype)
  81         {
  82             case OSCAN_TEXT:
  83                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_TEXT\n"));
  84                 memcpy(rect,&diminfo.TxtOScan,sizeof(struct Rectangle));
  85                 break;
  86
  87             case OSCAN_STANDARD:
  88                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_STANDARD\n"));
  89                 memcpy(rect,&diminfo.StdOScan,sizeof(struct Rectangle));
  90                 break;
  91
  92             case OSCAN_MAX:
  93                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_MAX\n"));
  94                 memcpy(rect,&diminfo.MaxOScan,sizeof(struct Rectangle));
  95                 break;
  96
  97             case OSCAN_VIDEO:
  98                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_VIDEO\n"));
  99                 memcpy(rect,&diminfo.VideoOScan,sizeof(struct Rectangle));
 100                 break;
 101
 102             default:
 103                 DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: OSCAN_????\n"));
 104                 /* or should we assume OSCAN_TEXT? */
 105                 retval = FALSE;
 106                 break;
 107
 108         } /* switch(oscantype) */
 109
 110     } /* if (GetDisplayInfoData(NULL, &diminfo, sizeof(diminfo), DTAG_DIMS, displayid) > 0) */
 111
 112     DEBUG_QUERYOVERSCAN(dprintf("LIB_QueryOverscan: retval %ld, %ld %ld %ld %ld\n",
 113                                 retval,
 114                                 rect->MinX,
 115                                 rect->MinY,
 116                                 rect->MaxX,
 117                                 rect->MaxY));
 118
 119     return retval;
 120
 121     AROS_LIBFUNC_EXIT
 122
 123 } /* QueryOverscan */