wml::des::imgbg(3) [debian 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)
Check Out this Related Man Page
wml::std::grid(3) EN Tools wml::std::grid(3) NAME
wml::std::grid - Layout Grid SYNOPSIS
#use wml::std::grid <grid [attributes]> <cell [attributes]>...</cell> : <cell [attributes]>...</cell> </grid> DESCRIPTION
The "<grid>" container tag provides a mixture between a HTML table and a TeX-like way of specifying its dimensions and the alignment of its cells. ATTRIBUTES
First the possible attributes for "<grid>": "summary" This attribute will be inserted into the "table" tag, see documentation of HTML 4.0 for details on why this attribute is recommended. "layout" This specifies the layout of the grid in X and Y dimension, i.e. "3x2" means 3 columns (x-dimension) and 2 rows (y-dimension). Default is "1x"NCELL where NCELL is the number of cell tags or in other words: Default is a top-down list. "align" This specifies the horizontal alignment of the cells in a row. The argument has to contain as many characters as there are cells in a row. The supported alignment characters are `"l"' (left), `"r"' (right) and `"c"' (center). Default is `"l...l"' (as much "l"'s as there are cells in a row). "valign" This specifies the vertical alignment of the cells in a column. The argument has to contain as many characters as there are cells in a column. The supported alignment characters are `"t"' (top), `"b"' (bottom) and `"m"' (middle). Default is `"t...t"' (as much "t"'s as there are cells in a column). "width" This is the corresponding attribute of the HTML "<table>" tag. Use it to set the width of the grid. Default is no specified width. "spacing" This is the corresponding attribute to "cellspacing" of the HTML "<table>" tag. Use it to set the spacing of cells in the grid, i.e. the space around the content of each cell. Default is 0 (no space). "padding" This is the corresponding attribute to "<cellpadding>" of the HTML "<table>" tag. Use it to set the padding between cells in the grid, i.e. the inter-cell space. Default is 0 (no space). "border" This is the corresponding attribute of the HTML "<table>" tag. Use it to set the border width of the grid. Default is 0 (no border). "bgcolor" This is the corresponding attribute of the HTML "<table>" tag. Use it to set the background color of the grid. Default is no specified color. "color" This sets the foreground (text) color of the grid's contents. Actually this sets the default for the same attribute of "<cell>". Default is no specified color. Second the possible attributes for "<cell>": "align" This is the corresponding attribute of the HTML "<td>" tag. Use it to set the horizontal alignment of the cell's contents. Default is taken from the same attribute of "<grid>". "valign" This is the corresponding attribute of the HTML "<td>" tag. Use it to set the vertical alignment of the cell's contents. Default is taken from the same attribute of "<grid>". "bgcolor" This is the corresponding attribute of the HTML "<td>" tag. Use it to set the background color of a particular cell. Default is no specified color. "color" This sets the foreground (text) color of the cell's contents. This is done via the HTML "<font>" tag. Default is no specified color or the color from the same attribute of "<grid>". "rowspan" This is the corresponding attribute of the HTML "<td>" tag. Use it to span a cell over more then one row of the grid. Default is 1 row. "colspan" This is the corresponding attribute of the HTML "<td>" tag. Use it to span a cell over more then one column of the grid. Default is 1 column. "width" This is the corresponding attribute of the HTML "<td>" tag. Use it to set the width of the cell. Default is no specified width. "height" This is the corresponding attribute of the HTML "<td>" tag. Use it to set the height of the cell. Default is no specified height. EXAMPLE
<grid bgcolor="#000000" color="#ffffff" layout="3x2" align="llr" valign="tm"> <cell>A</cell> <cell>B</cell> <cell>C</cell> <cell>D</cell> <cell>E</cell> <cell>F</cell> </grid> AUTHOR
Ralf S. Engelschall rse@engelschall.com www.engelschall.com REQUIRES
Internal: P1, P2, P3, P5 External: -- SEE ALSO
HTML <"table">-tag. EN Tools 2014-04-16 wml::std::grid(3)