RWExtras

Simpler webdev, one stack at a time…

RWExtras

Simpler webdev, one stack at a time…

RWExtras

Simpler webdev, one stack at a time…

RWExtras

Simpler webdev, one stack at a time…

Background Stretcher Stacks

bgStretcher

Background Stretcher Stacks Settings

Applies to the original bgStretcher and bgStretcher D&D stacks:
  • # of Images: enter the number of images to include in the slideshow
  • Original Width*: set the width of the images in pixels
  • Original Height*: set the height of the images in pixels
  • Background: select the color behind the bgStretcher slideshow
  • Random first image: check to select first image at random
  • Animate?: if unchecked, the first image will remain static on the screen and the slideshow will not be activated
  • Interval (sec): sets the duration in seconds for each image
  • Speed (ms): options include 3 keywords: 'slow' (default), 'normal', and 'fast' and, for greater control, the Speed can be set in milliseconds (1000 ms = 1 second). Quotes are required for the keywords however, do not use them if you set the Speed in milliseconds.
  • Stop on last image**: check to stop the slideshow on last image
  • Adjust z-index: unchecking this box might make the stack work better with some themes
*The values of Width and Height are used to calculate the aspect ratio of your images, therefore you can input those values instead. For example, if your images have a 4:3 aspect ratio, input '4' in Original Width and '3' in Original height.

**Do not use with "Random first image option" otherwise, the slideshow will only show the images available
after the randomly selected image.

Please note that all images must have the
same aspect ratio to avoid distortion.
In the original version of bgStretcher, the paths to your images are input in the Edit window.

When you drop the bgStretcher Stack, and you'll see specific instructions. Take a look at the screenshot below. It shows a bgStretcher with 5 images. Just enter the number of images in the HUD (info box) and then click in the gray area to enter the appropriate paths. Done...

Please note that, if you are using RapidWeaver 5, Page Assets have been replaced with Resources therefore, the path has a new format: %resource(myimage.jpg)% or %resource(myfolder/myimage.jpg)% if using a Resources folder

bgStretcher

In bgStretcher D&D, just drag and drop your images to the images wells.

A few important things to keep in mind about working with images that you drop into image wells and ensure that your images will display at their best quality:

1) RapidWeaver will usually scale down your images therefore, the quality of your images will suffer. To correct this, simply open the Media Inspector and set the Scale back to 100%

Image Scale


2) We also recommend adding a Filename and Alt Tag to each image: it's a good design practice, it can help your SEO efforts, and will prevent RW from uploading the images every time you publish your page

name and tag


3) Stacks will convert images to PNG format by default. In general, PNG files are much larger than JPEGs therefore, if you want to keep your images small, you must go to Page Inspector>General and select JPEG from the Image Format drop down menu. Yes, contrary to what you would expect, the "Original" option in Image Format will also convert your images to PNG

Image Format

4) Next, make sure that the settings in Page Inspector>Page>Preferences "Reduce large images" are large enough to fit your images

Stacks Preferences


5) Make sure that RapidWeaver>Preferences>General, "Automatically resize larger images" is unchecked

RW Preferences

For your reference, here's the bgStretcher Drag-and-Drop interface in Edit mode:

bgStretcher