Class BasicMaterial

A BasicMaterial is for rendering unlit geometry, either using a constant color or a color map modulated with a color.

// Create a new Basic material
const material = new pc.BasicMaterial();

// Set the material to have a texture map that is multiplied by a red color
material.color.set(1, 0, 0);
material.colorMap = diffuseMap;

// Notify the material that it has been modified
material.update();

Hierarchy (View Summary)

Properties

alphaTest alphaToCoverage color colorMap cull name stencilBack stencilFront userId

Accessors

alphaWrite blendState blendType blueWrite depthBias depthFunc depthState depthTest depthWrite greenWrite redWrite shader slopeDepthBias

Methods

clone copy deleteParameter destroy getParameter setParameter update

Properties

alphaTest

alphaTest: number = 0

The alpha test reference value to control which fragments are written to the currently active render target based on alpha value. All fragments with an alpha value of less than the alphaTest reference value will be discarded. alphaTest defaults to 0 (all fragments pass).

alphaToCoverage

alphaToCoverage: boolean = false

Enables or disables alpha to coverage (WebGL2 only). When enabled, and if hardware anti-aliasing is on, limited order-independent transparency can be achieved. Quality depends on the number of MSAA samples of the current render target. It can nicely soften edges of otherwise sharp alpha cutouts, but isn't recommended for large area semi-transparent surfaces. Note, that you don't need to enable blending to make alpha to coverage work. It will work without it, just like alphaTest.

color

color: Color = ...

The flat color of the material (RGBA, where each component is 0 to 1).

colorMap

colorMap: Texture = null

The color map of the material (default is null). If specified, the color map is modulated by the color property.

cull

cull: number = CULLFACE_BACK

Controls how triangles are culled based on their face direction with respect to the viewpoint. Can be:

  • CULLFACE_NONE: Do not cull triangles based on face direction.
  • CULLFACE_BACK: Cull the back faces of triangles (do not render triangles facing away from the view point).
  • CULLFACE_FRONT: Cull the front faces of triangles (do not render triangles facing towards the view point).

Defaults to CULLFACE_BACK.

name

name: string = 'Untitled'

The name of the material.

stencilBack

stencilBack: StencilParameters = null

Stencil parameters for back faces (default is null).

stencilFront

stencilFront: StencilParameters = null

Stencil parameters for front faces (default is null).

userId

userId: string = ''

A unique id the user can assign to the material. The engine internally does not use this for anything, and the user can assign a value to this id for any purpose they like. Defaults to an empty string.

Accessors

alphaWrite

  • get alphaWrite(): boolean

  • Gets whether the alpha channel is written to the color buffer.

    Returns boolean

  • set alphaWrite(value: boolean): void

  • Sets whether the alpha channel is written to the color buffer. If true, the red component of fragments generated by the shader of this material is written to the color buffer of the currently active render target. If false, the alpha component will not be written. Defaults to true.

    Parameters

    • value: boolean

    Returns void

blendState

blendType

blueWrite

  • get blueWrite(): boolean

  • Gets whether the blue channel is written to the color buffer.

    Returns boolean

  • set blueWrite(value: boolean): void

  • Sets whether the blue channel is written to the color buffer. If true, the red component of fragments generated by the shader of this material is written to the color buffer of the currently active render target. If false, the blue component will not be written. Defaults to true.

    Parameters

    • value: boolean

    Returns void

depthBias

  • get depthBias(): number

  • Gets the offset for the output depth buffer value.

    Returns number

  • set depthBias(value: number): void

  • Sets the offset for the output depth buffer value. Useful for decals to prevent z-fighting. Typically a small negative value (-0.1) is used to render the mesh slightly closer to the camera.

    Parameters

    • value: number

    Returns void

depthFunc

depthState

depthTest

  • get depthTest(): boolean

  • Gets whether depth testing is enabled.

    Returns boolean

  • set depthTest(value: boolean): void

  • Sets whether depth testing is enabled. If true, fragments generated by the shader of this material are only written to the current render target if they pass the depth test. If false, fragments generated by the shader of this material are written to the current render target regardless of what is in the depth buffer. Defaults to true.

    Parameters

    • value: boolean

    Returns void

depthWrite

  • get depthWrite(): boolean

  • Gets whether depth writing is enabled.

    Returns boolean

  • set depthWrite(value: boolean): void

  • Sets whether depth writing is enabled. If true, fragments generated by the shader of this material write a depth value to the depth buffer of the currently active render target. If false, no depth value is written. Defaults to true.

    Parameters

    • value: boolean

    Returns void

greenWrite

  • get greenWrite(): boolean

  • Gets whether the green channel is written to the color buffer.

    Returns boolean

  • set greenWrite(value: boolean): void

  • Sets whether the green channel is written to the color buffer. If true, the red component of fragments generated by the shader of this material is written to the color buffer of the currently active render target. If false, the green component will not be written. Defaults to true.

    Parameters

    • value: boolean

    Returns void

redWrite

  • get redWrite(): boolean

  • Gets whether the red channel is written to the color buffer.

    Returns boolean

  • set redWrite(value: boolean): void

  • Sets whether the red channel is written to the color buffer. If true, the red component of fragments generated by the shader of this material is written to the color buffer of the currently active render target. If false, the red component will not be written. Defaults to true.

    Parameters

    • value: boolean

    Returns void

shader

slopeDepthBias

  • get slopeDepthBias(): number

  • Gets the offset for the output depth buffer value based on the slope of the triangle relative to the camera.

    Returns number

  • set slopeDepthBias(value: number): void

  • Sets the offset for the output depth buffer value based on the slope of the triangle relative to the camera.

    Parameters

    • value: number

    Returns void

Methods

clone

copy

deleteParameter

destroy

getParameter

setParameter

update

Settings

Member Visibility

On This Page

Properties
Accessors
Methods