/* * Software License Agreement (BSD License) * * Point Cloud Library (PCL) - www.pointclouds.org * Copyright (c) 2010-2011, Willow Garage, Inc. * * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted 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 the copyright holder(s) nor the names of its * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * 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 OWNER 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 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * * $Id$ * Authors: Anatoly Baksheev */ #pragma once #include #include #include #include #include namespace pcl { namespace io { /** \brief Saves 8-bit encoded image to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] mono_image image grayscale data * \param[in] width image width * \param[in] height image height * \param[in] channels number of channels * \ingroup io */ PCL_EXPORTS void saveCharPNGFile (const std::string& file_name, const unsigned char *mono_image, int width, int height, int channels); /** \brief Saves 16-bit encoded image to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] short_image image short data * \param[in] width image width * \param[in] height image height * \param[in] channels number of channels * \ingroup io */ PCL_EXPORTS void saveShortPNGFile (const std::string& file_name, const unsigned short *short_image, int width, int height, int channels); /** \brief Saves 8-bit encoded RGB image to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] rgb_image image rgb data * \param[in] width image width * \param[in] height image height * \ingroup io */ PCL_EXPORTS void saveRgbPNGFile (const std::string& file_name, const unsigned char *rgb_image, int width, int height); /** \brief Saves 8-bit grayscale cloud as image to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] cloud point cloud to save * \ingroup io */ PCL_EXPORTS void savePNGFile (const std::string& file_name, const pcl::PointCloud& cloud); /** \brief Saves 16-bit grayscale cloud as image to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] cloud point cloud to save * \ingroup io */ PCL_EXPORTS void savePNGFile (const std::string& file_name, const pcl::PointCloud& cloud); /** \brief Saves a PCLImage (formerly ROS sensor_msgs::Image) to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] image image to save * \ingroup io * \note Currently only "rgb8", "mono8", and "mono16" image encodings are supported. */ PCL_EXPORTS void savePNGFile (const std::string& file_name, const pcl::PCLImage& image); /** \brief Saves the data from the specified field of the point cloud as image to PNG file. * \param[in] file_name the name of the file to write to disk * \param[in] cloud point cloud to save * \param[in] field_name the name of the field to extract data from * \ingroup io */ template void savePNGFile (const std::string& file_name, const pcl::PointCloud& cloud, const std::string& field_name) { using PointCloudImageExtractorPtr = typename PointCloudImageExtractor::Ptr; PointCloudImageExtractorPtr pcie; if (field_name == "normal") { pcie = PointCloudImageExtractorPtr (new PointCloudImageExtractorFromNormalField); } else if (field_name == "rgb") { pcie = PointCloudImageExtractorPtr (new PointCloudImageExtractorFromRGBField); } else if (field_name == "label") { pcie = PointCloudImageExtractorPtr (new PointCloudImageExtractorFromLabelField); } else if (field_name == "z") { pcie = PointCloudImageExtractorPtr (new PointCloudImageExtractorFromZField); } else if (field_name == "curvature") { pcie = PointCloudImageExtractorPtr (new PointCloudImageExtractorFromCurvatureField); } else if (field_name == "intensity") { pcie = PointCloudImageExtractorPtr (new PointCloudImageExtractorFromIntensityField); } else { PCL_ERROR ("[pcl::io::savePNGFile] Unsupported field \"%s\".\n", field_name.c_str ()); return; } pcl::PCLImage image; if (pcie->extract (cloud, image)) { savePNGFile(file_name, image); } else { PCL_ERROR ("[pcl::io::savePNGFile] Failed to extract an image from \"%s\" field.\n", field_name.c_str()); } } } }