Skip to content

Commit

Permalink
DebugRenderer: add 12 public methods
Browse files Browse the repository at this point in the history
  • Loading branch information
@stephengold
stephengold committed Sep 22, 2024
1 parent 5758f95 commit 7ca4899
Show file tree
Hide file tree
Showing 2 changed files with 406 additions and 1 deletion.
227 changes: 227 additions & 0 deletions src/main/java/com/github/stephengold/joltjni/DebugRenderer.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,13 @@ of this software and associated documentation files (the "Software"), to deal
*/
package com.github.stephengold.joltjni;

import com.github.stephengold.joltjni.readonly.ConstAaBox;
import com.github.stephengold.joltjni.readonly.ConstColor;
import com.github.stephengold.joltjni.readonly.ConstOrientedBox;
import com.github.stephengold.joltjni.readonly.RMat44Arg;
import com.github.stephengold.joltjni.readonly.RVec3Arg;
import com.github.stephengold.joltjni.readonly.Vec3Arg;

/**
* Visualization for debugging purposes.
*
Expand Down Expand Up @@ -51,6 +58,193 @@ abstract public class DebugRenderer extends NonCopyable {
instance = this;
}
// *************************************************************************
// new methods exposed

/**
* Draw the specified 3-D arrow.
*
* @param from the desired starting point (not null, unaffected)
* @param to the desired ending point (not null, unaffected)
* @param color the desired color (not null, unaffected)
* @param size the desired size
*/
public void drawArrow(
RVec3Arg from, RVec3Arg to, ConstColor color, float size) {
double fromX = from.xx();
double fromY = from.yy();
double fromZ = from.zz();
double toX = to.xx();
double toY = to.yy();
double toZ = to.zz();
int colorInt = color.getUInt32();
drawArrow(fromX, fromY, fromZ, toX, toY, toZ, colorInt, size);
}

/**
* Draw the specified 3-D coordinate axes.
*
* @param transform the desired coordinate transform (not null, unaffected)
* @param size the desired size
*/
public void drawCoordinateSystem(RMat44Arg transform, float size) {
long transformVa = transform.va();
drawCoordinateSystem(transformVa, size);
}

/**
* Draw the specified 3-D line.
*
* @param from the desired first endpoint (not null, unaffected)
* @param to the desired 2nd endpoint (not null, unaffected)
* @param color the desired color (not null, unaffected)
*/
public void drawLine(RVec3Arg from, RVec3Arg to, ConstColor color) {
double fromX = from.xx();
double fromY = from.yy();
double fromZ = from.zz();
double toX = to.xx();
double toY = to.yy();
double toZ = to.zz();
int colorInt = color.getUInt32();
drawLine(fromX, fromY, fromZ, toX, toY, toZ, colorInt);
}

/**
* Draw a marker at the specified location.
*
* @param location the desired location (not null, unaffected)
* @param color the desired color (not null, unaffected)
* @param size the desired size
*/
public void drawMarker(RVec3Arg location, ConstColor color, float size) {
double locX = location.xx();
double locY = location.yy();
double locZ = location.zz();
int colorInt = color.getUInt32();
drawMarker(locX, locY, locZ, colorInt, size);
}

/**
* Draw the specified plane.
*
* @param location the location of a point through which the plane passes
* (not null, unaffected)
* @param normal a direction normal to the plane's surface (not null,
* unaffected)
* @param color the desired color (not null, unaffected)
* @param size the desired size
*/
public void drawPlane(
RVec3Arg location, Vec3Arg normal, ConstColor color, float size) {
double locX = location.xx();
double locY = location.yy();
double locZ = location.zz();
float normX = normal.getX();
float normY = normal.getY();
float normZ = normal.getZ();
int colorInt = color.getUInt32();
drawPlane(locX, locY, locZ, normX, normY, normZ, colorInt, size);
}

/**
* Draw a wire-frame of the specified axis-aligned box.
*
* @param box the desired geometric properties (not null, unaffected)
* @param color the desired color (not null, unaffected)
*/
public void drawWireBox(ConstAaBox box, ConstColor color) {
long boxVa = box.va();
int colorInt = color.getUInt32();
drawWireBoxAligned(boxVa, colorInt);
}

