SurfaceAppearance¶
An object that allows developers to override the appearance of a MeshPart with advanced graphics options.
Not implemented yet
PBR surface maps are not rendered.
Workaround: Use a Texture/SpecialMesh with baked colour maps.
Description¶
SurfaceAppearance objects let you override the appearance of a MeshPart with advanced graphics options. Most notably, it can apply a set of Physically‑Based Rendering (PBR) texture images, or maps, on a single object. Combining multiple texture maps can more accurately simulate color, roughness, and reflectivity in any lighting environment and can enhance the visual elements of your assets and environment; see PBR Textures for more details.
Appearance of this object on a MeshPart depends on the user's device and graphics quality level. For best results, you may want to preview your content with different quality level settings.
Note that most SurfaceAppearance properties cannot be modified by scripts, as the necessary pre-processing is usually too expensive during runtime.
Inheritance¶
Object → Instance → SurfaceAppearance
Properties¶
| Member | Signature | Summary |
|---|---|---|
AlphaMode |
AlphaMode: AlphaMode |
Determines how the alpha channel of the SurfaceAppearance.ColorMap is used. |
Color |
Color: Color3 |
Applies a tint to your existing colormap. Set directly with color picker or programmatically with Color3. |
ColorMap |
ColorMap: ContentId |
Determines the color and opacity of the surface. |
ColorMapContent |
ColorMapContent: Content |
Content object that determines the color and opacity of the surface. |
EmissiveMaskContent |
EmissiveMaskContent: Content |
Determines the emissivity across the surface. |
EmissiveStrength |
EmissiveStrength: float |
Determines the strength of emissive contribution. |
EmissiveTint |
EmissiveTint: Color3 |
Determines the tinting color for emissive contribution. |
MetalnessMap |
MetalnessMap: ContentId |
Determines which parts of the surface are metal or non-metal. |
MetalnessMapContent |
MetalnessMapContent: Content |
Content object that determines which parts of the surface are metal or non-metal. |
NormalMap |
NormalMap: ContentId |
Modifies the lighting of the surface by adding bumps, dents, cracks, and curves. |
NormalMapContent |
NormalMapContent: Content |
Content object that modifies the lighting of the surface by adding bumps, dents, cracks, and curves. |
ResampleMode |
ResampleMode: ResamplerMode |
Selects the texture resampling mode used for the surface's texture maps. |
RoughnessMap |
RoughnessMap: ContentId |
Determines the apparent roughness across the surface. |
RoughnessMapContent |
RoughnessMapContent: Content |
Content object that determines the apparent roughness across the surface. |
TexturePack |
TexturePack: ContentId |
— |
TexturePackContent |
TexturePackContent: Content |
Engine-managed Content that stores the compressed runtime texture data for the surface appearance. |
Roblox reference: SurfaceAppearance
Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.