GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  WML::DES::IMGBG (3)

.ds Aq ’

NAME

wml::des::imgbg - Background Images

CONTENTS

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



SEEALSO

HTML <body> tag.
Search for    or go to Top of page |  Section 3 |  Main Index


EN Tools WML::DES::IMGBG (1) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.