rom/intuition/freescreenbuffer.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     Desc: Intuition function FreeScreenBuffer()
   7     Lang: english
   8 */
   9 #include <graphics/rastport.h>
  10 #include <proto/graphics.h>
  11 #include "intuition_intern.h"
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16 #include <intuition/screens.h>
  17 #include <proto/intuition.h>
  18
  19         AROS_LH2(void, FreeScreenBuffer,
  20
  21 /*  SYNOPSIS */
  22         AROS_LHA(struct Screen *      , screen, A0),
  23         AROS_LHA(struct ScreenBuffer *, screenbuffer, A1),
  24
  25 /*  LOCATION */
  26         struct IntuitionBase *, IntuitionBase, 129, Intuition)
  27
  28 /*  FUNCTION
  29         Frees a ScreenBuffer allocated by AllocScreenBuffer() and releases
  30         associated resources. You have to call this before closing your
  31         screen.
  32
  33     INPUTS
  34         screen - The screen this screenbuffer belongs to
  35         screenbuffer - The screenbuffer obtained by AllocScreenBuffer().
  36             It is safe to pass NULL.
  37
  38     RESULT
  39         None.
  40
  41     NOTES
  42         When used SB_SCREEN_BITMAP on allocating the ScreenBuffer
  43         (ie. the ScreenBuffer only refers to the screen's BitMap) you must
  44         FreeScreenBuffer() the ScreenBuffer before closing the screen.
  45         Intuition will recognize when FreeScreenBuffer() is called for the
  46         currently installed ScreenBuffer that it must not free the BitMap.
  47         This is left to the CloseScreen() function.
  48
  49     EXAMPLE
  50
  51     BUGS
  52
  53     SEE ALSO
  54         AllocScreenBuffer(), ChangeScreenBuffer()
  55
  56     INTERNALS
  57
  58 *****************************************************************************/
  59 {
  60     AROS_LIBFUNC_INIT
  61
  62     struct GfxBase *GfxBase = GetPrivIBase(IntuitionBase)->GfxBase;
  63     DEBUG_FREESCREENBUFFER(dprintf("FreeScreenBuffer: Screen 0x%lx ScreenBuffer 0x%lx\n",
  64                                    screen, screenbuffer));
  65
  66     if (screenbuffer)
  67     {
  68         if (((struct IntScreenBuffer *)screenbuffer)->free_bitmap &&
  69             (screen->RastPort.BitMap == screenbuffer->sb_BitMap))
  70         {
  71             DEBUG_FREESCREENBUFFER(dprintf("freescreenbuffer: Restoring original bitmap! RestoreDBInfo %0xlx\n",
  72                 IS(screen)->RestoreDBufInfo));
  73
  74             if (IS(screen)->RestoreDBufInfo)
  75             {
  76                 struct MsgPort safereply;
  77                 struct ScreenBuffer scb;
  78
  79                 memset( &safereply, 0, sizeof( safereply ) );
  80                 safereply.mp_Node.ln_Type = NT_MSGPORT;
  81                 safereply.mp_Flags = PA_SIGNAL;
  82                 safereply.mp_SigTask = FindTask(NULL);
  83                 safereply.mp_SigBit = SIGB_INTUITION;
  84                 NEWLIST(&(safereply.mp_MsgList));
  85
  86                 IS(screen)->RestoreDBufInfo->dbi_SafeMessage.mn_ReplyPort = &safereply;
  87
  88                 scb.sb_BitMap = IS(screen)->AllocatedBitMap;
  89                 scb.sb_DBufInfo = IS(screen)->RestoreDBufInfo;
  90
  91                 ChangeScreenBuffer(screen, &scb);
  92
  93                 while (!GetMsg(&safereply))
  94                 {
  95                     Wait(1L << SIGB_INTUITION);
  96                 }
  97             }
  98             else
  99             {
 100                 /* AllocScreenBuffer ensures this is allocated, so... */
 101                 dprintf("MAJOR BUG: screenbuffer allocated for a wrong screen!?\n");
 102             }
 103         }
 104
 105         FreeDBufInfo(screenbuffer->sb_DBufInfo);
 106
 107         if (((struct IntScreenBuffer *)screenbuffer)->free_bitmap)
 108         {
 109             FreeBitMap(screenbuffer->sb_BitMap);
 110         }
 111
 112         FreeMem(screenbuffer, sizeof(struct IntScreenBuffer));
 113     }
 114
 115     AROS_LIBFUNC_EXIT
 116 } /* FreeScreenBuffer */
 117