sstl.1 (2846B)
1 .\" Copyright (C) 2015, 2016, 2019, 2021, 2023, 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 April 11, 2025 16 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 17 .Dt SSTL 1 18 .Os 19 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 20 .Sh NAME 21 .Nm sstl 22 .Nd load and print information on StL files 23 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 24 .Sh SYNOPSIS 25 .Nm 26 .Op Fl abhv 27 .Op Ar file No ... 28 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 29 .Sh DESCRIPTION 30 .Nm 31 loads StL files, whether ASCII or binary encoded, and displays 32 information about them. 33 If no file is provided, the StL is read from standard input. 34 .Pp 35 Its output is a list of lines, one for each file loaded, where each line 36 contains a tab-separated list of values formatted as follows: 37 .Bd -literal -offset Ds 38 "%s\\t%s\\t%u\\t%u\\t%s\\n", type, name, ntriangles, nvertices, file 39 .Ed 40 .Pp 41 with 42 .Ar type 43 the encoding of the file, i.e. either 44 .Qq ascii 45 or 46 .Qq binary , 47 .Ar name 48 the name of the geometry 49 .Po Qq null 50 if not defined 51 .Pc , 52 .Ar ntriangles 53 and 54 .Ar nvertices 55 the number of triangles and vertices in the loaded StL, 56 and 57 .Ar file 58 the file loaded. 59 .Pp 60 The options are as follows: 61 .Bl -tag -width Ds 62 .It Fl a 63 Assumes ASCII input files. 64 .It Fl b 65 Assumes binary input files. 66 .It Fl h 67 Output short help and exit. 68 .It Fl v 69 Make 70 .Nm 71 verbose. 72 Multiple 73 .Fl v 74 options increase the verbosity. 75 The maximum is 3. 76 .El 77 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 78 .Sh EXIT STATUS 79 .Ex -std 80 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 81 .Sh EXAMPLES 82 Load all StL files into the current directory. 83 Let 84 .Nm 85 defines their encoding and make the command as verbose as possible: 86 .Bd -literal -offset Ds 87 sstl -vvv *.stl 88 .Ed 89 .Pp 90 Read a binary StL from standard input: 91 .Bd -literal -offset Ds 92 sstl -b < file.stl 93 .Ed 94 .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" 95 .Sh STANDARDS 96 .Rs 97 .%T The StL Format: Standard Data Format for Fabbers 98 .%A Marshall Burns 99 .%D 1993 100 .%U https://www.fabbers.com/tech/STL_Format 101 .Re