@unikia/upe-renderer 0.186.110 → 0.187.11

package/examples/jsm/loaders/materialx/MaterialXUtils.js

@@ -1,3 +1,9 @@
+import {
+	RepeatWrapping,
+	ClampToEdgeWrapping,
+	MirroredRepeatWrapping,
+} from 'three/webgpu';
+
 import {
 	bool,
 	element,
@@ -6,6 +12,12 @@ import {
 } from 'three/tsl';
 
 const BOOLEAN_OPERATOR_OPS = new Set( [ '&&', '||', '^^', '!', '==', '!=', '<', '>', '<=', '>=' ] );
+const TEXTURE_ADDRESS_MODE_WRAPPING = {
+	constant: ClampToEdgeWrapping,
+	clamp: ClampToEdgeWrapping,
+	periodic: RepeatWrapping,
+	mirror: MirroredRepeatWrapping,
+};
 
 function normalizeSpaceName( value, fallback = 'world' ) {
 
@@ -48,10 +60,23 @@ function toVec3Channels( input ) {
 
 }
 
+// Normalizes a raw `*addressmode` attribute value, defaulting to `'periodic'`
+// when unset and returning `null` when the value isn't a recognized mode.
+function resolveTextureAddressMode( value ) {
+
+	if ( typeof value !== 'string' || value === '' ) return 'periodic';
+
+	const mode = value.trim().toLowerCase();
+	return mode in TEXTURE_ADDRESS_MODE_WRAPPING ? mode : null;
+
+}
+
 export {
 	getComponentCountForType,
 	isBooleanNode,
 	normalizeSpaceName,
+	resolveTextureAddressMode,
+	TEXTURE_ADDRESS_MODE_WRAPPING,
 	toBooleanNode,
 	toVec3Channels,
 };

package/examples/jsm/loaders/materialx/compile/MaterialXCompileRegistry.js

@@ -7,7 +7,6 @@ import {
 	mul,
 	normalMap,
 	texture,
-	uv,
 	vec2,
 	vec3,
 	vec4,
@@ -54,32 +53,13 @@ const register = ( registry, categories, handler ) => {
 
 };
 
-const UV_FALLBACK_CATEGORIES = new Set( [ 'checkerboard', 'noise2d', 'fractal2d', 'cellnoise2d', 'worleynoise2d', 'unifiednoise2d', 'heighttonormal' ] );
 const SCALAR_TYPES = new Set( [ 'boolean', 'integer', 'float' ] );
 const THREE_COMPONENT_TYPES = new Set( [ 'vector2', 'vector3', 'vector4', 'color3', 'color4' ] );
-const TEXTURE_ADDRESS_MODES = new Set( [ 'constant', 'clamp', 'periodic', 'mirror' ] );
 const SWITCH_MIN_INDEX = 1;
 const SWITCH_MAX_INDEX = 10;
 
-const getDefaultUvNode = ( compileContext ) => compileContext.mxToBottomLeftUvSpace( uv( 0 ) );
-
 const toBooleanMaskNode = ( node ) => toBooleanNode( node ).select( float( 1 ), float( 0 ) );
 
-const getTextureAddressMode = ( nodeX, inputName ) => {
-
-	const value = nodeX.getInputValueByName( inputName );
-	if ( value === null || value === undefined || value === '' ) return 'periodic';
-
-	const mode = value.trim().toLowerCase();
-	return TEXTURE_ADDRESS_MODES.has( mode ) ? mode : 'periodic';
-
-};
-
-const getTextureAddressModes = ( nodeX ) => ( {
-	u: getTextureAddressMode( nodeX, 'uaddressmode' ),
-	v: getTextureAddressMode( nodeX, 'vaddressmode' ),
-} );
-
 const getZeroNodeForType = ( type ) => {
 
 	if ( type === 'vector2' ) return vec2( 0, 0 );
@@ -98,13 +78,13 @@ const toTextureDefaultNode = ( node, type ) => {
 
 };
 
-const getTextureInputs = ( nodeX, compileContext ) => {
+const getTextureInputs = ( nodeX ) => {
 
 	const file = nodeX.getChildByName( 'file' );
-	const uvNode = nodeX.getNodeByName( 'texcoord' ) || getDefaultUvNode( compileContext );
+	const uvNode = nodeX.getNodeByName( 'texcoord' );
 	const textureFile = file ? file.getTexture() : null;
-	const defaultNode = nodeX.getNodeByName( 'default' ) || getZeroNodeForType( nodeX.type );
-	const addressModes = getTextureAddressModes( nodeX );
+	const defaultNode = nodeX.getNodeByName( 'default' );
+	const addressModes = nodeX.getTextureAddressModes();
 	return { file, uvNode, textureFile, defaultNode, addressModes };
 
 };
@@ -153,7 +133,7 @@ const compileConvertNode = ( nodeX ) => {
 
 	const input = nodeX.getNodeByName( 'in' );
 	const inputElement = nodeX.getChildByName( 'in' );
-	const inputType = inputElement ? inputElement.type : null;
+	const inputType = inputElement && inputElement.type ? inputElement.type : nodeX.getNodeDefInputType( 'in' );
 	const nodeClass = nodeX.getClassFromType( nodeX.type ) || float;
 
 	if ( nodeX.type === 'boolean' ) {
@@ -198,11 +178,11 @@ const compileConstantNode = ( nodeX ) => nodeX.getNodeByName( 'value' );
 const compileArtisticIorNode = ( nodeX, out ) => {
 
 	const reflectivity = clamp(
-		nodeX.getNodeByName( 'reflectivity' ) || vec3( 0.944, 0.776, 0.373 ),
+		nodeX.getNodeByName( 'reflectivity' ),
 		vec3( 0, 0, 0 ),
 		vec3( 0.99, 0.99, 0.99 ),
 	);
-	const edgeColor = nodeX.getNodeByName( 'edge_color' ) || vec3( 0.998, 0.981, 0.751 );
+	const edgeColor = nodeX.getNodeByName( 'edge_color' );
 	const one = vec3( 1, 1, 1 );
 	const nMin = div( sub( one, reflectivity ), add( one, reflectivity ) );
 	const nMax = div( add( one, sqrt( reflectivity ) ), sub( one, sqrt( reflectivity ) ) );
@@ -227,11 +207,10 @@ const compileArtisticIorNode = ( nodeX, out ) => {
 const compileBooleanConditionalNode = ( nodeX ) => {
 
 	if ( nodeX.type !== 'boolean' ) return null;
+	if ( nodeX.element !== 'ifgreater' && nodeX.element !== 'ifgreatereq' && nodeX.element !== 'ifequal' ) return null;
 
-	const value1Default = nodeX.element === 'ifequal' ? float( 0 ) : float( 1 );
-	const value2Default = float( 0 );
-	const value1 = nodeX.getNodeByName( 'value1' ) || value1Default;
-	const value2 = nodeX.getNodeByName( 'value2' ) || value2Default;
+	const value1 = nodeX.getNodeByName( 'value1' );
+	const value2 = nodeX.getNodeByName( 'value2' );
 
 	if ( nodeX.element === 'ifgreater' ) return value1.greaterThan( value2 );
 	if ( nodeX.element === 'ifgreatereq' ) return value1.greaterThanEqual( value2 );
@@ -243,16 +222,16 @@ const compileBooleanConditionalNode = ( nodeX ) => {
 
 const compileClampNode = ( nodeX ) => {
 
-	const inNode = nodeX.getNodeByName( 'in' ) || float( 0 );
-	const low = nodeX.getNodeByName( 'low' ) || float( 0 );
-	const high = nodeX.getNodeByName( 'high' ) || float( 1 );
+	const inNode = nodeX.getNodeByName( 'in' );
+	const low = nodeX.getNodeByName( 'low' );
+	const high = nodeX.getNodeByName( 'high' );
 	return min( max( inNode, low ), high );
 
 };
 
 const compileNormalizeNode = ( nodeX ) => {
 
-	const inNode = nodeX.getNodeByName( 'in' ) || getZeroNodeForType( nodeX.type );
+	const inNode = nodeX.getNodeByName( 'in' );
 	const zeroNode = getZeroNodeForType( nodeX.type );
 	const lengthSquared = dot( inNode, inNode );
 	const safeLengthSquared = max( lengthSquared, float( 1e-8 ) );
@@ -263,11 +242,11 @@ const compileNormalizeNode = ( nodeX ) => {
 
 const compileRemapNode = ( nodeX ) => {
 
-	const inNode = nodeX.getNodeByName( 'in' ) || float( 0 );
-	const inLow = nodeX.getNodeByName( 'inlow' ) || float( 0 );
-	const inHigh = nodeX.getNodeByName( 'inhigh' ) || float( 1 );
-	const outLow = nodeX.getNodeByName( 'outlow' ) || float( 0 );
-	const outHigh = nodeX.getNodeByName( 'outhigh' ) || float( 1 );
+	const inNode = nodeX.getNodeByName( 'in' );
+	const inLow = nodeX.getNodeByName( 'inlow' );
+	const inHigh = nodeX.getNodeByName( 'inhigh' );
+	const outLow = nodeX.getNodeByName( 'outlow' );
+	const outHigh = nodeX.getNodeByName( 'outhigh' );
 	const denominator = sub( inHigh, inLow );
 	const isDegenerate = abs( denominator ).lessThan( float( 1e-8 ) );
 	const safeDenominator = isDegenerate.select( float( 1 ), denominator );
@@ -281,13 +260,13 @@ const compileRemapNode = ( nodeX ) => {
 
 const compileRangeNode = ( nodeX ) => {
 
-	const inNode = nodeX.getNodeByName( 'in' ) || float( 0 );
-	const inLow = nodeX.getNodeByName( 'inlow' ) || float( 0 );
-	const inHigh = nodeX.getNodeByName( 'inhigh' ) || float( 1 );
-	const outLow = nodeX.getNodeByName( 'outlow' ) || float( 0 );
-	const outHigh = nodeX.getNodeByName( 'outhigh' ) || float( 1 );
-	const gamma = nodeX.getNodeByName( 'gamma' ) || float( 1 );
-	const doClamp = nodeX.getNodeByName( 'doclamp' ) || int( 0 );
+	const inNode = nodeX.getNodeByName( 'in' );
+	const inLow = nodeX.getNodeByName( 'inlow' );
+	const inHigh = nodeX.getNodeByName( 'inhigh' );
+	const outLow = nodeX.getNodeByName( 'outlow' );
+	const outHigh = nodeX.getNodeByName( 'outhigh' );
+	const gamma = nodeX.getNodeByName( 'gamma' );
+	const doClamp = nodeX.getNodeByName( 'doclamp' );
 
 	const denominator = sub( inHigh, inLow );
 	const isDegenerate = abs( denominator ).lessThan( float( 1e-8 ) );
@@ -305,13 +284,12 @@ const compileRangeNode = ( nodeX ) => {
 
 };
 
-const getSwitchBranchNode = ( nodeX, index ) => nodeX.getNodeByName( `in${index}` ) || getZeroNodeForType( nodeX.type );
+const getSwitchBranchNode = ( nodeX, index ) => nodeX.getNodeByName( `in${index}` );
 
 const compileSwitchNode = ( nodeX ) => {
 
 	const fallbackNode = getSwitchBranchNode( nodeX, SWITCH_MIN_INDEX );
-	const whichInput = nodeX.getNodeByName( 'which' );
-	const switchIndex = add( floor( float( whichInput === undefined || whichInput === null ? 0 : whichInput ) ), 1 );
+	const switchIndex = add( floor( float( nodeX.getNodeByName( 'which' ) ) ), 1 );
 	const whichNode = clamp(
 		float( switchIndex ),
 		float( SWITCH_MIN_INDEX ),
@@ -332,8 +310,7 @@ const compileSwitchNode = ( nodeX ) => {
 
 const compileSpaceInputNode = ( nodeX, objectNode, worldNode ) => {
 
-	const rawSpace = nodeX.getInputValueByName( 'space' ) ?? nodeX.getAttribute( 'space' );
-	const space = normalizeSpaceName( rawSpace, 'object' );
+	const space = normalizeSpaceName( nodeX.getNodeByName( 'space' ), 'object' );
 	return space === 'world' ? worldNode : objectNode;
 
 };
@@ -344,7 +321,7 @@ const compileTexcoordNode = ( nodeX, compileContext ) => {
 
 	const indexNode = nodeX.getChildByName( 'index' );
 	const index = indexNode ? parseInt( indexNode.value, 10 ) : 0;
-	return compileContext.mxToBottomLeftUvSpace( uv( index ) );
+	return compileContext.getTexcoordNode( index );
 
 };
 
@@ -358,7 +335,7 @@ const compileGeomColorNode = ( nodeX ) => {
 
 const compileImageLikeNode = ( nodeX, compileContext ) => {
 
-	const { file, uvNode, textureFile, defaultNode, addressModes } = getTextureInputs( nodeX, compileContext );
+	const { file, uvNode, textureFile, defaultNode, addressModes } = getTextureInputs( nodeX );
 	const textureDefault = toTextureDefaultNode( defaultNode, nodeX.type );
 	const node = sampleTexture( textureFile, uvNode, compileContext, textureDefault, addressModes, textureDefault );
 	return applyTextureColorSpace( node, file );
@@ -367,7 +344,7 @@ const compileImageLikeNode = ( nodeX, compileContext ) => {
 
 const compileTiledImageNode = ( nodeX, compileContext ) => {
 
-	const { file, uvNode, textureFile, defaultNode, addressModes } = getTextureInputs( nodeX, compileContext );
+	const { file, uvNode, textureFile, defaultNode, addressModes } = getTextureInputs( nodeX );
 	const textureDefault = toTextureDefaultNode( defaultNode, nodeX.type );
 	if ( ! textureFile ) {
 
@@ -383,10 +360,52 @@ const compileTiledImageNode = ( nodeX, compileContext ) => {
 
 };
 
+const compileTriplanarProjectionNode = ( nodeX, compileContext ) => {
+
+	const position = nodeX.getNodeByName( 'position' );
+	const normal = nodeX.getNodeByName( 'normal' );
+	const upAxis = nodeX.getNodeByName( 'upaxis' );
+	const blend = nodeX.getNodeByName( 'blend' );
+	const defaultNode = nodeX.getNodeByName( 'default' );
+	const textureDefault = toTextureDefaultNode( defaultNode, nodeX.type );
+
+	const x = element( position, 0 );
+	const y = element( position, 1 );
+	const z = element( position, 2 );
+	const xUp = upAxis.equal( int( 0 ) );
+	const zUp = upAxis.equal( int( 2 ) );
+	const texcoords = {
+		filex: zUp.select( vec2( y, z ), vec2( z, y ) ),
+		filey: xUp.select( vec2( z, x ), vec2( x, z ) ),
+		filez: xUp.select( vec2( mul( y, - 1 ), x ), vec2( x, y ) ),
+	};
+
+	// color4 and vector4 keep the alpha of the textures.
+	const fourChannels = nodeX.type === 'color4' || nodeX.type === 'vector4';
+	const samples = Object.entries( texcoords ).map( ( [ fileInput, texcoord ] ) => {
+
+		const file = nodeX.getChildByName( fileInput );
+		const textureFile = file && file.getValue() !== '' ? file.getTexture() : null;
+		const sample = applyTextureColorSpace( sampleTexture( textureFile, texcoord, compileContext, textureDefault ), file );
+		return fourChannels ? sample : toVec3Channels( sample );
+
+	} );
+
+	const absNormal = abs( normalize( normal ) );
+	const weights = pow( div( absNormal, dot( absNormal, vec3( 1, 1, 1 ) ) ), div( 1, clamp( blend, float( 0.03 ), float( 1 ) ) ) );
+	const normalizedWeights = div( weights, dot( weights, vec3( 1, 1, 1 ) ) );
+
+	return add(
+		add( mul( samples[ 0 ], element( normalizedWeights, 0 ) ), mul( samples[ 1 ], element( normalizedWeights, 1 ) ) ),
+		mul( samples[ 2 ], element( normalizedWeights, 2 ) ),
+	);
+
+};
+
 const compileHexTiledNormalMapNode = ( nodeX, compileContext, sampleNode ) => {
 
 	const normalMapNodeElement = compileContext.nodeLibrary.normalmap;
-	const strengthNode = nodeX.getNodeByName( 'strength' ) || float( 1 );
+	const strengthNode = nodeX.getNodeByName( 'strength' );
 
 	if ( ! normalMapNodeElement || typeof normalMapNodeElement.nodeFunc !== 'function' ) {
 
@@ -420,6 +439,32 @@ const compileHexTiledNormalMapNode = ( nodeX, compileContext, sampleNode ) => {
 
 };
 
+const getHextileLuminanceWeights = ( nodeX, c0, c1, c2 ) => {
+
+	const falloffContrast = nodeX.getNodeByName( 'falloffcontrast' );
+	let lumaCoeffs = nodeX.getNodeByName( 'lumacoeffs' );
+	const lumaCoeffsInput = nodeX.getChildByName( 'lumacoeffs' );
+	if ( lumaCoeffsInput && lumaCoeffsInput.isConst ) {
+
+		const lumaCoeffValues = lumaCoeffsInput.getVector();
+		if ( lumaCoeffValues.length === 3 ) {
+
+			// Treat luminance coefficients as raw numeric values, not display colors.
+			lumaCoeffs = vec3( lumaCoeffValues[ 0 ], lumaCoeffValues[ 1 ], lumaCoeffValues[ 2 ] );
+
+		}
+
+	}
+
+	const falloffContrastWeight = mul( falloffContrast, 0.5 );
+	return mix(
+		vec3( 1, 1, 1 ),
+		vec3( dot( c0, lumaCoeffs ), dot( c1, lumaCoeffs ), dot( c2, lumaCoeffs ) ),
+		vec3( falloffContrastWeight, falloffContrastWeight, falloffContrastWeight ),
+	);
+
+};
+
 const compileHexTiledTextureNode = ( nodeX, compileContext, category ) => {
 
 	const file = nodeX.getChildByName( 'file' );
@@ -432,7 +477,7 @@ const compileHexTiledTextureNode = ( nodeX, compileContext, category ) => {
 		);
 		if ( category === 'hextilednormalmap' ) {
 
-			return normalize( nodeX.getNodeByName( 'normal' ) || normalLocal );
+			return normalize( nodeX.getNodeByName( 'normal' ) );
 
 		}
 
@@ -445,7 +490,7 @@ const compileHexTiledTextureNode = ( nodeX, compileContext, category ) => {
 
 		if ( category === 'hextilednormalmap' ) {
 
-			return normalize( nodeX.getNodeByName( 'normal' ) || normalLocal );
+			return normalize( nodeX.getNodeByName( 'normal' ) );
 
 		}
 
@@ -453,29 +498,15 @@ const compileHexTiledTextureNode = ( nodeX, compileContext, category ) => {
 
 	}
 
-	const uvNode = nodeX.getNodeByName( 'texcoord' ) || getDefaultUvNode( compileContext );
-	const tiling = nodeX.getNodeByName( 'tiling' ) || vec2( 1, 1 );
-	const rotation = nodeX.getNodeByName( 'rotation' ) || float( 1 );
-	const rotationRange = nodeX.getNodeByName( 'rotationrange' ) || vec2( 0, 360 );
-	const scale = nodeX.getNodeByName( 'scale' ) || float( 1 );
-	const scaleRange = nodeX.getNodeByName( 'scalerange' ) || vec2( 0.5, 2 );
-	const offset = nodeX.getNodeByName( 'offset' ) || float( 1 );
-	const offsetRange = nodeX.getNodeByName( 'offsetrange' ) || vec2( 0, 1 );
-	const falloff = nodeX.getNodeByName( 'falloff' ) || float( 0.5 );
-	const falloffContrast = nodeX.getNodeByName( 'falloffcontrast' ) || float( 0.5 );
-	let lumaCoeffs = nodeX.getNodeByName( 'lumacoeffs' ) || vec3( 0.2722287, 0.6740818, 0.0536895 );
-	const lumaCoeffsInput = nodeX.getChildByName( 'lumacoeffs' );
-	if ( lumaCoeffsInput && lumaCoeffsInput.isConst ) {
-
-		const lumaCoeffValues = lumaCoeffsInput.getVector();
-		if ( lumaCoeffValues.length === 3 ) {
-
-			// Treat luminance coefficients as raw numeric values, not display colors.
-			lumaCoeffs = vec3( lumaCoeffValues[ 0 ], lumaCoeffValues[ 1 ], lumaCoeffValues[ 2 ] );
-
-		}
-
-	}
+	const uvNode = nodeX.getNodeByName( 'texcoord' );
+	const tiling = nodeX.getNodeByName( 'tiling' );
+	const rotation = nodeX.getNodeByName( 'rotation' );
+	const rotationRange = nodeX.getNodeByName( 'rotationrange' );
+	const scale = nodeX.getNodeByName( 'scale' );
+	const scaleRange = nodeX.getNodeByName( 'scalerange' );
+	const offset = nodeX.getNodeByName( 'offset' );
+	const offsetRange = nodeX.getNodeByName( 'offsetrange' );
+	const falloff = nodeX.getNodeByName( 'falloff' );
 
 	const transformedUv = compileContext.mxFromBottomLeftUvSpace( mul( uvNode, tiling ) );
 	const tileData = compileContext.mxHextileCoord( transformedUv, rotation, rotationRange, scale, scaleRange, offset, offsetRange );
@@ -508,12 +539,8 @@ const compileHexTiledTextureNode = ( nodeX, compileContext, category ) => {
 	const c0 = toVec3Channels( sample0 );
 	const c1 = toVec3Channels( sample1 );
 	const c2 = toVec3Channels( sample2 );
-	const falloffContrastWeight = mul( falloffContrast, 0.5 );
-	const cw = mix(
-		vec3( 1, 1, 1 ),
-		vec3( dot( c0, lumaCoeffs ), dot( c1, lumaCoeffs ), dot( c2, lumaCoeffs ) ),
-		vec3( falloffContrastWeight, falloffContrastWeight, falloffContrastWeight ),
-	);
+	// hextilednormalmap blends with unit weights, as in MaterialX
+	const cw = category === 'hextilednormalmap' ? vec3( 1, 1, 1 ) : getHextileLuminanceWeights( nodeX, c0, c1, c2 );
 	const blendWeights = compileContext.mxHextileComputeBlendWeights( cw, tileData.weights, falloff );
 	const alphaWeights = compileContext.mxHextileComputeBlendWeights( vec3( 1, 1, 1 ), tileData.weights, falloff );
 	const blendedRgb = add( add( mul( element( blendWeights, 0 ), c0 ), mul( element( blendWeights, 1 ), c1 ) ), mul( element( blendWeights, 2 ), c2 ) );
@@ -550,17 +577,17 @@ const compileHexTiledTextureNode = ( nodeX, compileContext, category ) => {
 
 const compileGltfTextureNode = ( nodeX, compileContext, category ) => {
 
-	const { file, uvNode, textureFile, addressModes } = getTextureInputs( nodeX, compileContext );
+	const { file, uvNode, textureFile, addressModes } = getTextureInputs( nodeX );
 	let transformedUv = uvNode;
 	const place2d = compileContext.nodeLibrary.place2d;
 
 	if ( place2d ) {
 
-		const pivot = nodeX.getNodeByName( 'pivot' ) || vec2( 0, 1 );
-		const scale = nodeX.getNodeByName( 'scale' ) || vec2( 1, 1 );
-		const rotate = nodeX.getNodeByName( 'rotate' ) || float( 0 );
-		const offset = nodeX.getNodeByName( 'offset' ) || vec2( 0, 0 );
-		const operationorder = nodeX.getNodeByName( 'operationorder' ) || int( 0 );
+		const pivot = nodeX.getNodeByName( 'pivot' );
+		const scale = nodeX.getNodeByName( 'scale' );
+		const rotate = nodeX.getNodeByName( 'rotate' );
+		const offset = nodeX.getNodeByName( 'offset' );
+		const operationorder = nodeX.getNodeByName( 'operationorder' );
 		transformedUv = place2d.nodeFunc(
 			uvNode,
 			pivot,
@@ -595,12 +622,12 @@ const compileGltfTextureNode = ( nodeX, compileContext, category ) => {
 
 	if ( category === 'gltf_normalmap' ) {
 
-		const normalScale = nodeX.getNodeByName( 'scale' ) || float( 1 );
+		const normalScale = nodeX.getNodeByName( 'scale' );
 		return normalMap( node, normalScale );
 
 	}
 
-	const factor = nodeX.getNodeByName( 'factor' );
+	const factor = nodeX.declaresInput( 'factor' ) ? nodeX.getNodeByName( 'factor' ) : null;
 
 	if ( factor ) {
 
@@ -620,16 +647,16 @@ const compileGltfTextureNode = ( nodeX, compileContext, category ) => {
 
 const compileGltfColorImageNode = ( nodeX, out, compileContext ) => {
 
-	const { file, uvNode, textureFile, addressModes } = getTextureInputs( nodeX, compileContext );
+	const { file, uvNode, textureFile, addressModes } = getTextureInputs( nodeX );
 	let transformedUv = uvNode;
 	const place2d = compileContext.nodeLibrary.place2d;
 
 	if ( place2d ) {
 
-		const pivot = nodeX.getNodeByName( 'pivot' ) || vec2( 0, 1 );
-		const scale = nodeX.getNodeByName( 'scale' ) || vec2( 1, 1 );
-		const rotate = nodeX.getNodeByName( 'rotate' ) || float( 0 );
-		const offset = nodeX.getNodeByName( 'offset' ) || vec2( 0, 0 );
+		const pivot = nodeX.getNodeByName( 'pivot' );
+		const scale = nodeX.getNodeByName( 'scale' );
+		const rotate = nodeX.getNodeByName( 'rotate' );
+		const offset = nodeX.getNodeByName( 'offset' );
 		// Match MaterialX's ND_gltf_colorimage graph implementation, which wires gltf_image with operationorder=0.
 		const operationorder = int( 0 );
 		transformedUv = place2d.nodeFunc(
@@ -643,12 +670,12 @@ const compileGltfColorImageNode = ( nodeX, out, compileContext ) => {
 
 	}
 
-	const defaultInput = nodeX.getNodeByName( 'default' ) || vec4( 0, 0, 0, 0 );
+	const defaultInput = nodeX.getNodeByName( 'default' );
 	const fallback = vec4( defaultInput );
 	const sampled = sampleTexture( textureFile, transformedUv, compileContext, fallback, addressModes, fallback );
 	const converted = applyTextureColorSpace( sampled, file );
-	const color = nodeX.getNodeByName( 'color' ) || vec4( 1, 1, 1, 1 );
-	const geomcolor = nodeX.getNodeByName( 'geomcolor' ) || vec4( 1, 1, 1, 1 );
+	const color = nodeX.getNodeByName( 'color' );
+	const geomcolor = nodeX.getNodeByName( 'geomcolor' );
 	const modulated = mul( mul( converted, color ), geomcolor );
 
 	if ( out === 'outa' ) {
@@ -663,12 +690,12 @@ const compileGltfColorImageNode = ( nodeX, out, compileContext ) => {
 
 const compileGltfAnisotropyImageNode = ( nodeX, out, compileContext ) => {
 
-	const { uvNode, textureFile, addressModes } = getTextureInputs( nodeX, compileContext );
-	const defaultInput = nodeX.getNodeByName( 'default' ) || vec3( 1, 0.5, 1 );
+	const { uvNode, textureFile, addressModes } = getTextureInputs( nodeX );
+	const defaultInput = nodeX.getNodeByName( 'default' );
 	const fallback = vec4( element( defaultInput, 0 ), element( defaultInput, 1 ), element( defaultInput, 2 ), 1 );
 	const sampled = sampleTexture( textureFile, uvNode, compileContext, fallback, addressModes, fallback );
-	const anisotropyStrengthFactor = nodeX.getNodeByName( 'anisotropy_strength' ) || float( 1 );
-	const anisotropyRotationFactor = nodeX.getNodeByName( 'anisotropy_rotation' ) || float( 0 );
+	const anisotropyStrengthFactor = nodeX.getNodeByName( 'anisotropy_strength' );
+	const anisotropyRotationFactor = nodeX.getNodeByName( 'anisotropy_rotation' );
 	const encodedDirection = vec2( sub( mul( element( sampled, 0 ), 2 ), 1 ), sub( mul( element( sampled, 1 ), 2 ), 1 ) );
 	const textureRotation = mx_atan2( element( encodedDirection, 1 ), element( encodedDirection, 0 ) );
 	const anisotropyStrengthOut = clamp( mul( anisotropyStrengthFactor, element( sampled, 2 ) ), 0, 1 );
@@ -686,40 +713,37 @@ const compileGltfAnisotropyImageNode = ( nodeX, out, compileContext ) => {
 
 const compileGltfIridescenceThicknessNode = ( nodeX, compileContext ) => {
 
-	const { uvNode, textureFile, addressModes } = getTextureInputs( nodeX, compileContext );
+	const { uvNode, textureFile, addressModes } = getTextureInputs( nodeX );
 	const fallback = vec4( 0, 0, 0, 1 );
 	const sampled = sampleTexture( textureFile, uvNode, compileContext, fallback, addressModes, fallback );
 	const sampledThickness = element( sampled, 0 );
-	const thicknessMin = nodeX.getNodeByName( 'thicknessMin' ) || float( 100 );
-	const thicknessMax = nodeX.getNodeByName( 'thicknessMax' ) || float( 400 );
+	const thicknessMin = nodeX.getNodeByName( 'thicknessMin' );
+	const thicknessMax = nodeX.getNodeByName( 'thicknessMax' );
 	return add( thicknessMin, mul( sampledThickness, sub( thicknessMax, thicknessMin ) ) );
 
 };
 
-const compileTransformMatrixNode = ( nodeX, compileContext ) => {
+const compileTransformMatrixNode = ( nodeX ) => {
 
-	const nodeDefName = nodeX.getAttribute( 'nodedef' );
-	const inNode = nodeX.getNodeByName( 'in' ) || float( 0 );
-	const matrixNode =
-    nodeX.getNodeByName( 'mat' ) ||
-    ( nodeDefName === 'ND_transformmatrix_vector2M3' || nodeDefName === 'ND_transformmatrix_vector3'
-    	? mat3( ...compileContext.IDENTITY_MAT3_VALUES )
-    	: mat4( ...compileContext.IDENTITY_MAT4_VALUES ) );
+	const inputType = nodeX.getNodeDefInputType( 'in' );
+	const matrixType = nodeX.getNodeDefInputType( 'mat' );
+	const inNode = nodeX.getNodeByName( 'in' );
+	const matrixNode = nodeX.getNodeByName( 'mat' );
 
-	if ( nodeDefName === 'ND_transformmatrix_vector2M3' ) {
+	if ( inputType === 'vector2' ) {
 
 		const transformed = mul( matrixNode, vec3( element( inNode, 0 ), element( inNode, 1 ), 1 ) );
 		return vec2( element( transformed, 0 ), element( transformed, 1 ) );
 
 	}
 
-	if ( nodeDefName === 'ND_transformmatrix_vector3' ) {
+	if ( inputType === 'vector3' && matrixType === 'matrix33' ) {
 
 		return mul( matrixNode, vec3( element( inNode, 0 ), element( inNode, 1 ), element( inNode, 2 ) ) );
 
 	}
 
-	if ( nodeDefName === 'ND_transformmatrix_vector3M4' ) {
+	if ( inputType === 'vector3' ) {
 
 		const transformed = mul( matrixNode, vec4( element( inNode, 0 ), element( inNode, 1 ), element( inNode, 2 ), 1 ) );
 		return vec3( element( transformed, 0 ), element( transformed, 1 ), element( transformed, 2 ) );
@@ -734,25 +758,25 @@ const compileCreateMatrixNode = ( nodeX ) => {
 
 	if ( nodeX.type === 'matrix44' ) {
 
-		const vector3Input = nodeX.getAttribute( 'nodedef' ) === 'ND_creatematrix_vector3_matrix44';
-		const toVec4Input = ( name, fallback, w ) => {
+		const vector3Input = nodeX.getNodeDefInputType( 'in1' ) === 'vector3';
+		const toVec4Input = ( name, w ) => {
 
-			const input = nodeX.getNodeByName( name ) || fallback;
+			const input = nodeX.getNodeByName( name );
 			return vector3Input ? vec4( element( input, 0 ), element( input, 1 ), element( input, 2 ), w ) : input;
 
 		};
 
-		const in1 = toVec4Input( 'in1', vector3Input ? vec3( 1, 0, 0 ) : vec4( 1, 0, 0, 0 ), 0 );
-		const in2 = toVec4Input( 'in2', vector3Input ? vec3( 0, 1, 0 ) : vec4( 0, 1, 0, 0 ), 0 );
-		const in3 = toVec4Input( 'in3', vector3Input ? vec3( 0, 0, 1 ) : vec4( 0, 0, 1, 0 ), 0 );
-		const in4 = toVec4Input( 'in4', vector3Input ? vec3( 0, 0, 0 ) : vec4( 0, 0, 0, 1 ), 1 );
+		const in1 = toVec4Input( 'in1', 0 );
+		const in2 = toVec4Input( 'in2', 0 );
+		const in3 = toVec4Input( 'in3', 0 );
+		const in4 = toVec4Input( 'in4', 1 );
 		return mat4( in1, in2, in3, in4 );
 
 	}
 
-	const in1 = nodeX.getNodeByName( 'in1' ) || vec3( 1, 0, 0 );
-	const in2 = nodeX.getNodeByName( 'in2' ) || vec3( 0, 1, 0 );
-	const in3 = nodeX.getNodeByName( 'in3' ) || vec3( 0, 0, 1 );
+	const in1 = nodeX.getNodeByName( 'in1' );
+	const in2 = nodeX.getNodeByName( 'in2' );
+	const in3 = nodeX.getNodeByName( 'in3' );
 	return mat3( in1, in2, in3 );
 
 };
@@ -887,14 +911,11 @@ const compileInvertMatrixNode = ( nodeX, compileContext ) => {
 	const inNode = nodeX.getNodeByName( 'in' );
 	if ( isMatrixType ) {
 
-		const size = matrixType === 'matrix33' ? 3 : 4;
-		const fallback = size === 3 ? mat3( ...compileContext.IDENTITY_MAT3_VALUES ) : mat4( ...compileContext.IDENTITY_MAT4_VALUES );
-		const matrixNode = inNode === undefined || inNode === null ? fallback : inNode;
-		return size === 3 ? compileInvertMatrix3Node( matrixNode ) : compileInvertMatrix4Node( matrixNode );
+		return matrixType === 'matrix33' ? compileInvertMatrix3Node( inNode ) : compileInvertMatrix4Node( inNode );
 
 	}
 
-	return inNode === undefined || inNode === null ? float( 0 ) : inNode;
+	return inNode;
 
 };
 
@@ -916,6 +937,7 @@ function createMaterialXCompileRegistry() {
 	register( registry, [ 'geomcolor' ], ( nodeX ) => compileGeomColorNode( nodeX ) );
 	register( registry, [ 'tiledimage' ], ( nodeX, out, compileContext ) => compileTiledImageNode( nodeX, compileContext ) );
 	register( registry, [ 'image' ], ( nodeX, out, compileContext ) => compileImageLikeNode( nodeX, compileContext ) );
+	register( registry, [ 'triplanarprojection' ], ( nodeX, out, compileContext ) => compileTriplanarProjectionNode( nodeX, compileContext ) );
 	register( registry, [ 'hextiledimage', 'hextilednormalmap' ], ( nodeX, out, compileContext ) =>
 		compileHexTiledTextureNode( nodeX, compileContext, nodeX.element ) );
 	register( registry, [ 'gltf_image', 'gltf_normalmap' ], ( nodeX, out, compileContext ) =>
@@ -926,7 +948,7 @@ function createMaterialXCompileRegistry() {
 	register( registry, [ 'gltf_iridescence_thickness' ], ( nodeX, out, compileContext ) =>
 		compileGltfIridescenceThicknessNode( nodeX, compileContext ) );
 	register( registry, [ 'switch' ], ( nodeX ) => compileSwitchNode( nodeX ) );
-	register( registry, [ 'transformmatrix' ], ( nodeX, out, compileContext ) => compileTransformMatrixNode( nodeX, compileContext ) );
+	register( registry, [ 'transformmatrix' ], compileTransformMatrixNode );
 	register( registry, [ 'creatematrix' ], ( nodeX ) => compileCreateMatrixNode( nodeX ) );
 	register( registry, [ 'invertmatrix' ], ( nodeX, out, compileContext ) => compileInvertMatrixNode( nodeX, compileContext ) );
 	return registry;
@@ -959,31 +981,11 @@ function compileNodeFromRegistry( nodeX, out, compileContext ) {
 	const args = nodeX.getNodesByNames( ...nodeElement.params );
 	for ( let i = 0; i < nodeElement.params.length; i += 1 ) {
 
-		if ( args[ i ] !== undefined && args[ i ] !== null ) {
-
-			continue;
-
-		}
-
-		const paramName = nodeElement.params[ i ];
-		if ( paramName === 'texcoord' && UV_FALLBACK_CATEGORIES.has( nodeX.element ) ) {
-
-			args[ i ] = getDefaultUvNode( compileContext );
-			continue;
-
-		}
-
-		const defaultValue = nodeElement.defaults ? nodeElement.defaults[ paramName ] : undefined;
-		if ( defaultValue !== undefined ) {
-
-			args[ i ] = typeof defaultValue === 'function' ? defaultValue() : float( defaultValue );
-			continue;
-
-		}
+		if ( args[ i ] !== undefined && args[ i ] !== null ) continue;
 
 		nodeX.materialX.log.add(
 			MaterialXLogCodes.INVALID_VALUE,
-			`Missing input "${paramName}" for node "${nodeX.name || nodeX.element}" (${nodeX.element}). Using fallback 0.`,
+			`Missing input "${nodeElement.params[ i ]}" for node "${nodeX.name || nodeX.element}" (${nodeX.element}) and no nodedef default. Using fallback 0.`,
 			nodeX.name,
 		);
 		args[ i ] = float( 0 );