import defined from "../Core/defined.js"; import DeveloperError from "../Core/DeveloperError.js"; /** * A model's material with modifiable parameters. A glTF material * contains parameters defined by the material's technique with values * defined by the technique and potentially overridden by the material. * This class allows changing these values at runtime. *
* Use {@link Model#getMaterial} to create an instance. *
* * @alias ModelMaterial * @internalConstructor * @class * * @see Model#getMaterial */ function ModelMaterial(model, material, id) { this._name = material.name; this._id = id; this._uniformMap = model._uniformMaps[id]; this._technique = undefined; this._program = undefined; this._values = undefined; } Object.defineProperties(ModelMaterial.prototype, { /** * The value of thename
property of this material.
*
* @memberof ModelMaterial.prototype
*
* @type {String}
* @readonly
*/
name: {
get: function () {
return this._name;
},
},
/**
* The index of the material.
*
* @memberof ModelMaterial.prototype
*
* @type {String}
* @readonly
*/
id: {
get: function () {
return this._id;
},
},
});
/**
* Assigns a value to a material parameter. The type for value
* depends on the glTF type of the parameter. It will be a floating-point
* number, Cartesian, or matrix.
*
* @param {String} name The name of the parameter.
* @param {*} [value] The value to assign to the parameter.
*
* @exception {DeveloperError} name must match a parameter name in the material's technique that is targetable and not optimized out.
*
* @example
* material.setValue('diffuse', new Cesium.Cartesian4(1.0, 0.0, 0.0, 1.0)); // vec4
* material.setValue('shininess', 256.0); // scalar
*/
ModelMaterial.prototype.setValue = function (name, value) {
//>>includeStart('debug', pragmas.debug);
if (!defined(name)) {
throw new DeveloperError("name is required.");
}
//>>includeEnd('debug');
const uniformName = `u_${name}`;
const v = this._uniformMap.values[uniformName];
//>>includeStart('debug', pragmas.debug);
if (!defined(v)) {
throw new DeveloperError(
"name must match a parameter name in the material's technique that is targetable and not optimized out."
);
}
//>>includeEnd('debug');
v.value = v.clone(value, v.value);
};
/**
* Returns the value of the parameter with the given name
. The type of the
* returned object depends on the glTF type of the parameter. It will be a floating-point
* number, Cartesian, or matrix.
*
* @param {String} name The name of the parameter.
* @returns {*} The value of the parameter or undefined
if the parameter does not exist.
*/
ModelMaterial.prototype.getValue = function (name) {
//>>includeStart('debug', pragmas.debug);
if (!defined(name)) {
throw new DeveloperError("name is required.");
}
//>>includeEnd('debug');
const uniformName = `u_${name}`;
const v = this._uniformMap.values[uniformName];
if (!defined(v)) {
return undefined;
}
return v.value;
};
export default ModelMaterial;