Map put - Revision history

Sandman at 20:30, 30 November 2007

2007-11-30T20:30:05Z

←Older revision		Revision as of 20:30, 30 November 2007
Line 78:		Line 78:
	This will result in something like:<br />		This will result in something like:<br />
	http://wwwhome.cs.utwente.nl/~bergfi/fenix/wiki/map_put.PNG		http://wwwhome.cs.utwente.nl/~bergfi/fenix/wiki/map_put.PNG
		+
		+	{{Funcbox
		+	\| category = Maps
		+	}}

Sandman at 22:59, 23 July 2007

2007-07-23T22:59:07Z

←Older revision		Revision as of 22:59, 23 July 2007
Line 11:		Line 11:
	== Parameters ==		== Parameters ==
	{\|		{\|
-	\| '''INT''' fileID \|\| - The [[file]] that holds the ~~graphs~~.	+	\| '''INT''' fileID \|\| - The [[fileID]] of the [[file]] that holds the graphics.
	\|-		\|-
-	\| '''INT''' destinationGraphID \|\| - The [[~~graph~~]] to draw on.	+	\| '''INT''' destinationGraphID \|\| - The [[graphID]] of the [[graphic]] to draw on.
	\|-		\|-
-	\| '''INT''' originGraphID \|\| - The [[~~graph~~]] to draw with.	+	\| '''INT''' originGraphID \|\| - The [[graphID]] of the [[graphic]] to draw with.
	\|-		\|-
-	\| '''INT''' x \|\| - Where on the destination ~~graph~~'s x-axis to put the graph.	+	\| '''INT''' x \|\| - Where on the destination graphic's x-axis to put the graph.
	\|-		\|-
-	\| '''INT''' y \|\| - Where on the destination ~~graph~~'s y-axis to put the graph.	+	\| '''INT''' y \|\| - Where on the destination graphic's y-axis to put the graph.
	\|}		\|}

Sandman: /* Example */

2007-05-22T13:51:25Z

Example

←Older revision		Revision as of 13:51, 22 May 2007
Line 61:		Line 61:
	map_clear(0,origgraph2,rgb(0,0,255));		map_clear(0,origgraph2,rgb(0,0,255));

-	// Draws the blue ~~square~~ on ~~the center of~~ the red square ~~transparently,~~	+	// Draws the blue and green squares at a random position on the red square
-	~~// at a random angle and a random size~~	+
	map_put(0,destgraph,origgraph1,rand(0,100),rand(0,100));		map_put(0,destgraph,origgraph1,rand(0,100),rand(0,100));
	map_put(0,destgraph,origgraph2,rand(0,100),rand(0,100));		map_put(0,destgraph,origgraph2,rand(0,100),rand(0,100));

Sandman at 13:50, 22 May 2007

2007-05-22T13:50:26Z

←Older revision		Revision as of 13:50, 22 May 2007
Line 68:		Line 68:
	// Shows the final graph		// Shows the final graph
	put(0,destgraph,160,100);		put(0,destgraph,160,100);
		+
		+	Repeat
		+	frame;
		+	Until(key(_esc))

-	Loop
-	frame;
-	End
	End		End
	</pre>		</pre>
-	Used in example: [[set_mode]](), [[new_map]](), [[map_clear]](), [[put]]()	+	Used in example: [[set_mode]](), [[new_map]](), [[map_clear]](), [[put]](), [[key]]()

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

Sandman at 13:48, 22 May 2007

2007-05-22T13:48:07Z

New page

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

==Definition==
'''INT''' map_put ( <'''INT''' fileID> , <'''INT''' destinationGraphID> , <'''INT''' originGraphID> , <'''INT''' x> , <'''INT''' y> )

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

If more advanced parameters are needed, [[map_xput]]() can be used. If a graph from one [[file]] needs to be drawn onto another graph in a different file, or a separate width and height scaling is needed, [[map_xputnp]]() can be used.

== Parameters ==
{|
| '''INT''' fileID || - The [[file]] that holds the graphs.
|-
| '''INT''' destinationGraphID || - The [[graph]] to draw on.
|-
| '''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.
|}

== 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.

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

== Example ==
<pre>
Program watskeburt;
Global
int destgraph;
int origgraph1;
int origgraph2;
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 first origin graphic a green square
origgraph1=new_map(100,100,16);
map_clear(0,origgraph1,rgb(0,255,0));

// Makes the second origin graphic a blue square
origgraph2=new_map(100,100,16);
map_clear(0,origgraph2,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_put(0,destgraph,origgraph1,rand(0,100),rand(0,100));
map_put(0,destgraph,origgraph2,rand(0,100),rand(0,100));

// 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_put.PNG