Class EnhancedBlockModelLighter

java.lang.Object

net.minecraft.client.renderer.block.BlockModelLighter

net.neoforged.neoforge.client.model.ao.EnhancedBlockModelLighter

public class EnhancedBlockModelLighter
extends BlockModelLighter

Entrypoint and main class of our enhanced AO pipeline.

Vanilla's AO logic works well for faces that are axis-aligned. That computation is replicated in FullFaceCalculator, with some bug fixes. The job of the enhanced pipeline is to handle faces that are more complicated, by combining multiple full faces as needed using interpolation.

Compared to vanilla, we also remove any assumption about vertex order in the quad.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final record	EnhancedBlockModelLighter.AoObjectCache	Cache these objects so that they don't need to be reallocated for every EnhancedBlockModelLighter.

Nested classes/interfaces inherited from class BlockModelLighter

BlockModelLighter.AdjacencyInfo, BlockModelLighter.Cache, BlockModelLighter.SizeInfo

Field Summary

Fields

Modifier and Type	Field	Description
private static final float	AO_EPS
private static final ThreadLocal<EnhancedBlockModelLighter.AoObjectCache>	AO_OBJECT_CACHE
private static final float	AVERAGE_WEIGHT
private final FullFaceCalculator	calculator	Calculator for full faces.
private static final boolean	COMPARE_WITH_VANILLA	Debug option to compare the emulated vanilla AO with the actual vanilla AO.
private static final org.slf4j.Logger	LOGGER
private static final float	MAX_WEIGHT
private final float[]	weights

Fields inherited from class BlockModelLighter

cache, CACHE, CHECK_LIGHT, faceCubic, faceShape, scratchPos

Constructor Summary

Constructors

Constructor	Description
EnhancedBlockModelLighter()

Method Summary

Modifier and Type	Method	Description
private void	calculateAxisAligned(BlockAndTintGetter level, BlockState state, BlockPos pos, Direction direction, BakedQuad quad, QuadInstance outputInstance)	Computes AO for an axis-aligned quad.
private void	calculateIrregular(BlockAndTintGetter level, BlockState state, BlockPos pos, BakedQuad quad, QuadInstance outputInstance)	Computes AO for a general quad.
private static float	interpolateBrightness(AoCalculatedFace in, float[] weights)	Interpolates brightness from the 4 corners of a face.
private static int	interpolateLightmap(AoCalculatedFace in, float[] weights)	Interpolates lightmap from the 4 corners of a face.
private static int	lerpLightmap(int lightmap1, float w1, int lightmap2, float w2)	Interpolates two lightmaps linearly.
(package private) static int	maxLightmap(int lightmap1, int lightmap2)
static BlockModelLighter	newInstance()
void	prepareQuadAmbientOcclusion(BlockAndTintGetter level, BlockState state, BlockPos pos, BakedQuad quad, QuadInstance outputInstance)
void	prepareQuadFlat(BlockAndTintGetter level, BlockState state, BlockPos pos, int lightCoords, BakedQuad quad, QuadInstance outputInstance)
void	reset()

Methods inherited from class BlockModelLighter

clearCache, enableCaching, getLightCoords, prepareQuadShape

Methods inherited from class Object

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

Field Details

COMPARE_WITH_VANILLA

private static final boolean COMPARE_WITH_VANILLA

Debug option to compare the emulated vanilla AO with the actual vanilla AO. Only does something if emulated AO is enabled.

LOGGER

private static final org.slf4j.Logger LOGGER

AO_OBJECT_CACHE

private static final ThreadLocal<EnhancedBlockModelLighter.AoObjectCache> AO_OBJECT_CACHE

calculator

private final FullFaceCalculator calculator

Calculator for full faces.

weights

private final float[] weights

AO_EPS

private static final float AO_EPS

See Also:

• Constant Field Values

AVERAGE_WEIGHT

private static final float AVERAGE_WEIGHT

See Also:

• Constant Field Values

MAX_WEIGHT

private static final float MAX_WEIGHT

See Also:

• Constant Field Values

Constructor Details

EnhancedBlockModelLighter

public EnhancedBlockModelLighter()

Method Details

newInstance

public static BlockModelLighter newInstance()

reset

public void reset()

Overrides:

reset in class BlockModelLighter

prepareQuadAmbientOcclusion

public void prepareQuadAmbientOcclusion(BlockAndTintGetter level,
 BlockState state,
 BlockPos pos,
 BakedQuad quad,
 QuadInstance outputInstance)

Overrides:

prepareQuadAmbientOcclusion in class BlockModelLighter

calculateAxisAligned

private void calculateAxisAligned(BlockAndTintGetter level,
 BlockState state,
 BlockPos pos,
 Direction direction,
 BakedQuad quad,
 QuadInstance outputInstance)

Computes AO for an axis-aligned quad.

This is similar to vanilla in how we select whether to use the inside or outside light. However, we still use our own interpolation logic which does not make any assumption about vertex winding order.

calculateIrregular

private void calculateIrregular(BlockAndTintGetter level,
 BlockState state,
 BlockPos pos,
 BakedQuad quad,
 QuadInstance outputInstance)

Computes AO for a general quad. Projects onto each axis, computes the AO, then combines proportionally to the square of each normal component.

prepareQuadFlat

public void prepareQuadFlat(BlockAndTintGetter level,
 BlockState state,
 BlockPos pos,
 int lightCoords,
 BakedQuad quad,
 QuadInstance outputInstance)

Overrides:

prepareQuadFlat in class BlockModelLighter

interpolateBrightness

private static float interpolateBrightness(AoCalculatedFace in,
 float[] weights)

Interpolates brightness from the 4 corners of a face.

interpolateLightmap

private static int interpolateLightmap(AoCalculatedFace in,
 float[] weights)

Interpolates lightmap from the 4 corners of a face.

lerpLightmap

private static int lerpLightmap(int lightmap1,
 float w1,
 int lightmap2,
 float w2)

Interpolates two lightmaps linearly.

maxLightmap

static int maxLightmap(int lightmap1,
 int lightmap2)