orient - orients point, line or triangle clouds
orient [-x|-y] [-ox DOUBLE] [-oy DOUBLE] [-oz DOUBLE] [-px DOUBLE] [-py DOUBLE] [-pz DOUBLE] [-m STRING|--matrix STRING] [-p INT|--precision INT] [-?|-h|--help]
orient translates and rotate a point, line or triangle cloud so that:
1> point (0 0 0) of the input becomes point (ox oy oz) of the output (translation of the origin)
2> either point (1 0 0) of the input is moved to a point on the line (p-o) (by default or if option -x is set), either point (0 1 0) of the input is moved to a point on the line (p-o) (if option -y is set). (rotation around the new origin)
The vertical remains vertical. The program reads the cloud from the standard input and returns the result to the standard output. The format of the clouds are described in view_pt(1), view_li(1) and view_tri(1).
Option -m gives the possibility to use the program to orient the data using a 4x4 homogeneous transformation matrix specifying translation/rotation/scaling or more general transformations. When this option is selected, options -ox, -oy, ... -pz have no effect.
coordinate of the origin (default: 0 0 0)
coordinate of a point on the reference direction (default: 1 0 0)
set the reference direction (default x: 1 0 0)
number of decimals (default: 6)
read from file STRING a 4x4 matrix of translation and rotation
Returns the manual page
Written by Pierre Smars (first version: 2002)
Reports of bugs or problems should be submitted via electronic mail to <smars@yuntech.edu.tw>.
Copyright (C) 2015 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.
translate(1), rotate(1), mirror(1), scale(1), view_pt(1), view_li(1), view_tri(1)