## Image Boolean Symbol

A Boolean symbol control widget uses two images to represent its "On/Off" state. It supports GIF, PNG and SVG format.

The "On/Off" label and color of the symbol image can be selected. These colors will affect only black elements in the symbol (strokes or filled forms).

The selected image file name must have the format "xxx On.svg" or "xxx Off.svg", otherwise the same image is taken for the two states.

The File Path Browser automatically filters the filename with a regular expression which is based on the PV name. This option can be unchecked in the browser. The regular expression is defined in the preferences.ini file (`org.csstudio.boy.symbol.filter.regex`).

### Special Properties

- Symbol Image (image_file)
    The image used by the widget.
- Stretch to Fit (stretch_to_fit)
    Stretch the image to fit the widget size.
- Auto Size (auto_size)
    Automatically adjust the size of the widget to the image size. This only works if `Stretch to Fit` is not enabled.

### See Also

- Properties Common to Boolean Widgets
- Properties Common to PV Widgets
- Properties Common to All Widgets