This wiki is out of date, use the continuation of this wiki instead

Map xput

From FenixWiki

Jump to: navigation, search


[edit] Definition

INT map_xput ( <INT fileID> , <INT destinationGraphID> , <INT originGraphID> , <INT x> , <INT y> , <INT angle> , <INT size> , <INT blitflags> )

Draws (blits) a graphic onto another graphic.

If the advanced parameters aren't needed, map_put() can be used. If a graphic from one file needs to be drawn onto another graphic in a different file, or a separate width and height scaling is needed, map_xputnp() can be used.

[edit] Parameters

INT fileID - The fileID of the file that holds the graphics.
INT destinationGraphID - The graphID of the graphic to draw on.
INT originGraphID - The graphID of the graphic to draw with.
INT x - Where on the destination graphic's x-axis to put the graphic.
INT y - Where on the destination graphic's y-axis to put the graphic.
INT angle - What angle to draw the graphic at.
INT size - What size to draw the graphic at.
INT blitflags - What blit flags to draw the graphic with.

[edit] Returns

INT : true

[edit] Notes

The x and y parameters denote where to draw the graphic, that is, where the center of the to be drawn graphic will be. Blit flags can be used to give the drawing (blitting) a special effect.

When angle is 0 and size is 100, the speed is greater, because the graph doesn't need rotating or scaling.

[edit] Errors

Unsupported color depth - The origin graphic's color depth is greater than the destination graphic's.

[edit] Example

Program watskeburt;
    int destgraph;
    int origgraph;

    // Set the mode to 16bit and some resolution

    // Makes the destination graphic a red square

    // Makes the origin graphic a blue square

    // Draws the blue square on the center of the red square transparently,
    // at a random angle and a random size

    // Shows the final graph



Used in example: set_mode(), new_map(), map_clear(), put(), key()

This will result in something like:

Maps Functions
Graphic_info() • Map_block_copy() • Map_clear() • Map_clone() • Map_put() • Map_put_pixel() • Map_xput() • Map_xputnp() • New_map() • Save_png() • Unload_map() •
Personal tools