This function block controls a bitmap display in an HMI.

The input bShow is used to show or hide the HMI object. A language specific bitmap resource is assigned to the object via iLang and iBmp.

Finally, the background color is set at lBGClr. A palette index (0-255) is expected at 8-bit color depth and a BGR-value (blue-green-red) at 24-bit color depth. It is provided e.g. by the color parameter block as of library version 7.0.

HMI objects

The HMI object displays a bitmap resource.


The mask designer is called as the parameter dialog via the context menu of the block. An HMI object of the type "Bitmap" is assigned to the block by creating or selecting it. With the checkbox in the lower left corner you can switch between global and instanceable assignment.

Default settings for the HMI object are made in the corresponding dialog, which appears after "Additional settings …". Here, the default settings for the bitmap resource and the background color are specified. Furthermore, the horizontal and vertical alignment of the bitmap is defined.


Name I/O Type(s) Function
iBmp I WORD Bitmap resource (ID)
bShow I BIT Show/hide object
iLang I WORD Language resource (ID)
lBGClr I LONG Background color

Note: If inputs are not connected the object appears with the corresponding default parameters that have been entered in the mask designer. Otherwise the input signal from the function block overwrites the according setting from the parameter dialog.


The assignment of the HMI object is displayed in the block by the color of the text boxes. A yellowish background indicates a global assignment. If the assignment is instanceable, the background is white. And at missing or incorrect assignment it is red.