rom/intuition/getscreendrawinfo.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 "intuition_intern.h"
   8
   9 /*****************************************************************************
  10
  11     NAME */
  12 #include <proto/intuition.h>
  13
  14     AROS_LH1(struct DrawInfo *, GetScreenDrawInfo,
  15
  16 /*  SYNOPSIS */
  17          AROS_LHA(struct Screen *, screen, A0),
  18
  19 /*  LOCATION */
  20          struct IntuitionBase *, IntuitionBase, 115, Intuition)
  21
  22 /*  FUNCTION
  23     Returns a pointer to struct DrawInfo of the passed screen.
  24     This data is READ ONLY. The version of the struct DrawInfo
  25     is given in the dri_Version field.
  26
  27     INPUTS
  28     screen - The screen you want to get the DrawInfo from.
  29         Must be valid and open.
  30
  31     RESULT
  32     Returns pointer to struct DrawInfo defined in intuition/screens.h
  33
  34     NOTES
  35     Call FreeScreenDrawInfo() after finishing using the pointer.
  36     This function does not prevent the screen from being closed.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43     FreeScreenDrawInfo(), LockPubScreen(), intuition/screens.h
  44
  45     INTERNALS
  46     Only returns the pointer.
  47
  48     HISTORY
  49     29-10-95    digulla automatically created from
  50                 intuition_lib.fd and clib/intuition_protos.h
  51
  52 *****************************************************************************/
  53 {
  54     AROS_LIBFUNC_INIT
  55
  56     ASSERT_VALID_PTR(screen);
  57
  58     DEBUG_GETSCREENDRAWINFO(dprintf("GetScreenDrawInfo(screen 0x%lx)\n",screen));
  59
  60     IntuitionBase = IntuitionBase;  /* shut up the compiler */
  61
  62     SANITY_CHECKR(screen,FALSE)
  63
  64     return (struct DrawInfo *)&(((struct IntScreen *)screen)->DInfo);
  65
  66     AROS_LIBFUNC_EXIT
  67 } /* GetScreenDrawInfo */