screen

Functions
NUMBER	screen.print (NUMBER x, NUMBER y, STRING txt)
	Prints text on the screen ( default values ). More...
NUMBER	screen.print (FONT fnt, NUMBER x, NUMBER y, STRING txt)
	Prints text on the screen ( custom font ). More...
NUMBER	screen.print (NUMBER x, NUMBER y, STRING txt, NUMBER size)
	Prints text on the screen ( custom size ). More...
NUMBER	screen.print (FONT fnt, NUMBER x, NUMBER y, STRING txt, NUMBER size)
	Prints text on the screen ( custom font and size ). More...
NUMBER	screen.print (NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face)
	Prints text on the screen (custom size and color, default font). More...
NUMBER	screen.print (FONT fnt, NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face)
	Prints text on the screen (custom font, size and color). More...
NUMBER	screen.print (NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face, COLOR shadow)
	Prints text on the screen (default font, size, colors). More...
NUMBER	screen.print (FONT fnt, NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face, COLOR shadow)
	Prints text on the screen (custom font, size and color). More...
NUMBER	screen.print (NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face, COLOR shadow, NUMBER align)
	Prints text on the screen (default font, size, colors, and custom alignment). More...
NUMBER	screen.print (NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face, COLOR shadow, NUMBER align, NUMBER w)
	Prints text on the screen (font, size, colors, and custom alignment). More...
NUMBER	screen.print (FONT fnt, NUMBER x, NUMBER y, STRING txt, NUMBER size, COLOR face, COLOR shadow, NUMBER align)
	Prints text on the screen (font, size, colors, and custom alignment). More...
NIL	screen.clip (NUMBER x, NUMBER y, NUMBER r)
	Limiting the drawing area (circle). More...
NIL	screen.clip (NUMBER x, NUMBER y, NUMBER w, NUMBER h)
	Limiting the drawing area. More...
NIL	screen.clip ()
	Removes the limitation of the drawing area. More...
NUMBER	screen.textwidth (STRING txt)
	Gets the text width in pixels (using the default values). More...
NUMBER	screen.textwidth (STRING txt, NUMBER size)
	Gets the text width in pixels (using the default font, and custom text size). More...
NUMBER	screen.textwidth (FONT fnt, STRING txt)
	Gets the text width in pixels (using custom font, and 0.7 as text size). More...
NUMBER	screen.textwidth (FONT fnt, STRING txt, NUMBER size)
	Gets the text width in pixels (using custom font and text size). More...
NUMBER	screen.textheight ()
	Gets the text height in pixels (using the default values). More...
NUMBER	screen.textheight (NUMBER size)
	Gets the text height in pixels (using the default font, and custom text size). More...
NUMBER	screen.textheight (FONT fnt)
	Gets the text height in pixels (using custom font). More...
NUMBER	screen.textheight (FONT fnt, NUMBER size)
	Gets the text height in pixels (using custom font and text size). More...
NIL	screen.clear (COLOR bkg)
	Clears the screen with the specified color. More...
IMAGE	screen.toimage ()
	Makes an image with the screen content. More...
IMAGE	screen.buffertoimage ()
	Makes an image with the draw buffer content. More...
NIL	screen.shot (STRING path)
	Takes a screenshot and save it in the specified folder with Toma una captura de pantalla, y la guarda en la ruta y con el nombre especificados. More...
NUMBER	screen.fps ()
	Computes the screen frames per second (fps). More...
NUMBER	screen.frame ()
	Returns the actual frame shown by the console. More...
NIL	screen.waitvblankstart ()
	Wait for the vertical screen refresh to begin. More...
NUMBER	screen.brightness ()
	Gets the screen brightness. More...
NIL	screen.brightness (NUMBER bright)
	Sets the screen brightness. More...
NIL	screen.flip ()
	Refresh the screen. Any modifications made to it (display pictures, drawn shapes or text) will not be visible until this function is called. More...

Detailed Description

Screen managing.

Function Documentation

NUMBER screen.print	(	NUMBER	x,
		NUMBER	y,
		STRING	txt
	)

Prints text on the screen ( default values ).

Parameters

x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.

Note

The default values are: size 0.7, color white, without shadow and left alingment.

Returns

The text width in pixels.

NUMBER screen.print	(	FONT	fnt,
		NUMBER	x,
		NUMBER	y,
		STRING	txt
	)

Prints text on the screen ( custom font ).

Parameters

fnt	A font previously loaded.
x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.

Returns

The text width in pixels.

NUMBER screen.print	(	NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size
	)

Prints text on the screen ( custom size ).

Parameters

x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.

Returns

The text width in pixels.

NUMBER screen.print	(	FONT	fnt,
		NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size
	)

Prints text on the screen ( custom font and size ).

Parameters

fnt	A font previously loaded.
x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.

Returns

The text width in pixels.

NUMBER screen.print	(	NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face
	)

Prints text on the screen (custom size and color, default font).

Parameters

x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color.

Returns

The text width in pixels.

NUMBER screen.print	(	FONT	fnt,
		NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face
	)

Prints text on the screen (custom font, size and color).

Parameters

fnt	A font previously loaded.
x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color

Returns

The text width in pixels.

NUMBER screen.print	(	NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face,
		COLOR	shadow
	)

Prints text on the screen (default font, size, colors).

Parameters

x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color
shadow	Shadow color.

Returns

The text width in pixels.

NUMBER screen.print	(	FONT	fnt,
		NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face,
		COLOR	shadow
	)

Prints text on the screen (custom font, size and color).

Parameters

fnt	A font previously loaded.
x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color
shadow	Shadow color.

Returns

The text width in pixels.

