rayzee 4.8.9 → 4.8.11

package/src/api/OutputAPI.js

@@ -0,0 +1,90 @@
+/**
+ * Output sub-API — canvas, screenshots, resize, and scene statistics.
+ *
+ * Access via `engine.output`.
+ *
+ * @example
+ * engine.output.setSize(1920, 1080);
+ * engine.output.screenshot();
+ * const stats = engine.output.getStatistics();
+ */
+export class OutputAPI {
+
+	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
+	constructor( app ) {
+
+		this._app = app;
+
+	}
+
+	/**
+	 * Returns the canvas element with the final rendered image.
+	 * Ensures the WebGPU canvas has fresh content if needed.
+	 * @returns {HTMLCanvasElement|null}
+	 */
+	getCanvas() {
+
+		return this._app.getOutputCanvas();
+
+	}
+
+	/**
+	 * Downloads a PNG screenshot of the current render.
+	 */
+	screenshot() {
+
+		this._app.takeScreenshot();
+
+	}
+
+	/**
+	 * Returns scene statistics (triangle count, mesh count, etc.).
+	 * @returns {Object|null}
+	 */
+	getStatistics() {
+
+		return this._app.getSceneStatistics();
+
+	}
+
+	/**
+	 * Sets explicit canvas dimensions and triggers resize.
+	 * @param {number} width
+	 * @param {number} height
+	 */
+	setSize( width, height ) {
+
+		this._app.setCanvasSize( width, height );
+
+	}
+
+	/**
+	 * Triggers a manual resize recalculation from current canvas dimensions.
+	 */
+	resize() {
+
+		this._app.onResize();
+
+	}
+
+	/**
+	 * Whether the path tracer has finished converging.
+	 * @returns {boolean}
+	 */
+	isComplete() {
+
+		return this._app.isComplete();
+
+	}
+
+	/**
+	 * Returns the current accumulated frame/sample count.
+	 * @returns {number}
+	 */
+	getFrameCount() {
+
+		return this._app.getFrameCount();
+
+	}
+
+}

package/src/api/SelectionAPI.js

@@ -0,0 +1,89 @@
+/**
+ * Selection sub-API — object picking and interaction modes.
+ *
+ * Access via `engine.selection`.
+ *
+ * @example
+ * engine.selection.select(meshObject);
+ * engine.selection.toggleMode();
+ */
+export class SelectionAPI {
+
+	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
+	constructor( app ) {
+
+		this._app = app;
+
+	}
+
+	/**
+	 * Programmatically selects an object (or deselects if null).
+	 * @param {import('three').Object3D|null} object
+	 */
+	select( object ) {
+
+		this._app.selectObject( object );
+
+	}
+
+	/**
+	 * Deselects the current object.
+	 */
+	deselect() {
+
+		this._app.selectObject( null );
+
+	}
+
+	/**
+	 * Toggles object selection mode on/off.
+	 * @returns {boolean} Whether selection mode is now active
+	 */
+	toggleMode() {
+
+		return this._app.toggleSelectMode();
+
+	}
+
+	/**
+	 * Disables selection mode and detaches transform gizmo.
+	 */
+	disableMode() {
+
+		this._app.disableSelectMode();
+
+	}
+
+	/**
+	 * Toggles click-to-focus DOF mode.
+	 * @returns {boolean} Whether focus mode is now active
+	 */
+	toggleFocusMode() {
+
+		return this._app.toggleFocusMode();
+
+	}
+
+	/**
+	 * Dispatches an event through the interaction manager.
+	 * @param {Object} event
+	 */
+	dispatchEvent( event ) {
+
+		this._app.dispatchInteractionEvent( event );
+
+	}
+
+	/**
+	 * Subscribes to an interaction manager event.
+	 * @param {string} type
+	 * @param {Function} handler
+	 * @returns {Function} Unsubscribe function
+	 */
+	on( type, handler ) {
+
+		return this._app.onInteractionEvent( type, handler );
+
+	}
+
+}

package/src/api/TransformAPI.js

@@ -0,0 +1,49 @@
+/**
+ * Transform sub-API — gizmo mode and space controls.
+ *
+ * Access via `engine.transform`.
+ *
+ * @example
+ * engine.transform.setMode('rotate');
+ * engine.transform.setSpace('local');
+ */
+export class TransformAPI {
+
+	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
+	constructor( app ) {
+
+		this._app = app;
+
+	}
+
+	/**
+	 * Sets the transform gizmo mode.
+	 * @param {'translate'|'rotate'|'scale'} mode
+	 */
+	setMode( mode ) {
+
+		this._app.setTransformMode( mode );
+
+	}
+
+	/**
+	 * Sets the transform gizmo coordinate space.
+	 * @param {'world'|'local'} space
+	 */
+	setSpace( space ) {
+
+		this._app.setTransformSpace( space );
+
+	}
+
+	/**
+	 * Direct access to the underlying TransformManager (advanced).
+	 * @returns {import('../managers/TransformManager.js').TransformManager}
+	 */
+	get manager() {
+
+		return this._app.transformManager;
+
+	}
+
+}

package/src/api/index.js

@@ -0,0 +1,16 @@
+/**
+ * Rayzee Sub-API Facades
+ *
+ * Namespaced API modules accessed via engine.camera, engine.lights, etc.
+ * Each facade wraps an internal manager with a clean, consistent public interface.
+ */
+
+export { OutputAPI } from './OutputAPI.js';
+export { LightsAPI } from './LightsAPI.js';
+export { AnimationAPI } from './AnimationAPI.js';
+export { SelectionAPI } from './SelectionAPI.js';
+export { TransformAPI } from './TransformAPI.js';
+export { CameraAPI } from './CameraAPI.js';
+export { EnvironmentAPI } from './EnvironmentAPI.js';
+export { MaterialsAPI } from './MaterialsAPI.js';
+export { DenoisingAPI } from './DenoisingAPI.js';

package/src/index.js

@@ -52,3 +52,16 @@ export { TransformManager } from './managers/TransformManager.js';
 
 // Video rendering
 export { VideoRenderManager } from './managers/VideoRenderManager.js';
+
+// Sub-API facades (namespaced access via engine.camera, engine.lights, etc.)
+export {
+	OutputAPI,
+	LightsAPI,
+	AnimationAPI,
+	SelectionAPI,
+	TransformAPI,
+	CameraAPI,
+	EnvironmentAPI,
+	MaterialsAPI,
+	DenoisingAPI,
+} from './api/index.js';