import ColorGeometryInstanceAttribute from "../Core/ColorGeometryInstanceAttribute.js";
|
import defaultValue from "../Core/defaultValue.js";
|
import defined from "../Core/defined.js";
|
import DeveloperError from "../Core/DeveloperError.js";
|
import GeometryInstance from "../Core/GeometryInstance.js";
|
import GeometryPipeline from "../Core/GeometryPipeline.js";
|
import Matrix4 from "../Core/Matrix4.js";
|
import PerInstanceColorAppearance from "./PerInstanceColorAppearance.js";
|
import Primitive from "./Primitive.js";
|
|
/**
|
* Creates a {@link Primitive} to visualize well-known vector vertex attributes:
|
* <code>normal</code>, <code>tangent</code>, and <code>bitangent</code>. Normal
|
* is red; tangent is green; and bitangent is blue. If an attribute is not
|
* present, it is not drawn.
|
*
|
* @function
|
*
|
* @param {Object} options Object with the following properties:
|
* @param {Geometry} options.geometry The <code>Geometry</code> instance with the attribute.
|
* @param {Number} [options.length=10000.0] The length of each line segment in meters. This can be negative to point the vector in the opposite direction.
|
* @param {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] The model matrix that transforms to transform the geometry from model to world coordinates.
|
* @returns {Primitive} A new <code>Primitive</code> instance with geometry for the vectors.
|
*
|
* @example
|
* scene.primitives.add(Cesium.createTangentSpaceDebugPrimitive({
|
* geometry : instance.geometry,
|
* length : 100000.0,
|
* modelMatrix : instance.modelMatrix
|
* }));
|
*/
|
function createTangentSpaceDebugPrimitive(options) {
|
options = defaultValue(options, defaultValue.EMPTY_OBJECT);
|
var instances = [];
|
var geometry = options.geometry;
|
|
//>>includeStart('debug', pragmas.debug);
|
if (!defined(geometry)) {
|
throw new DeveloperError("options.geometry is required.");
|
}
|
//>>includeEnd('debug');
|
|
if (!defined(geometry.attributes) || !defined(geometry.primitiveType)) {
|
// to create the debug lines, we need the computed attributes.
|
// compute them if they are undefined.
|
geometry = geometry.constructor.createGeometry(geometry);
|
}
|
|
var attributes = geometry.attributes;
|
var modelMatrix = Matrix4.clone(
|
defaultValue(options.modelMatrix, Matrix4.IDENTITY)
|
);
|
var length = defaultValue(options.length, 10000.0);
|
|
if (defined(attributes.normal)) {
|
instances.push(
|
new GeometryInstance({
|
geometry: GeometryPipeline.createLineSegmentsForVectors(
|
geometry,
|
"normal",
|
length
|
),
|
attributes: {
|
color: new ColorGeometryInstanceAttribute(1.0, 0.0, 0.0, 1.0),
|
},
|
modelMatrix: modelMatrix,
|
})
|
);
|
}
|
|
if (defined(attributes.tangent)) {
|
instances.push(
|
new GeometryInstance({
|
geometry: GeometryPipeline.createLineSegmentsForVectors(
|
geometry,
|
"tangent",
|
length
|
),
|
attributes: {
|
color: new ColorGeometryInstanceAttribute(0.0, 1.0, 0.0, 1.0),
|
},
|
modelMatrix: modelMatrix,
|
})
|
);
|
}
|
|
if (defined(attributes.bitangent)) {
|
instances.push(
|
new GeometryInstance({
|
geometry: GeometryPipeline.createLineSegmentsForVectors(
|
geometry,
|
"bitangent",
|
length
|
),
|
attributes: {
|
color: new ColorGeometryInstanceAttribute(0.0, 0.0, 1.0, 1.0),
|
},
|
modelMatrix: modelMatrix,
|
})
|
);
|
}
|
|
if (instances.length > 0) {
|
return new Primitive({
|
asynchronous: false,
|
geometryInstances: instances,
|
appearance: new PerInstanceColorAppearance({
|
flat: true,
|
translucent: false,
|
}),
|
});
|
}
|
|
return undefined;
|
}
|
export default createTangentSpaceDebugPrimitive;
|
