bvv.core.render

Class VolumeBlocks

java.lang.Object

bvv.core.render.VolumeBlocks

public class VolumeBlocks
extends Object

For setting up the volume for one frame, call methods in this order:

1. init(MultiResolutionStack3D, TextureCache, int, Matrix4fc)
2. getFillTasks()
3. makeLut(int)

getLutBlockScales(int) can be called at any point after init().

For the next frame start over with init().

Constructor Summary

Constructors

Constructor and Description
VolumeBlocks()

Method Summary

Modifier and Type	Method and Description
int	getBaseLevel() Get the base resolution level for rendering the volume.
double	getBaseLevelVoxelSizeInWorldCoordinates() Get the size of a voxel at base resolution in world coordinates.
List<FillTask>	getFillTasks() Sets up RequiredBlocks (internally) and creates a list of FillTasks for the cache to process.
org.joml.Matrix4f	getIms()
LookupTextureARGB	getLookupTexture()
float[][]	getLutBlockScales(int NUM_BLOCK_SCALES) Set up lutBlockScales array for shader.
org.joml.Vector3f	getSourceLevelMax()
org.joml.Vector3f	getSourceLevelMin()
TextureCache	getTextureCache()
void	init(MultiResolutionStack3D<?> multiResolutionStack, TextureCache textureCache, int viewportWidth, org.joml.Matrix4fc pv)
boolean	makeLut(int timestamp)
void	setBaseLevel(int baseLevel) Set the base resolution level for rendering the volume.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VolumeBlocks

public VolumeBlocks()

Method Detail

init

public void init(MultiResolutionStack3D<?> multiResolutionStack,
                 TextureCache textureCache,
                 int viewportWidth,
                 org.joml.Matrix4fc pv)

Parameters:

multiResolutionStack - single-channel, multi-resolution source

viewportWidth - width of the surface to be rendered

pv - projection * view matrix, transforms world coordinates to NDC coordinates

getBaseLevel

public int getBaseLevel()

Get the base resolution level for rendering the volume. Every block in the volumes LUT is at this level or higher (coarser).

This is chosen automatically, when calling init(MultiResolutionStack3D, TextureCache, int, Matrix4fc). It can be manually adjusted using setBaseLevel(int).

setBaseLevel

public void setBaseLevel(int baseLevel)

Set the base resolution level for rendering the volume. Every block in the volumes LUT is at this level or higher (coarser).

getBaseLevelVoxelSizeInWorldCoordinates

public double getBaseLevelVoxelSizeInWorldCoordinates()

Get the size of a voxel at base resolution in world coordinates. Take a source voxel (0,0,0)-(1,1,1) at the base mipmap level and transform it to world coordinates. Take the minimum of the transformed voxels edge lengths.

getFillTasks

public List<FillTask> getFillTasks()

Sets up RequiredBlocks (internally) and creates a list of FillTasks for the cache to process.

Returns:

list of FillTasks

makeLut

public boolean makeLut(int timestamp)

Returns:

whether every required block was completely available at the desired resolution level. I.e., if false is returned, the frame should be repainted until the remaining incomplete blocks are loaded.

getLutBlockScales

public float[][] getLutBlockScales(int NUM_BLOCK_SCALES)

Set up lutBlockScales array for shader.

• lutBlockScales[0] = (0,0,0) is used for oob blocks.
• lutBlockScales[i+1] is the relative scale between baseLevel and level baseLevel+i
• lutBlockScales[i+1] = (0,0,0) for i > maxLevel is used to fill up the array to NUM_BLOCK_SCALES

Parameters:

NUM_BLOCK_SCALES -

Returns:

getIms

public org.joml.Matrix4f getIms()

getSourceLevelMin

public org.joml.Vector3f getSourceLevelMin()

getSourceLevelMax

public org.joml.Vector3f getSourceLevelMax()

getLookupTexture

public LookupTextureARGB getLookupTexture()

getTextureCache

public TextureCache getTextureCache()