<<

Contents

Search

>>

 

PLAY_PICTURES

 

 

Function

 

 

Syntax:

PLAY_PICTURES(<Start-stop>,<Delay>,<Row>,<Column>,<Height in Rows>,<Width in Columns>,<Mode>,<Names of Images>[,<Handle>,<Load From Server>])

 

<Start-stop>

= <NUM-EXPRESSION>

<Delay>

= <NUM-EXPRESSION>

<Row>

= <NUM-EXPRESSION>

<Column>

= <NUM-EXPRESSION>

<Height in Rows>

= <NUM-EXPRESSION>

<Width in Columns>

= <NUM-EXPRESSION>

<Mode>

= <NUM-EXPRESSION>

<Names of Images>

= <STRING-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

<Load From Server>

= <NUM-EXPRESSION>

 

 

Meaning:

Plays a sequence of images as a film.

 

PLAY_PICTURES returns the following values:

 

0: no error

-1: window not found

-2: could not create temporary file

7500: image not found

 

<Row> and <Column> define the position of the upper left corner of the image.

 

<Handle> specifies in which window the film is displayed. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing or <Handle> < 0, the film is displayed in the current window.

 

Parameter:

Start-stop

> 0: The pictures are played.

= 0: Pictures previously started with the same parameter is stopped.

 

Delay

Specifies the time in milliseconds between the display of one picture and the display of the next picture. If <Delay> <= 0, then <Delay> = 200.

 

Row

Row position of the upper left corner of the pictures

 

Column

Column position of the upper left corner of the pictures

 

Height in Rows

Height of the pictures in rows. This parameter only has a meaning with <Mode> = 1.

 

Width in Columns

Width of the pictures in columns. This parameter only has a meaning with <Mode> = 1.

 

Mode

0: The pictures are shown in their original size.

1: The pictures are enlarged or reduced to the size specified by <Height in Rows> and <Width in Columns>.

2: The pictures fill the whole current window or main window. Thy are automatically enlarged or reduced. <Row> and <Columns> do not have any meaning in this case.

 

Names of Images

Contains separated by ";" the names of the pictures to be displayed.

 

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

 

Load From Server

Specifies with 2T programs whether the pictures are to be loaded from the Server or the Client. Normally the pictures are loaded from the Client. If <Load From Server> = 1, the pictures are loaded from the Server and transferred to the Client. If this parameter is missing, then this is equivalent to <Load From Server> = 0.

 

Sample:

/* Start the film

H% = PLAY_PICTURES(1,200,5,10,0,0,0,

          "Bild_1.jpg;Bild_2.jpg;Bild_3.jpg;Bild_4.jpg;Bild_5.jpg")

IF H% <> 0

THEN … Error …

ENDIF

...

/* Stop the film

H% = PLAY_PICTURES(0,200,5,10,0,0,0,

          "Bild_1.jpg;Bild_2.jpg;Bild_3.jpg;Bild_4.jpg;Bild_5.jpg")

IF H% <> 0

THEN … Error …

ENDIF

 

See also:

LOAD_PICTURE