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 the name 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;