QGIS/external/mdal/3rdparty/libplyxx.h

/*
This file forked from https://github.com/srajotte/libplyxx

Copyright (c) 2016 Simon Rajotte

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Updated (c) 2021 - 23 Runette Software Ltd to make multiplatform, to complete the typemaps and add to voxel types.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

*/

#pragma once

#include <vector>
#include <array>
#include <map>
#include <unordered_map>
#include <type_traits>
#include <cassert>
#include <memory>
#include <functional>

#include "textio.h"

namespace libply
{
  enum class Type
  {
    INT8,
    UINT8,
    INT16,
    UINT16,
    INT32,
    UINT32,
    FLOAT32,
    FLOAT64,
    COORDINATE
  };

  class IProperty
  {
    public:
      virtual ~IProperty() = default;

      virtual IProperty &operator=( unsigned char value ) = 0;
      virtual IProperty &operator=( char value ) = 0;
      virtual IProperty &operator=( unsigned short value ) = 0;
      virtual IProperty &operator=( short value ) = 0;
      virtual IProperty &operator=( unsigned int value ) = 0;
      virtual IProperty &operator=( int value ) = 0;
      virtual IProperty &operator=( float value ) = 0;
      virtual IProperty &operator=( double value ) = 0;

      virtual operator char() = 0;
      virtual operator unsigned char() = 0;
      virtual operator short() = 0;
      virtual operator unsigned short() = 0;
      virtual operator int() = 0;
      virtual operator unsigned int() = 0;
      virtual operator float() = 0;
      virtual operator double() = 0;

      virtual bool isList() = 0;

  };

  template<typename InternalType>
  class ScalarProperty: public IProperty
  {
    public :

      virtual ~ScalarProperty() = default;

      virtual ScalarProperty &operator= ( unsigned char value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };
      virtual ScalarProperty &operator= ( char value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };
      virtual ScalarProperty &operator= ( unsigned short value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };
      virtual ScalarProperty &operator= ( short value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };

      virtual ScalarProperty &operator=( unsigned int value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };
      virtual ScalarProperty &operator=( int value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };
      virtual ScalarProperty &operator=( float value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };
      virtual ScalarProperty &operator=( double value ) override
      {
        m_value = static_cast<InternalType>( value );
        return *this;
      };

      virtual operator char() override
      {
        return static_cast<char>( m_value );
      };

      virtual operator unsigned char() override
      {
        return static_cast<unsigned char>( m_value );
      };

      virtual operator short() override
      {
        return static_cast<short>( m_value );
      };

      virtual operator unsigned short() override
      {
        return static_cast<unsigned short>( m_value );
      };

      virtual operator int() override
      {
        return static_cast<int>( m_value );
      };

      virtual operator unsigned int() override
      {
        return static_cast<unsigned int>( m_value );
      };

      virtual operator float() override
      {
        return static_cast<float>( m_value );
      };

      virtual operator double() override
      {
        return static_cast<double>( m_value );
      };

      virtual bool isList() override { return false; }

    public:
      InternalType value() const { return m_value; };

    private :
      InternalType m_value;
  };

  class ListProperty : public IProperty
  {
    public:

      IProperty &operator=( unsigned char ) override { return *this; };
      IProperty &operator=( char ) override { return *this; };
      IProperty &operator=( unsigned short ) override { return *this; };
      IProperty &operator=( short ) override { return *this; };
      IProperty &operator=( unsigned int ) override { return *this; };
      IProperty &operator=( int ) override  { return *this; };
      IProperty &operator=( float ) override  { return *this; };
      IProperty &operator=( double ) override  { return *this; };

      operator char()override { return 0; };
      operator unsigned char()override { return 0; };
      operator short() override { return 0; };
      operator unsigned short() override { return 0; };
      operator int() override { return 0; };
      operator unsigned int() override { return 0; };
      operator float() override { return 0; };
      operator double() override { return 0; };

      bool isList() override { return true; }

      void define( Type type, size_t size );
      size_t size() const { return list.size(); }

      IProperty &value( size_t index );

    private:
      std::vector<std::unique_ptr<IProperty>> list;
      std::unique_ptr<IProperty> getScalarProperty( Type type );
  };

  struct ElementDefinition;

  class ElementBuffer
  {
    public:
      ElementBuffer() = default;
      ElementBuffer( const ElementDefinition &definition );

    public:
      size_t size() const { return properties.size(); };
      IProperty &operator[]( size_t index );

    private:
      void appendScalarProperty( Type type );
      void appendListProperty( Type type );
      std::unique_ptr<IProperty> getScalarProperty( Type type );

    private:
      std::vector<std::unique_ptr<IProperty>> properties;
  };

  struct Property
  {
    Property( const std::string &name, Type type, bool isList )
      : name( name ), type( type ), isList( isList ) {};

    std::string name;
    Type type;
    bool isList;
    size_t listCount;
  };

  typedef std::size_t ElementSize;

  struct Element
  {
    Element( const std::string &name, ElementSize size, const std::vector<Property> &properties )
      : name( name ), size( size ), properties( properties ) {};

    std::string name;
    ElementSize size;
    std::vector<Property> properties;
  };

  typedef std::function< void( ElementBuffer & ) > ElementReadCallback;

  class FileParser;

  typedef std::vector<Element> ElementsDefinition;
  typedef std::unordered_map<std::string, std::string> Metadata;

  class File
  {
    public:
      File( const std::string &filename );
      ~File();

      ElementsDefinition definitions() const;
      Metadata metadata() const;

      void setElementReadCallback( std::string elementName, ElementReadCallback &readCallback );
      void read();

    public:
      enum class Format
      {
        ASCII,
        BINARY_LITTLE_ENDIAN,
        BINARY_BIG_ENDIAN
      };

      std::string format() const;

    private:
      std::string m_filename;
      std::unique_ptr<FileParser> m_parser;
  };


  typedef std::function< void( ElementBuffer &, size_t index ) > ElementWriteCallback;

  class FileOut
  {
    public:
      FileOut( const std::string &filename, File::Format format );

      void setElementsDefinition( const ElementsDefinition &definitions );
      void setElementWriteCallback( const std::string &elementName, ElementWriteCallback &writeCallback );
      void write();
      Metadata metadata;

    private:
      std::string m_filename;
      File::Format m_format;
      ElementsDefinition m_definitions;
      std::map<std::string, ElementWriteCallback> m_writeCallbacks;
  };
}