Unit 'Intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#aros]

FreeScreenBuffer

Free a ScreenBuffer structure.

Declaration

Source position: intuition.pas line 3309

procedure FreeScreenBuffer(

  Screen: PScreen;

  ScreenBuffer: PScreenBuffer

);

Arguments

Screen

  

A pointer to the screen this ScreenBuffer is associated with.

ScreenBuffer

  

A pointer to a ScreenBuffer structure obtained from AllocScreenBuffer(). It is safe to call this function with a nil argument. It will have no effect.

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