PlugIn Commands

<< Click to Display Table of Contents >>

Navigation:  3. Script Language > PlugIn-Commands > PIS. - PlugIn Send >

PlugIn Commands

PIS.sp  / SetPicture

Previous Top Next


MiniRobotLanguage (MRL)

 

PIS.SetPicture Command

Set/Change Picture on Plugin-Buttons

 

 

Intention

 

The PIS.SetPicture -Command will set or change the Picture that is displayed on a Button from the specified Buttonbar.

It can also Re-Size a picture during the loading to any size you specify.

 

$$FIX=?path\PA_32x16.bmp

PIS.$$REA|SetPicture|1|$$FIX|32|5

 

clip0302

 

 

PIS.$$REA|SetPicture|1|

     will remove the Picture.

 

clip0303

 

For this Command, only the following File-Formats are supported:

 

.BMP.

.ICO

.CUR

 

 

 

Syntax

 

PIS.P1|SetPicture|P2|P3[|P4|P5]

PIS.P1|sP|P2|P3[|P4|P5]

 

 

Parameter Explanation

 

P1 - Variable which contains the PlugIn Index-No.

 

P2 - Button Number, starting with "1"

 

P3 - Filename (incl. Path) of the Picture to load.

 

P4 - if 0 this Parameter is unused. Otherwise the X-Size of the Picture. (Resize-X)

 

P5 - if 0 this Parameter is unused. Otherwise the Y-Size of the Picture. (Resize-Y)

 

All commands are specific for the type of PlugIn used.

 

 

Example

 

' This code is just a Syntax-Sample and will not run

$$FIX=?path\PA_32x16.bmp

PIS.$$REA|SetPicture|1|$$FIX

' Remove Picture from Button

PIS.$$REA|SetPicture|1|

' Remove Text from Button

PIS.$$REA|sBt|1|

 

 

 

 

 

Remarks

 

You can use up to 5 Plugins at the same time.

Just start them, each will get another Index.

To communicate with each PlugIn, you just give the PlugIn-Index to each command.

 

Button-Colors and transparency:

Please note that if you set Buttons transparent, that they can not have a background-color at the same time.

 

To set multiple Buttontext at once you can use:

PIS.$$PIN|sbt|all|Button %n

The "%n" is replaced with the number of that button.

The "all" and %n-scheme will also work with most other commands, where it makes sense.

 

 

Limitations:-

-

 

 

 

See also:

 

    PIL. - PlugIn Launch

    PIS. - PlugIn Send

    PIW. - PlugInWait