/****************************************************************************** * Copyright (c) 2014, Hobu 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 Hobu, Inc. or Flaxen Geo Consulting 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. ****************************************************************************/ #pragma once #include #include #include #include #include #include #include #include #include #include #include //#pragma warning(disable: 4244) // conversion from 'type1' to 'type2', possible loss of data namespace pdal { namespace plang { class Invocation; } struct PointViewLess; class PointView; class PointViewIter; class KD2Index; class KD3Index; class BOX2D; class BOX3D; struct RasterLimits; template class Raster; using Rasterd = Raster; typedef std::shared_ptr PointViewPtr; typedef std::set PointViewSet; class PDAL_DLL PointView : public PointContainer { FRIEND_TEST(VoxelTest, center); friend class Stage; friend class plang::Invocation; friend class PointIdxRef; friend struct PointViewLess; public: PointView(const PointView&) = delete; PointView& operator=(const PointView&) = delete; PointView(PointTableRef pointTable); PointView(PointTableRef pointTable, const SpatialReference& srs); virtual ~PointView(); PointViewIter begin(); PointViewIter end(); int id() const { return m_id; } point_count_t size() const { return m_size; } bool empty() const { return m_size == 0; } inline void appendPoint(const PointView& buffer, PointId id); void append(const PointView& buf) { // We use size() instead of the index end because temp points // might have been placed at the end of the buffer. // We're essentially ditching temp points. auto thisEnd = m_index.begin() + size(); auto bufEnd = buf.m_index.begin() + buf.size(); m_index.insert(thisEnd, buf.m_index.begin(), bufEnd); m_size += buf.size(); clearTemps(); } /// Return a new point view with the same point table as this /// point buffer. PointViewPtr makeNew() const { return PointViewPtr(new PointView(m_pointTable, m_spatialReference)); } PointRef point(PointId id) { return PointRef(*this, id); } template T getFieldAs(Dimension::Id dim, PointId pointIndex) const; inline void getField(char *pos, Dimension::Id d, Dimension::Type type, PointId id) const; template void setField(Dimension::Id dim, PointId idx, T val); inline void setField(Dimension::Id dim, Dimension::Type type, PointId idx, const void *val); template bool compare(Dimension::Id dim, PointId id1, PointId id2) const { return (getFieldInternal(dim, id1) < getFieldInternal(dim, id2)); } virtual bool compare(Dimension::Id dim, PointId id1, PointId id2) const { const Dimension::Detail *dd = layout()->dimDetail(dim); switch (dd->type()) { case Dimension::Type::Float: return compare(dim, id1, id2); break; case Dimension::Type::Double: return compare(dim, id1, id2); break; case Dimension::Type::Signed8: return compare(dim, id1, id2); break; case Dimension::Type::Signed16: return compare(dim, id1, id2); break; case Dimension::Type::Signed32: return compare(dim, id1, id2); break; case Dimension::Type::Signed64: return compare(dim, id1, id2); break; case Dimension::Type::Unsigned8: return compare(dim, id1, id2); break; case Dimension::Type::Unsigned16: return compare(dim, id1, id2); break; case Dimension::Type::Unsigned32: return compare(dim, id1, id2); break; case Dimension::Type::Unsigned64: return compare(dim, id1, id2); break; case Dimension::Type::None: default: return false; break; } } /*! @return a cumulated bounds of all points in the PointView. \verbatim embed:rst .. note:: This method requires that an `X`, `Y`, and `Z` dimension be available, and that it can be casted into a *double* data type using the :cpp:func:`pdal::Dimension::applyScaling` method. Otherwise, an exception will be thrown. \endverbatim */ void calculateBounds(BOX2D& box) const; void calculateBounds(BOX3D& box) const; void dump(std::ostream& ostr) const; bool hasDim(Dimension::Id id) const { return layout()->hasDim(id); } std::string dimName(Dimension::Id id) const { return layout()->dimName(id); } Dimension::IdList dims() const { return layout()->dims(); } std::size_t pointSize() const { return layout()->pointSize(); } std::size_t dimSize(Dimension::Id id) const { return layout()->dimSize(id); } Dimension::Type dimType(Dimension::Id id) const { return layout()->dimType(id);} DimTypeList dimTypes() const { return layout()->dimTypes(); } PointLayoutPtr layout() const { return m_layout; } inline PointTableRef table() const { return m_pointTable;} SpatialReference spatialReference() const { return m_spatialReference; } /// Fill a buffer with point data specified by the dimension list. /// \param[in] dims List of dimensions/types to retrieve. /// \param[in] idx Index of point to get. /// \param[in] buf Pointer to buffer to fill. void getPackedPoint(const DimTypeList& dims, PointId idx, char *buf) const { for (auto di = dims.begin(); di != dims.end(); ++di) { getField(buf, di->m_id, di->m_type, idx); buf += Dimension::size(di->m_type); } } /// Load the point buffer from memory whose arrangement is specified /// by the dimension list. /// \param[in] dims Dimension/types of data in packed order /// \param[in] idx Index of point to write. /// \param[in] buf Packed data buffer. void setPackedPoint(const DimTypeList& dims, PointId idx, const char *buf) { for (auto di = dims.begin(); di != dims.end(); ++di) { setField(di->m_id, di->m_type, idx, (const void *)buf); buf += Dimension::size(di->m_type); } } /// Provides access to the memory storing the point data. Though this /// function is public, other access methods are safer and preferred. char *getPoint(PointId id) { return m_pointTable.getPoint(m_index[id]); } /// Provides access to the memory storing the point data. Though this /// function is public, other access methods are safer and preferred. char *getOrAddPoint(PointId id) { if (id == size()) { m_index.push_back(m_pointTable.addPoint()); ++m_size; assert(m_temps.empty()); } return m_pointTable.getPoint(m_index.at(id)); } // The standard idiom is swapping with a stack-created empty queue, but // that invokes the ctor and probably allocates. We've probably only got // one or two things in our queue, so just pop until we're empty. void clearTemps() { while (!m_temps.empty()) m_temps.pop(); } MetadataNode toMetadata() const; void invalidateProducts(); /** Creates a mesh with the specified name. \param name Name of the mesh. \return Pointer to the new mesh. Null is returned if the mesh already exists. */ TriangularMesh *createMesh(const std::string& name); /** Get a pointer to a mesh. \param name Name of the mesh. \return New mesh. Null is returned if the mesh already exists. */ TriangularMesh *mesh(const std::string& name = ""); /** Creates a raster with the specified name. \param name Name of the raster. \param limits Limits of the raster to create. \return Pointer to the new raster. Null is returned if the raster already exists. */ Rasterd *createRaster(const std::string& name, const RasterLimits& limits, double noData = 0); /** Get a pointer to a raster. \param name Name of the raster. \return Pointer to the New raster. Null */ Rasterd *raster(const std::string& name = ""); KD3Index& build3dIndex(); KD2Index& build2dIndex(); protected: PointTableRef m_pointTable; PointLayoutPtr m_layout; std::deque m_index; // The index might be larger than the size to support temporary point // references. point_count_t m_size; int m_id; std::queue m_temps; SpatialReference m_spatialReference; std::map> m_meshes; std::map> m_rasters; std::unique_ptr m_index3; std::unique_ptr m_index2; private: static int m_lastId; PointId tableId(PointId idx); virtual void setFieldInternal(Dimension::Id dim, PointId idx, const void *buf); virtual void getFieldInternal(Dimension::Id dim, PointId idx, void *buf) const { m_pointTable.getFieldInternal(dim, m_index[idx], buf); } virtual void swapItems(PointId id1, PointId id2) { PointId temp = m_index[id2]; m_index[id2] = m_index[id1]; m_index[id1] = temp; } virtual void setItem(PointId dst, PointId src) { m_index[dst] = m_index[src]; } template T getFieldInternal(Dimension::Id dim, PointId pointIndex) const; inline PointId getTemp(PointId id); void freeTemp(PointId id) { m_temps.push(id); } void setSpatialReference(const SpatialReference& spatialRef) { m_spatialReference = spatialRef; } // For testing only. PointId index(PointId id) const { return m_index[id]; } }; struct PointViewLess { bool operator () (const PointViewPtr& p1, const PointViewPtr& p2) const { return p1->m_id < p2->m_id; } }; template T PointView::getFieldInternal(Dimension::Id dim, PointId id) const { T t; getFieldInternal(dim, id, &t); return t; } inline void PointView::getField(char *pos, Dimension::Id d, Dimension::Type type, PointId id) const { Everything e; switch (type) { case Dimension::Type::Float: e.f = getFieldAs(d, id); break; case Dimension::Type::Double: e.d = getFieldAs(d, id); break; case Dimension::Type::Signed8: e.s8 = getFieldAs(d, id); break; case Dimension::Type::Signed16: e.s16 = getFieldAs(d, id); break; case Dimension::Type::Signed32: e.s32 = getFieldAs(d, id); break; case Dimension::Type::Signed64: e.s64 = getFieldAs(d, id); break; case Dimension::Type::Unsigned8: e.u8 = getFieldAs(d, id); break; case Dimension::Type::Unsigned16: e.u16 = getFieldAs(d, id); break; case Dimension::Type::Unsigned32: e.u32 = getFieldAs(d, id); break; case Dimension::Type::Unsigned64: e.u64 = getFieldAs(d, id); break; case Dimension::Type::None: break; } memcpy(pos, &e, Dimension::size(type)); } inline void PointView::setField(Dimension::Id dim, Dimension::Type type, PointId idx, const void *val) { Everything e; memcpy(&e, val, Dimension::size(type)); switch (type) { case Dimension::Type::Float: setField(dim, idx, e.f); break; case Dimension::Type::Double: setField(dim, idx, e.d); break; case Dimension::Type::Signed8: setField(dim, idx, e.s8); break; case Dimension::Type::Signed16: setField(dim, idx, e.s16); break; case Dimension::Type::Signed32: setField(dim, idx, e.s32); break; case Dimension::Type::Signed64: setField(dim, idx, e.s64); break; case Dimension::Type::Unsigned8: setField(dim, idx, e.u8); break; case Dimension::Type::Unsigned16: setField(dim, idx, e.u16); break; case Dimension::Type::Unsigned32: setField(dim, idx, e.u32); break; case Dimension::Type::Unsigned64: setField(dim, idx, e.u64); break; case Dimension::Type::None: break; } } template inline T PointView::getFieldAs(Dimension::Id dim, PointId pointIndex) const { assert(pointIndex < m_size); T retval; bool ok = false; const Dimension::Detail *dd = m_layout->dimDetail(dim); Everything e; PointId rawIdx = m_index[pointIndex]; // Note that getFieldInternal() can't be hoisted out of the switch // because we don't want to call it in the case where the dimension // type isn't known. A separate test could be made, but that *might* // cost and this is an important code path. switch (dd->type()) { case Dimension::Type::Float: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.f, retval); break; case Dimension::Type::Double: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.d, retval); break; case Dimension::Type::Signed8: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.s8, retval); break; case Dimension::Type::Signed16: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.s16, retval); break; case Dimension::Type::Signed32: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.s32, retval); break; case Dimension::Type::Signed64: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.s64, retval); break; case Dimension::Type::Unsigned8: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.u8, retval); break; case Dimension::Type::Unsigned16: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.u16, retval); break; case Dimension::Type::Unsigned32: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.u32, retval); break; case Dimension::Type::Unsigned64: m_pointTable.getFieldInternal(dim, rawIdx, &e); ok = Utils::numericCast(e.u64, retval); break; case Dimension::Type::None: default: ok = true; retval = 0; break; } // switch if (!ok) { std::ostringstream oss; oss << "Unable to fetch data and convert as requested: "; oss << Dimension::name(dim) << ":" << Dimension::interpretationName(dd->type()) << "(" << Utils::toDouble(e, dd->type()) << ") -> " << Utils::typeidName(); throw pdal_error(oss.str()); } return retval; } template void PointView::setField(Dimension::Id dim, PointId idx, T val) { const Dimension::Detail *dd = layout()->dimDetail(dim); Everything e; bool ok = true; switch (dd->type()) { case Dimension::Type::Float: ok = Utils::numericCast(val, e.f); break; case Dimension::Type::Double: ok = Utils::numericCast(val, e.d); break; case Dimension::Type::Signed8: ok = Utils::numericCast(val, e.s8); break; case Dimension::Type::Signed16: ok = Utils::numericCast(val, e.s16); break; case Dimension::Type::Signed32: ok = Utils::numericCast(val, e.s32); break; case Dimension::Type::Signed64: ok = Utils::numericCast(val, e.s64); break; case Dimension::Type::Unsigned8: ok = Utils::numericCast(val, e.u8); break; case Dimension::Type::Unsigned16: ok = Utils::numericCast(val, e.u16); break; case Dimension::Type::Unsigned32: ok = Utils::numericCast(val, e.u32); break; case Dimension::Type::Unsigned64: ok = Utils::numericCast(val, e.u64); break; case Dimension::Type::None: return; } if (ok) m_pointTable.setFieldInternal(dim, tableId(idx), &e); else { std::ostringstream oss; oss << "Unable to set data and convert as requested: "; oss << Dimension::name(dim) << ":" << Utils::typeidName() << "(" << (double)val << ") -> " << Dimension::interpretationName(dd->type()); throw pdal_error(oss.str()); } } inline void PointView::appendPoint(const PointView& buffer, PointId id) { // Invalid 'id' is a programmer error. PointId rawId = buffer.m_index[id]; m_index.push_back(rawId); m_size++; assert(m_temps.empty()); } // Make a temporary copy of a point by adding an entry to the index. inline PointId PointView::getTemp(PointId id) { PointId newid; if (m_temps.size()) { newid = m_temps.front(); m_temps.pop(); m_index[newid] = m_index[id]; } else { newid = (PointId)m_index.size(); m_index.push_back(m_index[id]); } return newid; } PDAL_DLL std::ostream& operator<<(std::ostream& ostr, const PointView&); // PointViewIter class PointViewIter { private: PointView *m_view; PointId m_id; public: using iterator_category = std::random_access_iterator_tag; using value_type = PointRef; using difference_type = ptrdiff_t; using pointer = PointRef*; using reference = PointRef; PointViewIter() {} PointViewIter(PointView* view, PointId id) : m_view(view), m_id(id) {} PointViewIter& operator++() { m_id++; return *this; } PointViewIter operator++(int) { return PointViewIter(m_view, m_id++); } PointViewIter& operator--() { --m_id; return *this; } PointViewIter operator--(int) { return PointViewIter(m_view, m_id--); } PointViewIter operator+(const difference_type& n) const { return PointViewIter(m_view, m_id + n); } PointViewIter operator+=(const difference_type& n) { m_id += n; return *this; } PointViewIter operator-(const difference_type& n) const { return PointViewIter(m_view, m_id - n); } PointViewIter operator-=(const difference_type& n) { m_id -= n; return *this; } difference_type operator-(const PointViewIter& i) const { return static_cast(m_id - i.m_id); } bool operator==(const PointViewIter& i) const { return m_id == i.m_id; } bool operator!=(const PointViewIter& i) const { return m_id != i.m_id; } bool operator<(const PointViewIter& i) const { return m_id < i.m_id; } bool operator<=(const PointViewIter& i) const { return m_id <= i.m_id; } bool operator>(const PointViewIter& i) const { return m_id > i.m_id; } bool operator>=(const PointViewIter& i) const { return m_id >= i.m_id; } reference operator*() const { return PointRef(*m_view, m_id); } pointer operator->() { return nullptr; } reference operator[](const difference_type& n) const { return PointRef(*m_view, m_id + n); } }; } // namespace pdal