setBitmapTile
Syntax
- int setBitmapTile(int x, int y, int iName, int tileWidth, int tileHeight, int tileIndex)
Arguments
- x
- The horizontal coordinate at which to draw the bitmap.
- y
- The vertical coordinate at which to draw the bitmap.
- name
- Null-terminated string with the name of the bitmap to use. Can be either the name of an embedded resource or a filename. Filenames may include directory information.
- tileWidth
- Width of each tile in the bitmap.
- tileHeight
- Height of each tile in the bitmap.
- tileIndex
- Index number of the tile to be drawn, ordered along rows then columns similar to this text.
Return
- Integer containing value TRUE if operation completed successfully, otherwise FALSE.
Description
- Draw part of the specified bitmap on the current ownerdraw of buffer canvas at the specified coordinates.
- The bitmap is divided in tiles of the specified dimensions which are accessed using the tileIndex starting from 0. If you have 3 columns and 2 rows, a tileIndex of 3 will be the first column on the second row. If the specified dimensions are such that they do not fit the dimensions of the bitmap, no partial tiles are created.
- If coordinates are negative or the bitmap will not fit the canvas, it is clipped at the edges of the canvas.
- tileWidth and tileHeight must be 1 or more, otherwise FALSE will be returned.
- If tileIndex is negative or beyond the number of available tiles, nothing will be drawn.
See Also
- startSetPixel
Comments
- Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.