ply.h

/*****************************************************************************
 * VCLib                                                                     *
 * Visual Computing Library                                                  *
 *                                                                           *
 * Copyright(C) 2021-2026                                                    *
 * Visual Computing Lab                                                      *
 * ISTI - Italian National Research Council                                  *
 *                                                                           *
 * All rights reserved.                                                      *
 *                                                                           *
 * This program is free software; you can redistribute it and/or modify      *
 * it under the terms of the Mozilla Public License Version 2.0 as published *
 * by the Mozilla Foundation; either version 2 of the License, or            *
 * (at your option) any later version.                                       *
 *                                                                           *
 * This program is distributed in the hope that it will be useful,           *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of            *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the              *
 * Mozilla Public License Version 2.0                                        *
 * (https://www.mozilla.org/en-US/MPL/2.0/) for more details.                *
 ****************************************************************************/
 
#ifndef VCL_IO_MESH_PLY_DETAIL_PLY_H
#define VCL_IO_MESH_PLY_DETAIL_PLY_H
 
#include <vclib/base.h>
 
#include <list>
 
namespace vcl::detail {
 
// put all these enumeration names inside a ply namespace, to avoid collisions
 
namespace ply {
 
typedef enum { ASCII, BINARY_LITTLE_ENDIAN, BINARY_BIG_ENDIAN, UNKNOWN } Format;
 
typedef enum { VERTEX, FACE, EDGE, TRISTRIP, MATERIAL, OTHER } ElementType;
 
typedef enum { RGB, RGBA } ColorMode;
 
typedef enum {
    unknown = -1,
    x,
    y,
    z,
    nx,
    ny,
    nz,
    red,
    green,
    blue,
    alpha,
    quality,
    texture_u,
    texture_v,
    material_index,
    vertex_indices,
    texcoord,
    vertex1,
    vertex2,
    // material properties (base color is red, green, blue, alpha)
    name,
    metallic,
    roughness,
    emissive_red,
    emissive_green,
    emissive_blue,
    alpha_mode,
    alpha_cutoff,
    normal_scale,
    occlusion_strength,
    double_sided,
    base_color_texture,
    metallic_roughness_texture,
    normal_texture,
    occlusion_texture,
    emissive_texture
} PropertyName;
 
using PropertyType = PrimitiveType;
 
} // namespace ply
 
struct PlyProperty
{
    ply::PropertyName name;
    ply::PropertyType type;
    bool              list = false;
    ply::PropertyType listSizeType;
    std::string       unknownPropertyName; // when a property is not recognized
};
 
struct PlyElement
{
    ply::ElementType       type;
    std::list<PlyProperty> properties;
    uint                   elementCount;
    std::string unknownElementType; // when an element is not recognized
};
 
} // namespace vcl::detail
 
#endif // VCL_IO_MESH_PLY_DETAIL_PLY_H