rayzee 4.8.15 → 5.0.0

package/src/api/DenoisingAPI.js

@@ -1,243 +0,0 @@
-/**
- * Denoising sub-API — denoiser strategy, ASVGF, OIDN, upscaler,
- * adaptive sampling, and auto-exposure controls.
- *
- * Access via `engine.denoising`.
- *
- * @example
- * engine.denoising.setStrategy('asvgf', 'medium');
- * engine.denoising.setAutoExposure(true);
- * engine.denoising.setASVGFParams({ temporalAlpha: 0.1 });
- */
-export class DenoisingAPI {
-
-	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
-	constructor( app ) {
-
-		this._app = app;
-
-	}
-
-	// ── Strategy ──
-
-	/**
-	 * Switches the real-time denoiser strategy.
-	 * @param {'none'|'asvgf'|'ssrc'|'edgeaware'} strategy
-	 * @param {string} [asvgfPreset] - ASVGF quality preset if strategy is 'asvgf'
-	 */
-	setStrategy( strategy, asvgfPreset ) {
-
-		this._app.setDenoiserStrategy( strategy, asvgfPreset );
-
-	}
-
-	/**
-	 * Enables or disables the ASVGF denoiser with optional quality preset.
-	 * @param {boolean} enabled
-	 * @param {string} [qualityPreset]
-	 */
-	setASVGFEnabled( enabled, qualityPreset ) {
-
-		this._app.setASVGFEnabled( enabled, qualityPreset );
-
-	}
-
-	/**
-	 * Applies an ASVGF quality preset.
-	 * @param {'low'|'medium'|'high'} presetName
-	 */
-	applyASVGFPreset( presetName ) {
-
-		this._app.applyASVGFPreset( presetName );
-
-	}
-
-	/**
-	 * Enables or disables auto-exposure.
-	 * @param {boolean} enabled
-	 */
-	setAutoExposure( enabled ) {
-
-		this._app.setAutoExposureEnabled( enabled );
-
-	}
-
-	/**
-	 * Enables or disables adaptive sampling.
-	 * @param {boolean} enabled
-	 */
-	setAdaptiveSampling( enabled ) {
-
-		this._app.setAdaptiveSamplingEnabled( enabled );
-
-	}
-
-	// ── Stage Parameters ──
-
-	/**
-	 * Updates ASVGF stage parameters.
-	 * @param {Object} params - { temporalAlpha, phiColor, phiLuminance, atrousIterations, ... }
-	 */
-	setASVGFParams( params ) {
-
-		this._app.updateASVGFParameters( params );
-
-	}
-
-	/**
-	 * Toggles the ASVGF heatmap debug overlay.
-	 * @param {boolean} enabled
-	 */
-	toggleASVGFHeatmap( enabled ) {
-
-		this._app.toggleASVGFHeatmap( enabled );
-
-	}
-
-	/**
-	 * Configures ASVGF for a specific render mode.
-	 * @param {Object} config - { enabled, temporalAlpha, atrousIterations, ... }
-	 */
-	configureASVGFForMode( config ) {
-
-		this._app.configureASVGFForMode( config );
-
-	}
-
-	/**
-	 * Updates SSRC stage parameters.
-	 * @param {Object} params - { temporalAlpha, spatialRadius, spatialWeight }
-	 */
-	setSSRCParams( params ) {
-
-		this._app.updateSSRCParameters( params );
-
-	}
-
-	/**
-	 * Updates edge-aware filtering parameters.
-	 * @param {Object} params - { pixelEdgeSharpness, edgeSharpenSpeed, edgeThreshold }
-	 */
-	setEdgeAwareParams( params ) {
-
-		this._app.updateEdgeAwareUniforms( params );
-
-	}
-
-	/**
-	 * Updates auto-exposure stage parameters.
-	 * @param {Object} params - { keyValue, minExposure, maxExposure, ... }
-	 */
-	setAutoExposureParams( params ) {
-
-		this._app.updateAutoExposureParameters( params );
-
-	}
-
-	// ── Adaptive Sampling ──
-
-	/**
-	 * Updates adaptive sampling parameters.
-	 * @param {Object} params
-	 */
-	setAdaptiveSamplingParams( params ) {
-
-		this._app.setAdaptiveSamplingParameters( params );
-
-	}
-
-	/**
-	 * Toggles the adaptive sampling debug helper.
-	 * @param {boolean} enabled
-	 */
-	toggleAdaptiveSamplingHelper( enabled ) {
-
-		this._app.toggleAdaptiveSamplingHelper( enabled );
-
-	}
-
-	// ── OIDN ──
-
-	/**
-	 * Enables or disables Intel OIDN denoiser (final render quality).
-	 * @param {boolean} enabled
-	 */
-	setOIDNEnabled( enabled ) {
-
-		this._app.setOIDNEnabled( enabled );
-
-	}
-
-	/**
-	 * Sets OIDN denoiser quality.
-	 * @param {string} quality
-	 */
-	setOIDNQuality( quality ) {
-
-		this._app.updateOIDNQuality( quality );
-
-	}
-
-	/**
-	 * Enables or disables the OIDN tile helper overlay.
-	 * @param {boolean} enabled
-	 */
-	setOIDNTileHelper( enabled ) {
-
-		this._app.setOIDNTileHelper( enabled );
-
-	}
-
-	/**
-	 * Enables or disables the tile helper overlay.
-	 * @param {boolean} enabled
-	 */
-	setTileHelperEnabled( enabled ) {
-
-		this._app.setTileHelperEnabled( enabled );
-
-	}
-
-	/**
-	 * Enables or disables tile highlight.
-	 * @param {boolean} enabled
-	 */
-	setTileHighlightEnabled( enabled ) {
-
-		this._app.setTileHighlightEnabled( enabled );
-
-	}
-
-	// ── AI Upscaler ──
-
-	/**
-	 * Enables or disables the AI upscaler.
-	 * @param {boolean} enabled
-	 */
-	setUpscalerEnabled( enabled ) {
-
-		this._app.setUpscalerEnabled( enabled );
-
-	}
-
-	/**
-	 * Sets the upscaler scale factor.
-	 * @param {number} factor
-	 */
-	setUpscalerScaleFactor( factor ) {
-
-		this._app.setUpscalerScaleFactor( factor );
-
-	}
-
-	/**
-	 * Sets the upscaler quality level.
-	 * @param {string} quality
-	 */
-	setUpscalerQuality( quality ) {
-
-		this._app.setUpscalerQuality( quality );
-
-	}
-
-}

