From 3caa86a46288bc3ffaaccca05127811e12f593cc Mon Sep 17 00:00:00 2001 From: David Williams Date: Sun, 31 Jan 2016 10:23:46 +0000 Subject: [PATCH] Minor update to 'Principles of PolyVox' --- documentation/principles.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/documentation/principles.rst b/documentation/principles.rst index b7c9c1b4..3277f26b 100644 --- a/documentation/principles.rst +++ b/documentation/principles.rst @@ -3,12 +3,10 @@ Principles of PolyVox ********************** .. warning :: - This section is being written and is just a skeleton for now + This section is yet to be fully written and is just a skeleton for now. -PolyVox provides a library for managing 3D arrays (volumes) of data (voxels). It gives you the tools to iterate through, randomly access, read and write volumes. It supports any type you'd like to represent each voxel whether it's just an ``int`` or a class which encapsulates both density and colour. +PolyVox provides a library for managing 3D arrays (volumes) of data (voxels). It gives you the tools to iterate through, randomly access, read and write volumes. The volumes are templatized on voxel type, so that each voxel can be as simple as just an number or as complex as a class with a range of properties. -Once you have a volume, PolyVox provides a number of tools for turning it into something that you can pass to your rendering engine. These are called `surface extractors`. +Once you have created a volume, PolyVox provides a number of tools for turning it into a mesh that you can pass to your rendering engine. These are called `surface extractors`. A 'Marching Cubes' surface extractor and a 'cubic' (Minecraft-style) surface extractor are included, and it is possible to write your own. -Each surface extractor needs to be told how to interperet your voxel type and that is done using... - -Link to a page describing how to write your own voxel type and link it to a surface extractor... +PolyVox primarily handles this task of storing volume data and extracting surfaces from it. Most other aspects of you voxel application or game will need to be implemented by you (rendering, logic, physics, AI, networking, etc) though PolyVox does have a few utility classes for things like the A* algorithm on a 3D grid. \ No newline at end of file