wml::des::preload(3) EN Tools wml::des::preload(3)NAME
wml::des::preload - Preload Images
SYNOPSIS
#use wml::des::preload
<preload src=<image filename> via=<trick>>
DESCRIPTION
This include file provides the "<preload>" tag which can be used to preload images. Such preloading is usually done to speedup access for
following pages. Currently there are only a few tricks how this can be done.
The following combinations are currently supported:
"src="anyimage "via=size"
Preloads the image anyimage by using an "<img>" tag with the attributes "width=1 height=1" which leads to the loading of the image but
only to a 1 pixel in display.
Advantage: Works for all browsers.
Disadvantage: This approach has the nasty side-effect of an occuring 1 pixel in display because "width=0 height=0" does not work as
expected in most browsers (especially in Netscape 4.x). So, position your "<preload>" tag somewhere it does not destroy the look and
feel of your page.
"src="anyimage "via=js"
Preloads the image anyimage by using a JavaScript snippet which loads the image by declaring an unused "Image" object.
Advantage: Silently preloads the image without displaying anything.
Disadvantage: Only works for browsers with a JavaScript implementation and only for those who support the "Image" object (currently
NS/3, NS/4, IE/4).
AUTHORS
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
Denis Barbier
barbier@engelschall.com
REQUIRES
Internal: P1, P2
External: --
SEE ALSO wml::std::tags(3) HTML 3.2 "<img>" tag.
EN Tools 2014-04-16 wml::des::preload(3)
Check Out this Related Man Page
wml::des::imgbg(3) EN Tools wml::des::imgbg(3)NAME
wml::des::imgbg - Background Images
SYNOPSIS
#use wml::des::imgbg
<: $file = &imgbg($base, $direction, $content, $pixels, $format); :>
<body ... background=<imgbg [attributes]> ...>
DESCRIPTION
The usual purpose of this tag is to create a PNG or GIF image containing a background image and to expand to its filename. Its contents is
specified via the "content" attribute by use of size/color pairs.
ATTRIBUTES
"base"
Usually the created images are named imgbg-xxxxxx.png where "xxxxxx" is the content id of the image. When you use a "base=foo"
attribute, then the resulting files are named foo.imgbg-xxxxxx.png. Actually you can even use a complete filename including a
directory prefix, i.e. when you use "base=../../common/foo" attribute, then the images are created as
../../common/foo.imgbg-xxxxxx.png.
And for most flexibility when no base is specified and the variable "BGIMG_BASE" is defined (usually from within a .wmlrc file via
"-DBGIMG_BASE~path/to/imgbg/dir/base") it is used. Use this feature to redirect the created images to a particular directory.
You may also use the variable "IMAGE_BASE" which defines in a single line all base names for images generated by WML.
"format"
By default, GIF images are generated. This attribute lets you use an alternate image format (actually only PNG and GIF are recognized).
You may also change the default format with the variable "IMAGE_FORMAT".
"direction"
Specifies the color change direction of the image: ``"h"'' for horizontal (default) or ``"v"'' for vertical.
"pixels"
Size of the image in the other direction, 1 by default.
"content"
This is a comma-separated list of size/color specifications ``pixels":#"rrggbb":#"rrggbb":"slices''
The last two arguments are optional, only present for gradient images. In this case, a linear gradient line is drawn from color 1 to
color 2, with slices different colors.
To get a background with two columns, a black one with 150 point in size and a white one which fills the rest of the page use
``"150:#000000,1200:#ffffff"''.
AUTHORS
Ralf S. Engelschall
rse@engelschall.com
www.engelschall.com
Denis Barbier
barbier@engelschall.com
REQUIRES
Internal: P1, P2, P3
SEE ALSO
HTML <"body"> tag.
EN Tools 2014-04-16 wml::des::imgbg(3)