Parallel Raytracer Assignment

Code To Investigate

RayTraceContext

public interface RayTraceContext {
	int width();

	int height();

	void mark(int xMin, int yMin, int xMaxExclusive, int yMaxExclusive);

	void markAndRender(int xMin, int yMin, int xMaxExclusive, int yMaxExclusive);
}

Scheduler

public interface Scheduler {
	void void_fork(Runnable runnable);
}

Section

public final class Section {
	private final int xMin;
	private final int yMin;
	private final int xMaxExclusive;
	private final int yMaxExclusive;

	public Section(int xMin, int yMin, int xMaxExclusive, int yMaxExclusive) {
		this.xMin = xMin;
		this.yMin = yMin;
		this.xMaxExclusive = xMaxExclusive;
		this.yMaxExclusive = yMaxExclusive;
	}

	public int xMin() {
		return xMin;
	}

	public int yMin() {
		return yMin;
	}

	public int xMaxExclusive() {
		return xMaxExclusive;
	}

	public int yMaxExclusive() {
		return yMaxExclusive;
	}
}

Code To Implement

SplitFourWayRayTracer

class:	SplitFourWayRayTracer.java
methods:	rayTrace
package:	raytrace.exercise
source folder:	student/src/main/java

rayTrace

method: public void rayTrace(RayTraceContext context, Scheduler scheduler) (parallel implementation required)

LoopRayTracer

class:	LoopRayTracer.java
methods:	constructor sectionsCreator rayTrace
package:	raytrace.exercise
source folder:	student/src/main/java

constructor

method: public LoopRayTracer(int sectionSize (sequential implementation only)

Hang onto the sectionSize in an instance variable. You will need it.

sectionSize

method: int sectionSize() (sequential implementation only)

Return the sectionSize you stored in an instance variable.

rayTrace

method: public void rayTrace(RayTraceContext context, Scheduler scheduler) (parallel implementation required)

Use the sectionSize to create a list of Sections.

To call createSections(), use the Sections class, i.e. Sections.createSections(rayTraceContext, size).

public class Sections {
	public static List<Section> createSections(int xMin, int yMin, int xMaxExclusive, int yMaxExclusive, int size) {
		List<Section> sections = new LinkedList<>();
		for (int y = yMin; y < yMaxExclusive; y += size) {
			for (int x = xMin; x < xMaxExclusive; x += size) {
				sections.add(new Section(x, y, Math.min(x + size, xMaxExclusive), Math.min(y + size, yMaxExclusive)));
			}
		}
		return sections;
	}

	public static List<Section> createSections(RayTraceContext rayTraceContext, int size) {
		return createSections(0, 0, rayTraceContext.width(), rayTraceContext.height(), size);
	}
}

Then create a rayTrace task for each section.

DivideAndConquerRayTracer

class:	DivideAndConquerRayTracer.java
methods:	constructor thresholdPredicate rayTraceKernel
package:	raytrace.exercise
source folder:	student/src/main/java

constructor

method: public DivideAndConquerRayTracer(BiPredicate<Integer, Integer> thresholdPredicate) (sequential implementation only)

Hang onto the thresholdPredicate in an instance variable. You will need it.

thresholdPredicate determines the threshold for division. If thresholdPredicate.test() is true, then the section is still large enough for more division of work.

thresholdPredicate

method: public BiPredicate<Integer, Integer> thresholdPredicate() (sequential implementation only)

Return the thresholdPredicate you stored in an instance variable.

rayTrace

method: public void rayTrace(RayTraceContext context, Scheduler scheduler) (parallel implementation required)

Checking Your Solution

Visualization

class:	RayTracerViz.java	VIZ
package:	raytrace.viz
source folder:	student/src/main/java

Correctness

class:	_ParallelRayTracerTestSuite.java
package:	raytrace.exercise
source folder:	testing/src/test/java