star-stl

Load STereo Lithography (StL) file format
git clone git://git.meso-star.fr/star-stl.git
Log | Files | Refs | README | LICENSE

README.md (2577B)

      1 # Star STereo Lithography
      2 
      3 Star-StL loads StL file format
      4 
      5 ## Requirements
      6 
      7 - C compiler (C99)
      8 - POSIX make
      9 - pkg-config
     10 - [RSys](https://gitlab.com/vaplv/rsys/)
     11 - [mandoc](https://mandoc.bsd.lv)
     12 
     13 ## Installation
     14 
     15 Edit config.mk as needed, then run:
     16 
     17     make clean install
     18 
     19 ## Release notes
     20 
     21 ### Version 0.7
     22 
     23 - Add the Descriptors API to facilitate access to mesh data from its raw
     24   data structure.
     25 
     26 ### Version 0.6
     27 
     28 - Improve code readability and simplicity by rewriting the internal
     29   architecture and implementation.
     30 - Improve detection of the type of StL loaded (binary or ASCII).
     31 - Prohibit the loading of untyped StL on non-searchable streams such as
     32   pipes, FIFOs or sockets.
     33   This would require duplicating input data, a complex implementation
     34   for a marginal feature, in other words, "it would suck".
     35 - Rewrite the "write" API.
     36   It's designed to simplify streamed output, i.e. to write StLs whose
     37   data is not in memory.
     38 - Make binary loading agnostic to the endianness of the host
     39   architecture.
     40 - Added the sstl utility, which loads StL files and prints information
     41   about them.
     42 - Improve the build system.
     43   Simplify it by doing everything in one place (the Makefile).
     44   Add macros to control installation sub-directories.
     45 
     46 ### Version 0.5.1
     47 
     48 - Fix issues when reading on stdin
     49 - Add a warning if trailing chars detected after the solid in ascii
     50   files.
     51 - Add the read data type in the descriptor.
     52 - Fix a false error log message (should have been an information
     53   message).
     54 
     55 ### Version 0.5
     56 
     57 - Replace CMake by Makefile as build system.
     58 - Provide a pkg-config file to link the library as an external
     59   dependency.
     60 
     61 ### Version 0.4.1
     62 
     63 Correction of a compilation error highlighted in particular by GCC 4.9.2
     64 
     65 ### Version 0.4
     66 
     67 - Add write functionality (either to files or streams),
     68 - Add support for binary format,
     69 - Fix tests (a test was run twice, the other one was not run).
     70 
     71 ### Version 0.3.4
     72 
     73 - Sets the CMake minimum version to 3.1: since CMake 3.20, version 2.8
     74   has become obsolete.
     75 
     76 ### Version 0.3.3
     77 
     78 - Fix star-stl lack of reentrancy. When used from a code using strtok,
     79   star-stl was corrupting the strtok context.
     80 
     81 ### Version 0.3.2
     82 
     83 - Update the version of the RSys dependency to 0.6: replace the
     84   deprecated `[N]CHECK` macros by the new macro `CHK`.
     85 
     86 ## License
     87 
     88 Copyright (C) 2015, 2016, 2019, 2021, 2023, 2025 |Méso|Star> (contact@meso-star.com)
     89 
     90 Star-STL is free software released under GPL v3+ license: GNU GPL
     91 version 3 or later. You are welcome to redistribute it under certain
     92 conditions; refer to the COPYING file for details.
     93