LasScalarField.h

Go to the documentation of this file.

// ----------------------------------------------------------------------------
// -                        CloudViewer: www.cloudViewer.org                  -
// ----------------------------------------------------------------------------
// Copyright (c) 2018-2024 www.cloudViewer.org
// SPDX-License-Identifier: MIT
// ----------------------------------------------------------------------------
 
#pragma once
 
// ##########################################################################
// #                                                                        #
// #                CloudViewer PLUGIN: LAS-IO Plugin                      #
// #                                                                        #
// #  This program is free software; you can redistribute it and/or modify  #
// #  it under the terms of the GNU General Public License as published by  #
// #  the Free Software Foundation; version 2 of the License.               #
// #                                                                        #
// #  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         #
// #  GNU General Public License for more details.                          #
// #                                                                        #
// #                   COPYRIGHT: Thomas Montaigu                           #
// #                                                                        #
// ##########################################################################
 
// CORE
#include <CVTypes.h>
// qCC_db
#include <ecvScalarField.h>
 
// System
#include <cstdint>
 
struct LasScalarField
{
    enum Id
    {
        Intensity       = 0,
        ReturnNumber    = 1,
        NumberOfReturns = 2,
        ScanDirectionFlag,
        EdgeOfFlightLine,
        Classification,
        SyntheticFlag,
        KeypointFlag,
        WithheldFlag,
        ScanAngleRank,
        UserData,
        PointSourceId,
        GpsTime,
        // Extended (LAS 1.4)
        ExtendedScanAngle,
        ExtendedScannerChannel,
        OverlapFlag,
        ExtendedClassification,
        ExtendedReturnNumber,
        ExtendedNumberOfReturns,
        NearInfrared
    };
 
    struct Range
    {
        template <class T>
        constexpr Range(T minValue, T maxValue)
            : min(static_cast<ScalarType>(minValue))
            , max(static_cast<ScalarType>(maxValue))
        {
        }
 
        template <class T>
        static constexpr Range ForType()
        {
            return Range(std::numeric_limits<T>::min(), std::numeric_limits<T>::max());
        }
 
        static Range ForBitCount(uint8_t numBits)
        {
            return Range(0, ((1 << static_cast<uint32_t>(numBits)) - 1));
        }
 
        ScalarType min = 0;
        ScalarType max = 0;
    };
 
  public: // Methods and Constructors
    LasScalarField() = delete;
 
    explicit LasScalarField(LasScalarField::Id id, ccScalarField* sf = nullptr);
 
    const char* name() const;
 
  public: // Static functions
    static constexpr const char* NameFromId(LasScalarField::Id id);
    static LasScalarField::Id IdFromName(const char* name, unsigned targetPointFormat);
    static LasScalarField::Range ValueRange(LasScalarField::Id id);
    static std::vector<LasScalarField> ForPointFormat(unsigned pointFormatId);
 
  public: // Members
    Id id;
    ccScalarField* sf{nullptr};
    Range          range;
};