/****************************************************************************
**
** 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 */