mesh-tool.1 (3237B)
1 .\" Copyright (C) 2025 |Méso|Star> (contact@meso-star.com) 2 .\" 3 .\" This program is free software: you can redistribute it and/or modify 4 .\" it under the terms of the GNU General Public License as published by 5 .\" the Free Software Foundation, either version 3 of the License, or 6 .\" (at your option) any later version. 7 .\" 8 .\" This program is distributed in the hope that it will be useful, 9 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of 10 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 11 .\" GNU Lesser General Public License for more details. 12 .\" 13 .\" You should have received a copy of the GNU Lesser General Public License 14 .\" along with this program. If not, see <http://www.gnu.org/licenses/>. 15 .Dd November 19, 2025 16 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 17 .Dt MESH-TOOL 1 18 .Os 19 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 20 .Sh NAME 21 .Nm mesh-tool 22 .Nd transform an StL mesh 23 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 24 .Sh SYNOPSIS 25 .Nm 26 .Op Fl abdhrv 27 .Op Fl i Ar input 28 .Op Fl o Ar output 29 .Op Fl S Ar sx , Ns Ar sy , Ns Ar sz 30 .Op Fl T Ar tx , Ns Ar ty , Ns Ar tz 31 .Op Fl V Ar verbosity 32 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 33 .Sh DESCRIPTION 34 .Nm 35 aims to transform a mesh stored in StL format. 36 Multiple transformations can be applied in a single invocation by 37 repeating the transformation options as needed 38 .Po 39 options 40 .Fl S 41 and 42 .Fl T 43 .Pc . 44 .Pp 45 The options are as follows: 46 .Bl -tag -width Ds 47 .It Fl a 48 Assume an ASCII StL format. 49 .It Fl b 50 Assumes a binary StL format. 51 .It Fl d 52 Output mesh description and exit. 53 .It Fl h 54 Output short help and exit. 55 .It Fl i Ar input 56 Path to the input StL file. 57 If not defined, the mesh is read from standard input. 58 .It Fl o Ar output 59 Path to the output StL file. 60 If not defined, the transformed mesh is written to standard output. 61 .It Fl r 62 Reverse the normals. 63 .It Fl S Ar sx , Ns Ar sy , Ns Ar sz 64 Scale the mesh. 65 Repeating this option allows you to apply multiple scales. 66 .It Fl T Ar tx , Ns Ar ty , Ns Ar tz 67 Translate the mesh. 68 Repeating this option allows you to apply multiple translations. 69 .It Fl V Ar verbosity 70 Set the verbosity level. 71 Possible values are 72 .Ql 0 73 .Pq no message , 74 .Ql 1 75 .Pq error messages only , 76 .Ql 2 77 .Pq error and warning messages , 78 and 79 .Ql 3 80 .Pq error, warning and informative messages . 81 All the messages are written to standard error. 82 Default is 0. 83 .It Fl v 84 Output version information and exit. 85 .El 86 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 87 .Sh EXIT STATUS 88 .Ex -std 89 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 90 .Sh EXAMPLES 91 Make the 92 .Pa bunny.stl 93 mesh twice as big and move it 5 units along the X axis and 3.14 units 94 along the Z axis. 95 Store the transformed mesh in the 96 .Pa big_move_bunny.stl 97 file: 98 .Bd -literal -offset Ds 99 mesh-tool -i bunny.stl -S 2,2,2 -T 5,0,3.14 -o big_move_bunny.stl 100 .Ed 101 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 102 .Sh SEE ALSO 103 .Rs 104 .%T The StL Format: Standard Data Format for Fabbers 105 .%A Marshall Burns 106 .%D 1993 107 .%U https://www.fabbers.com/tech/STL_Format 108 .Re