rom/intuition/getscreendrawinfo.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 "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 *****************************************************************************/
  49 {
  50     AROS_LIBFUNC_INIT
  51
  52     ASSERT_VALID_PTR(screen);
  53
  54     DEBUG_GETSCREENDRAWINFO(dprintf("GetScreenDrawInfo(screen 0x%lx)\n",screen));
  55
  56     IntuitionBase = IntuitionBase;  /* shut up the compiler */
  57
  58     SANITY_CHECKR(screen,FALSE)
  59
  60     return (struct DrawInfo *)&(((struct IntScreen *)screen)->DInfo);
  61
  62     AROS_LIBFUNC_EXIT
  63 } /* GetScreenDrawInfo */