view_li

NAME

view_li - cloud of lines visualisation

SYNOPSIS

view_li [OPTIONS]

DESCRIPTION

view_li visualises a cloud of lines in 3D. Data is taken from the standard input.

Various colouring options are available ( -0 , -x , -y , -z , -sl , -sf , -g , -b ).

A background triangle model can be visualised in parallel ( -t ), possibly with an image projected on the model ( -i , -c )

New data or files can be produced using keystrokes.

DATA FORMAT

> number_of_lines
> x11 y11 z11 x12 y12 z12
> x21 y21 z21 x22 y22 z22
> ...
> xn1 yn1 zn1 xn2 yn2 zn2

(use pt2li(1) to connect points and create a cloud of lines, use li2string(1) to format the input if coordinates and topology are separated)

OPTIONS

-b INTEGER, --bands INTEGER

INTEGER is the number of colours to use for visualisation (default: 256).

-c FILE, --camera FILE

Option used together with -i and -t to project an image on a triangle file. FILE contains the projection matrix (3x4) of the image [see p_compute(1)].

-g,--greyscale

Use a greyscale scalar map.

-h,--help,-?

Returns the manual page.

-i FILE, --image FILE

Option used together with -c and -t to project an image on a triangle file. Project an image on the triangle file FILE.

-m INTEGER, --magnification INTEGER

Images output by keystrokes (see below) have a resolution INTEGER higher than the screen resolution.

-p INTEGER

INTEGER is the thickness of the lines in pixel (default: 3).

-sl,--scalar-lines

scalar values are associated with lines and not with the nodes of the lines (always together with option -sf).

-sf FILE, --scalar-file FILE

FILE contains two (or one with option -sl) scalar value(s) for each line. The lines are colored according to the scalar value of their vertices (or uniform color with option -sl). By default colours are used. A greyscale output is possible using the -g option. Scalar values are automatically scaled to fit the full output range.

-s,--smooth

smooth output of triangle file.

-si

invert the direction used by the scalar map.

-t FILE, --triangle FILE

visualise the lines on a background triangle file FILE.

-tr

triangle file is semi-trasparent.

-a,--axes

Draw a set of axes at the origin. x is red, y is green and z is blue and the lines are 1 unit long.

INTERACTIONS

Mouse

left mouse button: rotate 3D.
shift + left button: translate.
middle-button: idem (translate).
control + left button: rotate around axis of vision.
control + shift + left button: return the coordinate of the point under the mouse.
right button: zoom.

keyboard

w/s

toggle between wireframe and solid rendering (only when there is a triangle cloud in the background).

m/b

toggle between a light which follows the camera and a light fixed at the current position of the camera (only when there is a triangle cloud in the background).

p/c

toggle between parallel and central projection.

i

toggle between black and white background.

t

produce a tiff file (view_li.tif).

j

produce a jpeg file (view_li.jpg).

v

produce a vrml file (view_li.wrl).

x

set the viewing direction to ( 1, 0, 0).

X

set the viewing direction to (-1, 0, 0).

y

set the viewing direction to ( 0, 1, 0).

Y

set the viewing direction to ( 0,-1, 0).

z

set the viewing direction to ( 0, 0, 1).

Z

set the viewing direction to ( 0, 0,-1).

3

toggle visualisation mode between Red/Cyan (3D) and normal (colour or B&W).

f

return the coordinate of the focus point.

AUTHORS

Written by Pierre Smars (first version: 2007).

BUGS

Reports of bugs or problems should be submitted via electronic mail to <smars@yuntech.edu.tw>.

COPYRIGHT

Copyright (C) 2017 Pierre Smars. License GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

view_pt(1), view_tri(1), pt2li(1), li2string(1)

Pierre SMARS (tools, home page)