.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "tmp::AJlWMyhGwA::Hoola 3"
.TH tmp::AJlWMyhGwA::Hoola 3 "2018-12-25" "EN Tools" "EN Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
wml::des::imgdot \- 1pt Dot\-Images for Webdesign
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& #use wml::des::imgdot
\&
\& <: $file = &imgdot($base, $x, $y, $c, $r, $g, $b, $transp, $format); :>
\&
\& <imgdot [attributes]>
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Currently (as of \s-1HTML 3.2\s0 and 1997 ;_) webdesigners use two commonly known
tricks for creating their layout on webpages: \s-1HTML\s0 tables and so-called 1pt
Dot-Images.  The first one is nicely supported by the \s-1WML\s0 tag
\&\f(CW\*(C`<grid>\*(C'\fR (see \fBwml::des::grid\fR\|(3) for details), the latter is supported
by this \f(CW\*(C`<imgdot>\*(C'\fR tag.
.PP
The usual purpose of this tag is to create a transparent \s-1PNG\s0 or \s-1GIF\s0 image with a
physical size of 1x1 points and a corresponding \f(CW\*(C`<img>\*(C'\fR tag which
includes this image with appropriate \f(CW\*(C`width\*(C'\fR and \f(CW\*(C`height\*(C'\fR attributes. The
visual result is a invisible reserved space of size \f(CW\*(C`width\*(C'\fRX\f(CW\*(C`height\*(C'\fR.
Alternatively this tag can create the image with the requested size instead of
scaling the 1pt image (see the \f(CW\*(C`noscale\*(C'\fR attribute below). This approach is
more safe (all browsers support this) but wastes bandwidth and increases page
load time.
.SH "ATTRIBUTES"
.IX Header "ATTRIBUTES"
.IP "base" 4
.IX Item "base"
Usually the created images are named
\&\fIimgdot\-XxY\-rrggbb.png\fR where \f(CW\*(C`XxY\*(C'\fR is the dimension of the image and
\&\f(CW\*(C`rrggbb\*(C'\fR the used color (or `\f(CW\*(C`transp\*(C'\fR' for transparent). When you use a
\&\f(CW\*(C`base=foo\*(C'\fR attribute, then the resulting files are named
\&\fIfoo.imgdot\-XxY\-rrggbb.gif\fR.  Actually you can even use a complete filename
including a directory prefix, i.e. when you use \f(CW\*(C`base=../../common/foo\*(C'\fR
attribute, then the \s-1PNG\s0 images are created as
\&\fI../../common/foo.imgdot\-XxY\-rrggbb.png\fR.
.Sp
And for most flexibility when no base is specified and the variable
\&\f(CW\*(C`IMGDOT_BASE\*(C'\fR is defined (usually from within a \fI.wmlrc\fR file via
\&\f(CW\*(C`\-DIMGDOT_BASE~path/to/imgdot/dir/base\*(C'\fR) it is used.  Use this feature to
redirect the created images to a particular directory.
.Sp
You may also use the variable \f(CW\*(C`IMAGE_BASE\*(C'\fR which defines in a single line
all base names for images generated by \s-1WML.\s0
.IP "format" 4
.IX Item "format"
By default, \s-1GIF\s0 images are generated. This attribute lets you use an
alternate image format (actually only \s-1PNG\s0 and \s-1GIF\s0 are recognized).
You may also change the default format with the variable \f(CW\*(C`IMAGE_FORMAT\*(C'\fR.
.IP "width" 4
.IX Item "width"
Specifies the width (x\-dimension) of the reserved space in pixel. Default is
1 pixel.
.IP "height" 4
.IX Item "height"
Specifies the height (y\-dimension) of the reserved space in pixel. Default is
1 pixel.
.IP "color" 4
.IX Item "color"
Sets the color of the image. Default is transparent, i.e. no color. In
fact, this is not true, transparency is rendered by choosing a color
which is made transparent, which is white by default.
Prepending an hyphen to the \f(CW\*(C`color\*(C'\fR attribute sets the color of the
transparent color.
.IP "align" 4
.IX Item "align"
Sets the alignment of the image. Default is `\f(CW\*(C`bottom\*(C'\fR'. This alignment is
used for the \f(CW\*(C`align\*(C'\fR attribute of the inserted \f(CW\*(C`<img>\*(C'\fR tag.
.IP "noscale" 4
.IX Item "noscale"
Indicates if the image should be created with 1pt in size and scaled online by
the browser (default) or should be created with the correct physical size
(this option).
.IP ":img:\fI\s-1ATTR\s0\fR=\fI\s-1STR\s0\fR" 4
.IX Item ":img:ATTR=STR"
The ``\fI\s-1ATTR\s0\fR=\fI\s-1STR\s0\fR'' pairs are passed along to the \f(CW\*(C`<img>\*(C'\fR \s-1HTML\s0 tag.
.SH "AUTHOR"
.IX Header "AUTHOR"
.Vb 3
\& Ralf S. Engelschall
\& rse@engelschall.com
\& www.engelschall.com
\&
\& Denis Barbier
\& barbier@engelschall.com
.Ve
.SH "REQUIRES"
.IX Header "REQUIRES"
.Vb 1
\& Internal: P1, P2, P3
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\s-1HTML\s0 <\f(CW\*(C`img\*(C'\fR> tag.