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

From FenixWiki

Revision as of 21:36, 24 July 2007 (edit) Rincewind (Talk | contribs) (New article!) ← Previous diff		Revision as of 22:21, 24 July 2007 (edit) (undo) Rincewind (Talk | contribs) (not-pointer info moved to notes) Next diff →
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.

---

Revision as of 22:21, 24 July 2007

Contents 1 Definition 2 Parameters 3 Returns 4 Notes 5 Errors 6 Example

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.
VARSPACE var	- The name of any variable.

Returns

INT : TextID

0	- Error. The text could not be obtained or was empty.
!0	- The TextID of the text.

Notes

Please note that for the 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.

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

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

Used in example: rand()

This will result in something like: