Wiki source for KeyPgFlip


Show raw source

{{fbdoc item="title" value="FLIP"}}----
Changes the current video display page

{{fbdoc item="syntax"}}##
[[KeyPgDeclare|declare]] [[KeyPgFunction|function]] **Flip** ( [[KeyPgByval|byval]] //frompage// [[KeyPgAs|as]] [[KeyPgLong|long]] = -1, [[KeyPgByval|byval]] //topage// [[KeyPgAs|as]] [[KeyPgLong|long]] = -1 ) [[KeyPgAs|as]] [[KeyPgLong|long]]
##
{{fbdoc item="usage"}}##
**Flip** [ //frompage// ] [, //topage// ]
##
{{fbdoc item="param"}}
##//frompage//##
previous page
##//topage//##
new page to display

{{fbdoc item="ret"}}
Returns zero (##0##) if successful, or a non-zero error code to indicate a failure.

{{fbdoc item="desc"}}
In normal graphics mode, ##**Flip**## is an alias for ##[[KeyPgPcopy|PCopy]]## and ##[[KeyPgScreencopy|ScreenCopy]]##. See ##[[KeyPgScreencopy|ScreenCopy]]## for details.

In OpenGL mode, ##**Flip**## does a hardware page flip and displays the contents of the backbuffer. It is recommended that you call ##**Flip**## regularly while in OpenGL mode, otherwise your app may also become unresponsive.

The error code returned by ##**Flip**## can be checked using ##[[KeyPgErr|Err]]## in the next line. The function version of ##**Flip**## returns directly the error code as a 32 bit ##[[KeyPgLong|Long]]##.

{{fbdoc item="ex"}}
{{fbdoc item="filename" value="examples/manual/gfx/flip.bas"}}%%(freebasic)
ScreenRes 320, 240, 32, 2 'Sets up the screen to be 320x240 in 32-bit color with 2 video pages.
ScreenSet 1,0 'Sets the working page to 1 and the displayed page to 0


for n as integer = 50 to 270

Cls
Circle (n, 50),50 ,rgb(255,255,0) 'Draws a circle with a 50 pixel radius in yellow on page 1
flip 1,0 'Copies our circle from page 1 to page 0

Sleep 25
next

print "Now wasn't that neat!"
print "Push any key."
flip 1,0 'Copies our text from page 1 to page 0
Sleep
%%


{{fbdoc item="lang"}}
- Not available in the //[[CompilerOptlang|-lang qb]]// dialect unless referenced with the alias ##**""__Flip""**##.

{{fbdoc item="diff"}}
- New to ""FreeBASIC""

{{fbdoc item="back" value="CatPgGfxScreen|Screen Functions"}}
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki



sf.net phatcode