patchGeneration.hpp

Go to the documentation of this file.

/*****************************************************************************
 * This file is part of uvgVPCCenc V-PCC encoder.
 *
 * Copyright (c) 2024-present, Tampere University, ITU/ISO/IEC, project contributors
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted (subject to the limitations in the disclaimer below) provided that the following conditions are met:
 * 
 * * Redistributions of source code must retain the above copyright notice, this
 *   list of conditions and the following disclaimer.
 * 
 * * Redistributions in binary form must reproduce the above copyright notice, this
 *   list of conditions and the following disclaimer in the documentation and/or
 *   other materials provided with the distribution.
 * 
 * * Neither the name of Tampere University, ITU/ISO/IEC nor the names of its
 *   contributors may be used to endorse or promote products derived from
 *   this software without specific prior written permission.
 * 
 * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE.
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON
 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS
 ****************************************************************************/
 
 
#pragma once
 
#include "utils/types.hpp"
#include "utils/types.hpp"
 
class PatchGeneration {
   public:
 
   PatchGeneration(const std::shared_ptr<uvgvpcc_enc::FrameContext>& frameInput);
 
   // Main function called by the job
   static void generateFramePatches(std::shared_ptr<uvgvpcc_enc::FrameContext> frameInput);
   
   private:
   // Normal-based 
   void computeNormals(std::vector<uvgutils::VectorN<double, 3>>& normals,
                    const std::vector<uvgutils::VectorN<uvgvpcc_enc::typeGeometryInput, 3>>& pointsGeometry,
                    const std::vector<std::vector<size_t>>& pointsNNList);
 
   void orientNormals(std::vector<uvgutils::VectorN<double, 3>>& normals,
                   const std::vector<uvgutils::VectorN<uvgvpcc_enc::typeGeometryInput, 3>>& pointsGeometry,
                   const std::vector<std::vector<size_t>>& pointsNNList);
 
 
   // PPI Segmentation 
      // Normal-Based
   void initialSegmentation(std::vector<size_t>& pointsPPIs, const std::vector<uvgutils::VectorN<double, 3>>& pointsNormals, 
                             const std::vector<uvgutils::VectorN<uvgvpcc_enc::typeGeometryInput, 3>>& pointsGeometry,const size_t& frameId);
    
   template<typename keyType>
   void refineSegmentation(std::vector<size_t>& pointsPPIs, const std::vector<uvgutils::VectorN<double, 3>>& pointsNormals, 
                            const std::vector<uvgutils::VectorN<uvgvpcc_enc::typeGeometryInput, 3>>& pointsGeometry, const size_t& frameId);
 
 
      // Slice-Based
   template<typename indexType>
   void ppiAssignationSlicing(const std::vector<uvgutils::VectorN<uvgvpcc_enc::typeGeometryInput, 3>>& pointsGeometry, std::vector<size_t>& pointPPIs);
   
   template<typename keyType>
   void refineSegmentation_NewRS(std::vector<size_t>& pointsPPIs,
                                      const std::vector<bool>& normalExists,
                                      const std::vector<uvgutils::VectorN<uvgvpcc_enc::typeGeometryInput, 3>>& pointsGeometry,
                                      const size_t& frameId);
 
   // Patch segmentation
   template<typename keyType>
   void patchSegmentation(const std::vector<size_t>& pointsPPIs);
 
   const std::shared_ptr<uvgvpcc_enc::FrameContext>& frame_;
};