STRETCH_OFF

STRETCH_OFF N

STOPS THE AUTOMATIC RESIZING OF THE PICTURE DISPLAYED BY THE SYSTEM OBJECT NUMBER N

  • Type: Command
  • Parameter: 1
  • Group: System Objects

ACTION

The command STRETCH_OFF N stops the automatic resizing of the picture displayed by the system object designated by its number N : the displayed picture takes its own shape.

The system object is a PICTURE or a SCENE2D.

Remark: the automatic resizing is started by the command STRETCH_ON.

SYNTAX: STRETCH_OFF N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • The command STRETCH_OFF is used to come back to the own shape of the picture displayed by a PICTURE or a SCENE2D.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If system object number N does not exist.
  • If system object number N is not of the type : PICTURE, SCENE2D.

EXAMPLE

rem create a SCENE2D with default position and dimensions

scene2D 1

rem load a background picture

file_load 1,"My 2D world.bmp"

rem start the automatic resizing

stretch_on 1

rem change the dimensions of SCENE2D

width 1,600

height 1,400

rem wait for 1 second

wait 1000

rem stop the automatic resizing

stretch_off 1

SEE ALSO

STRETCH_ON