BoxPress lets you apply colors, textures, and images to (1) your banner and (2) your webpage. It also applies a footer image. Your Home page, Category: ___ pages, and even individual pages can all have their own backgrounds. You can collect your background textures and images inside Theme Folders.

A Theme Folder is any folder inside img/BoxPressThemes that has at least the five files (with these exact names): BannerImage.png, BannerTexture.png, BodyImage.png, BodyTexture.png, and FooterImage.png.

These are your default background images and textures. To activate a Theme Folder, simply pick its name from the Theme Folder Widget pop-up menu (or enter its name manually if you’ve made a new Theme Folder).

To view the background options for a note (or prototype), simply run the Keys • BKG stamp and make your selections from the pop-up menu.

Background Triggers

To activate the default webpage background styles, just add the appropriate background trigger: BKG-COLOR, BKG-TEXTURE, or BKG-IMAGE. The color, texture, or image applied is determined by your Styles Dash settings. You can even combine them if your images are proper PNG files (with Alpha channel):

• BKG-COLOR fills the webpage background with Styles Dash > Body Widget > $Color.
• BKG-TEXTURE fills the webpage background with a scrolling texture made by the repeating image BodyTexture.png, which is stored in your current Theme Folder. (This is the folder you have entered in Styles Dash > Theme Folder Widget.)
• BKG-IMAGE fills the webpage background with the fixed image BodyImage.png, which is stored in your current Theme Folder.

To activate the default Text Area background color, just add the CARD background trigger:

•  CARD transform the Text Area into a floating card with color, border, and shadow. This is most noticeable for pages with teasers—i.e., the Home and Category: ___ pages. For these pages, the Text Area becomes a series of floating cards.

Background Modifiers

You can add other options to modify these:

• BKG-FIXED makes the BodyTexture.png texture fixed.
• BKG-XFIT and BKG-YFIT stretch the BodyImage.png image to fit.

Note that BKG-TEXTURE and BKG-IMAGE can be combined with BKG-COLOR if the former have an Alpha channel. If you include both BKG-TEXTURE and BKG-IMAGE, the latter overrides. If the image or texture does not have an Alpha channel, the image or texture overrides the color.

Background Overrides

Finally, the webpage background color, texture, and image (and also the andText Area background color) can be overridden. Simply assign values to $bpBkgColor, $bpBkgTexture, $bpBkgImage, and $bpBkgCardColor. Add new textures and images to the current Theme Folder and use their names as the values for bpBkgTexture and $bpBkgImage.

To pass a note’s background settings to its children, use BKG-BEQUEATH. This is a great option to use with category notes.