Method constructor

packages/melonjs/src/renderable/sprite3d.js:113–305

* @param {number} x - world x position * @param {number} y - world y position * @param {object} settings - configuration * @param {HTMLImageElement|TextureAtlas|string} [settings.image] - the sprite texture (image name, image, or atlas). Alias: `settings.texture`. * @param {number} [settings

(x, y, settings)

	 * @param {number} [settings.alphaCutoff=0.5] - alpha cutout threshold (see {@link Mesh}). The mesh pass is opaque (no alpha blending), so this defaults to `0.5` to discard a sprite's transparent background (clean cutout silhouette, correct depth, no sorting). Set `0` for a fully-opaque quad, or tune the threshold.
	 */
	constructor(x, y, settings) {
		// world-space quad size (in pixels): explicit width/height first, then the
		// spritesheet frame size, then the full texture size. The texture atlas
		// itself is resolved by the Mesh base class (passing framewidth/frameheight
		// through, below) — so Sprite3d never touches the renderer directly.
		let w;
		let h;
		if (typeof settings.width === "number") {
			w = settings.width;
			h = typeof settings.height === "number" ? settings.height : w;
		} else if (typeof settings.framewidth === "number") {
			w = settings.framewidth;
			h = typeof settings.frameheight === "number" ? settings.frameheight : w;
		} else {
			const size = imageSize(settings);
			w = size.w;
			h = size.h;
		}
		const hw = w / 2;
		const hh = h / 2;
		// a unit quad with the real pixel size baked in, in the XY plane, facing
		// +Z. `normalize: false` + `scale: 1` keeps these coordinates as-is so the
		// fixed-orientation (non-billboard) case renders at the right size, and
		// the billboard path reuses the local (±hw, ±hh) offsets directly.
		const vertices = new Float32Array([
			-hw,
			-hh,
			0,
			hw,
			-hh,
			0,
			hw,
			hh,
			0,
			-hw,
			hh,
			0,
		]);
		// V flipped (1→0 top to bottom) so the texture renders upright under the
		// Y-down render space, matching Sprite. Overwritten per-frame by
		// `_applyFrame` once an animation/region is selected.
		const uvs = new Float32Array([0, 1, 1, 1, 1, 0, 0, 0]);
		const indices = new Uint16Array([0, 1, 2, 0, 2, 3]);
		const normals = new Float32Array([0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1]);

		super(x, y, {
			vertices,
			uvs,
			indices,
			normals,
			// let Mesh resolve the texture; forward the spritesheet grid so the
			// resolved atlas carries animation frames
			texture: settings.image ?? settings.texture,
			framewidth: settings.framewidth,
			frameheight: settings.frameheight,
			// width/height drive the frustum-cull bounds; use the larger side so
			// the cull sphere always encloses the quad whatever way it faces
			width: Math.max(w, h),