2D_TARGET_IS

2D_TARGET_IS N

DESIGNATES THE SYSTEM OBJECT NUMBER N (FORM, PICTURE, BUTTON_PICTURE) AS RECEIVER OF "2D" COMMANDS

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

ACTION

The command 2D_TARGET_IS N designates the system object number N (FORM, PICTURE, BUTTON_PICTURE) which will receive the "2D" commands. This system object becomes the "2D target" system object.

By default, the "2D target" system object is : FORM number 0.

SYNTAX: 2D_TARGET_IS 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 2D_TARGET_IS is used to draw on a system object which is not FORM0.

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 the system object number N does not exist.
  • If the object number N is not of type : FORM, PICTURE, BUTTON_PICTURE.

EXAMPLE

rem create a PICTURE

picture 1

rem designate this system object as the 2D target

2d_target_is 1

rem draw a circle on the PICTURE

2d_circle 100,100,50

SEE ALSO

FORM

PICTURE

BUTTON_PICTURE

NUMBER_2D_TARGET