<#474#>SYNOPSIS:
\dashline[<#125#>stretch<#125#>]{<#126#>dash-length<#126#>}
[<#127#>inter-dot-gap for dash<#127#>]29
(x1,y1)(x2,y2)...(xn,yn)<#474#>
where <#128#>stretch<#128#> is an integer between -100 and infinity.
The above command connects the specified points by drawing a dashline
between each pair of coordinates. At least two points must be
specified. A 47 is a dashed line where each <#129#>dash<#129#> is
constructed using a <#130#>dottedline<#130#>30
1.
The dash-length is the length of the <#132#>dash<#132#> and inter-dot-gap is the gap
between each dot that is used to construct the dash, both in unitlengths.
By default, a solid looking dash is constructed, but by specifying an
inter-dot-gap in the third argument, different looking dashes may be
constructed. With a large inter-dot-gap (about ;SPMgt;0.4mm), each dash will have
the appearance of a little dotted line. One can create a variety of <#133#>dashlines<#133#> where each <#134#>dash<#134#> looks different. Here are a few sample
dashlines:
#picture136#
The <#143#>stretch<#143#> in 48 is an integer percentage and implies
a certain ``stretch'' for positive values and ``shrink'' for negative
values; it is optional and by default is ``0'' unless the default
itself has been changed (described later). The number ``0'' signifies
that a minimum number of dashes be put such that they are
approximately equally spaced with the empty spaces between them. A
+ve number means increase the number of dashes by <#144#>stretch<#144#>
percent, and a -ve number means reduce by that percent. By reducing
the number of dashes, the empty space between dashes is stretched
while maintaining the symmetry. The lower limit on <#145#>stretch<#145#> is
obviously -100 since at less than -100 reduction one essentially
gets nothing. On the upper side, the number, theoretically, can be as
large as infinity (barring arithmetic overflows) and the macro does
not check for any upper bound; one should normally not require more
than 100 percent increase (100 #math94#⇒ double the number of
dashes) since that would essentially mean a ``solid line'' and it is
more efficient to use the 49 command for drawing such
lines, as described later.
The idea behind the <#146#>stretch<#146#> percentage option is that if several
dashed lines of different lengths are being drawn, then all the dashed lines
with the same -ve or +ve <#147#>stretch<#147#> will have similar visual
appearance, as might be desired if one were plotting a graph --- one would
like a particular ``curve'' to look the same between all the points on that
curve. Also, it can be used to take any corrective actions, if the appearance
of the default dashline does not meet one's approval.
The default <#148#>stretch<#148#> percentage can be changed by a
50 on the parameter
51 any time and it takes effect immediately. The
argument is the integer percentage increase or reduction that will be
applied to all 52 commands except the ones in which the
percentage is explicitly given using 53 optional parameter.
For example, all <#149#>dashlines<#149#> could be reduced by 50 percent by
putting the following line <#150#>before<#150#> using any 54
command:
56
An explicit argument to the 57 command in 58
overrides any default values, so for instance, after the above declaration,
if a dashline with ``0'' stretch was desired,
then one would simply say:
60
A note about dashlines of small length. All dashlines always have a dash
beginning at the first coordinate and another ending at the second
coordinate, which implies that a minimum of two dashes are plotted. For small
lines (or larger lines with accordingly larger sized dashes) the dash-length
is reduced as much as necessary to meet above conditions; in such cases, if
necessary, the -ve stretch arguments are ignored. Such dashlines
usually do not have an acceptable appearance, and may either be omitted or be
plotted separately as a dottedline or a dashline with a small dash-length.