Class FLine

src/main/java/field/graphics/FLine.java:53–2734

FLine is our main high level geometry container for lines, meshes and lists of points. FLines consist of a list of drawing instructions, or nodes: `line.moveTo(...).lineTo(...).cubicTo(...)` .etc This is essentially the common postscript / pdf / java2d drawing model with a few key difference

 * <p>
 * The caching of the flattening of this line into MeshBuilder data (ready for OpenGL) cascades into MeshBuilder's cache structure. Thus, we have three levels of caching in total: FLine caches
 * whether or not the geometry has
 * changed at all, MeshBuilder caches whether or not there's any point sending anything to the OpenGL
 * underlying Buffers or whether this piece of geometry can be skipped, and finally individual ArrayBuffers can elect to skip the upload to OpenGL. This means that static geometry is extremely cheap
 * to draw.
 */
public class FLine implements Supplier<FLine>, fieldlinker.AsMap, HandlesCompletion, Serializable_safe, OverloadedMath {

	static {
		new StandardFLineDrawing(); // cause properties to be loaded
	}

	public List<Node> nodes = new ArrayList<>();
	public Dict attributes = new Dict();
	transient protected Set<String> knownNonProperties;
	long mod = 0;
	WeakHashMap<MeshBuilder, BookmarkCache> cache = new WeakHashMap<>();
	WeakHashMap<MeshBuilder, BookmarkCache> cache_thickening = new WeakHashMap<>();
	private Map<Integer, Function<Node, Object>> auxProperties;

	public FLine() {
	}

	public FLine(Map<Object, Object> attributes) {
		for (Map.Entry e : attributes.entrySet()) {
			String name = (String) Conversions.convert(e.getKey(), String.class);
			asMap_set(name, e.getValue());
		}
	}

	@HiddenInAutocomplete
	static public Vec2 evaluateCubicFrame(double ax, double ay, double c1x, double c1y, double c2x, double c2y, double bx, double by, double alpha, Vec2 out) {
		if (out == null) out = new Vec2();

		double oma = 1 - alpha;
		double oma2 = oma * oma;
		double oma3 = oma2 * oma;
		double alpha2 = alpha * alpha;
		double alpha3 = alpha2 * alpha;

		out.x = ax * oma3 + 3 * c1x * alpha * oma2 + 3 * c2x * alpha2 * oma + bx * alpha3;
		out.y = ay * oma3 + 3 * c1y * alpha * oma2 + 3 * c2y * alpha2 * oma + by * alpha3;

		return out;
	}

	@HiddenInAutocomplete
	static public Vec3 evaluateCubicFrame(double ax, double ay, double az, double c1x, double c1y, double c1z, double c2x, double c2y, double c2z, double bx, double by, double bz, double alpha,
					      Vec3 out) {
		if (out == null) out = new Vec3();

		double oma = 1 - alpha;
		double oma2 = oma * oma;
		double oma3 = oma2 * oma;
		double alpha2 = alpha * alpha;
		double alpha3 = alpha2 * alpha;

		out.x = ax * oma3 + 3 * c1x * alpha * oma2 + 3 * c2x * alpha2 * oma + bx * alpha3;
		out.y = ay * oma3 + 3 * c1y * alpha * oma2 + 3 * c2y * alpha2 * oma + by * alpha3;