54 lines
1.7 KiB
C
54 lines
1.7 KiB
C
/****************************************************************************
|
|
**
|
|
** GeomIO Library
|
|
** Copyright FougSys (2 Mar. 2015)
|
|
** contact@fougsys.fr
|
|
**
|
|
** This software is a reusable library whose purpose is to provide complete
|
|
** I/O support for various CAD file formats (eg. STL)
|
|
**
|
|
** This software is governed by the CeCILL-B license under French law and
|
|
** abiding by the rules of distribution of free software. You can use,
|
|
** modify and/ or redistribute the software under the terms of the CeCILL-B
|
|
** license as circulated by CEA, CNRS and INRIA at the following URL
|
|
** "http://www.cecill.info".
|
|
**
|
|
****************************************************************************/
|
|
|
|
#ifndef GMIO_LIBSTL_FORMAT_H
|
|
#define GMIO_LIBSTL_FORMAT_H
|
|
|
|
#include "stl_global.h"
|
|
#include "../gmio_core/stream.h"
|
|
|
|
GMIO_C_LINKAGE_BEGIN
|
|
|
|
/*! This enums defines the various STL formats */
|
|
enum gmio_stl_format
|
|
{
|
|
GMIO_STL_ASCII_FORMAT, /*!< STL ASCII (text) */
|
|
GMIO_STL_BINARY_LE_FORMAT, /*!< STL binary (little-endian) */
|
|
GMIO_STL_BINARY_BE_FORMAT, /*!< STL binary (big-endian) */
|
|
GMIO_STL_UNKNOWN_FORMAT
|
|
};
|
|
|
|
typedef enum gmio_stl_format gmio_stl_format_t;
|
|
|
|
/*! \brief Returns the format of the STL data in \p stream
|
|
*
|
|
* It will try to read 512 bytes from \p stream into a buffer and then
|
|
* analyses this data to guess the format.
|
|
*
|
|
* Parameter \p data_size must provide the total size (in bytes) of the
|
|
* stream data (e.g. file size), it is required to guess endianness in case
|
|
* of binary format.
|
|
*
|
|
* Returns GMIO_STL_UNKNOWN_FORMAT in case of error.
|
|
*/
|
|
GMIO_LIBSTL_EXPORT
|
|
gmio_stl_format_t gmio_stl_get_format(gmio_stream_t* stream, size_t data_size);
|
|
|
|
GMIO_C_LINKAGE_END
|
|
|
|
#endif /* GMIO_LIBSTL_FORMAT_H */
|