Documentation tweaks.

This commit is contained in:
David Williams 2016-01-03 18:04:07 +00:00
parent c0b72b6a55
commit 75a2831ae7
3 changed files with 14 additions and 4 deletions

View File

@ -25,6 +25,16 @@
namespace PolyVox
{
/**
* This function fills a 3D array with ambient occlusion values computed by raycasting through the volume.
* This approach to ambient occlusion is only appropriate for relatvely small volumes, otherwise it will
* become very slow and consume a lot of memory. You will need to find a way to actually use the generated
* ambient occlusion data, which might mean uploading it the the GPU as a volume texture or sampling on
* the CPU using the vertex positions from your generated mesh.
*
* In practice we have not made much use of this implementation ourselves, so you may find it needs some
* optimizations or improvements to be useful. It is likely that there are actually better approaches to
* the ambient occlusion problem.
*
* \param volInput The volume to calculate the ambient occlusion for
* \param[out] arrayResult The output of the calculator
* \param region The region of the volume for which the occlusion should be calculated

View File

@ -32,8 +32,8 @@
namespace PolyVox
{
/// The BaseVolume class provides common functionality and an interface for other volume classes to implement. You should not try to create an instance of this
/// class directly. Instead you should use RawVolume or PagedVolume.
/// The BaseVolume class provides common functionality and an interface for other volume classes to implement.
/// You should not try to create an instance of this class directly. Instead you should use RawVolume or PagedVolume.
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
/// More details to come...
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

View File

@ -119,12 +119,12 @@ namespace PolyVox
}
////////////////////////////////////////////////////////////////////////////////
/// Note: This function needs reviewing for accuracy...
///
////////////////////////////////////////////////////////////////////////////////
template <typename VoxelType>
uint32_t BaseVolume<VoxelType>::calculateSizeInBytes(void)
{
return this->getWidth() * this->getHeight() * this->getDepth() * sizeof(VoxelType);
POLYVOX_THROW(not_implemented, "You should never call the base class version of this function.");
}
}