3D Materials & Facades (MaterialFacade)
In Aircada, all primary visual 3D scene objects (such as Shapes, Models, and Text) possess a material property conforming to the MaterialFacade interface. This facade allows developers to dynamically modify surface styling at runtime.
Properties like colors, metallic properties, roughness, and visual transparency can be retrieved or assigned directly on the referenced scene object's material facade.
PBR Material Maps and Asset Configuration#
Aircada materials support multiple specialized texture map coordinates, including colorMap, roughnessMap, metalnessMap, normalMap, and emissiveMap. For maximum performance, these maps should be loaded and managed using native platform systems.
1. The Recommended Approach: Media Registry
It is highly recommended to assign maps using assets uploaded to your project media directory. In your custom Operator classes, declare inputs using the @MediaItemProperty() decorator, or pull pre-compiled media identifiers from the autogenerated media.registry.ts file. This allows Aircada to compile, compress, and deliver images over the high-speed CDN in next-generation GPU-accelerated formats (e.g. KTX2).
2. URL Fallbacks
If dynamic external assets are required, the system will accept a standard external URL string (HTTP/HTTPS) as a map value. The Aircada engine will download the asset and automatically generate a temporary media item under the hood.
Performance Caution: Using raw URLs bypasses the Aircada asset optimization and pre-compression systems. Uncompressed PNG/JPEG files can lead to memory bloat and stuttering on mobile viewports. Always prioritize CDN-based media items for production environments.
MaterialFacade Direct Properties Reference#
The Aircada material system uses a Physically Based Rendering (PBR) model to compute realistic surface lighting. Visual characteristics like clearcoats, index of refraction (IOR), sheen, and transparency are exposed as configurable variables.
These settings map directly to physical shaders, allowing detailed simulation of plastic, metal, glass, fabric, and polished coatings.
Studio Asset Overrides
When applying material properties dynamically to imported 3D models (ModelObjects), ensure the ModelObject has useOriginal: false enabled in Aircada Studio. If useOriginal is true, the embedded baked glTF material takes precedence.
Material Source Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
linkedMaterialId: any | Share From | STRING_ARRAYUNIT SELECTOR | [] |
linkedMaterialType: "INSTANCE" | "COPY" | "LEVELS" | Material Linkage Type | ENUMDROPDOWN | "INSTANCE" |
useLinkedProperties: boolean | Use Linked Properties | BOOLTOGGLE | true |
colorMap: IMediaItem | Texture | MEDIA_ITEMELEMENT SELECTOR | "" |
color: IColor | Color | COLORCOLOR PICKER | [1, 1, 1, 1] |
isTransparent: boolean | isTransparent | BOOLTOGGLE | false |
opacity: float | Opacity | FLOATRANGE SLIDER | 1 |
alphaMap: IMediaItem | alphaMap | MEDIA_ITEMELEMENT SELECTOR | "" |
roughness: float | Roughness | FLOATRANGE SLIDER | 0.5 |
roughnessMap: IMediaItem | roughnessMap | MEDIA_ITEMELEMENT SELECTOR | "" |
metalness: float | Metalness | FLOATRANGE SLIDER | 0 |
metalnessMap: IMediaItem | metalnessMap | MEDIA_ITEMELEMENT SELECTOR | "" |
envMapIntensity: float | Env Map | FLOATRANGE SLIDER | 1 |
envMap: IMediaItem | envMap | MEDIA_ITEMELEMENT SELECTOR | "" |
useCustomEnvRotation: boolean | Custom Env Rotation | BOOLTOGGLE | false |
envMapRotationY: float | Rotation | FLOATRANGE SLIDER | 0 |
envMapRotationX: float | Tilt | FLOATRANGE SLIDER | 0 |
bumpScale: float | Bump Scale | FLOATRANGE SLIDER | 0 |
bumpMap: IMediaItem | bumpMap | MEDIA_ITEMELEMENT SELECTOR | "" |
normalScale: float | Normal Scale | FLOATRANGE SLIDER | 1 |
normalMap: IMediaItem | normalMap | MEDIA_ITEMELEMENT SELECTOR | "" |
aoMapIntensity: float | AO | FLOATRANGE SLIDER | 1 |
aoMap: IMediaItem | aoMap | MEDIA_ITEMELEMENT SELECTOR | "" |
transmission: float | Transmission | FLOATRANGE SLIDER | 0 |
transmissionMap: IMediaItem | transmissionMap | MEDIA_ITEMELEMENT SELECTOR | "" |
thickness: float | Thickness | FLOATRANGE SLIDER | 0 |
thicknessMap: IMediaItem | thicknessMap | MEDIA_ITEMELEMENT SELECTOR | "" |
dispersion: float | Dispersion | FLOATRANGE SLIDER | 0 |
dispersionMap: IMediaItem | dispersionMap | MEDIA_ITEMELEMENT SELECTOR | "" |
ior: float | IOR | FLOATRANGE SLIDER | 1.5 |
iorMap: IMediaItem | iorMap | MEDIA_ITEMELEMENT SELECTOR | "" |
sheen: float | Sheen | FLOATRANGE SLIDER | 0 |
sheenColorMap: IMediaItem | sheenColorMap | MEDIA_ITEMELEMENT SELECTOR | "" |
sheenColor: IColor | Sheen Color | COLORCOLOR PICKER | [1, 1, 1, 1] |
sheenRoughness: float | Roughness | FLOATRANGE SLIDER | 0 |
sheenRoughnessMap: IMediaItem | sheenRoughnessMap | MEDIA_ITEMELEMENT SELECTOR | "" |
specularIntensity: float | Specular | FLOATRANGE SLIDER | 1 |
specularColor: IColor | specularColor | COLORCOLOR PICKER | [1, 1, 1, 1] |
specularColorMap: any | specularColorMap | NONE | "" |
emissiveIntensity: float | Emissive | FLOATRANGE SLIDER | 0 |
emissiveMap: IMediaItem | Emissive Map | MEDIA_ITEMELEMENT SELECTOR | "" |
emissive: IColor | emissive | COLORCOLOR PICKER | [1, 1, 0.8, 1] |
attenuationDistance: float | Attenuation | FLOATRANGE SLIDER | 0 |
attenuationDistanceMap: IMediaItem | attenuationDistanceMap | MEDIA_ITEMELEMENT SELECTOR | "" |
attenuationColor: IColor | attenuationColor | COLORCOLOR PICKER | [0, 0.9, 1, 1] |
clearcoat: float | Clearcoat | FLOATRANGE SLIDER | 0 |
clearcoatMap: IMediaItem | clearcoatMap | MEDIA_ITEMELEMENT SELECTOR | "" |
clearcoatNormalScale: float | Normal | FLOATRANGE SLIDER | 1 |
clearcoatNormalMap: IMediaItem | clearcoatNormalMap | MEDIA_ITEMELEMENT SELECTOR | "" |
clearcoatRoughness: float | Clearcoat Roughness | FLOATRANGE SLIDER | 0 |
clearcoatRoughnessMap: IMediaItem | clearcoatRoughnessMap | MEDIA_ITEMELEMENT SELECTOR | "" |
iridescence: float | Iridescence | FLOATRANGE SLIDER | 0 |
iridescenceMap: IMediaItem | iridescenceMap | MEDIA_ITEMELEMENT SELECTOR | "" |
iridescenceThickness: float | Thickness | FLOATRANGE SLIDER | 400 |
iridescenceThicknessMap: IMediaItem | iridescenceThicknessMap | MEDIA_ITEMELEMENT SELECTOR | "" |
iridescenceIOR: float | IOR | FLOATRANGE SLIDER | 1.3 |
iridescenceIORMap: IMediaItem | iridescenceIORMap | MEDIA_ITEMELEMENT SELECTOR | "" |
displacementScale: float | Displacement | FLOATRANGE SLIDER | 0 |
displacementMap: IMediaItem | displacementMap | MEDIA_ITEMELEMENT SELECTOR | "" |
displacementBias: float | Displacement Bias | FLOATRANGE SLIDER | 0 |
side: "FRONT" | "BACK" | "DOUBLE" | Side | ENUMDROPDOWN | "FRONT" |
wrappingType: "REPEAT" | "CLAMP" | "MIRROR" | Wrapping | ENUMDROPDOWN | "REPEAT" |
uvScaleX: float | Scale X | FLOATRANGE SLIDER | 1 |
uvScaleY: float | Scale Y | FLOATRANGE SLIDER | 1 |
uvOffsetX: float | Offset X | FLOATRANGE SLIDER | 0 |
uvOffsetY: float | Offset Y | FLOATRANGE SLIDER | 0 |
autoScaleUV: boolean | Auto-Scale | BOOLTOGGLE | false |
autoScaleAdjustment: float | Auto-Scale Amount | FLOATRANGE SLIDER | 1 |
autoScaleTextureProperty: "colorMap" | "alphaMap" | "alphaTestMap" | "roughnessMap" | "metalnessMap" | "envMap" | "bumpMap" | "iorMap" | "transmissionMap" | "thicknessMap" | "dispersionMap" | "specularColorMap" | "sheenColorMap" | "sheenRoughnessMap" | "iridescenceMap" | "iridescenceThicknessMap" | "iridescenceIORMap" | "emissiveMap" | "clearcoatMap" | "clearcoatRoughnessMap" | "clearcoatNormalMap" | "attenuationDistanceMap" | "normalMap" | "aoMap" | "displacementMap" | Aspect Based On | ENUMDROPDOWN | "colorMap" |
autoScaleType: "IMAGE_SIZE" | "WIDTH" | "HEIGHT" | Scale Based On | ENUMDROPDOWN | "IMAGE_SIZE" |
autoScalePlane: "XY" | "XZ" | "YZ" | Scale Plane | ENUMDROPDOWN | "XY" |
defaultImageQuality: "ORIGINAL" | "TINY" | "LOW" | "MEDIUM" | "HIGH" | "OPTIMIZED" | "KTX2_TINY" | "KTX2_LOW" | "KTX2_MEDIUM" | "KTX2_HIGH" | Default Image Quality | ENUMDROPDOWN | "OPTIMIZED" |
alphaTest: float | Alpha Test | FLOATRANGE SLIDER | 0.11 |
alphaTestMap: IMediaItem | alphaTestMap | MEDIA_ITEMELEMENT SELECTOR | "" |
wireframe: boolean | Wireframe | BOOLTOGGLE | false |
polygonOffset: boolean | Polygon Offset | BOOLTOGGLE | false |
polygonOffsetFactor: float | Polygon Offset Factor | FLOATRANGE SLIDER | -4 |