Material Effects
Material effects allow developers to alter the surface properties and visual appearance of 3D models and geometry within an experience.
By adding these effects to an object's material pipeline, you can customize properties like color maps, surface normal depth, holographic projections, engravings, and mirror-like reflections.
Engraving and Emboss Effect for 3D Materials#
The Engraving effect projects high-quality images onto 3D surfaces as embossed or engraved designs, giving assets tangible depth.
It reads a texture file via the textureMediaItemId property and applies depth offsets through the depth parameter, which can be configured to carve inward (negative values) or emboss outward (positive values). Properties under the Texture and Placement groups like colorBlend, feather, proportionalScalar (Scale), textureOffsetX (Center X), textureOffsetY (Center Y), and uvRotation govern the visual blending, positioning, and rotation. Boundaries can be restricted using useBoundaries alongside xBoundaries and yBoundaries ranges, while emissive highlights are customized via emissiveIntensity, emissiveMap, and emissiveColor.
Engraving
AME_ENGRAVING_EFFECTXR_MATERIALXR_UNITEngraving Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
textureMediaItemId: IMediaItem | Material | MEDIA_ITEMELEMENT SELECTOR | "" |
colorBlend: IColor | Color Blend | COLORCOLOR PICKER | [1, 1, 1, 1] |
replaceColor: boolean | Replace Color | BOOLTOGGLE | false |
feather: float | Feather | FLOATRANGE SLIDER | 0.1 |
proportionalScalar: float | Scale | FLOATRANGE SLIDER | 0.5 |
textureOffsetX: float | Center X | FLOATRANGE SLIDER | 0.5 |
textureOffsetY: float | Center Y | FLOATRANGE SLIDER | 0.5 |
uvRotation: float | Rotation | FLOATRANGE SLIDER | 0 |
uvCorrectionAngle: float | Angle Correction | FLOATRANGE SLIDER | 0 |
manualUVScaleX: float | UV Adjust X | FLOATRANGE SLIDER | 1 |
manualUVScaleY: float | UV Adjust Y | FLOATRANGE SLIDER | 1 |
useBoundaries: boolean | Use Bounds | BOOLTOGGLE | false |
xBoundaries: [number, number] | X Bounds | RANGERANGE SLIDER | [0, 1] |
yBoundaries: [number, number] | Y Bounds | RANGERANGE SLIDER | [0, 1] |
fitMode: "none" | "cover" | "contain" | Fit Mode | ENUMDROPDOWN | "none" |
leftBoundAngle: int | leftBoundAngle | INTTEXT INPUT | 0 |
rightBoundAngle: int | rightBoundAngle | INTTEXT INPUT | 0 |
topBoundAngle: int | topBoundAngle | INTTEXT INPUT | 0 |
bottomBoundAngle: int | bottomBoundAngle | INTTEXT INPUT | 0 |
showBoundsOutline: boolean | Show Outline | BOOLTOGGLE | false |
boundsOutlineStyle: "dashed" | "solid" | "dotted" | Line Style | ENUMDROPDOWN | "dashed" |
boundsOutlineThickness: float | Line Thickness | FLOATRANGE SLIDER | 1 |
boundsOutlineColor: IColor | Line Color | COLORCOLOR PICKER | [1, 1, 1, 1] |
uvOffsetX: float | UV Offset X | FLOATRANGE SLIDER | 0 |
uvOffsetY: float | UV Offset Y | FLOATRANGE SLIDER | 0 |
uvScaleX: float | UV Scale X | FLOATRANGE SLIDER | 1 |
uvScaleY: float | UV Scale Y | FLOATRANGE SLIDER | 1 |
depth: float | Depth | FLOATRANGE SLIDER | -0.5 |
color: IColor | Color | COLORCOLOR PICKER | [1, 1, 1, 1] |
colorMix: float | Color Mix | FLOATRANGE SLIDER | 0.5 |
emissiveIntensity: float | Emissive | FLOATRANGE SLIDER | 0 |
emissiveMap: IMediaItem | Emissive Map | MEDIA_ITEMELEMENT SELECTOR | "" |
emissiveColor: IColor | emissiveColor | COLORCOLOR PICKER | [1, 1, 1, 1] |
Material Effect and Surface Texture Mapping#
The Imported Material effect is the standard shader used to project high-fidelity textures onto 3D objects in Aircada.
It supports assigning a primary texture via the materialMediaItemId property, managing compression settings with the defaultImageQuality enum, and layering tint values through overlayColor and overlayColorMap. For advanced surface detail, it utilizes normalScale and displacementScale alongside their corresponding image maps. The positioning and tiling of these assets are customized using the collapsible Scale & Position section, containing uvScaleX, uvScaleY, uvOffsetX, and uvOffsetY scaling properties.
Material
AME_IMPORTED_MATERIALXR_MATERIALXR_UNITMaterial Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
materialMediaItemId: IMediaItem | Material | MEDIA_ITEMELEMENT SELECTOR | "" |
defaultImageQuality: "ORIGINAL" | "TINY" | "LOW" | "MEDIUM" | "HIGH" | "OPTIMIZED" | "KTX2_TINY" | "KTX2_LOW" | "KTX2_MEDIUM" | "KTX2_HIGH" | Quality | ENUMOPTION SELECTOR | "KTX2_MEDIUM" |
overlayColor: IColor | Color | COLORCOLOR PICKER | [1, 1, 1, 1] |
overlayColorMap: IMediaItem | overlayColorMap | MEDIA_ITEMELEMENT SELECTOR | "" |
normalScale: float | Normal | FLOATRANGE SLIDER | 1 |
normalScaleMap: IMediaItem | normalScaleMap | MEDIA_ITEMELEMENT SELECTOR | "" |
displacementScale: float | Displacement | FLOATRANGE SLIDER | 0 |
displacementScaleMap: IMediaItem | displacementScaleMap | MEDIA_ITEMELEMENT SELECTOR | "" |
uvScaleX: float | Scale X | FLOATRANGE SLIDER | 4 |
uvScaleY: float | Scale Y | FLOATRANGE SLIDER | 4 |
uvOffsetX: float | Offset X | FLOATRANGE SLIDER | 0 |
uvOffsetY: float | Offset Y | FLOATRANGE SLIDER | 0 |
Real-Time Reflector and Mirror Material Effect#
The Reflector effect turns static surfaces into interactive mirrors that reflect surrounding environment objects in real-time.
The resolution of the reflection is controlled by resolutionScale, and multiobject bounces can be toggled using bounces. The reflection can be refined using depth-based effects like useDepthMask, useDepthTransparency, and depthFactor. Moving liquid or wavy glass appearances can also be simulated by applying a normal or flow map to distortionTextureMediaItemId and adjusting the intensity and tiling via distortionScale and distortionTiling.
Reflector
AME_REFLECTORXR_MATERIALXR_UNITReflector Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
resolutionScale: float | Resolution Scale | FLOATRANGE SLIDER | 1 |
useDepthMask: boolean | Depth Mask | BOOLTOGGLE | false |
useDepthTransparency: boolean | Depth Transparency | BOOLTOGGLE | false |
depthFactor: float | Depth Factor | FLOATRANGE SLIDER | 1 |
bounces: boolean | Reflects Others | BOOLTOGGLE | false |
distortionTextureMediaItemId: IMediaItem | Normal/Flow Texture | MEDIA_ITEMELEMENT SELECTOR | "" |
distortionScale: float | Distortion Scale | FLOATRANGE SLIDER | 0.01 |
distortionTiling: float | Distortion Tiling | FLOATRANGE SLIDER | 5 |
3D Sticker Decal Projection Material Effect#
The Sticker effect is the main way to put a custom image or decal on any 3D model in Aircada.
It applies a primary graphic to a surface using the textureMediaItemId property, with an option to tint or blend colors through colorBlend and soften edges using feather. Positioning and scaling of the decal are managed interactively via proportionalScalar (Scale), textureOffsetX (Center X), textureOffsetY (Center Y), and uvRotation (Rotation). For complex models, the sticker's boundaries can be restricted using useBoundaries alongside precise bounds controls like xBoundaries, yBoundaries, and orientation angles (leftBoundAngle, rightBoundAngle, topBoundAngle, bottomBoundAngle).
Sticker
ASE_TEXTURE_STICKER_MATERIALFXXR_MATERIALXR_UNITSticker Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
textureMediaItemId: IMediaItem | Material | MEDIA_ITEMELEMENT SELECTOR | "" |
colorBlend: IColor | Color Blend | COLORCOLOR PICKER | [1, 1, 1, 1] |
replaceColor: boolean | Replace Color | BOOLTOGGLE | false |
feather: float | Feather | FLOATRANGE SLIDER | 0.1 |
proportionalScalar: float | Scale | FLOATRANGE SLIDER | 0.5 |
textureOffsetX: float | Center X | FLOATRANGE SLIDER | 0.5 |
textureOffsetY: float | Center Y | FLOATRANGE SLIDER | 0.5 |
uvRotation: float | Rotation | FLOATRANGE SLIDER | 0 |
uvCorrectionAngle: float | Angle Correction | FLOATRANGE SLIDER | 0 |
manualUVScaleX: float | UV Adjust X | FLOATRANGE SLIDER | 1 |
manualUVScaleY: float | UV Adjust Y | FLOATRANGE SLIDER | 1 |
useBoundaries: boolean | Use Bounds | BOOLTOGGLE | false |
xBoundaries: [number, number] | X Bounds | RANGERANGE SLIDER | [0, 1] |
yBoundaries: [number, number] | Y Bounds | RANGERANGE SLIDER | [0, 1] |
fitMode: "none" | "cover" | "contain" | Fit Mode | ENUMDROPDOWN | "none" |
leftBoundAngle: int | leftBoundAngle | INTTEXT INPUT | 0 |
rightBoundAngle: int | rightBoundAngle | INTTEXT INPUT | 0 |
topBoundAngle: int | topBoundAngle | INTTEXT INPUT | 0 |
bottomBoundAngle: int | bottomBoundAngle | INTTEXT INPUT | 0 |
showBoundsOutline: boolean | Show Outline | BOOLTOGGLE | false |
boundsOutlineStyle: "dashed" | "solid" | "dotted" | Line Style | ENUMDROPDOWN | "dashed" |
boundsOutlineThickness: float | Line Thickness | FLOATRANGE SLIDER | 1 |
boundsOutlineColor: IColor | Line Color | COLORCOLOR PICKER | [1, 1, 1, 1] |
uvOffsetX: float | UV Offset X | FLOATRANGE SLIDER | 0 |
uvOffsetY: float | UV Offset Y | FLOATRANGE SLIDER | 0 |
uvScaleX: float | UV Scale X | FLOATRANGE SLIDER | 1 |
uvScaleY: float | UV Scale Y | FLOATRANGE SLIDER | 1 |