Sandman: /* Example */

Sandman — Tue, 01 May 2007 02:04:26 GMT

Example

New page

[[Category:functions]]
[[Category:maps]]

==Definition==
'''INT''' map_xputnp ( <'''INT''' destinationFileID> , <'''INT''' destinationGraphID> , <'''INT''' originFileID> , <'''INT''' originGraphID> , <'''INT''' x> , <'''INT''' y> , <'''INT''' angle> , <'''INT''' scale_x> , <'''INT''' scale_y> , <'''INT''' blitflags> )

Draws ([[blit]]s) a [[graph]] onto another graph.

If the advanced parameters aren't needed, [[map_put]]() or [[map_xput]]() can be used.

== Parameters ==
{|
| '''INT''' destinationFileID || - The [[file]] that holds the destination graph.
|-
| '''INT''' destinationGraphID || - The [[graph]] to draw on.
|-
| '''INT''' originFileID || - The [[file]] that holds the origin graph.
|-
| '''INT''' originGraphID || - The [[graph]] to draw with.
|-
| '''INT''' x || - Where on the destination graph's x-axis to put the graph.
|-
| '''INT''' y || - Where on the destination graph's y-axis to put the graph.
|-
| '''INT''' angle || - What [[angle]] to draw the graph at.
|-
| '''INT''' scale_x|| - What [[size]] to draw the origin graph's x-axis at (also see [[size_x]])
|-
| '''INT''' scale_y || - What [[size]] to draw the origin graph's y-axis at (also see [[size_y]]).
|-
| '''INT''' blitflags || - What [[blit flags]] to draw the graph with.
|}

== Returns ==
'''INT''' : [[true]]

== Notes ==
The x and y parameters denote where to draw the graph, that is, where the center of the to be drawn graph 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.

== Errors ==
{|
| Unsupported color depth || - The origin graph's color depth is greater than the destination graph's.
|}

== Example ==
<pre>
Program watskeburt;
Global
destgraph;
origgraph;
Begin

// Set the mode to 16bit and some resolution
set_mode(320,200,16);

// Makes the destination graphic a red square
destgraph=new_map(100,100,16);
map_clear(0,destgraph,rgb(255,0,0));

// Makes the origin graphic a blue square
origgraph=new_map(100,100,16);
map_clear(0,origgraph,rgb(0,0,255));

// Draws the blue square on the center of the red square transparently,
// at a random angle and a random size
map_xputnp(0,destgraph,0,origgraph,50,50,rand(-180000,180000),rand(50,150),rand(50,150),4);
map_xputnp(0,destgraph,0,origgraph,50,50,rand(-180000,180000),rand(50,150),rand(50,150),4);

// Shows the final graph
put(0,destgraph,160,100);

Loop
frame;
End

End
</pre>
Used in example: [[set_mode]](), [[new_map]](), [[map_clear]](), [[put]]()

This will result in something like:<br />
http://wwwhome.cs.utwente.nl/~bergfi/fenix/wiki/map_xputnp.PNG

EXPORTTEST - Revision history

Sandman: /* Example */