fileExport.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
 ****************************************************************************/
 
 
#include <cstddef>
#include <memory>
#include <string>
#include <vector>
 
#include "utils/constants.hpp"
#include "uvgutils/utils.hpp"
#include "utils/types.hpp"
#include "types.hpp"
 
using namespace uvgvpcc_enc;
 
namespace FileExport {
 
const std::array<uvgutils::VectorN<uint8_t, 3>, 10> ppiColors = {{
    {91, 91, 91},    // Charcoal Gray
    {0, 102, 51},    // Forest Green
    {153, 0, 0},     // Rich Crimson
    {0, 51, 102},    // Deep Blue
    {255, 204, 0},   // Golden Yellow
    {102, 204, 204}, // Muted Cyan
    {255,0,255},     // Magenta for isolated point identification
    {255,255,255},   // White for masters
    {0,0,0},         // Black
    {255, 0, 255} // 
}};    
 
void cleanIntermediateFiles();
 
// Patch generation
void exportPointCloudNormalComputation(const std::shared_ptr<FrameContext>& frame, const std::vector<uvgutils::VectorN<typeGeometryInput, 3>>& pointsGeometry,
                                       std::vector<uvgutils::VectorN<double, 3>>& normals);
void exportPointCloudNormalOrientation(const std::shared_ptr<FrameContext>& frame, const std::vector<uvgutils::VectorN<typeGeometryInput, 3>>& pointsGeometry,
                                       std::vector<uvgutils::VectorN<double, 3>>& normals);
void exportPointCloudInitialSegmentation(const std::shared_ptr<FrameContext>& frame, const std::vector<uvgutils::VectorN<typeGeometryInput, 3>>& pointsGeometry,
                                         const std::vector<size_t>& pointsPPIs);
void exportPointCloudSubslices(const std::shared_ptr<FrameContext>& frame, const std::vector<uvgutils::VectorN<typeGeometryInput, 3>>& pointsGeometry,const std::vector<uvgutils::VectorN<uint8_t, 3>>& attributes,
                                       const std::string& axisStr);
void exportPointCloudPPIAttributionSlicing(const std::shared_ptr<FrameContext>& frame, const std::vector<uvgutils::VectorN<typeGeometryInput, 3>>& pointsGeometry,
                                        const std::vector<size_t>& pointsPPIs);
void exportPointCloudRefineSegmentation(const std::shared_ptr<FrameContext>& frame, const std::vector<uvgutils::VectorN<typeGeometryInput, 3>>& pointsGeometry,
                                        const std::vector<size_t>& pointsPPIs);
void exportPointCloudPatchSegmentationColor(const std::shared_ptr<FrameContext>& frame);
void exportPointCloudPatchSegmentationBorder(const std::shared_ptr<FrameContext>& frame);
void exportPointCloudPatchSegmentationBorderBlank(const std::shared_ptr<FrameContext>& frame);
 
// Map generation
void exportImageOccupancy(const std::shared_ptr<FrameContext>& frame);
void exportImageOccupancyDS(const std::shared_ptr<FrameContext>& frame);
void exportImageAttribute(const std::shared_ptr<FrameContext>& frame);
void exportImageGeometry(const std::shared_ptr<FrameContext>& frame);
void exportImageAttributeBgFill(const std::shared_ptr<FrameContext>& frame);
void exportImageGeometryBgFill(const std::shared_ptr<FrameContext>& frame);
void exportImageAttributeYUV(const std::shared_ptr<FrameContext>& frame);
 
// Map encoding
void exportOccupancyBitstream(const std::shared_ptr<uvgvpcc_enc::GOF>& gof, const std::vector<uint8_t>& bitstream,
                              const std::string& codecExtension);
void exportAttributeBitstream(const std::shared_ptr<uvgvpcc_enc::GOF>& gof, const std::vector<uint8_t>& bitstream,
                              const std::string& codecExtension);
void exportGeometryBitstream(const std::shared_ptr<uvgvpcc_enc::GOF>& gof, const std::vector<uint8_t>& bitstream,
                             const std::string& codecExtension);
 
// Bitstream generation
void exportAtlasInformation(const size_t& gofId, const std::string& logLine);
 
 
}  // namespace FileExport