DebugAppearance

new Cesium.DebugAppearance(options)
engine/Source/Scene/DebugAppearance.js 35

Visualizes a vertex attribute by displaying it as a color for debugging.

Components for well-known unit-length vectors, i.e., normal, tangent, and bitangent, are scaled and biased from [-1.0, 1.0] to (-1.0, 1.0).

Name Type Description
options Object Object with the following properties:
Name Type Default Description
attributeName String The name of the attribute to visualize.
perInstanceAttribute Boolean false optional Boolean that determines whether this attribute is a per-instance geometry attribute.
glslDatatype String 'vec3' optional The GLSL datatype of the attribute. Supported datatypes are float, vec2, vec3, and vec4.
vertexShaderSource String optional Optional GLSL vertex shader source to override the default vertex shader.
fragmentShaderSource String optional Optional GLSL fragment shader source to override the default fragment shader.
renderState Object optional Optional render state to override the default render state.
Throws:
  • DeveloperError : options.glslDatatype must be float, vec2, vec3, or vec4.
Example:
const primitive = new Cesium.Primitive({
  geometryInstances : // ...
  appearance : new Cesium.DebugAppearance({
    attributeName : 'normal'
  })
});

Members

readonly attributeName : String
engine/Source/Scene/DebugAppearance.js 217

The name of the attribute being visualized.

readonly closed : Boolean
engine/Source/Scene/DebugAppearance.js 203

When true, the geometry is expected to be closed.
Default Value: false

readonly fragmentShaderSource : String
engine/Source/Scene/DebugAppearance.js 173

The GLSL source code for the fragment shader. The full fragment shader source is built procedurally taking into account the DebugAppearance#material. Use DebugAppearance#getFragmentShaderSource to get the full source.

readonly glslDatatype : String
engine/Source/Scene/DebugAppearance.js 231

The GLSL datatype of the attribute being visualized.

material : Material
engine/Source/Scene/DebugAppearance.js 122

This property is part of the Appearance interface, but is not used by DebugAppearance since a fully custom fragment shader is used.
Default Value: undefined

readonly renderState : Object
engine/Source/Scene/DebugAppearance.js 187

The WebGL fixed-function state to use when rendering the geometry.

translucent : Boolean
engine/Source/Scene/DebugAppearance.js 131

When true, the geometry is expected to appear translucent.
Default Value: false

readonly vertexShaderSource : String
engine/Source/Scene/DebugAppearance.js 157

The GLSL source code for the vertex shader.

Methods

getFragmentShaderSource() → String
engine/Source/Scene/DebugAppearance.js 246

Returns the full GLSL fragment shader source, which for DebugAppearance is just DebugAppearance#fragmentShaderSource.
Returns:
The full GLSL fragment shader source.

getRenderState() → Object
engine/Source/Scene/DebugAppearance.js 267

Creates a render state. This is not the final render state instance; instead, it can contain a subset of render state properties identical to the render state created in the context.
Returns:
The render state.

isTranslucent() → Boolean
engine/Source/Scene/DebugAppearance.js 256

Determines if the geometry is translucent based on DebugAppearance#translucent.
Returns:
true if the appearance is translucent.
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
packages/engine
packages/widgets