package/src/api/EnvironmentAPI.js

@@ -1,106 +0,0 @@
-/**
- * Environment sub-API — HDR maps, sky modes, and procedural generation.
- *
- * Access via `engine.environment`.
- *
- * @example
- * await engine.environment.setMode('gradient');
- * engine.environment.params.sunElevation = 45;
- * engine.environment.markDirty();
- */
-export class EnvironmentAPI {
-
-	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
-	constructor( app ) {
-
-		this._app = app;
-
-	}
-
-	/**
-	 * Current environment parameters (sun position, sky colors, etc.).
-	 * @returns {Object|null}
-	 */
-	get params() {
-
-		return this._app.getEnvParams();
-
-	}
-
-	/**
-	 * The loaded environment texture.
-	 * @returns {import('three').Texture|null}
-	 */
-	get texture() {
-
-		return this._app.getEnvironmentTexture();
-
-	}
-
-	/**
-	 * Loads an HDR/EXR environment map from URL.
-	 * @param {string} url
-	 */
-	async load( url ) {
-
-		await this._app.loadEnvironment( url );
-
-	}
-
-	/**
-	 * Sets a custom environment texture directly.
-	 * @param {import('three').Texture} texture
-	 */
-	async setTexture( texture ) {
-
-		await this._app.setEnvironmentMap( texture );
-
-	}
-
-	/**
-	 * Switches the sky mode.
-	 * @param {'hdri'|'procedural'|'gradient'|'color'} mode
-	 */
-	async setMode( mode ) {
-
-		await this._app.setEnvironmentMode( mode );
-
-	}
-
-	/**
-	 * Generates a procedural Preetham-model sky texture.
-	 */
-	async generateProcedural() {
-
-		return this._app.generateProceduralSkyTexture();
-
-	}
-
-	/**
-	 * Generates a gradient sky texture.
-	 */
-	async generateGradient() {
-
-		return this._app.generateGradientTexture();
-
-	}
-
-	/**
-	 * Generates a solid color sky texture.
-	 */
-	async generateSolid() {
-
-		return this._app.generateSolidColorTexture();
-
-	}
-
-	/**
-	 * Flags the environment texture for GPU re-upload.
-	 */
-	markDirty() {
-
-		this._app.markEnvironmentNeedsUpdate();
-
-	}
-
-}

