| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677 |
- <html>
- <head>
- <title>Blitz3D Docs</title>
- <link rel=stylesheet href=../css/commands.css type=text/css>
- </head>
- <body>
- <h1>ImageBuffer (handle[,frame])</h1>
- <h1>Parameters</h1>
- <table>
- <tr>
- <td>
- handle=variable holding the image's handle
<br />
- frame=optional frame to draw to if using an imagestrip image
- </td>
- </tr>
- </table>
- <h1>Description</h1>
- <table>
- <tr>
- <td>
- There are 1000 reasons for this command. Simply put, you may want to 'draw' on an existing image you've loaded (LoadImage or LoadAnimImage) or created (CreateImage). You could, for example, have a blank wall graphic and you want to add 'graffiti' to it based on the user action (Jet Grind Radio baybeee! Sorry...). Instead of trying to draw a dozen images all over the wall, just use the SetBuffer command to denote the wall graphic as the 'target' buffer, and draw away! Next time you display that graphic (DrawImage), you will see your changes! This is a powerful command!
- </td>
- </tr>
- </table>
- <h1><a href=../2d_examples/ImageBuffer.bb>Example</a></h1>
- <table>
- <tr>
- <td>
- ; CreateImage/TileImage/ImageBuffer example
<br />
-
<br />
- ; Again, we'll use globals even tho we don't need them here
<br />
- ; One variable for the graphic we'll create, one for a timer
<br />
- Global gfxStarfield, tmrScreen
<br />
-
<br />
- ; Declare graphic mode
<br />
- Graphics 640,480,16
<br />
-
<br />
- ; Create a blank image that is 320 pixels wide and 32 high with 10 frames of 32x32
<br />
- gfxStarfield=CreateImage(32,32,10)
<br />
-
<br />
- ; loop through each frame of the graphic we just made
<br />
- For t = 0 To 9
<br />
- ; Set the drawing buffer to the graphic frame so we can write on it
<br />
- SetBuffer ImageBuffer(gfxStarfield,t)
<br />
- ; put 50 stars in the frame at random locations
<br />
- For y = 1 To 50
<br />
- Plot Rnd(32),Rnd(32)
<br />
- Next
<br />
- Next
<br />
-
<br />
- ; Double buffer mode for smooth screen drawing
<br />
- SetBuffer BackBuffer()
<br />
-
<br />
- ; Loop until ESC is pressed
<br />
- While Not KeyHit(1)
<br />
-
<br />
- ; Only update the screen every 300 milliseconds. Change 300 for faster or
<br />
- ; slower screen updates
<br />
- If MilliSecs() > tmrScreen+300 Then
<br />
- Cls ; clear the screen
<br />
-
<br />
- ; Tile the screen with a random frame from our new graphic starting at
<br />
- ; x=0 and y=0 location.
<br />
- TileImage gfxStarfield,0,0,Rnd(9)
<br />
- Flip ; Flip the screen into view
<br />
- tmrScreen=MilliSecs() ; reset the time
<br />
- End If
<br />
- Wend
<br />
- </td>
- </tr>
- </table>
- <br>
- <a target=_top href=../index.htm>Index</a><br>
- <br>
- Click <a href=http://www.blitzbasic.co.nz/b3ddocs/command.php?name=ImageBuffer&ref=comments target=_blank>here</a> to view the latest version of this page online</body>
- </html>
|
