nova.core.util

Class RayTracer

java.lang.Object

nova.core.util.RayTracer

public class RayTracer
extends java.lang.Object

Ray tracing for cuboids.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RayTracer.RayTraceBlockResult
static class	RayTracer.RayTraceEntityResult
static class	RayTracer.RayTraceResult

Field Summary

Fields

Modifier and Type	Field and Description
double	distance
int	parallelThreshold
Ray	ray

Constructor Summary

Constructors

Constructor and Description
RayTracer(Entity entity) Does an entity look ray trace to see which block the entity is looking at.
RayTracer(Ray ray)

Method Summary

Modifier and Type	Method and Description
boolean	doParallel()
java.util.Optional<RayTracer.RayTraceResult>	rayTrace(Cuboid cuboid)
<R extends RayTracer.RayTraceResult> java.util.Optional<R>	rayTrace(Cuboid cuboid, java.util.function.BiFunction<org.apache.commons.math3.geometry.euclidean.threed.Vector3D,Cuboid,R> resultMapper) Ray traces a cuboid
java.util.Optional<org.apache.commons.math3.geometry.euclidean.threed.Vector3D>	rayTrace(Cuboid cuboid, double minDist, double maxDist) Calculates intersection with the given ray between a certain distance interval.
java.util.List<RayTracer.RayTraceResult>	rayTrace(java.util.stream.Stream<Cuboid> stream) Ray traces a set of cuboids
java.util.stream.Stream<RayTracer.RayTraceResult>	rayTraceAll(World world)
java.util.stream.Stream<RayTracer.RayTraceBlockResult>	rayTraceBlocks(java.util.Set<Block> blocks) Ray traces a set of blocks
java.util.stream.Stream<RayTracer.RayTraceBlockResult>	rayTraceBlocks(java.util.stream.Stream<Block> blockStream)
java.util.stream.Stream<RayTracer.RayTraceBlockResult>	rayTraceBlocks(World world) Check all blocks that are in a line
<R extends RayTracer.RayTraceResult> java.util.stream.Stream<R>	rayTraceCollider(ComponentProvider<? extends ComponentMap> colliderProvider, java.util.function.BiFunction<org.apache.commons.math3.geometry.euclidean.threed.Vector3D,Cuboid,R> resultMapper)
java.util.stream.Stream<RayTracer.RayTraceEntityResult>	rayTraceEntities(java.util.stream.Stream<Entity> entityStream)
java.util.stream.Stream<RayTracer.RayTraceEntityResult>	rayTraceEntities(World world)
RayTracer	setDistance(double distance) Sets the distance of the ray
RayTracer	setParallelThreshold(int parallelThreshold)

Methods inherited from class java.lang.Object

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

Field Detail

ray

public final Ray ray

distance

public double distance

parallelThreshold

public int parallelThreshold

Constructor Detail

RayTracer

public RayTracer(Ray ray)

RayTracer

public RayTracer(Entity entity)

Does an entity look ray trace to see which block the entity is looking at.

Parameters:

entity - The entity

Method Detail

setDistance

public RayTracer setDistance(double distance)

Sets the distance of the ray

Parameters:

distance - Distance in meters

Returns:

This

setParallelThreshold

public RayTracer setParallelThreshold(int parallelThreshold)

doParallel

public boolean doParallel()

rayTraceAll

public java.util.stream.Stream<RayTracer.RayTraceResult> rayTraceAll(World world)

rayTraceBlocks

public java.util.stream.Stream<RayTracer.RayTraceBlockResult> rayTraceBlocks(World world)

Check all blocks that are in a line

Parameters:

world - The world to perform the ray trace in.

Returns:

The blocks ray traced in the order from closest to furthest.

rayTraceBlocks

public java.util.stream.Stream<RayTracer.RayTraceBlockResult> rayTraceBlocks(java.util.Set<Block> blocks)

Ray traces a set of blocks

Parameters:

blocks - Set of blocks

Returns:

A list of cuboids that intersect with the line segment in the order from closest to furthest.

rayTraceBlocks

public java.util.stream.Stream<RayTracer.RayTraceBlockResult> rayTraceBlocks(java.util.stream.Stream<Block> blockStream)

rayTraceEntities

public java.util.stream.Stream<RayTracer.RayTraceEntityResult> rayTraceEntities(World world)

rayTraceEntities

public java.util.stream.Stream<RayTracer.RayTraceEntityResult> rayTraceEntities(java.util.stream.Stream<Entity> entityStream)

rayTraceCollider

public <R extends RayTracer.RayTraceResult> java.util.stream.Stream<R> rayTraceCollider(ComponentProvider<? extends ComponentMap> colliderProvider,
                                                                                        java.util.function.BiFunction<org.apache.commons.math3.geometry.euclidean.threed.Vector3D,Cuboid,R> resultMapper)

rayTrace

public java.util.List<RayTracer.RayTraceResult> rayTrace(java.util.stream.Stream<Cuboid> stream)

Ray traces a set of cuboids

Parameters:

stream - A stream of cuboids

Returns:

A list of cuboids that intersect with the line segment in the order from closest to furthest.

rayTrace

public java.util.Optional<RayTracer.RayTraceResult> rayTrace(Cuboid cuboid)

rayTrace

public <R extends RayTracer.RayTraceResult> java.util.Optional<R> rayTrace(Cuboid cuboid,
                                                                           java.util.function.BiFunction<org.apache.commons.math3.geometry.euclidean.threed.Vector3D,Cuboid,R> resultMapper)

Ray traces a cuboid

Type Parameters:

R - the result type

Parameters:

cuboid - The cuboid in absolute world coordinates

resultMapper - the RayTracer.RayTraceResult converter

Returns:

The ray trace result if the ray intersects the cuboid

rayTrace

public java.util.Optional<org.apache.commons.math3.geometry.euclidean.threed.Vector3D> rayTrace(Cuboid cuboid,
                                                                                                double minDist,
                                                                                                double maxDist)

Calculates intersection with the given ray between a certain distance interval.

Ray-box intersection is using IEEE numerical properties to ensure the test is both robust and efficient, as described in:
Amy Williams, Steve Barrus, R. Keith Morley, and Peter Shirley: "An Efficient and Robust Ray-Box Intersection Algorithm" Journal of graphics tools, 10(1):49-54, 2005

Parameters:

cuboid - The cuboid to trace

minDist - The minimum distance

maxDist - The maximum distance

Returns:

intersection point on the bounding box (only the first is returned) or null if no intersection