view_pt

NAME

view_pt - point cloud visualisation

SYNOPSIS

view_pt [OPTIONS]

DESCRIPTION

view_pt visualises a point cloud in 3D. It takes its input from the standard input.

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

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

point cloud:

> number_of_points
> x1 y1 z1
> x2 y2 z2
> ...
> xn yn zn

scalar file (free range of values):

> number_of_points
> v1
> v2
> ...
> vn

rgb file (values in range 0..255):

> number_of_points
> r1 g1 b1
> r2 g2 b2
> ...
> rn gn bn

OPTIONS

-b INTEGER, --bands INTEGER

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

-c FILE, --camera FILE

FILE contains the projection matrix (3x4) of the image [see p_compute(1)].

-g,--greyscale

use a greyscale scalar map (default is colour).

-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. FILE is the image file.

-o

copy the point file to the standard output.

-p

point_size: size of the points in pixel (default: 3).

-s,--smooth

smooth output of triangle file.

-si

invert the direction used by the scalar map.

-sf FILE, --scalar-file FILE

FILE contains a scalar value for each point. The points are colored according to the scalar value. 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.

-rgb FILE, --rgb FILE

For each point, FILE contains three values specifying its color: R [0-255], G [0-255], B [0-255].

-t FILE, --triangle FILE

visualise the points 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.
right button: zoom
control + shift + left button: return the coordinate of the point under the mouse.

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_pt.tif).

j

produce a jpeg file (view_pt.jpg).

v

produce a vrml file (view_pt.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 camera and focus points.

AUTHORS

Written by Pierre Smars (first version: 2001).

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_li(1), view_tri(1)

Pierre SMARS (tools, home page)