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

ChangeScreenBuffer

Swap the screen's BitMap.

Declaration

Source position: intuition.pas line 3310

function ChangeScreenBuffer(

  Screen: PScreen;

  ScreenBuffer: PScreenBuffer

):LongWord;

Arguments

Screen

  

A pointer to the screen whose bitmap is to be swapped.

ScreenBuffer

  

A pointer to a ScreenBuffer structure obtained from AllocScreenBuffer().

Function result

Returns non-zero if the operation succeeded. Returns zero if the operation cannot be performed. This function will fail if Intuition's state cannot permit it, for example the user is playing with menus or gadgets.

Description

Performs double (or multiple) buffering on an Intuition screen in an Intuition-cooperative manner. The BitMap associated with the supplied ScreenBuffer will be installed in the specified screen, if possible. The previously-installed BitMap is available for re-use upon receiving a signal from graphics.library. See the graphics.library autodocs for AllocDBufInfo() and ChangeVPBitMap() for details.

It is not required to restore the original ScreenBuffer before closing the screen. Simply FreeScreenBuffer() each buffer (including the original and the currently-installed one) then close the screen. Of course, you cannot call ChangeScreenBuffer() after freeing the currently-installed one.

See also

AllocScreenBuffer

  

Get a ScreenBuffer for double-buffering.

FreeScreenBuffer

  

Free a ScreenBuffer structure.

ChangeVPBitMap

  

Change display memory address for multi-buffered animation


Documentation generated on: 2021-07-30