NUMBER screen.print	(	NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face,
		COLOR	shadow,
		NUMBER	align
	)

Prints text on the screen (default font, size, colors, and custom alignment).

Parameters

x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color
shadow	Shadow color.
align	Alignment of text, one of the following constants: __ALEFT Left. __ACENTER Centred. __ARIGHT Right. __AFULL Full justify text.

Returns

The text width in pixels.

NUMBER screen.print	(	NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face,
		COLOR	shadow,
		NUMBER	align,
		NUMBER	w
	)

Prints text on the screen (font, size, colors, and custom alignment).

Parameters

x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color
shadow	Shadow color.
align	Alignment of text, one of the following constants: __ALEFT Left. __ACENTER Centred. __ARIGHT Right. __AFULL Full justify text. __SLEFT Left. __SRIGHT Rigth __STHROUGH Left (Through). __SSEESAW Left-Right.
w	Width in pixels.

Returns

The text width in pixels.

NUMBER screen.print	(	FONT	fnt,
		NUMBER	x,
		NUMBER	y,
		STRING	txt,
		NUMBER	size,
		COLOR	face,
		COLOR	shadow,
		NUMBER	align
	)

Prints text on the screen (font, size, colors, and custom alignment).

Parameters

fnt	A font previously loaded.
x	X coordinate where the text is printed.
y	Y coordinate where the text is printed.
txt	Text to print.
size	Size of the text. There is no restriction, but are preferable sizes close to 1.
face	Text color
shadow	Shadow color.
align	Alignment of text, one of the following constants: __ALEFT Left. __ACENTER Centred. __ARIGHT Right. __AFULL Full justify text.

Returns

The text width in pixels.

NIL screen.clip	(	NUMBER	x,
		NUMBER	y,
		NUMBER	r
	)

Limiting the drawing area (circle).

Parameters

x	Coordinate X of the top left corner.
y	Coordinate Y of the top left corner.
r	Radius.

Returns

Nothing.

NIL screen.clip	(	NUMBER	x,
		NUMBER	y,
		NUMBER	w,
		NUMBER	h
	)

Limiting the drawing area.

Parameters

x	Coordinate X of the top left corner.
y	Coordinate Y of the top left corner.
w	Width.
h	Height.

Returns

Nothing.

NIL screen.clip

(

)

Removes the limitation of the drawing area.

Returns

Nothing.

NUMBER screen.textwidth

(

STRING

txt

)

Gets the text width in pixels (using the default values).

Parameters

txt	Text to get its width.

Returns

The text width in pixels.

NUMBER screen.textwidth	(	STRING	txt,
		NUMBER	size
	)

Gets the text width in pixels (using the default font, and custom text size).

Parameters

txt	Text to get its width.
size	Text size.

Returns

The text width in pixels.

NUMBER screen.textwidth	(	FONT	fnt,
		STRING	txt
	)

Gets the text width in pixels (using custom font, and 0.7 as text size).

Parameters

fnt	A loaded font.
txt	Text to get its width.

Returns

The text width in pixels.

NUMBER screen.textwidth	(	FONT	fnt,
		STRING	txt,
		NUMBER	size
	)

Gets the text width in pixels (using custom font and text size).

Parameters

fnt	A loaded font.
txt	Text to get its width.
size	Text size.

Returns

The text width in pixels.

NUMBER screen.textheight

(

)

Gets the text height in pixels (using the default values).

Returns

The text height in pixels.

NUMBER screen.textheight

(

NUMBER

size

)

Gets the text height in pixels (using the default font, and custom text size).

Parameters

size	Text size.

Returns

The text height in pixels.

NUMBER screen.textheight

(

FONT

fnt

)

Gets the text height in pixels (using custom font).

Parameters

fnt	A loaded font.

Returns

The text height in pixels.

NUMBER screen.textheight	(	FONT	fnt,
		NUMBER	size
	)

Gets the text height in pixels (using custom font and text size).

Parameters

fnt	A loaded font.
size	Text size.

Returns

The text height in pixels.

NIL screen.clear

(

COLOR

bkg

)

Clears the screen with the specified color.

Parameters

bkg	Color to use.

Note

This function should not be used unless the intention is to paint the entire screen of a different color other than black (it does it automatically with screen.flip() ).

Returns

Nothing.

IMAGE screen.toimage

(

)

Makes an image with the screen content.

Returns

An image object, ready to use.

IMAGE screen.buffertoimage

(

)

Makes an image with the draw buffer content.

Returns

An image object, ready to use.

NIL screen.shot

(

STRING

path

)

Takes a screenshot and save it in the specified folder with Toma una captura de pantalla, y la guarda en la ruta y con el nombre especificados.

Parameters

path	Path and name where the screenshot will be saved (only PNG format).

Returns

Nothing.

NUMBER screen.fps

(

)

Computes the screen frames per second (fps).

Returns

The actual framerate.

NUMBER screen.frame

(

)

Returns the actual frame shown by the console.

Returns

The actual FPS (Frames per second) calculation, from 0 - 60.

NIL screen.waitvblankstart

(

)

Wait for the vertical screen refresh to begin.

Returns

Nothing.

NUMBER screen.brightness

(

)

Gets the screen brightness.

Returns

The actual screen brightness.

NIL screen.brightness

(

NUMBER

bright

)

Sets the screen brightness.

Parameters

bright

The new value for the screen brightness (range 21-65536, 0 turns off the screen).

Returns

Nothing.

NIL screen.flip

(

)

Refresh the screen. Any modifications made to it (display pictures, drawn shapes or text) will not be visible until this function is called.

Note

Now you can specify a color to clear the screen (OPTIONAL).

Returns

Nothing.