Unit 'intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#amunits]

FreeScreenBuffer

Free a ScreenBuffer structure.

Declaration

Source position: intuition.pas line 4104

procedure FreeScreenBuffer(

  sc: pScreen;

  sb: pScreenBuffer

);

Description

Frees a ScreenBuffer structure you got from AllocScreenBuffer(), and releases associated resources. You must call FreeScreenBuffer() before you close your screen.

Notes:

Originally, FreeScreenBuffer() did not WaitBlit() before freeing a BitMap. The intent was that the application should do this. Application writers should ensure that freeing the buffer is safe by calling WaitBlit() themselves.

The SB_SCREEN_BITMAP flag instructs AllocScreenBuffer() to provide a ScreenBuffer referring to the screen's actual bitmap. When you are done changing screen buffers, you must FreeScreenBuffer() the currently-installed ScreenBuffer before you close the screen. Intuition will recognize when FreeScreenBuffer() is called for the currently-installed ScreenBuffer, and will know to free the supporting structures but not the BitMap. CloseScreen() will take care of that.

See also

AllocScreenBuffer

  

Get a ScreenBuffer for double-buffering.

ChangeScreenBuffer

  

Swap the screen's BitMap.

ChangeVPBitMap

  

Change display memory address for multi-buffered animation


Documentation generated on: 2021-07-30