rom/intuition/getscreendata.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     Get infos about a screen. *OBSOLETE*
   7 */
   8
   9 #include "intuition_intern.h"
  10 #include <string.h>
  11 #include <proto/exec.h>
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16 #include <intuition/screens.h>
  17 #include <proto/intuition.h>
  18
  19     AROS_LH4(LONG, GetScreenData,
  20
  21 /*  SYNOPSIS */
  22          AROS_LHA(APTR           , buffer, A0),
  23          AROS_LHA(ULONG          , size, D0),
  24          AROS_LHA(ULONG          , type, D1),
  25          AROS_LHA(struct Screen *, screen, A1),
  26
  27 /*  LOCATION */
  28          struct IntuitionBase *, IntuitionBase, 71, Intuition)
  29
  30 /*  FUNCTION
  31     Copy part or all infos about a screen into a private buffer.
  32
  33     To copy the Workbench, one would call
  34
  35         GetScreenData (buffer, sizeof(struct Screen), WBENCHSCREEN, NULL)
  36
  37     If the screen is not open, this call will open it. You can use
  38     this function for these purposes:
  39
  40     1) Get information about the workbench in order to open a window
  41        on it (eg. size).
  42     2) Clone a screen.
  43
  44     INPUTS
  45     buffer - The data gets copied here
  46     size - The size of the buffer in bytes
  47     type - The type of the screen as in OpenWindow().
  48     screen - Ignored unless type is CUSTOMSCREEN.
  49
  50     RESULT
  51     TRUE if successful, FALSE if the screen could not be opened.
  52
  53     NOTES
  54
  55     EXAMPLE
  56
  57     BUGS
  58
  59     SEE ALSO
  60
  61     INTERNALS
  62
  63     HISTORY
  64     29-10-95    digulla automatically created from
  65                 intuition_lib.fd and clib/intuition_protos.h
  66
  67 *****************************************************************************/
  68 {
  69     AROS_LIBFUNC_INIT
  70
  71     DEBUG_GETSCREENDATA(dprintf("GetScreenData(buffer 0x%lx size 0x%lx type 0x%lx screen 0x%lx)\n",buffer,size,type,screen));
  72
  73     EXTENDUWORD(size);
  74     EXTENDUWORD(type);
  75
  76     if (type == WBENCHSCREEN)
  77     {
  78         screen = GetPrivIBase(IntuitionBase)->WorkBench;
  79     }
  80     else if (type != CUSTOMSCREEN)
  81     {
  82         /* FIXME: Handle CUSTOMSCREEN */
  83         screen = NULL;
  84     }
  85
  86     if (screen)
  87         CopyMem (screen, buffer, size);
  88
  89     return (screen != NULL);
  90
  91     AROS_LIBFUNC_EXIT
  92 } /* GetScreenData */