Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

bkgdmgr

Photon Background Manager

Syntax:

bkgdmgr

Runs on:

Neutrino

Options:

None.

Description:

The Photon Background Manager (bkgdmgr) provides advanced capabilities for Photon's desktop background display.

In addition to being able to draw a solid color background, bkgdmgr can blend primary and secondary colors in a tiled 8×8 pixel pattern, or display a bitmap image in any format that Photon supports. Bitmaps can be displayed in any of the following modes:

Tiled to fill
Repeats the image side-to-side and top-to-bottom to fill the screen. Tile positioning can be biased to the top, bottom, left, right (or a combination such as top-left), or centered.
Stretched to fill
Stretches the image to fill the screen. You can specify that bkgdmgr either maintain the original aspect (width:height) ratio of the image, or ignore it if necessary to fill the screen.
Unmodified
Don't tile or stretch the image, but display only a single copy. Positioning can be biased to the top, bottom, left, right (or a combination such as top-left), or centered.

Note: If you need only a solid background color, you don't need to run bkgdmgr. The Photon Window Manager, pwm, can draw a solid color desktop background.

The Background Manager reads options from a config file that it shares with pwm, located in $HOME/.ph/wm/wm.cfg. If $HOME isn't set, bkgdmgr looks for the file in /.ph/wm/wm.cfg. Normally you don't edit this file manually. Use the Background tab on the pwmopts utility to set the options for bkgdmgr, which are saved to the configuration file.

You can force bkgdmgr to reread the configuration file and reapply the settings by rerunning it, or by sending it the signal SIGUSR1, for example, slay -sUSR1 bkgdmgr.

Files:

$HOME/.ph/wm/wm.cfg
Holds a user's PWM workspace and configuration.

See also:

pwm, pwmopts