cut_tri

NAME

cut_tri - cut a triangle cloud using one or more planes.

SYNOPSIS

cut_tri [-?|-h|--help] [-l|--lines|-t|--triangles] [-d DOUBLE|--distance DOUBLE] [-n DOUBLE|--number DOUBLE] x1 y1 z1 x2 y2 z2 x3 y3 z3

or

cut_tri [-?|-h|--help] [-l|--lines|-t|--triangles] [-d DOUBLE|--distance DOUBLE] [-n DOUBLE|--number DOUBLE] FILE

DESCRIPTION

cut_tri cuts a triangle cloud using a plane defined by 3 points. Those 3 points can be read from the argument line x1 y1 ... (1st option) or from a FILE (second option, format explained below). The input triangle cloud is read from the standard input and the result is returned to the standard output. If the option --triangles is chosen (default), the result is a triangle cloud, with the part on the side (p2-p1)x(p3-p1) cut away from the original (or, optionally, just a slice parallel to the plane). The option --lines is used to produce one or more line sections through the triangle cloud. If the options --number N and --distance D are specified, N parallel sections with a distance of D between the first and last sections are produced. The first section is made at the level of the plane given by the user and the following sections are made in the direction of the vector (p2-p1)x(p3-p1).

3 POINTS FILE DATA FORMAT

> x1 y1 z1
> x2 y2 z2
> x3 y3 z3

OPTIONS

-h,--help,-?

Returns the manual page.

-l,--lines

Output a line cloud (default is to output a triangle cloud). This option is used to produce one section through the triangle cloud or a series of parallel sections (contour lines).

-t,--triangles

Output a triangle cloud (this is the default).

-d DOUBLE",--distanceDOUBLE

If the output is a triangle cloud, the value specifies the thickness of the slice to extract (if no value is specified, the original point cloud is cut in two by the plane. If the output is a line cloud, the value is the distance between the lowest and the highest section (used together with --number [default: 1.].

-n DOUBLE, --number DOUBLE

Number of parallel sections to produce (used together with --distance; only used if --triangle is not chosen). [default: 1]

AUTHORS

Written by Pierre Smars (first version: 2002)

BUGS

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

COPYRIGHT

Copyright (C) 2018 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

cut_pt(1), view_tri(1)

Pierre SMARS (tools, home page)