@combeenation/3d-viewer 4.0.0-beta4 → 4.0.0-beta5

package/src/api/classes/parameter.ts

@@ -1,277 +1,408 @@
-import { Color3 } from '@babylonjs/core/Maths/math.color';
-import { Vector3 } from '@babylonjs/core/Maths/math.vector';
-import { isNumber, isString } from 'lodash-es';
-
-
-/**
- * This `Parameter` class defines all parameters that can be consumed and committed by a {@link ParameterObservable}.
- * Use {@link ParameterObservable.addParameterObserver} or {@link ParameterObservable.commitParameters} to either add or
- * commit parameters on your observable objects.
- */
-export class Parameter {
-
-	/**
-	 * Constructor.
-	 */
-	private constructor() {}
-
-	/**
-	 * Mutates the visibility. Helper methods are {@link ElementParameterizable.show} and
-	 * {@link ElementParameterizable.hide}. Getter and setter is {@link ElementParameterizable.visible}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly VISIBLE = 'visible';
-
-	/**
-	 * Stretches or compresses some meshes. Getter and setter is {@link ElementParameterizable.scaling}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseScaling}
-	 */
-	public static readonly SCALING = 'scaling';
-
-	/**
-	 * Mutates the material. Getter and setter is {@link ElementParameterizable.material}. The value of this parameter
-	 * represents the ID of a baked-in glTF or custom created material in the {@link Variant} tree.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser string
-	 */
-	public static readonly MATERIAL = 'material';
-
-	/**
-	 * Mutates the material color.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseColor}
-	 */
-	public static readonly MATERIAL_COLOR = 'material.color';
-
-	/**
-	 * Mutates the material metallness.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly MATERIAL_METALLNESS = 'material.metallness';
-
-	/**
-	 * Mutates the material roughness.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly MATERIAL_ROUGHNESS = 'material.roughness';
-
-	/**
-	 * Mutates whether a highlight layer should be enabled.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly HIGHLIGHT_ENABLED = 'highlight.enabled';
-
-	/**
-	 * Changes the highlight color.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseColor}
-	 */
-	public static readonly HIGHLIGHT_COLOR = 'highlight.color';
-
-	/**
-	 * Mutates the highlighted state. Getter and setter is {@link ElementParameterizable.highlighted}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly HIGHLIGHTED = 'highlighted';
-
-	/**
-	 * Mutates the position relative to its origin position. Getter and setter is {@link ElementParameterizable.position}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseVector}
-	 */
-	public static readonly POSITION = 'position';
-
-	/**
-	 * Mutates the rotation relative to its origin rotation. Getter and setter is {@link ElementParameterizable.rotation}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseRotation}
-	 */
-	public static readonly ROTATION = 'rotation';
-
-	/**
-	 * The {@link ParameterDeclarations} for all parameters in this class.
-	 */
-	public static get declarations(): ParameterDeclarations {
-		const declaration: ParameterDeclarations = {};
-		declaration[Parameter.VISIBLE] = { type: 'boolean' };
-		declaration[Parameter.SCALING] = { type: 'number' };
-		declaration[Parameter.HIGHLIGHTED] = { type: 'boolean' };
-		declaration[Parameter.MATERIAL] = { type: 'string' };
-		declaration[Parameter.MATERIAL_COLOR] = { type: 'color' };
-		declaration[Parameter.MATERIAL_METALLNESS] = { type: 'number' };
-		declaration[Parameter.MATERIAL_ROUGHNESS] = { type: 'number' };
-		declaration[Parameter.HIGHLIGHT_ENABLED] = { type: 'boolean' };
-		declaration[Parameter.HIGHLIGHT_COLOR] = { type: 'color' };
-		declaration[Parameter.HIGHLIGHTED] = { type: 'boolean' };
-		declaration[Parameter.POSITION] = { type: 'vector' };
-		declaration[Parameter.ROTATION] = { type: 'vector' };
-		return declaration;
-	}
-
-	/**
-	 * Gets the {@link ParameterDeclaration} for a given {@link Parameter} declared in this class.
-	 */
-	public static getDeclaration(parameter: string): ParameterDeclaration {
-		return Parameter.declarations[parameter];
-	}
-
-	/**
-	 * All parameters defined in this class.
-	 */
-	public static get all() {
-		const all: string[] = [];
-		for( const parameter in Parameter ) {
-			const property = Object.getOwnPropertyDescriptor(Parameter, parameter);
-			if( parameter.toUpperCase() === parameter && property && isString( property.value ) ) {
-				all.push( property.value );
-			}
-		}
-		return all;
-	}
-
-	/**
-	 * Parses a string of format `'(x,y,z)'` to a `Vector3`.
-	 */
-	public static parseVector( value: ParameterValue ): Vector3 {
-		if( !isString( value ) ) {
-			throw new Error( `Unable to convert "${value}" into a Vector: not a string.` );
-		}
-		let cleanedValue = value.split( ' ' ).join( '' );
-		if( cleanedValue.startsWith( '(' ) && cleanedValue.endsWith( ')' ) ) {
-			cleanedValue = cleanedValue.substring( 1, cleanedValue.length - 1 );
-			let [x, y, z] = cleanedValue.split( ',' ).map( value => parseFloat( value ) );
-			return new Vector3( x, y, z );
-		} else {
-			throw new Error( `Unable to parse "${value}" to a Vector: expected "(x,y,z)".` );
-		}
-	}
-
-	/**
-	 * Stringifies a Vector3 to format `(x,y,z)`.
-	 */
-	public static stringifyVector( value: Vector3 ): string {
-		return `(${value.x},${value.y},${value.z})`;
-	}
-
-	/**
-	 * Parses a string of format `'(x,y,z)'` with angular degrees to a `Vector3` with rotation information in radians.
-	 */
-	public static parseRotation( value: ParameterValue ): Vector3 {
-		const rotation = Parameter.parseVector( value );
-		const deg2rad = function( deg: number ) {
-			return deg * Math.PI / 180;
-		};
-		return rotation.set(
-			deg2rad( rotation.x ),
-			deg2rad( rotation.y ),
-			deg2rad( rotation.z )
-		);
-	}
-
-	/**
-	 * Parses a string of format `'(x,y,z)'` or a simple `number` to a `Vector3` for scaling.
-	 */
-	public static parseScaling( value: ParameterValue ): Vector3 {
-		let scaling = new Vector3();
-		if( isString( value ) ) {
-			const cleanedFactor = value.split( ' ' ).join( '' );
-			if( cleanedFactor.startsWith( '(' ) && cleanedFactor.endsWith( ')' ) ) {
-				scaling = Parameter.parseVector( cleanedFactor );
-			} else {
-				const _factor = parseFloat( value );
-				scaling = new Vector3( _factor, _factor, _factor );
-			}
-		} else if( isNumber( value ) ) {
-			scaling = new Vector3( value, value, value );
-		} else {
-			throw new Error( `Unable to convert "${value}" to a Vector: expected "(x,y,z)".` );
-		}
-		return scaling;
-	}
-
-	/**
-	 * Parses a string of format `'#rrggbb'` or `'(r,g,b)'` to a `Color3`.
-	 */
-	public static parseColor( value: ParameterValue ): Color3 {
-		let cleanedValue = value.toString().split( ' ' ).join( '' );
-		if( cleanedValue.startsWith( '#' ) ) {
-			return Color3.FromHexString( value.toString() );
-		}
-		if( cleanedValue.startsWith( '(' ) && cleanedValue.endsWith( ')' ) ) {
-			cleanedValue = cleanedValue.substring( 1, cleanedValue.length - 1 );
-			let [r, g, b] = cleanedValue.split( ',' ).map( value => parseFloat( value ) );
-			return Color3.FromInts( r, g, b );
-		}
-		throw new Error( `Unable to parse "${value}" to a Color: expected "#rrggbb" or "(r,g,b)".` );
-	}
-
-	/**
-	 * Parses a `boolean` string (`'true'`/`'1'` or `'false'`/`'0'`) or `number` (`1` or `0`) to a `boolean` or `undefined`.
-	 */
-	public static parseBoolean( value: ParameterValue ): boolean {
-		if( value.toString() === 'true' || value.toString() === '1' ) {
-			return true;
-		} else if( value.toString() === 'false' || value.toString() === '0' ) {
-			return false;
-		}
-		throw new Error( `Unable to parse "${value}" to a boolean.` );
-	}
-
-	/**
-	 * Parses a number `string` to a `number`.
-	 */
-	public static parseNumber( value: ParameterValue ): number {
-		return parseFloat( value.toString() );
-	}
-
-}
+import { Color3 } from '@babylonjs/core/Maths/math.color';
+import { Vector3 } from '@babylonjs/core/Maths/math.vector';
+import { get, isEmpty, isNumber, isString } from 'lodash-es';
+
+
+/**
+ * This `Parameter` class defines all parameters that can be consumed and committed by a {@link ParameterObservable}.
+ * Use {@link ParameterObservable.addParameterObserver} or {@link ParameterObservable.commitParameters} to either add or
+ * commit parameters on your observable objects.
+ */
+export class Parameter {
+
+	/**
+	 * Constructor.
+	 */
+	private constructor() {}
+
+	/**
+	 * Mutates the visibility. Helper methods are {@link VariantParameterizable.show} and
+	 * {@link VariantParameterizable.hide}. Getter and setter is {@link VariantParameterizable.visible}.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 * * {@link ViewerLight} Available for all light types
+	 *
+	 * @parser {@link parseBoolean}
+	 */
+	public static readonly VISIBLE = 'visible';
+
+	/**
+	 * Stretches or compresses some meshes. Getter and setter is {@link VariantParameterizable.scaling}.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseScaling}
+	 */
+	public static readonly SCALING = 'scaling';
+
+	/**
+	 * Mutates the material. Getter and setter is {@link VariantParameterizable.material}. The value of this parameter
+	 * represents the ID of a baked-in glTF or custom created material in the {@link Variant} tree.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser string
+	 */
+	public static readonly MATERIAL = 'material';
+
+	/**
+	 * Mutates the material color.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseColor}
+	 */
+	public static readonly MATERIAL_COLOR = 'material.color';
+
+	/**
+	 * Mutates the material metallness.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly MATERIAL_METALLNESS = 'material.metallness';
+
+	/**
+	 * Mutates the material roughness.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly MATERIAL_ROUGHNESS = 'material.roughness';
+
+	/**
+	 * Mutates whether a highlight layer should be enabled.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseBoolean}
+	 */
+	public static readonly HIGHLIGHT_ENABLED = 'highlight.enabled';
+
+	/**
+	 * Changes the highlight color.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseColor}
+	 */
+	public static readonly HIGHLIGHT_COLOR = 'highlight.color';
+
+	/**
+	 * Mutates the highlighted state. Getter and setter is {@link VariantParameterizable.highlighted}.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseBoolean}
+	 */
+	public static readonly HIGHLIGHTED = 'highlighted';
+
+	/**
+	 * Mutates the position relative to its origin position. Getter and setter is {@link VariantParameterizable.position}.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#position), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#position), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#position)
+	 *
+	 * @parser {@link parseVector}
+	 */
+	public static readonly POSITION = 'position';
+
+	/**
+	 * Mutates the rotation relative to its origin rotation. Getter and setter is {@link VariantParameterizable.rotation}.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseRotation}
+	 */
+	public static readonly ROTATION = 'rotation';
+
+	/**
+	 * Mutates whether a shadow should be casted or not.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseBoolean}
+	 */
+	public static readonly CAST_SHADOW = 'castShadow';
+
+	/**
+	 * Mutates from which lights a shadow should be casted.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseCommaSeparatedList}
+	 */
+	public static readonly CAST_SHADOW_FROM_LIGHTS = 'castShadow.fromLights';
+
+	/**
+	 * Mutates whether to receive shadows or not.
+	 *
+	 * Scopes:
+	 * * {@link Element}
+	 * * {@link Variant}
+	 *
+	 * @parser {@link parseBoolean}
+	 */
+	public static readonly RECEIVE_SHADOWS = 'receiveShadows';
+
+	/**
+	 * Mutates the intensity of Lights.
+	 *
+	 * Scopes:
+	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#intensity), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#intensity), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#intensity), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#intensity)
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly INTENSITY = 'intensity';
+
+	/**
+	 * Mutates the direction of Lights.
+	 *
+	 * Scopes:
+	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#direction), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#direction), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#direction), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#direction)
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly DIRECTION = 'direction';
+
+	/**
+	 * Mutates the angle of Lights.
+	 *
+	 * Scopes:
+	 * * {@link ViewerLight} Available for [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#angle)
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly ANGLE = 'angle';
+
+	/**
+	 * Mutates the exponent of Lights.
+	 *
+	 * Scopes:
+	 * * {@link ViewerLight} Available for [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#exponent)
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly EXPONENT = 'exponent';
+
+	/**
+	 * Mutates the diffuse color of Lights.
+	 *
+	 * Scopes:
+	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#diffuse), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#diffuse), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#diffuse), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#diffuse)
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly DIFFUSE = 'diffuse';
+
+	/**
+	 * Mutates the specular color of Lights.
+	 *
+	 * Scopes:
+	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#specular), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#specular), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#specular), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#specular)
+	 *
+	 * @parser {@link parseNumber}
+	 */
+	public static readonly SPECULAR = 'specular';
+
+	/**
+	 * The {@link ParameterDeclarations} for all parameters in this class.
+	 */
+	public static get declarations(): ParameterDeclarations {
+		const declarations: ParameterDeclarations = {};
+		declarations[Parameter.VISIBLE] = { type: 'boolean', parser: Parameter.parseBoolean };
+		declarations[Parameter.SCALING] = { type: 'number', parser: Parameter.parseNumber };
+		declarations[Parameter.HIGHLIGHTED] = { type: 'boolean', parser: Parameter.parseBoolean };
+		declarations[Parameter.MATERIAL] = { type: 'string' };
+		declarations[Parameter.MATERIAL_COLOR] = { type: 'color', parser: Parameter.parseColor };
+		declarations[Parameter.MATERIAL_METALLNESS] = { type: 'number', parser: Parameter.parseNumber };
+		declarations[Parameter.MATERIAL_ROUGHNESS] = { type: 'number', parser: Parameter.parseNumber };
+		declarations[Parameter.HIGHLIGHT_ENABLED] = { type: 'boolean', parser: Parameter.parseBoolean };
+		declarations[Parameter.HIGHLIGHT_COLOR] = { type: 'color', parser: Parameter.parseColor };
+		declarations[Parameter.HIGHLIGHTED] = { type: 'boolean', parser: Parameter.parseBoolean };
+		declarations[Parameter.POSITION] = { type: 'vector', parser: Parameter.parseVector };
+		declarations[Parameter.ROTATION] = { type: 'vector', parser: Parameter.parseVector };
+		declarations[Parameter.CAST_SHADOW] = { type: 'boolean', parser: Parameter.parseBoolean };
+		declarations[Parameter.CAST_SHADOW_FROM_LIGHTS] = { type: 'csl', parser: Parameter.parseCommaSeparatedList };
+		declarations[Parameter.RECEIVE_SHADOWS] = { type: 'boolean', parser: Parameter.parseBoolean };
+		declarations[Parameter.INTENSITY] = { type: 'number', parser: Parameter.parseNumber };
+		declarations[Parameter.DIRECTION] = { type: 'vector', parser: Parameter.parseVector };
+		declarations[Parameter.ANGLE] = { type: 'number', parser: Parameter.parseNumber };
+		declarations[Parameter.EXPONENT] = { type: 'number', parser: Parameter.parseNumber };
+		declarations[Parameter.DIFFUSE] = { type: 'color', parser: Parameter.parseColor };
+		declarations[Parameter.SPECULAR] = { type: 'color', parser: Parameter.parseColor };
+		return declarations;
+	}
+
+	/**
+	 * Gets the {@link ParameterDeclaration} for a given {@link Parameter} declared in this class.
+	 */
+	public static getDeclaration(parameter: string): ParameterDeclaration {
+		return Parameter.declarations[parameter];
+	}
+
+	/**
+	 * All parameters defined in this class.
+	 */
+	public static get all() {
+		const all: string[] = [];
+		for( const parameter in Parameter ) {
+			const property = Object.getOwnPropertyDescriptor(Parameter, parameter);
+			if( parameter.toUpperCase() === parameter && property && isString( property.value ) ) {
+				all.push( property.value );
+			}
+		}
+		return all;
+	}
+
+	/**
+	 * Parses given {@link ParameterBag} with given {@link ParameterDeclarations}.
+	 */
+	public static parseFromDeclarations( declarations: ParameterDeclarations, parameterBag: ParameterBag ): ParsedParameterBag {
+		const parameters: ParsedParameterBag = {};
+		for( const parameter in parameterBag ) {
+			const value = get( parameterBag, parameter );
+			parameters[parameter] = value;
+			const declaration: ParameterDeclaration = declarations[parameter];
+			if( declaration ) {
+				if( !isEmpty( value ) && declaration.parser ) {
+					parameters[parameter] = declaration.parser( value );
+				}
+			}
+		}
+		return parameters;
+	}
+
+	/**
+	 * Parses a string of format `'(x,y,z)'` to a `Vector3`.
+	 */
+	public static parseVector( value: ParameterValue ): Vector3 {
+		if( !isString( value ) ) {
+			throw new Error( `Unable to convert "${value}" into a Vector: not a string.` );
+		}
+		let cleanedValue = value.split( ' ' ).join( '' );
+		if( cleanedValue.startsWith( '(' ) && cleanedValue.endsWith( ')' ) ) {
+			cleanedValue = cleanedValue.substring( 1, cleanedValue.length - 1 );
+			let [x, y, z] = cleanedValue.split( ',' ).map( value => parseFloat( value ) );
+			return new Vector3( x, y, z );
+		} else {
+			throw new Error( `Unable to parse "${value}" to a Vector: expected "(x,y,z)".` );
+		}
+	}
+
+	/**
+	 * Stringifies a Vector3 to format `(x,y,z)`.
+	 */
+	public static stringifyVector( value: Vector3 ): string {
+		return `(${value.x},${value.y},${value.z})`;
+	}
+
+	/**
+	 * Parses a string of format `'(x,y,z)'` with angular degrees to a `Vector3` with rotation information in radians.
+	 */
+	public static parseRotation( value: ParameterValue ): Vector3 {
+		const rotation = Parameter.parseVector( value );
+		const deg2rad = function( deg: number ) {
+			return deg * Math.PI / 180;
+		};
+		return rotation.set(
+			deg2rad( rotation.x ),
+			deg2rad( rotation.y ),
+			deg2rad( rotation.z )
+		);
+	}
+
+	/**
+	 * Parses a string of format `'(x,y,z)'` or a simple `number` to a `Vector3` for scaling.
+	 */
+	public static parseScaling( value: ParameterValue ): Vector3 {
+		let scaling = new Vector3();
+		if( isString( value ) ) {
+			const cleanedFactor = value.split( ' ' ).join( '' );
+			if( cleanedFactor.startsWith( '(' ) && cleanedFactor.endsWith( ')' ) ) {
+				scaling = Parameter.parseVector( cleanedFactor );
+			} else {
+				const _factor = parseFloat( value );
+				scaling = new Vector3( _factor, _factor, _factor );
+			}
+		} else if( isNumber( value ) ) {
+			scaling = new Vector3( value, value, value );
+		} else {
+			throw new Error( `Unable to convert "${value}" to a Vector: expected "(x,y,z)".` );
+		}
+		return scaling;
+	}
+
+	/**
+	 * Parses a string of format `'#rrggbb'` or `'(r,g,b)'` to a `Color3`.
+	 */
+	public static parseColor( value: ParameterValue ): Color3 {
+		let cleanedValue = value.toString().split( ' ' ).join( '' );
+		if( cleanedValue.startsWith( '#' ) ) {
+			return Color3.FromHexString( value.toString() );
+		}
+		if( cleanedValue.startsWith( '(' ) && cleanedValue.endsWith( ')' ) ) {
+			cleanedValue = cleanedValue.substring( 1, cleanedValue.length - 1 );
+			let [r, g, b] = cleanedValue.split( ',' ).map( value => parseFloat( value ) );
+			return Color3.FromInts( r, g, b );
+		}
+		throw new Error( `Unable to parse "${value}" to a Color: expected "#rrggbb" or "(r,g,b)".` );
+	}
+
+	/**
+	 * Parses a `boolean` string (`'true'`/`'1'` or `'false'`/`'0'`) or `number` (`1` or `0`) to a `boolean` or `undefined`.
+	 */
+	public static parseBoolean( value: ParameterValue ): boolean {
+		if( value.toString() === 'true' || value.toString() === '1' ) {
+			return true;
+		} else if( value.toString() === 'false' || value.toString() === '0' ) {
+			return false;
+		}
+		throw new Error( `Unable to parse "${value}" to a boolean.` );
+	}
+
+	/**
+	 * Parses a number `string` to a `number`.
+	 */
+	public static parseNumber( value: ParameterValue ): number {
+		return parseFloat( value.toString() );
+	}
+
+	/**
+	 * Parses a string with comma separated values to a list of strings.
+	 */
+	public static parseCommaSeparatedList( value: ParameterValue ): string[] {
+		return value.toString()
+			.split( ',' )
+			.map( s => s.trim() );
+	}
+
+}