Page Comparison

{alias:bol}
h2. Name

*bol* --- Border line

h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}
*bol* \[_linewidth_\] \[*nrg*\] \[*sav*\] \[*tub*\] \[*col*\] \[*edge*\] \[*fang*\] \[*flat*\] \[*nodraw*\]

{panel}

h2. Description

Generate and draw a border line around a grid or a triangle structure. The border line may be used to outline the grid for display purposes, or it may be extracted as a separate dataset (argument *nrg*) for further use.

h2. Arguments

_linewidth_
{indent} Draw border line with line width _linewidth_ where _linewidth_ is \[1, 2, 3 ..\]. 1 is the thinnest line, one pixel in width.
{indent}

*nrg*
{indent} Apply no regridding (decimation) of the grid.
{indent}

*col* red \| blu \| gre \|pin \| tur \| yel \| whi \| bla \| bro
{indent} Display the border line in color red / blue / green / pink / turquoise / yellow / white / black / brown
{indent}

*sav*
{indent} Save the border line in workspace \^bol. Make it active by *mlo \^bol*. The saved border line contains many cells or line pieces. To sort the line pieces together into a continuous line do the command [ref:mak - Make datasets] [mak sortpl - Make sorted and connected polyline].
{indent}

*tub* \[_factor_\]
{indent} Display border line as a tube. The _factor_ is a number larger than 0, relative to 1 (default), giving the thickness of the tube.
{indent}

*edge*
{indent} Display internal and external edges of the dataset.
{indent}

*fang* _feature_angle_
{indent} Controls the edge finding property. _feature_angle_ is ...? The old Geocap logo uses fang 60.
{indent}

*flat* _level_
{indent} The border line result is displayed at z-level _level_. E.g. *bol flat 200* will display the border line at z=200.
{indent}

*nodraw*
{indent} No display of border result. Often used with argument *sav*, where the border line is saved in a workspace.
{indent}

h2. Examples

h3. Ex.1: Borderline around grid

{noformat:|borderWidth=1|bgColor=#eeeeee}
# read any grid
bol 3 col red
col bla
pol x sel 10   ;# draw every 10th gridline in x-direction
col bla
pol y sel 10   ;# draw every 10th gridline in y-direction
{noformat}

{section}
{column}
!att:_img_ref^bol.png|thumbnail,border=1,width=200!
_Red border line from_ *{_}bol 3 col red{_}*
{column}
{column}
!att:_img_ref^cmd_bol.png|thumbnail,border=1,width=200!
_Border line produced by *Additional Display > Border line, blue*_
{column}
{section}


h3. Ex.2: Border line in old logo

{noformat:|borderWidth=1|bgColor=#eeeeee}
scaz off                      ;# set scale in z to default
d3                            ;# set to 3d
upd u                         ;# set z direction upwards
z                             ;# blank screen
rea $Geocap::geocapdir/data/logo_text.vtk   ;# read text
win -100 100 -100 100 0 100   ;# set window
col .6 .7 .9                  ;# set rgb color
bol tub fang 60               ;# border of logo-text
rea $Geocap::geocapdir/data/logo.vtk    ;# read logo
col whi                       ;# set color to white
cur                           ;# draw spline
{noformat}

!att:_img_ref^bol2.png|thumbnail,border=1,width=200!
_Old Geocap logo, using_ *{_}bol{_}*

h2. See also

[bmo - Border model grid], [trg - Triangulate point data], [ski - Skirt generation], [son ppg | son - Sonar data gridding]
{pagebreak}