/**
* Draw a wire-frame of the specified 3-D box.
*
* @param box the desired geometric properties (not null, unaffected)
* @param color the desired color (not null, unaffected)
*/
public void drawWireBox(ConstOrientedBox box, ConstColor color) {
long boxVa = box.va();
int colorInt = color.getUInt32();
drawWireBoxOriented(boxVa, colorInt);
}

/**
* Draw a wire frame of the specified 3-D box.
*
* @param transform the desired coordinate transform (not null, unaffected)
* @param box the desired geometric properties (not null, unaffected)
* @param color the desired color (not null, unaffected)
*/
public void drawWireBox(
RMat44Arg transform, ConstAaBox box, ConstColor color) {
long transformVa = transform.va();
long boxVa = box.va();
int colorInt = color.getUInt32();
drawWireBoxTransformed(transformVa, boxVa, colorInt);
}

/**
* Draw a wire frame of the specified sphere.
*
* @param location the location of the sphere's center (not null,
* unaffected)
* @param radius the desired radius
* @param color the desired color (not null, unaffected)
* @param level the desired level of detail
*/
public void drawWireSphere(
RVec3Arg location, float radius, ConstColor color, int level) {
double locX = location.xx();
double locY = location.yy();
double locZ = location.zz();
int colorInt = color.getUInt32();
drawWireSphere(locX, locY, locZ, radius, colorInt, level);
}

/**
* Draw a wire frame of the specified 3-D triangle.
*
* @param v1 the location of the first vertex (not null, unaffected)
* @param v2 the location of the 2nd vertex (not null, unaffected)
* @param v3 the location of the 3rd vertex (not null, unaffected)
* @param color the desired color (not null, unaffected)
*/
public void drawWireTriangle(
RVec3Arg v1, RVec3Arg v2, RVec3Arg v3, ConstColor color) {
double v1x = v1.xx();
double v1y = v1.yy();
double v1z = v1.zz();
double v2x = v2.xx();
double v2y = v2.yy();
double v2z = v2.zz();
double v3x = v3.xx();
double v3y = v3.yy();
double v3z = v3.zz();
int colorInt = color.getUInt32();
drawWireTriangle(v1x, v1y, v1z, v2x, v2y, v2z, v3x, v3y, v3z, colorInt);
}

/**
* Draw a wire frame of the specified unit sphere.
*
* @param transform the desired coordinate transform (not null, unaffected)
* @param color the desired color (not null, unaffected)
* @param level the desired level of detail
*/
public void drawWireUnitSphere(
RMat44Arg transform, ConstColor color, int level) {
long transformVa = transform.va();
int colorInt = color.getUInt32();
drawWireUnitSphere(transformVa, colorInt, level);
}

/**
* Notify that the current frame is complete.
*/
native public void nextFrame();
// *************************************************************************
// NonCopyable methods

/**
Expand All @@ -69,5 +263,38 @@ void setVirtualAddress(long rendererVa, boolean owner) {
// *************************************************************************
// native private methods

native private static void drawArrow(
double fromX, double fromY, double fromZ, double toX, double toY,
double toZ, int colorInt, float size);

native private static void drawCoordinateSystem(
long transformVa, float size);

native private static void drawLine(double fromX, double fromY,
double fromZ, double toX, double toY, double toZ, int colorInt);

native private static void drawMarker(
double locX, double locY, double locZ, int colorInt, float size);

native private static void drawPlane(double locX, double locY, double locZ,
float normX, float normY, float normZ, int colorInt, float size);

native private static void drawWireBoxAligned(long boxVa, int colorInt);

native private static void drawWireBoxOriented(long boxVa, int colorInt);

native private static void drawWireBoxTransformed(
long transformVa, long boxVa, int colorInt);

native private static void drawWireSphere(double locX, double locY,
double locZ, float radius, int colorInt, int level);

native private static void drawWireTriangle(double v1x, double v1y,
double v1z, double v2x, double v2y, double v2z, double v3x,
double v3y, double v3z, int colorInt);

native private static void drawWireUnitSphere(
long transformVa, int colorInt, int level);

native private static void free(long rendererVa);
}
Loading

0 comments on commit 7ca4899

Please sign in to comment.