LOD comparison

DistanceLodPolicy turns caller-owned camera distance into a standard detail level and a set of suggested generation/render budgets. The scene displays the same flowering herb in all four distance bands.

Left to right: full at 25 studs, medium at 90, low at 200, and impostor at 500. The topology is held constant while streamed branch and organ count falls.

import {
	DistanceLodPolicy,
	PartPlantRenderer,
	PLANT_PRESETS,
	PlantCompiler,
	PlantGenerator,
	type StreamingPlantRenderHandle,
} from "@rbxts/a-plant-generator";

export const sampleDistances = [25, 90, 200, 500] as const;
export const lodPlant = PlantGenerator.generate(PlantCompiler.compile(PLANT_PRESETS["branching-herb"]!), {
	seed: 8080,
	iterations: 6,
	limits: { maxSymbols: 20_000, maxSegments: 2_000 },
});

const policy = new DistanceLodPolicy(70, 150, 320);
export const lodSamples = sampleDistances.map((distance) => ({
	distance,
	settings: policy.select(distance, lodPlant),
}));

export function renderLodComparison(parent: Instance): () => void {
	const renderers = new Array<PartPlantRenderer>();
	const handles = new Array<StreamingPlantRenderHandle>();

	for (let index = 0; index < lodSamples.size(); index++) {
		const sample = lodSamples[index];
		if (sample === undefined) continue;
		const renderer = new PartPlantRenderer({
			parent,
			name: `LOD_${sample.settings.level}`,
			maxInstances: sample.settings.maxInstances,
		});
		const handle = renderer.beginRender(lodPlant);
		handle.setLod(sample.settings.level);
		while (!handle.isComplete()) handle.step(128);
		handle.updateTransform(new CFrame((index - 1.5) * 18, 0, 0));
		renderers.push(renderer);
		handles.push(handle);
	}

	return () => {
		for (const handle of handles) handle.destroy();
		for (const renderer of renderers) renderer.destroy();
	};
}
Copy

The example calls setLod on a streaming handle before its first step, so excluded branches never acquire Parts. Calling setLod only after render would provide the same visual hiding but would not reduce renderedInstances.

Try moving the three policy thresholds while keeping the sample distances fixed to verify the band transitions.