RG_Tile structure describes a graphical surface generated from a set of instructions
Note: Unless you need to generate or manipulate tiles programmatically, you do not need to use this interface. Libraries such as MAP(3) use this interface to display graphics.
The following types of elements are implemented:
The public members of the RG_Tile structure are as follows:
The RG_TileNew() function allocates, initializes, and attaches a new RG_Tile of width by height pixels. name is a string identifier for the tile (if a tile of the same name exists, a unique name will be generated automatically). Accepted flags include:
RG_TileScale() resizes the canvas of the tile to width by height pixels. Note that this only resizes the canvas used for rendering the tile, and has no effect on the pixmaps and other features.
The RG_TileGenerate() function updates the surface (the su member of the RG_Tile structure) using the tile instructions.
RG_TileFindElement() searches for a tile element by type and name.
RG_TileAddPixmap() inserts a reference to pixmap at coordinates x, y. RG_TileAddSketch() inserts a reference to sketch at coordinates x, y. RG_TileAddFeature() inserts the feature described by featureOps. For features, the x and y parameters may or may not have any meaning. See RG_Feature(3) for more information on the feature framework.
RG_TileDelFeature(), RG_TileDelPixmap() and RG_TileDelSketch() remove any element that refers to the given pixmap, sketch or feature, respectively. This causes the reference count of the referenced element to be decremented. If destroyFlag is 1, the element is automatically freed is that reference count reaches 0.
|RG(3), RG_Anim(3), RG_Feature(3), RG_Pixmap(3), RG_Sketch(3), RG_Texture(3), RG_Tileview(3)|