Write var - Revision history

Sandman: /* Errors */

Sandman — Thu, 15 Nov 2007 00:18:26 GMT

Errors

←Older revision		Revision as of 00:18, 15 November 2007
Line 38:		Line 38:

	== Errors ==		== Errors ==
-	~~''<If someone knows, please edit!> ''~~	+	{\|
		+	\| Too many texts onscreen \|\| - There are too many texts on the screen.
		+	\|}

	== Example ==		== Example ==

Sandman at 00:18, 15 November 2007

Sandman — Thu, 15 Nov 2007 00:18:09 GMT

←Older revision		Revision as of 00:18, 15 November 2007
Line 23:		Line 23:
	'''INT''' : [[TextID]]		'''INT''' : [[TextID]]
	{\|		{\|
-	\| 0 \|\| - Error~~. The text could not be obtained or was empty~~.	+	\| -1 \|\| - Error.
	\|-		\|-
-	\| !0 \|\| - The [[TextID]] of the text.	+	\| >=0 \|\| - The [[TextID]] of the text.
	\|}		\|}

Line 44:		Line 44:
	Program test;		Program test;
	Global		Global
-	~~My_integer~~=0;	+	my_integer=0;
-	string ~~My_string~~="Fenix";	+	string my_string="Fenix";
-		+
	Begin		Begin
-	Write_var(0,0,0,0,My_string);
-	Write_var(0,320/2,200/2,4,My_integer);

-	~~Loop~~	+	write_var(0,0,0,0,my_string);
-	~~My_integer~~=rand(1,1000);	+	write_var(0,320/2,200/2,4,my_integer);
-	~~Frame~~;	+
-	~~End~~	+	Repeat
		+	my_integer=rand(1,1000);
		+	frame;
		+	Until(key(_ESC))
		+
	End		End
	</pre>		</pre>
-	Used in example: [[rand]]()	+	Used in example: [[rand]](), [[key]]()

-	This will result in something like:<br/>	+	This will result in something like:<br>
	[[Image:Write_var.png]]		[[Image:Write_var.png]]

Rincewind: not-pointer info moved to notes

Rincewind — Tue, 24 Jul 2007 22:21:10 GMT

not-pointer info moved to notes

←Older revision		Revision as of 22:21, 24 July 2007
Line 17:		Line 17:
	\| '''INT''' alignment \|\| - The type of [[Alignment modes\|alignment]].		\| '''INT''' alignment \|\| - The type of [[Alignment modes\|alignment]].
	\|-		\|-
-	\| '''VARSPACE''' var \|\| - The name of [[Varspace\|any variable]]~~. Please note that this should not be a pointer, while [[write_int]]()/[[write_string]]()/[[write_float]]() do require a pointer~~.	+	\| '''VARSPACE''' var \|\| - The name of [[Varspace\|any variable]].
	\|}		\|}

Line 29:		Line 29:

	== Notes ==		== Notes ==
		+	Please note that for the [[Varspace\|varspace]] '''var''' parameter ''no'' pointer should be filled out, while [[write_int]]()/[[write_string]]()/[[write_float]]() ''do'' require a pointer.
		+
	There is a limit of 511 texts to simultaneously exist on the screen. The program will crash with an error when this number is reached.		There is a limit of 511 texts to simultaneously exist on the screen. The program will crash with an error when this number is reached.

Rincewind: New article!

Rincewind — Tue, 24 Jul 2007 21:36:22 GMT

New article!

New page

[[Category:functions]]
[[Category:texts]]

==Definition==
'''INT''' write_var ( <'''INT''' fontID> , <'''INT''' x> , <'''INT''' y> , <'''INT''' alignment> , <'''VARSPACE''' var> )

Writes a variable of any kind to the screen, which will be automatically updated when the value of the variable changes. The variable will remain on the screen until deleted with [[delete_text]]().

== Parameters ==
{|
| '''INT''' fontID || - The [[FontID]] of the font to be used for the text.
|-
| '''INT''' x || - The X coordinate of the text.
|-
| '''INT''' y || - The Y coordinate of the text.
|-
| '''INT''' alignment || - The type of [[Alignment modes|alignment]].
|-
| '''VARSPACE''' var || - The name of [[Varspace|any variable]]. Please note that this should not be a pointer, while [[write_int]]()/[[write_string]]()/[[write_float]]() do require a pointer.
|}

== Returns ==
'''INT''' : [[TextID]]
{|
| 0 || - Error. The text could not be obtained or was empty.
|-
| !0 || - The [[TextID]] of the text.
|}

== Notes ==
There is a limit of 511 texts to simultaneously exist on the screen. The program will crash with an error when this number is reached.

The text depth can be changed by adjusting the global variable [[text_z]].

Instead of [[write_var]](), [[write_int]]() could be used to write an [[int]] to the screen, [[write_string]]() for a [[string]], [[write_float]]() for a [[float]].

== Errors ==
''<If someone knows, please edit!> ''

== Example ==
<pre>
Program test;
Global
My_integer=0;
string My_string="Fenix";

Begin
Write_var(0,0,0,0,My_string);
Write_var(0,320/2,200/2,4,My_integer);

Loop
My_integer=rand(1,1000);
Frame;
End
End
</pre>
Used in example: [[rand]]()

This will result in something like:<br/>
[[Image:Write_var.png]]