391 lines
17 KiB
C++
391 lines
17 KiB
C++
/*******************************************************************************
|
|
Copyright (c) 2005-2009 David Williams
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any damages
|
|
arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
including commercial applications, and to alter it and redistribute it
|
|
freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
claim that you wrote the original software. If you use this software
|
|
in a product, an acknowledgment in the product documentation would be
|
|
appreciated but is not required.
|
|
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
misrepresented as being the original software.
|
|
|
|
3. This notice may not be removed or altered from any source
|
|
distribution.
|
|
*******************************************************************************/
|
|
|
|
namespace PolyVox
|
|
{
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This constructor creates a volume with a fixed size which is specified as a parameter.
|
|
/// \param regValid Specifies the minimum and maximum valid voxel positions.
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
RawVolume<VoxelType>::RawVolume(const Region& regValid)
|
|
:BaseVolume<VoxelType>(regValid)
|
|
{
|
|
this->setBorderValue(VoxelType());
|
|
|
|
//Create a volume of the right size.
|
|
initialise(regValid);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This function should never be called. Copying volumes by value would be expensive, and we want to prevent users from doing
|
|
/// it by accident (such as when passing them as paramenters to functions). That said, there are times when you really do want to
|
|
/// make a copy of a volume and in this case you should look at the Volumeresampler.
|
|
///
|
|
/// \sa VolumeResampler
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
RawVolume<VoxelType>::RawVolume(const RawVolume<VoxelType>& /*rhs*/)
|
|
{
|
|
POLYVOX_THROW(not_implemented, "Volume copy constructor not implemented for performance reasons.");
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// Destroys the volume
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
RawVolume<VoxelType>::~RawVolume()
|
|
{
|
|
delete[] m_pData;
|
|
m_pData = 0;
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This function should never be called. Copying volumes by value would be expensive, and we want to prevent users from doing
|
|
/// it by accident (such as when passing them as paramenters to functions). That said, there are times when you really do want to
|
|
/// make a copy of a volume and in this case you should look at the Volumeresampler.
|
|
///
|
|
/// \sa VolumeResampler
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
RawVolume<VoxelType>& RawVolume<VoxelType>::operator=(const RawVolume<VoxelType>& /*rhs*/)
|
|
{
|
|
POLYVOX_THROW(not_implemented, "Volume assignment operator not implemented for performance reasons.");
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This version of the function requires the wrap mode to be specified as a
|
|
/// template parameter, which can provide better performance.
|
|
/// \param uXPos The \c x position of the voxel
|
|
/// \param uYPos The \c y position of the voxel
|
|
/// \param uZPos The \c z position of the voxel
|
|
/// \tparam eWrapMode Specifies the behaviour when the requested position is outside of the volume.
|
|
/// \param tBorder The border value to use if the wrap mode is set to 'Border'.
|
|
/// \return The voxel value
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
template <WrapMode eWrapMode>
|
|
VoxelType RawVolume<VoxelType>::getVoxel(int32_t uXPos, int32_t uYPos, int32_t uZPos, VoxelType tBorder) const
|
|
{
|
|
// Simply call through to the real implementation
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<eWrapMode>(), tBorder);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This version of the function requires the wrap mode to be specified as a
|
|
/// template parameter, which can provide better performance.
|
|
/// \param uXPos The \c x position of the voxel
|
|
/// \param uYPos The \c y position of the voxel
|
|
/// \param uZPos The \c z position of the voxel
|
|
/// \tparam eWrapMode Specifies the behaviour when the requested position is outside of the volume.
|
|
/// \param tBorder The border value to use if the wrap mode is set to 'Border'.
|
|
/// \return The voxel value
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
template <WrapMode eWrapMode>
|
|
VoxelType RawVolume<VoxelType>::getVoxel(const Vector3DInt32& v3dPos, VoxelType tBorder) const
|
|
{
|
|
// Simply call through to the real implementation
|
|
return getVoxel<eWrapMode>(v3dPos.getX(), v3dPos.getY(), v3dPos.getZ(), tBorder);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This version of the function is provided so that the wrap mode does not need
|
|
/// to be specified as a template parameter, as it may be confusing to some users.
|
|
/// \param uXPos The \c x position of the voxel
|
|
/// \param uYPos The \c y position of the voxel
|
|
/// \param uZPos The \c z position of the voxel
|
|
/// \param eWrapMode Specifies the behaviour when the requested position is outside of the volume.
|
|
/// \param tBorder The border value to use if the wrap mode is set to 'Border'.
|
|
/// \return The voxel value
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxel(int32_t uXPos, int32_t uYPos, int32_t uZPos, WrapMode eWrapMode, VoxelType tBorder) const
|
|
{
|
|
switch(eWrapMode)
|
|
{
|
|
case WrapModes::Validate:
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::Validate>(), tBorder);
|
|
case WrapModes::Clamp:
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::Clamp>(), tBorder);
|
|
case WrapModes::Border:
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::Border>(), tBorder);
|
|
case WrapModes::AssumeValid:
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::AssumeValid>(), tBorder);
|
|
default:
|
|
// Should never happen
|
|
POLYVOX_ASSERT(false, "Invalid wrap mode");
|
|
return VoxelType();
|
|
}
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This version of the function is provided so that the wrap mode does not need
|
|
/// to be specified as a template parameter, as it may be confusing to some users.
|
|
/// \param v3dPos The 3D position of the voxel
|
|
/// \param eWrapMode Specifies the behaviour when the requested position is outside of the volume.
|
|
/// \param tBorder The border value to use if the wrap mode is set to 'Border'.
|
|
/// \return The voxel value
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxel(const Vector3DInt32& v3dPos, WrapMode eWrapMode, VoxelType tBorder) const
|
|
{
|
|
return getVoxel(v3dPos.getX(), v3dPos.getY(), v3dPos.getZ(), eWrapMode, tBorder);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// \param uXPos The \c x position of the voxel
|
|
/// \param uYPos The \c y position of the voxel
|
|
/// \param uZPos The \c z position of the voxel
|
|
/// \return The voxel value
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxelAt(int32_t uXPos, int32_t uYPos, int32_t uZPos) const
|
|
{
|
|
if(this->m_regValidRegion.containsPoint(Vector3DInt32(uXPos, uYPos, uZPos)))
|
|
{
|
|
const Vector3DInt32& v3dLowerCorner = this->m_regValidRegion.getLowerCorner();
|
|
int32_t iLocalXPos = uXPos - v3dLowerCorner.getX();
|
|
int32_t iLocalYPos = uYPos - v3dLowerCorner.getY();
|
|
int32_t iLocalZPos = uZPos - v3dLowerCorner.getZ();
|
|
|
|
return m_pData
|
|
[
|
|
iLocalXPos +
|
|
iLocalYPos * this->getWidth() +
|
|
iLocalZPos * this->getWidth() * this->getHeight()
|
|
];
|
|
}
|
|
else
|
|
{
|
|
return this->getBorderValue();
|
|
}
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// \param v3dPos The 3D position of the voxel
|
|
/// \return The voxel value
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxelAt(const Vector3DInt32& v3dPos) const
|
|
{
|
|
return getVoxelAt(v3dPos.getX(), v3dPos.getY(), v3dPos.getZ());
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// \param uXPos the \c x position of the voxel
|
|
/// \param uYPos the \c y position of the voxel
|
|
/// \param uZPos the \c z position of the voxel
|
|
/// \param tValue the value to which the voxel will be set
|
|
/// \param eWrapMode Specifies the behaviour when the requested position is outside of the volume.
|
|
/// This must be set to 'None' or 'DontCheck'. Other wrap modes cannot be used when writing to volume data.
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
void RawVolume<VoxelType>::setVoxel(int32_t uXPos, int32_t uYPos, int32_t uZPos, VoxelType tValue, WrapMode eWrapMode)
|
|
{
|
|
if((eWrapMode != WrapModes::Validate) && (eWrapMode != WrapModes::AssumeValid))
|
|
{
|
|
POLYVOX_THROW(std::invalid_argument, "Invalid wrap mode in call to setVoxel(). It must be 'None' or 'DontCheck'.");
|
|
}
|
|
|
|
// This validation is skipped if the wrap mode is 'DontCheck'
|
|
if(eWrapMode == WrapModes::Validate)
|
|
{
|
|
if(this->m_regValidRegion.containsPoint(Vector3DInt32(uXPos, uYPos, uZPos)) == false)
|
|
{
|
|
POLYVOX_THROW(std::out_of_range, "Position is outside valid region");
|
|
}
|
|
}
|
|
|
|
const Vector3DInt32& v3dLowerCorner = this->m_regValidRegion.getLowerCorner();
|
|
int32_t iLocalXPos = uXPos - v3dLowerCorner.getX();
|
|
int32_t iLocalYPos = uYPos - v3dLowerCorner.getY();
|
|
int32_t iLocalZPos = uZPos - v3dLowerCorner.getZ();
|
|
|
|
m_pData
|
|
[
|
|
iLocalXPos +
|
|
iLocalYPos * this->getWidth() +
|
|
iLocalZPos * this->getWidth() * this->getHeight()
|
|
] = tValue;
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// \param v3dPos the 3D position of the voxel
|
|
/// \param tValue the value to which the voxel will be set
|
|
/// \param eWrapMode Specifies the behaviour when the requested position is outside of the volume.
|
|
/// This must be set to 'None' or 'DontCheck'. Other wrap modes cannot be used when writing to volume data.
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
void RawVolume<VoxelType>::setVoxel(const Vector3DInt32& v3dPos, VoxelType tValue, WrapMode eWrapMode)
|
|
{
|
|
setVoxel(v3dPos.getX(), v3dPos.getY(), v3dPos.getZ(), tValue, eWrapMode);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// \param uXPos the \c x position of the voxel
|
|
/// \param uYPos the \c y position of the voxel
|
|
/// \param uZPos the \c z position of the voxel
|
|
/// \param tValue the value to which the voxel will be set
|
|
/// \return whether the requested position is inside the volume
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
bool RawVolume<VoxelType>::setVoxelAt(int32_t uXPos, int32_t uYPos, int32_t uZPos, VoxelType tValue)
|
|
{
|
|
if(this->m_regValidRegion.containsPoint(Vector3DInt32(uXPos, uYPos, uZPos)))
|
|
{
|
|
const Vector3DInt32& v3dLowerCorner = this->m_regValidRegion.getLowerCorner();
|
|
int32_t iLocalXPos = uXPos - v3dLowerCorner.getX();
|
|
int32_t iLocalYPos = uYPos - v3dLowerCorner.getY();
|
|
int32_t iLocalZPos = uZPos - v3dLowerCorner.getZ();
|
|
|
|
m_pData
|
|
[
|
|
iLocalXPos +
|
|
iLocalYPos * this->getWidth() +
|
|
iLocalZPos * this->getWidth() * this->getHeight()
|
|
] = tValue;
|
|
|
|
//Return true to indicate that we modified a voxel.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
return false;
|
|
}
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// \param v3dPos the 3D position of the voxel
|
|
/// \param tValue the value to which the voxel will be set
|
|
/// \return whether the requested position is inside the volume
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
bool RawVolume<VoxelType>::setVoxelAt(const Vector3DInt32& v3dPos, VoxelType tValue)
|
|
{
|
|
return setVoxelAt(v3dPos.getX(), v3dPos.getY(), v3dPos.getZ(), tValue);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// This function should probably be made internal...
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
void RawVolume<VoxelType>::initialise(const Region& regValidRegion)
|
|
{
|
|
this->m_regValidRegion = regValidRegion;
|
|
|
|
if(this->getWidth() <= 0)
|
|
{
|
|
POLYVOX_THROW(std::invalid_argument, "Volume width must be greater than zero.");
|
|
}
|
|
if(this->getHeight() <= 0)
|
|
{
|
|
POLYVOX_THROW(std::invalid_argument, "Volume height must be greater than zero.");
|
|
}
|
|
if(this->getDepth() <= 0)
|
|
{
|
|
POLYVOX_THROW(std::invalid_argument, "Volume depth must be greater than zero.");
|
|
}
|
|
|
|
//Create the data
|
|
m_pData = new VoxelType[this->getWidth() * this->getHeight()* this->getDepth()];
|
|
|
|
//Other properties we might find useful later
|
|
this->m_uLongestSideLength = (std::max)((std::max)(this->getWidth(),this->getHeight()),this->getDepth());
|
|
this->m_uShortestSideLength = (std::min)((std::min)(this->getWidth(),this->getHeight()),this->getDepth());
|
|
this->m_fDiagonalLength = sqrtf(static_cast<float>(this->getWidth() * this->getWidth() + this->getHeight() * this->getHeight() + this->getDepth() * this->getDepth()));
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// Note: This function needs reviewing for accuracy...
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
template <typename VoxelType>
|
|
uint32_t RawVolume<VoxelType>::calculateSizeInBytes(void)
|
|
{
|
|
return this->getWidth() * this->getHeight() * this->getDepth() * sizeof(VoxelType);
|
|
}
|
|
|
|
template <typename VoxelType>
|
|
template <WrapMode eWrapMode>
|
|
VoxelType RawVolume<VoxelType>::getVoxelImpl(int32_t uXPos, int32_t uYPos, int32_t uZPos, WrapModeType<eWrapMode>, VoxelType tBorder) const
|
|
{
|
|
// This function should never be called because one of the specialisations should always match.
|
|
POLYVOX_ASSERT(false, "This function is not implemented and should never be called!");
|
|
}
|
|
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxelImpl(int32_t uXPos, int32_t uYPos, int32_t uZPos, WrapModeType<WrapModes::Validate>, VoxelType tBorder) const
|
|
{
|
|
if(this->m_regValidRegion.containsPoint(Vector3DInt32(uXPos, uYPos, uZPos)) == false)
|
|
{
|
|
POLYVOX_THROW(std::out_of_range, "Position is outside valid region");
|
|
}
|
|
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::AssumeValid>(), tBorder); // No wrapping as we've just validated the position.
|
|
}
|
|
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxelImpl(int32_t uXPos, int32_t uYPos, int32_t uZPos, WrapModeType<WrapModes::Clamp>, VoxelType tBorder) const
|
|
{
|
|
//Perform clamping
|
|
uXPos = (std::max)(uXPos, this->m_regValidRegion.getLowerX());
|
|
uYPos = (std::max)(uYPos, this->m_regValidRegion.getLowerY());
|
|
uZPos = (std::max)(uZPos, this->m_regValidRegion.getLowerZ());
|
|
uXPos = (std::min)(uXPos, this->m_regValidRegion.getUpperX());
|
|
uYPos = (std::min)(uYPos, this->m_regValidRegion.getUpperY());
|
|
uZPos = (std::min)(uZPos, this->m_regValidRegion.getUpperZ());
|
|
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::AssumeValid>(), tBorder); // No wrapping as we've just validated the position.
|
|
}
|
|
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxelImpl(int32_t uXPos, int32_t uYPos, int32_t uZPos, WrapModeType<WrapModes::Border>, VoxelType tBorder) const
|
|
{
|
|
if(this->m_regValidRegion.containsPoint(uXPos, uYPos, uZPos))
|
|
{
|
|
return getVoxelImpl(uXPos, uYPos, uZPos, WrapModeType<WrapModes::AssumeValid>(), tBorder); // No wrapping as we've just validated the position.
|
|
}
|
|
else
|
|
{
|
|
return tBorder;
|
|
}
|
|
}
|
|
|
|
template <typename VoxelType>
|
|
VoxelType RawVolume<VoxelType>::getVoxelImpl(int32_t uXPos, int32_t uYPos, int32_t uZPos, WrapModeType<WrapModes::AssumeValid>, VoxelType /*tBorder*/) const
|
|
{
|
|
const Region& regValidRegion = this->m_regValidRegion;
|
|
int32_t iLocalXPos = uXPos - regValidRegion.getLowerX();
|
|
int32_t iLocalYPos = uYPos - regValidRegion.getLowerY();
|
|
int32_t iLocalZPos = uZPos - regValidRegion.getLowerZ();
|
|
|
|
return m_pData
|
|
[
|
|
iLocalXPos +
|
|
iLocalYPos * this->getWidth() +
|
|
iLocalZPos * this->getWidth() * this->getHeight()
|
|
];
|
|
}
|
|
}
|
|
|