chubv/php-stl

Library to parse STL file and get some statistics of the model

v2.1.1 2022-11-22 09:27 UTC

README

This repository contains code for handling 3D models saved in STL format.

How to get it

The suggested installation method is via composer.

Add a dependency on chubv/php-stl to your project's composer.json file.

Usage

To get the model build the Reader and read the model from file

$model = STLReader::forFile(__DIR__ . '/stls/text.stl')->readModel();

You can use VolumeHandler to calculate volume of 3D model without STLModel object construction (memory consumption is proportional to model size) or write your own handler by implementing HandlerInterface and setting it to reader.

    $reader = STLReader::forFile(__DIR__ . '/stls/text.stl');
    $reader->setHandler(new VolumeHandler());
    $volume = $reader->readModel();

Tests

The PHPUnit version to be used is the one installed as a dev- dependency via composer:

$ ./vendor/bin/phpunit

License

It's under MIT. Look at LICENSE file.

Contributing

Feel free to make pull requests or create issues. You can also contact me via e-mail v[at]chub.com.ua