package/src/api/LightsAPI.js

@@ -1,80 +0,0 @@
-/**
- * Lights sub-API — light CRUD, helpers, and GPU sync.
- *
- * Access via `engine.lights`.
- *
- * @example
- * engine.lights.add('PointLight');
- * engine.lights.showHelpers(true);
- * engine.lights.getAll();
- */
-export class LightsAPI {
-
-	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
-	constructor( app ) {
-
-		this._app = app;
-
-	}
-
-	/**
-	 * Adds a light to the scene.
-	 * @param {'DirectionalLight'|'PointLight'|'SpotLight'|'RectAreaLight'} type
-	 * @returns {Object|null} Light descriptor
-	 */
-	add( type ) {
-
-		return this._app.addLight( type );
-
-	}
-
-	/**
-	 * Removes a light by UUID.
-	 * @param {string} uuid
-	 * @returns {boolean}
-	 */
-	remove( uuid ) {
-
-		return this._app.removeLight( uuid );
-
-	}
-
-	/**
-	 * Removes all lights from the scene.
-	 */
-	clear() {
-
-		this._app.clearLights();
-
-	}
-
-	/**
-	 * Returns descriptors for all lights in the scene.
-	 * @returns {Object[]}
-	 */
-	getAll() {
-
-		return this._app.getLights();
-
-	}
-
-	/**
-	 * Re-uploads light data to the GPU.
-	 */
-	sync() {
-
-		this._app.updateLights();
-
-	}
-
-	/**
-	 * Shows or hides visual light helpers.
-	 * @param {boolean} show
-	 */
-	showHelpers( show ) {
-
-		this._app.setShowLightHelper( show );
-
-	}
-
-}

package/src/api/MaterialsAPI.js

@@ -1,73 +0,0 @@
-/**
- * Materials sub-API — material property updates and texture transforms.
- *
- * Access via `engine.materials`.
- *
- * @example
- * engine.materials.setProperty(0, 'roughness', 0.5);
- * engine.materials.refresh();
- */
-export class MaterialsAPI {
-
-	/** @param {import('../PathTracerApp.js').PathTracerApp} app */
-	constructor( app ) {
-
-		this._app = app;
-
-	}
-
-	/**
-	 * Updates a single material property and triggers emissive rebuild if needed.
-	 * @param {number} materialIndex
-	 * @param {string} property
-	 * @param {*} value
-	 */
-	setProperty( materialIndex, property, value ) {
-
-		this._app.updateMaterialProperty( materialIndex, property, value );
-
-	}
-
-	/**
-	 * Updates a material's texture transform (offset, repeat, rotation).
-	 * @param {number} materialIndex
-	 * @param {string} textureName
-	 * @param {Object} transform
-	 */
-	setTextureTransform( materialIndex, textureName, transform ) {
-
-		this._app.updateTextureTransform( materialIndex, textureName, transform );
-
-	}
-
-	/**
-	 * Re-uploads all material data to the GPU.
-	 */
-	refresh() {
-
-		this._app.refreshMaterial();
-
-	}
-
-	/**
-	 * Replaces a material entirely.
-	 * @param {number} materialIndex
-	 * @param {import('three').Material} material
-	 */
-	replace( materialIndex, material ) {
-
-		this._app.updateMaterial( materialIndex, material );
-
-	}
-
-	/**
-	 * Full material rebuild (required after texture changes).
-	 * @param {import('three').Scene} [scene]
-	 */
-	async rebuild( scene ) {
-
-		await this._app.rebuildMaterials( scene );
-
-	}
-
-}

package/src/api/OutputAPI.js

@@ -1,90 +0,0 @@
-/**
- * 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

@@ -1,89 +0,0 @@
-/**
- * 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

@@ -1,49 +0,0 @@
-/**
- * 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;
-
-	}
-
-}