Source: extern/material.js

  1. import register from "../util/register.js";
  3. import m_batch_fact from "../intern/batch.js";
  4. import m_cfg_fact from "../intern/config.js";
  5. import m_geom_fact from "../intern/geometry.js";
  6. import m_obj_fact from "../intern/objects.js";
  7. import m_obj_util_fact from "../intern/obj_util.js";
  8. import m_print_fact from "../intern/print.js";
  9. import m_shaders_fact from "../intern/shaders.js";
  10. import * as m_util from "../intern/util.js";
  11. import m_scenes_fact from "../intern/scenes.js";
  13. /**
  14.  * Material API.
  15.  * Contains methods to control parameters of materials.
  16.  * @module material
  17.  * @local LineParams
  18.  * @local MaterialExtParams
  19.  * @local WaterMaterialParams
  20.  */
  21. function Material(ns, exports) {
  23. var m_batch    = m_batch_fact(ns);
  24. var m_cfg      = m_cfg_fact(ns);
  25. var m_geom     = m_geom_fact(ns);
  26. var m_obj      = m_obj_fact(ns);
  27. var m_obj_util = m_obj_util_fact(ns);
  28. var m_print    = m_print_fact(ns);
  29. var m_shaders  = m_shaders_fact(ns);
  30. var m_scenes   = m_scenes_fact(ns);
  32. var cfg_def = m_cfg.defaults;
  34. /**
  35.  * Line params.
  36.  * @typedef {Object} LineParams
  37.  * @property {RGBA} [color] Line diffuse color
  38.  * @property {number} [width] Line width in pixels
  39.  * @cc_externs color width
  40.  */
  42. /**
  43.  * Additional group of parameters for a non-node material.
  44.  * @typedef {Object} MaterialExtParams
  45.  * @property {number} [fresnel] Power of Fresnel for mirror reflection.
  46.  * @property {number} [fresnel_factor] Blending factor for Fresnel.
  47.  * @property {number} [parallax_scale] Scale parameter for texture wrapping. 
  48.  * Available if the parallax effect is enabled on the material's normal map texture.
  49.  * @property {number} [parallax_steps] Number of steps taken to build a parallax surface.
  50.  * Available if the parallax effect is enabled on the material's normal map texture.
  51.  * @property {number} [reflect_factor] Amount of mirror reflection.
  52.  * @cc_externs fresnel fresnel_factor parallax_scale parallax_steps reflect_factor
  53.  */
  55. /**
  56.  * Parameters for a water material.
  57.  * @typedef {Object} WaterMaterialParams
  58.  * @property {boolean} [shore_smoothing] Perform the smoothing between the water 
  59.  * and the shore objects. Can be used only for Add, Alpha Blend and Alpha Sort 
  60.  * materials.
  61.  * @property {number} [absorb_factor] Water absorb factor. Used only if the 
  62.  * "shore_smoothing" parameter is true for this material.
  63.  * @property {number} [foam_factor] Water foam intensity factor. Can be used if 
  64.  * there is a foam texture in this material.
  65.  * @property {RGB} [shallow_water_col] Color of the shallow water.
  66.  * @property {RGB} [shore_water_col] Color of the shore water.
  67.  * @property {number} [shallow_water_col_fac] Shallow water color factor.
  68.  * @property {number} [shore_water_col_fac] Shore water color factor.
  69.  * @property {number} [norm_uv_velocity] Water normalmap UV velocity. Can be used 
  70.  * if there is a normalmap texture in this material.
  71.  * @property {boolean} [water_dynamic] Dynamic water surface. If disabled in the 
  72.  * blend-file, then this option cannot be enabled via API.
  73.  * @property {number} [sss_strength] Strength of subsurface scattering. Used if 
  74.  * the "water_dynamic" parameter is true.
  75.  * @property {number} [sss_width] Width of subsurface scattering. Used if the 
  76.  * "water_dynamic" parameter is true.
  77.  * @property {number} [waves_height] Waves height. Used if the "water_dynamic" 
  78.  * parameter is true.
  79.  * @property {number} [waves_length] Waves length. Used if the "water_dynamic" 
  80.  * parameter is true.
  81.  * @property {number} [dst_noise_scale0] Distant waves noise scale (first 
  82.  * component). Used if the "water_dynamic" parameter is true.
  83.  * @property {number} [dst_noise_scale1] Distant waves noise scale (second 
  84.  * component). Used if the "water_dynamic" parameter is true.
  85.  * @property {number} [dst_noise_freq0] Distant waves noise frequency (first 
  86.  * component). Used if the "water_dynamic" parameter is true.
  87.  * @property {number} [dst_noise_freq1] Distant waves noise frequency (second 
  88.  * component). Used if the "water_dynamic" parameter is true.
  89.  * @property {number} [dir_min_shore_fac] Minimum shore factor for directional 
  90.  * waves. Used if the "water_dynamic" parameter is true.
  91.  * @property {number} [dir_freq] Directional waves frequency. Used if the 
  92.  * "water_dynamic" parameter is true.
  93.  * @property {number} [dir_noise_scale] Directional waves noise scale. Used if the 
  94.  * "water_dynamic" parameter is true.
  95.  * @property {number} [dir_noise_freq] Directional waves noise frequency. Used if 
  96.  * the"water_dynamic" parameter is true.
  97.  * @property {number} [dir_min_noise_fac] Directional waves minimum noise factor. 
  98.  * Used if the "water_dynamic" parameter is true.
  99.  * @property {number} [dst_min_fac] Distant waves min factor. Used if the
  100.  * "water_dynamic" parameter is true.
  101.  * @property {number} [waves_hor_fac] Strength of horizontal waves inclination. 
  102.  * Used if the "water_dynamic" parameter is true.
  103.  * @cc_externs shore_smoothing absorb_factor foam_factor shallow_water_col 
  104.  * @cc_externs shore_water_col shallow_water_col_fac shore_water_col_fac 
  105.  * @cc_externs sss_strength sss_width norm_uv_velocity water_dynamic 
  106.  * @cc_externs waves_height waves_length dst_noise_scale0 dst_noise_scale1 
  107.  * @cc_externs dst_noise_freq0 dst_noise_freq1 dir_min_shore_fac dir_freq 
  108.  * @cc_externs dir_noise_scale dir_noise_freq dir_min_noise_fac dst_min_fac 
  109.  * @cc_externs waves_hor_fac 
  110.  */
  112. /**
  113.  * Inherit the batch material from another object.
  114.  * @method module:material.inherit_material
  115.  * @param {Object3D} obj_from Source Object 3D
  116.  * @param {string} mat_from_name Source material name
  117.  * @param {Object3D} obj_to Destination Object 3D
  118.  * @param {string} mat_to_name Destination material name
  119.  * @example 
  120.  * var m_mat = require("material");
  121.  * var m_scenes = require("scenes");
  122.  *
  123.  * var cube = m_scenes.get_object_by_name("Cube");
  124.  * var cube_001 = m_scenes.get_object_by_name("Cube.001");
  125.  * m_mat.inherit_material(cube, "MyMaterial_1", cube_001, "MyMaterial_2");
  126.  */
  127. exports.inherit_material = function(obj_from, mat_from_name, obj_to, mat_to_name) {
  128.     if (!m_geom.has_dyn_geom(obj_to) || !m_geom.has_dyn_geom(obj_from)) {
  129.         m_print.error("inherit_material(): both objects \"" 
  130.                 + obj_from.origin_name + "\" and \"" + obj_to.origin_name 
  131.                 + "\" must have the \"Dynamic Geometry & Materials\" flag enabled.");
  132.         return;
  133.     }
  135.     var bpy_mat_from_index = obj_from.mat_inheritance_data.original_mat_names.indexOf(mat_from_name);
  136.     if (bpy_mat_from_index == -1) {
  137.         m_print.error("inherit_material(): material \"" + mat_from_name 
  138.                 + "\" not found on the object \"" + obj_from.origin_name + "\".");
  139.         return;   
  140.     }
  142.     var bpy_mat_to_index = obj_to.mat_inheritance_data.original_mat_names.indexOf(mat_to_name);
  143.     if (bpy_mat_to_index == -1) {
  144.         m_print.error("inherit_material(): material \"" + mat_to_name 
  145.                 + "\" not found on the object \"" + obj_to.origin_name + "\".");
  146.         return;   
  147.     }
  149.     if (obj_to._bpy_obj["data"]["submeshes"][bpy_mat_to_index]["shade_tangs"].length == 0 
  150.             && obj_from.materials[bpy_mat_from_index].use_tangent_shading) {
  151.         m_print.warn("The target material \"" + mat_to_name + "\" was exported " 
  152.                 + "without tangent shading data. However, the \"" + mat_from_name 
  153.                 + "\" material requires it. It's needed to enable the \"Tangent Shading\" " 
  154.                 + "option on the target material for correct rendering.");
  155.     }
  157.     m_obj.inherit_material(obj_from, mat_from_name, obj_to, mat_to_name);
  158. }
  160. /**
  161.  * Get materials' names for the given object.
  162.  * @method module:material.get_materials_names
  163.  * @param {Object3D} obj Object 3D
  164.  * @returns {string[]} Array of materials' names
  165.  * @example var m_scenes = require("scenes");
  166.  * var m_mat = require("material");
  167.  *
  168.  * var cube = m_scenes.get_object_by_name("Cube");
  169.  * var material_list = m_mat.get_materials_names(cube);
  170.  */
  171. exports.get_materials_names = function(obj) {
  173.     var mat_names = [];
  175.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  176.         m_print.error("get_materials_names(): Object \"" + obj.name 
  177.                 + "\" is not a dynamic MESH.");
  178.         return mat_names;
  179.     }
  181.     var scenes_data = obj.scenes_data;
  182.     for (var i = 0; i < scenes_data.length; i++) {
  183.         var batches = scenes_data[i].batches;
  184.         for (var j = 0; j < batches.length; j++) {
  185.             var batch = batches[j];
  186.             if (batch.type == "MAIN")
  187.                 for (var k = 0; k < batch.material_names.length; k++)
  188.                     if (mat_names.indexOf(batch.material_names[k]) == -1)
  189.                         mat_names.push(batch.material_names[k]);
  190.         }
  191.     }
  193.     return mat_names;
  194. }
  196. /**
  197.  * Set the diffuse color and alpha for the object non-node material.
  198.  * @method module:material.set_diffuse_color
  199.  * @param {Object3D} obj Object 3D 
  200.  * @param {string} mat_name Material name
  201.  * @param {RGBA} color Color+alpha vector
  202.  * @example 
  203.  * var m_mat = require("material");
  204.  * var m_scenes = require("scenes");
  205.  * var m_rgba = require("rgba");
  206.  *
  207.  * var cube = m_scenes.get_object_by_name("Cube");
  208.  * m_mat.set_diffuse_color(cube, "MyMaterial", m_rgba.from_values(1.0, 0.0, 0.0, 1.0));
  209.  */
  210. exports.set_diffuse_color = function(obj, mat_name, color) {
  212.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  213.         m_print.error("set_diffuse_color(): Object \"" + obj.name 
  214.                 + "\" is not a dynamic MESH.");
  215.         return;
  216.     }
  218.     // TODO: check why there is only MAIN
  219.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  220.     if (!batch) {
  221.         m_print.error("set_diffuse_color(): Material \"" + mat_name 
  222.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  223.         return;
  224.     }
  226.     if (batch.has_nodes) {
  227.         m_print.error("set_diffuse_color(): Not allowed for node materials! " 
  228.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  229.         return;
  230.     }
  232.     batch.diffuse_color.set(color);
  233.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  234.     if (reflect_batch)
  235.         reflect_batch.diffuse_color.set(color);
  236. }
  238. /**
  239.  * Get the diffuse color and alpha for the object non-node material.
  240.  * @method module:material.get_diffuse_color
  241.  * @param {Object3D} obj Object 3D 
  242.  * @param {string} mat_name Material name
  243.  * @returns {RGBA} Material diffuse color+alpha
  244.  * @example var m_scenes = require("scenes");
  245.  * var m_mat = require("material");
  246.  *
  247.  * var cube = m_scenes.get_object_by_name("Cube");
  248.  * var diffuse_color = m_mat.get_diffuse_color(cube, "MyMaterial");
  249.  */
  250. exports.get_diffuse_color = function(obj, mat_name) {
  252.     var color = new Float32Array(4);
  254.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  255.         m_print.error("get_diffuse_color(): Object \"" + obj.name 
  256.                 + "\" is not a dynamic MESH.");
  257.         return color;
  258.     }
  260.     // TODO: check why there is only MAIN
  261.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  262.     if (!batch) {
  263.         m_print.error("get_diffuse_color(): Material \"" + mat_name 
  264.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  265.         return color;
  266.     }
  268.     if (batch.has_nodes) {
  269.         m_print.error("get_diffuse_color(): Not allowed for node materials! " 
  270.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  271.         return color;
  272.     }
  274.     color.set(batch.diffuse_color);
  275.     return color;
  276. }
  278. /**
  279.  * Set the diffuse color intensity for the object non-node material.
  280.  * @method module:material.set_diffuse_intensity
  281.  * @param {Object3D} obj Object 3D 
  282.  * @param {string} mat_name Material name
  283.  * @param {number} intensity Diffuse intensity value
  284.  * @example var m_scenes = require("scenes");
  285.  * var m_mat = require("material");
  286.  *
  287.  * var cube = m_scenes.get_object_by_name("Cube");
  288.  * m_mat.set_diffuse_intensity(cube, "MyMaterial", 0.5);
  289.  */
  290. exports.set_diffuse_intensity = function(obj, mat_name, intensity) {
  292.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  293.         m_print.error("set_diffuse_intensity(): Object \"" + obj.name 
  294.                 + "\" is not a dynamic MESH.");
  295.         return;
  296.     }
  298.     // TODO: check why there is only MAIN
  299.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  300.     if (!batch) {
  301.         m_print.error("set_diffuse_intensity(): Material \"" + mat_name 
  302.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  303.         return;
  304.     }
  306.     if (batch.has_nodes) {
  307.         m_print.error("set_diffuse_intensity(): Not allowed for node materials! " 
  308.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  309.         return;
  310.     }
  312.     batch.diffuse_intensity = intensity;
  313.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  314.     if (reflect_batch)
  315.         reflect_batch.diffuse_intensity = intensity;
  316. }
  318. /**
  319.  * Get the diffuse color intensity for the object non-node material.
  320.  * @method module:material.get_diffuse_intensity
  321.  * @param {Object3D} obj Object 3D 
  322.  * @param {string} mat_name Material name
  323.  * @returns {number} Diffuse intensity value
  324.  * @example var m_scenes = require("scenes");
  325.  * var m_mat = require("material");
  326.  *
  327.  * var cube = m_scenes.get_object_by_name("Cube");
  328.  * var diffuse_intensity = m_mat.get_diffuse_intensity(cube, "MyMaterial");
  329.  */
  330. exports.get_diffuse_intensity = function(obj, mat_name) {
  332.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  333.         m_print.error("get_diffuse_intensity(): Object \"" + obj.name 
  334.                 + "\" is not a dynamic MESH.");
  335.         return 0;
  336.     }
  338.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  339.     if (!batch) {
  340.         m_print.error("get_diffuse_intensity(): Material \"" + mat_name 
  341.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  342.         return 0;
  343.     }
  345.     if (batch.has_nodes) {
  346.         m_print.error("get_diffuse_intensity(): Not allowed for node materials! " 
  347.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  348.         return 0;
  349.     }
  351.     return batch.diffuse_intensity;
  352. }
  354. /**
  355.  * Set the specular color for the object non-node material.
  356.  * @method module:material.set_specular_color
  357.  * @param {Object3D} obj Object 3D 
  358.  * @param {string} mat_name Material name
  359.  * @param {RGB} color Color vector
  360.  * @example 
  361.  * var m_mat = require("material");
  362.  * var m_scenes = require("scenes");
  363.  *
  364.  * var cube = m_scenes.get_object_by_name("Cube");
  365.  * m_mat.set_specular_color(cube, "MyMaterial", [0, 0.8, 0]);
  366.  */
  367. exports.set_specular_color = function(obj, mat_name, color) {
  369.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  370.         m_print.error("set_specular_color(): Object \"" + obj.name 
  371.                 + "\" is not a dynamic MESH.");
  372.         return;
  373.     }
  375.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  376.     if (!batch) {
  377.         m_print.error("set_specular_color(): Material \"" + mat_name 
  378.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  379.         return;
  380.     }
  382.     if (batch.has_nodes) {
  383.         m_print.error("set_specular_color(): Not allowed for node materials! " 
  384.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  385.         return;
  386.     }
  388.     batch.specular_color.set(color);
  389.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  390.     if (reflect_batch)
  391.         reflect_batch.specular_color.set(color);
  392. }
  394. /**
  395.  * Get the specular color for the object non-node material.
  396.  * @method module:material.get_specular_color
  397.  * @param {Object3D} obj Object 3D 
  398.  * @param {string} mat_name Material name
  399.  * @returns {RGB} Specular color
  400.  * @example var m_scenes = require("scenes");
  401.  * var m_mat = require("material");
  402.  *
  403.  * var cube = m_scenes.get_object_by_name("Cube");
  404.  * var specular_color = m_mat.get_specular_color(cube, "MyMaterial");
  405.  */
  406. exports.get_specular_color = function(obj, mat_name) {
  408.     var color = new Float32Array(3);
  410.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  411.         m_print.error("get_specular_color(): Object \"" + obj.name 
  412.                 + "\" is not a dynamic MESH.");
  413.         return color;
  414.     }
  416.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  417.     if (!batch) {
  418.         m_print.error("get_specular_color(): Material \"" + mat_name 
  419.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  420.         return color;
  421.     }
  423.     if (batch.has_nodes) {
  424.         m_print.error("get_specular_color(): Not allowed for node materials! " 
  425.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  426.         return color;
  427.     }
  429.     color.set(batch.specular_color);
  430.     return color;
  431. }
  433. /**
  434.  * Set the specular color factor for the object non-node material.
  435.  * @method module:material.set_specular_color_factor
  436.  * @param {Object3D} obj Object 3D 
  437.  * @param {string} mat_name Material name
  438.  * @param {number} factor Specular color factor
  439.  * @example var m_scenes = require("scenes");
  440.  * var m_mat = require("material");
  441.  *
  442.  * var cube = m_scenes.get_object_by_name("Cube");
  443.  * m_mat.set_specular_color_factor(cube, "MyMaterial", 0.8);
  444.  */
  445. exports.set_specular_color_factor = function(obj, mat_name, factor) {
  447.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  448.         m_print.error("set_specular_color_factor(): Object \"" + obj.name 
  449.                 + "\" is not a dynamic MESH.");
  450.         return;
  451.     }
  453.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  454.     if (!batch) {
  455.         m_print.error("set_specular_color_factor(): Material \"" + mat_name 
  456.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  457.         return;
  458.     }
  460.     if (batch.has_nodes) {
  461.         m_print.error("set_specular_color_factor(): Not allowed for node materials! " 
  462.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  463.         return;
  464.     }
  466.     batch.specular_color_factor = factor;
  467.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  468.     if (reflect_batch)
  469.         reflect_batch.specular_color_factor = factor;
  470. }
  472. /**
  473.  * Get the specular color factor for the object non-node material.
  474.  * @method module:material.get_specular_color_factor
  475.  * @param {Object3D} obj Object 3D 
  476.  * @param {string} mat_name Material name
  477.  * @returns {number} Specular color factor
  478.  * @example var m_scenes = require("scenes");
  479.  * var m_mat = require("material");
  480.  *
  481.  * var cube = m_scenes.get_object_by_name("Cube");
  482.  * var specular_color_factor = m_mat.get_specular_color_factor(cube, "MyMaterial");
  483.  */
  484. exports.get_specular_color_factor = function(obj, mat_name) {
  486.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  487.         m_print.error("get_specular_color_factor(): Object \"" + obj.name 
  488.                 + "\" is not a dynamic MESH.");
  489.         return 0;
  490.     }
  492.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  493.     if (!batch) {
  494.         m_print.error("get_specular_color_factor(): Material \"" + mat_name 
  495.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  496.         return 0;
  497.     }
  499.     if (batch.has_nodes) {
  500.         m_print.error("get_specular_color_factor(): Not allowed for node materials! " 
  501.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  502.         return 0;
  503.     }
  505.     return batch.specular_color_factor;
  506. }
  508. /**
  509.  * Set the specular color intensity for the object non-node material.
  510.  * @method module:material.set_specular_intensity
  511.  * @param {Object3D} obj Object 3D 
  512.  * @param {string} mat_name Material name
  513.  * @param {number} intensity Specular intensity value
  514.  * @example 
  515.  * var m_mat = require("material");
  516.  * var m_scenes = require("scenes");
  517.  *
  518.  * var cube = m_scenes.get_object_by_name("Cube");
  519.  * m_mat.set_specular_intensity(cube, "MyMaterial", 0.7);
  520.  */
  521. exports.set_specular_intensity = function(obj, mat_name, intensity) {
  523.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  524.         m_print.error("set_specular_intensity(): Object \"" + obj.name 
  525.                 + "\" is not a dynamic MESH.");
  526.         return;
  527.     }
  529.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  530.     if (!batch) {
  531.         m_print.error("set_specular_intensity(): Material \"" + mat_name 
  532.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  533.         return;
  534.     }
  536.     if (batch.has_nodes) {
  537.         m_print.error("set_specular_intensity(): Not allowed for node materials! " 
  538.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  539.         return;
  540.     }
  542.     batch.specular_params[0] = intensity;
  543.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  544.     if (reflect_batch)
  545.         reflect_batch.specular_params[0] = intensity;
  546. }
  548. /**
  549.  * Get the specular color intensity for the object non-node material.
  550.  * @method module:material.get_specular_intensity
  551.  * @param {Object3D} obj Object 3D 
  552.  * @param {string} mat_name Material name
  553.  * @returns {number} Specular color intensity
  554.  * @example var m_scenes = require("scenes");
  555.  * var m_mat = require("material");
  556.  *
  557.  * var cube = m_scenes.get_object_by_name("Cube");
  558.  * var specular_intensity = m_mat.get_specular_intensity(cube, "MyMaterial");
  559.  */
  560. exports.get_specular_intensity = function(obj, mat_name) {
  562.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  563.         m_print.error("get_specular_intensity(): Object \"" + obj.name 
  564.                 + "\" is not a dynamic MESH.");
  565.         return 0;
  566.     }
  568.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  569.     if (!batch) {
  570.         m_print.error("get_specular_intensity(): Material \"" + mat_name 
  571.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  572.         return 0;
  573.     }
  575.     if (batch.has_nodes) {
  576.         m_print.error("get_specular_intensity(): Not allowed for node materials! " 
  577.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  578.         return 0;
  579.     }
  581.     return batch.specular_params[0];
  582. }
  584. /**
  585.  * Check the specular intensity for the object material.
  586.  * @method module:material.check_specular_intensity
  587.  * @param {Object3D} obj Object 3D 
  588.  * @param {string} mat_name Material name
  589.  * @returns {boolean} Specular intensity presence
  590.  * @deprecated [17.06] not needed anymore.
  591.  * @example var m_scenes = require("scenes");
  592.  * var m_mat = require("material");
  593.  *
  594.  * var cube = m_scenes.get_object_by_name("Cube");
  595.  * var has_specular_intensity = m_mat.check_specular_intensity(cube, "MyMaterial");
  596.  */
  597. exports.check_specular_intensity = function(obj, mat_name) {
  598.     m_print.error_once("check_specular_intensity() is deprecated, not needed anymore");
  600.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  601.     return Boolean(batch && batch.specular_params[0]);
  602. }
  604. /**
  605.  * Set the specular color hardness for the object non-node material.
  606.  * @method module:material.set_specular_hardness
  607.  * @param {Object3D} obj Object 3D 
  608.  * @param {string} mat_name Material name
  609.  * @param {number} hardness Specular hardness value
  610.  * @example 
  611.  * var m_mat = require("material");
  612.  * var m_scenes = require("scenes");
  613.  *
  614.  * var cube = m_scenes.get_object_by_name("Cube");
  615.  * m_mat.set_specular_hardness(cube, "MyMaterial", 0.8);
  616.  */
  617. exports.set_specular_hardness = function(obj, mat_name, hardness) {
  619.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  620.         m_print.error("set_specular_hardness(): Object \"" + obj.name 
  621.                 + "\" is not a dynamic MESH.");
  622.         return;
  623.     }
  625.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  626.     if (!batch) {
  627.         m_print.error("set_specular_hardness(): Material \"" + mat_name 
  628.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  629.         return;
  630.     }
  632.     if (batch.has_nodes) {
  633.         m_print.error("set_specular_hardness(): Not allowed for node materials! " 
  634.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  635.         return;
  636.     }
  638.     batch.specular_params[1] = hardness;
  639.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  640.     if (reflect_batch)
  641.         reflect_batch.specular_params[1] = hardness;
  642. }
  644. /**
  645.  * Get the specular color hardness for the object non-node material.
  646.  * @method module:material.get_specular_hardness
  647.  * @param {Object3D} obj Object 3D 
  648.  * @param {string} mat_name Material name
  649.  * @returns {number} Specular color hardness
  650.  * @example var m_scenes = require("scenes");
  651.  * var m_mat = require("material");
  652.  *
  653.  * var cube = m_scenes.get_object_by_name("Cube");
  654.  * var specular_hardness = m_mat.get_specular_hardness(cube, "MyMaterial");
  655.  */
  656. exports.get_specular_hardness = function(obj, mat_name) {
  658.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  659.         m_print.error("get_specular_hardness(): Object \"" + obj.name 
  660.                 + "\" is not a dynamic MESH.");
  661.         return 0;
  662.     }
  664.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  665.     if (!batch) {
  666.         m_print.error("get_specular_hardness(): Material \"" + mat_name 
  667.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  668.         return 0;
  669.     }
  671.     if (batch.has_nodes) {
  672.         m_print.error("get_specular_hardness(): Not allowed for node materials! " 
  673.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  674.         return 0;
  675.     }
  677.     return batch.specular_params[1];
  678. }
  680. /**
  681.  * Check the specular hardness for the object material.
  682.  * @method module:material.check_specular_hardness
  683.  * @param {Object3D} obj Object 3D 
  684.  * @param {string} mat_name Material name
  685.  * @returns {boolean} Specular hardness presence
  686.  * @deprecated [17.06] not needed anymore.
  687.  * @example var m_scenes = require("scenes");
  688.  * var m_mat = require("material");
  689.  *
  690.  * var cube = m_scenes.get_object_by_name("Cube");
  691.  * var has_specular_hardness = m_mat.check_specular_hardness(cube, "MyMaterial");
  692.  */
  693. exports.check_specular_hardness = function(obj, mat_name) {
  694.     m_print.error_once("check_specular_hardness() is deprecated, not needed anymore");
  695.     
  696.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  697.     return Boolean(batch && batch.specular_params[1]);
  698. }
  700. /**
  701.  * Set the emit factor for the object non-node material.
  702.  * @method module:material.set_emit_factor
  703.  * @param {Object3D} obj Object 3D 
  704.  * @param {string} mat_name Material name
  705.  * @param {number} emit_factor Emit factor value
  706.  * @example 
  707.  * var m_mat = require("material");
  708.  * var m_scenes = require("scenes");
  709.  *
  710.  * var cube = m_scenes.get_object_by_name("Cube");
  711.  * m_mat.set_emit_factor(cube, "MyMaterial", 1);
  712.  */
  713. exports.set_emit_factor = function(obj, mat_name, emit_factor) {
  715.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  716.         m_print.error("set_emit_factor(): Object \"" + obj.name 
  717.                 + "\" is not a dynamic MESH.");
  718.         return;
  719.     }
  721.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  722.     if (!batch) {
  723.         m_print.error("set_emit_factor(): Material \"" + mat_name 
  724.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  725.         return;
  726.     }
  728.     if (batch.has_nodes) {
  729.         m_print.error("set_emit_factor(): Not allowed for node materials! " 
  730.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  731.         return;
  732.     }
  734.     batch.emit = emit_factor;
  735.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  736.     if (reflect_batch)
  737.         reflect_batch.emit = emit_factor;
  738. }
  740. /**
  741.  * Get the emit factor for the object non-node material.
  742.  * @method module:material.get_emit_factor
  743.  * @param {Object3D} obj Object 3D 
  744.  * @param {string} mat_name Material name
  745.  * @returns {number} Emit factor value
  746.  * @example var m_scenes = require("scenes");
  747.  * var m_mat = require("material");
  748.  *
  749.  * var cube = m_scenes.get_object_by_name("Cube");
  750.  * var emit_factor = m_mat.get_emit_factor(cube, "MyMaterial");
  751.  */
  752. exports.get_emit_factor = function(obj, mat_name) {
  754.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  755.         m_print.error("get_emit_factor(): Object \"" + obj.name 
  756.                 + "\" is not a dynamic MESH.");
  757.         return 0;
  758.     }
  760.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  761.     if (!batch) {
  762.         m_print.error("get_emit_factor(): Material \"" + mat_name 
  763.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  764.         return 0;
  765.     }
  767.     if (batch.has_nodes) {
  768.         m_print.error("get_emit_factor(): Not allowed for node materials! " 
  769.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  770.         return 0;
  771.     }
  773.     return batch.emit;
  774. }
  776. /**
  777.  * Set the ambient factor for the object non-node material.
  778.  * @method module:material.set_ambient_factor
  779.  * @param {Object3D} obj Object 3D 
  780.  * @param {string} mat_name Material name
  781.  * @param {number} ambient_factor Ambient factor value
  782.  * @example var m_scenes = require("scenes");
  783.  * var m_mat = require("material");
  784.  *
  785.  * var cube = m_scenes.get_object_by_name("Cube");
  786.  * m_mat.set_ambient_factor(cube, "MyMaterial", 0.6);
  787.  */
  788. exports.set_ambient_factor = function(obj, mat_name, ambient_factor) {
  790.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  791.         m_print.error("set_ambient_factor(): Object \"" + obj.name 
  792.                 + "\" is not a dynamic MESH.");
  793.         return;
  794.     }
  796.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  797.     if (!batch) {
  798.         m_print.error("set_ambient_factor(): Material \"" + mat_name 
  799.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  800.         return;
  801.     }
  803.     if (batch.has_nodes) {
  804.         m_print.error("set_ambient_factor(): Not allowed for node materials! " 
  805.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  806.         return;
  807.     }
  809.     batch.ambient = ambient_factor;
  810.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  811.     if (reflect_batch)
  812.         reflect_batch.ambient = ambient_factor;
  813. }
  815. /**
  816.  * Get the ambient factor for the object non-node material.
  817.  * @method module:material.get_ambient_factor
  818.  * @param {Object3D} obj Object 3D 
  819.  * @param {string} mat_name Material name
  820.  * @returns {number} Ambient factor value
  821.  * @example var m_scenes = require("scenes");
  822.  * var m_mat = require("material");
  823.  *
  824.  * var cube = m_scenes.get_object_by_name("Cube");
  825.  * var ambient_factor = m_mat.get_ambient_factor(cube, "MyMaterial");
  826.  */
  827. exports.get_ambient_factor = function(obj, mat_name) {
  829.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  830.         m_print.error("get_ambient_factor(): Object \"" + obj.name 
  831.                 + "\" is not a dynamic MESH.");
  832.         return 0;
  833.     }
  835.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  836.     if (!batch) {
  837.         m_print.error("get_ambient_factor(): Material \"" + mat_name 
  838.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  839.         return 0;
  840.     }
  842.     if (batch.has_nodes) {
  843.         m_print.error("get_ambient_factor(): Not allowed for node materials! " 
  844.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  845.         return 0;
  846.     }
  848.     return batch.ambient;
  849. }
  851. /**
  852.  * Set the diffuse color factor for the object non-node material.
  853.  * @method module:material.set_diffuse_color_factor
  854.  * @param {Object3D} obj Object 3D 
  855.  * @param {string} mat_name Material name
  856.  * @param {number} diffuse_color_factor Diffuse color factor value
  857.  * @example var m_scenes = require("scenes");
  858.  * var m_mat = require("material");
  859.  *
  860.  * var cube = m_scenes.get_object_by_name("Cube");
  861.  * m_mat.set_diffuse_color_factor(cube, "MyMaterial", 0.05);
  862.  */
  863. exports.set_diffuse_color_factor = function(obj, mat_name, diffuse_color_factor) {
  865.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  866.         m_print.error("set_diffuse_color_factor(): Object \"" + obj.name 
  867.                 + "\" is not a dynamic MESH.");
  868.         return;
  869.     }
  871.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  872.     if (!batch) {
  873.         m_print.error("set_diffuse_color_factor(): Material \"" + mat_name 
  874.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  875.         return;
  876.     }
  878.     if (batch.has_nodes) {
  879.         m_print.error("set_diffuse_color_factor(): Not allowed for node materials! " 
  880.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  881.         return;
  882.     }
  884.     batch.diffuse_color_factor = diffuse_color_factor;
  885.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  886.     if (reflect_batch)
  887.         reflect_batch.diffuse_color_factor = diffuse_color_factor;
  888. }
  890. /**
  891.  * Get the diffuse color factor for the object non-node material.
  892.  * @method module:material.get_diffuse_color_factor
  893.  * @param {Object3D} obj Object 3D 
  894.  * @param {string} mat_name Material name
  895.  * @returns {number} Diffuse color factor value
  896.  * @example var m_scenes = require("scenes");
  897.  * var m_mat = require("material");
  898.  *
  899.  * var cube = m_scenes.get_object_by_name("Cube");
  900.  * var diffuse_color_factor = m_mat.get_diffuse_color_factor(cube, "MyMaterial");
  901.  */
  902. exports.get_diffuse_color_factor = function(obj, mat_name) {
  904.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  905.         m_print.error("get_diffuse_color_factor(): Object \"" + obj.name 
  906.                 + "\" is not a dynamic MESH.");
  907.         return 0;
  908.     }
  910.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  911.     if (!batch) {
  912.         m_print.error("get_diffuse_color_factor(): Material \"" + mat_name 
  913.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  914.         return 0;
  915.     }
  917.     if (batch.has_nodes) {
  918.         m_print.error("get_diffuse_color_factor(): Not allowed for node materials! " 
  919.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  920.         return 0;
  921.     }
  923.     return batch.diffuse_color_factor;
  924. }
  926. /**
  927.  * Set the alpha factor for the object non-node material.
  928.  * @method module:material.set_alpha_factor
  929.  * @param {Object3D} obj Object 3D
  930.  * @param {string} mat_name Material name
  931.  * @param {number} alpha_factor Alpha factor value
  932.  * @example 
  933.  * var m_mat = require("material");
  934.  * var m_scenes = require("scenes");
  935.  *
  936.  * var cube = m_scenes.get_object_by_name("Cube");
  937.  * m_mat.set_alpha_factor(cube, "MyMaterial", 0.2);
  938.  */
  939. exports.set_alpha_factor = function(obj, mat_name, alpha_factor) {
  941.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  942.         m_print.error("set_alpha_factor(): Object \"" + obj.name 
  943.                 + "\" is not a dynamic MESH.");
  944.         return;
  945.     }
  947.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  948.     if (!batch) {
  949.         m_print.error("set_alpha_factor(): Material \"" + mat_name 
  950.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  951.         return;
  952.     }
  954.     if (batch.has_nodes) {
  955.         m_print.error("set_alpha_factor(): Not allowed for node materials! " 
  956.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  957.         return;
  958.     }
  960.     batch.alpha_factor = alpha_factor;
  961.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  962.     if (reflect_batch)
  963.         reflect_batch.alpha_factor = alpha_factor;
  964. }
  966. /**
  967.  * Get the diffuse alpha factor for the object non-node material.
  968.  * @method module:material.get_alpha_factor
  969.  * @param {Object3D} obj Object 3D
  970.  * @param {string} mat_name Material name
  971.  * @returns {number} Diffuse alpha factor value
  972.  * @example var m_scenes = require("scenes");
  973.  * var m_mat = require("material");
  974.  *
  975.  * var cube = m_scenes.get_object_by_name("Cube");
  976.  * var alpha_factor = m_mat.get_alpha_factor(cube, "MyMaterial");
  977.  */
  978. exports.get_alpha_factor = function(obj, mat_name) {
  980.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  981.         m_print.error("get_alpha_factor(): Object \"" + obj.name 
  982.                 + "\" is not a dynamic MESH.");
  983.         return 0;
  984.     }
  986.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  987.     if (!batch) {
  988.         m_print.error("get_alpha_factor(): Material \"" + mat_name 
  989.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  990.         return 0;
  991.     }
  993.     if (batch.has_nodes) {
  994.         m_print.error("get_alpha_factor(): Not allowed for node materials! " 
  995.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  996.         return 0;
  997.     }
  999.     return batch.alpha_factor;
  1000. }
  1002. /**
  1003.  * Get the material extended params for the object non-node material.
  1004.  * @method module:material.get_material_extended_params
  1005.  * @param {Object3D} obj Object 3D
  1006.  * @param {string} mat_name Material name
  1007.  * @returns {?MaterialExtParams} Material extended params or null
  1008.  * @example var m_scenes = require("scenes");
  1009.  * var m_mat = require("material");
  1010.  *
  1011.  * var cube = m_scenes.get_object_by_name("Cube");
  1012.  * var extended_parameters = m_mat.get_material_extended_params(cube, "MyMaterial");
  1013.  */
  1014. exports.get_material_extended_params = function(obj, mat_name) {
  1016.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  1017.         m_print.error("get_material_extended_params(): Object \"" + obj.name 
  1018.                 + "\" is not a dynamic MESH.");
  1019.         return null;
  1020.     }
  1022.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  1023.     if (!batch) {
  1024.         m_print.error("get_material_extended_params(): Material \"" + mat_name 
  1025.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  1026.         return null;
  1027.     }
  1029.     if (batch.has_nodes) {
  1030.         m_print.error("get_material_extended_params(): Not allowed for node materials! " 
  1031.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  1032.         return null;
  1033.     }
  1035.     var mat_params = {};
  1037.     mat_params.reflect_factor = batch.reflect_factor;
  1038.     mat_params.fresnel        = batch.fresnel_params[0];
  1039.     mat_params.fresnel_factor = 5 * (1 - batch.fresnel_params[1]);
  1040.     mat_params.parallax_scale = batch.parallax_scale;
  1041.     mat_params.parallax_steps = parseFloat(m_batch.get_batch_directive(batch,
  1042.             "PARALLAX_STEPS")[1]);
  1044.     return mat_params;
  1045. }
  1047. /**
  1048.  * Set the material extended params for the object non-node material.
  1049.  * @method module:material.set_material_extended_params
  1050.  * @param {Object3D} obj Object 3D
  1051.  * @param {string} mat_name Material name
  1052.  * @param {MaterialExtParams} mat_params Material params
  1053.  * @example var m_scenes = require("scenes");
  1054.  * var m_mat = require("material");
  1055.  *
  1056.  * var cube = m_scenes.get_object_by_name("Cube");
  1057.  * m_mat.set_material_extended_params(cube, "MyMaterial", {
  1058.  *     fresnel: 0,
  1059.  *     fresnel_factor: 1.25,
  1060.  *     parallax_scale: 0,
  1061.  *     parallax_steps: 5,
  1062.  *     reflect_factor: 0
  1063.  * });
  1064.  */
  1065. exports.set_material_extended_params = function(obj, mat_name, mat_params) {
  1067.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  1068.         m_print.error("set_material_extended_params(): Object \"" + obj.name 
  1069.                 + "\" is not a dynamic MESH.");
  1070.         return;
  1071.     }
  1073.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  1074.     if (!batch) {
  1075.         m_print.error("set_material_extended_params(): Material \"" + mat_name 
  1076.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  1077.         return;
  1078.     }
  1080.     if (batch.has_nodes) {
  1081.         m_print.error("set_material_extended_params(): Not allowed for node materials! " 
  1082.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  1083.         return;
  1084.     }
  1086.     var batches = [batch];
  1087.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  1088.     if (reflect_batch)
  1089.         batches.push(reflect_batch);
  1091.     for (var i = 0; i < batches.length; i++) {
  1092.         batch = batches[i];
  1093.         if (typeof mat_params.reflect_factor == "number")
  1094.             batch.reflect_factor = mat_params.reflect_factor;
  1096.         if (typeof mat_params.fresnel == "number")
  1097.             batch.fresnel_params[0] = mat_params.fresnel;
  1099.         if (typeof mat_params.fresnel_factor == "number")
  1100.             batch.fresnel_params[1] = 1 - mat_params.fresnel_factor / 5;
  1102.         if (typeof mat_params.parallax_scale == "number")
  1103.             batch.parallax_scale = mat_params.parallax_scale;
  1105.         if (typeof mat_params.parallax_steps == "number") {
  1106.             m_batch.set_batch_directive(batch, "PARALLAX_STEPS", 
  1107.                     m_shaders.glsl_value(mat_params.parallax_steps));
  1108.             m_batch.update_shader(batch);
  1109.             m_scenes.recalculate_draw_data(batch);
  1110.         }
  1111.     }
  1112. }
  1114. /**
  1115.  * Get the parameters of a water non-node material.
  1116.  * @method module:material.get_water_material_params
  1117.  * @param {Object3D} obj Object 3D
  1118.  * @param {string} mat_name Water material name
  1119.  * @returns {?WaterMaterialParams} Water material params or null.
  1120.  * @example var m_scenes = require("scenes");
  1121.  * var m_mat = require("material");
  1122.  *
  1123.  * var water = m_scenes.get_object_by_name("MyWater");
  1124.  * var water_params = m_mat.get_water_material_params(water, "MyMaterial");
  1125.  */
  1126. exports.get_water_material_params = function(obj, mat_name) {
  1128.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  1129.         m_print.error("get_water_material_params(): Object \"" + obj.name 
  1130.                 + "\" is not a dynamic MESH.");
  1131.         return null;
  1132.     }
  1134.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  1135.     if (!batch || !batch.water) {
  1136.         m_print.error("get_water_material_params(): Material \"" + mat_name 
  1137.                 + "\" wasn't found on the object \"" + obj.name 
  1138.                 + "\" or it's not a water material.");
  1139.         return null;
  1140.     }
  1142.     if (batch.has_nodes) {
  1143.         m_print.error("get_water_material_params(): Not allowed for node materials! " 
  1144.                 + "Use get_nodemat_value/get_nodemat_rgb methods instead.");
  1145.         return null;
  1146.     }
  1149.     var water_mat_params = {};
  1151.     water_mat_params.shore_smoothing = cfg_def.shore_smoothing 
  1152.             && batch.water_shore_smoothing && Boolean(parseFloat(
  1153.             m_batch.get_batch_directive(batch, "SHORE_SMOOTHING")[1]));
  1155.     water_mat_params.absorb_factor = parseFloat(m_batch.get_batch_directive(
  1156.             batch, "ABSORB")[1]);
  1157.     water_mat_params.foam_factor = batch.foam_factor;
  1159.     water_mat_params.shallow_water_col = new Float32Array(3);
  1160.     water_mat_params.shore_water_col = new Float32Array(3);
  1161.     water_mat_params.shallow_water_col_fac = 0;
  1162.     water_mat_params.shore_water_col_fac = 0;
  1164.     if (cfg_def.shore_distance) {
  1165.         water_mat_params.shallow_water_col.set(batch.shallow_water_col);
  1166.         water_mat_params.shore_water_col.set(batch.shore_water_col);
  1167.         water_mat_params.shallow_water_col_fac = batch.shallow_water_col_fac;
  1168.         water_mat_params.shore_water_col_fac = batch.shore_water_col_fac;
  1169.     }
  1171.     water_mat_params.norm_uv_velocity = batch.water_norm_uv_velocity;
  1173.     water_mat_params.water_dynamic = cfg_def.water_dynamic 
  1174.             && batch.water_dynamic && Boolean(parseFloat(
  1175.             m_batch.get_batch_directive(batch, "DYNAMIC")[1]));
  1176.     water_mat_params.sss_strength = parseFloat(m_batch.get_batch_directive(
  1177.             batch, "SSS_STRENGTH")[1]);
  1178.     water_mat_params.sss_width = parseFloat(m_batch.get_batch_directive(
  1179.             batch, "SSS_WIDTH")[1]);
  1180.     water_mat_params.waves_height = parseFloat(m_batch.get_batch_directive(
  1181.             batch, "WAVES_HEIGHT")[1]);
  1182.     water_mat_params.waves_length = parseFloat(m_batch.get_batch_directive(
  1183.             batch, "WAVES_LENGTH")[1]);
  1185.     water_mat_params.dst_noise_scale0 = parseFloat(m_batch.get_batch_directive(
  1186.             batch, "DST_NOISE_SCALE_0")[1]);
  1187.     water_mat_params.dst_noise_scale1 = parseFloat(m_batch.get_batch_directive(
  1188.             batch, "DST_NOISE_SCALE_1")[1]);
  1189.     water_mat_params.dst_noise_freq0 = parseFloat(m_batch.get_batch_directive(
  1190.             batch, "DST_NOISE_FREQ_0")[1]);
  1191.     water_mat_params.dst_noise_freq1 = parseFloat(m_batch.get_batch_directive(
  1192.             batch, "DST_NOISE_FREQ_1")[1]);
  1193.     water_mat_params.dir_min_shore_fac = parseFloat(m_batch.get_batch_directive(
  1194.             batch, "DIR_MIN_SHR_FAC")[1]);
  1195.     water_mat_params.dir_freq = parseFloat(m_batch.get_batch_directive(batch,
  1196.             "DIR_FREQ")[1]);
  1197.     water_mat_params.dir_noise_scale = parseFloat(m_batch.get_batch_directive(
  1198.             batch, "DIR_NOISE_SCALE")[1]);
  1199.     water_mat_params.dir_noise_freq = parseFloat(m_batch.get_batch_directive(
  1200.             batch, "DIR_NOISE_FREQ")[1]);
  1202.     water_mat_params.dir_min_noise_fac = parseFloat(m_batch.get_batch_directive(
  1203.             batch, "DIR_MIN_NOISE_FAC")[1]);
  1204.     water_mat_params.dst_min_fac = parseFloat(m_batch.get_batch_directive(batch,
  1205.             "DST_MIN_FAC")[1]);
  1206.     water_mat_params.waves_hor_fac = parseFloat(m_batch.get_batch_directive(
  1207.             batch, "WAVES_HOR_FAC")[1]);
  1209.     return water_mat_params;
  1210. }
  1212. /**
  1213.  * Set parameters for a water non-node material.
  1214.  * @method module:material.set_water_material_params
  1215.  * @param {Object3D} obj Object 3D
  1216.  * @param {string} mat_name Water material name
  1217.  * @param {WaterMaterialParams} water_mat_params Water material parameters.
  1218.  * @example var m_scenes = require("scenes");
  1219.  * var m_mat = require("material");
  1220.  *
  1221.  * var water = m_scenes.get_object_by_name("MyWater");
  1222.  * var water_params = m_mat.set_water_material_params(water, "MyMaterial", {
  1223.  *     waves_height: 2, 
  1224.  *     waves_length: 20, 
  1225.  *     shallow_water_col: [0, 0.3, 0.8]
  1226.  * });
  1227.  */
  1228. exports.set_water_material_params = function(obj, mat_name, water_mat_params) {
  1230.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  1231.         m_print.error("set_water_material_params(): Object \"" + obj.name 
  1232.                 + "\" is not a dynamic MESH.");
  1233.         return;
  1234.     }
  1236.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  1237.     if (!batch || !batch.water) {
  1238.         m_print.error("set_water_material_params(): Material \"" + mat_name 
  1239.                 + "\" wasn't found on the object \"" + obj.name 
  1240.                 + "\" or it's not a water material.");
  1241.         return;
  1242.     }
  1244.     if (batch.has_nodes) {
  1245.         m_print.error("set_water_material_params(): Not allowed for node materials! " 
  1246.                 + "Use set_nodemat_value/set_nodemat_rgb methods instead.");
  1247.         return;
  1248.     }
  1250.     var batches = [batch];
  1251.     var reflect_batch = m_batch.find_batch_material_forked(obj, mat_name, "MAIN");
  1252.     if (reflect_batch)
  1253.         batches.push(reflect_batch);
  1255.     for (var i = 0; i < batches.length; i++) {
  1256.         batch = batches[i];
  1259.         if (typeof water_mat_params.shore_smoothing == "boolean")
  1260.             if (cfg_def.shore_smoothing && batch.water_shore_smoothing 
  1261.                     && water_mat_params.shore_smoothing)
  1262.                 m_batch.set_batch_directive(batch, "SHORE_SMOOTHING", 1);
  1263.             else
  1264.                 m_batch.set_batch_directive(batch, "SHORE_SMOOTHING", 0);
  1266.         if (typeof water_mat_params.absorb_factor == "number") {
  1267.             var absorb_factor = m_shaders.glsl_value(parseFloat(
  1268.                     water_mat_params.absorb_factor));
  1269.             m_batch.set_batch_directive(batch, "ABSORB", absorb_factor);
  1270.         }
  1272.         if (typeof water_mat_params.foam_factor == "number" && cfg_def.foam)
  1273.             batch.foam_factor = water_mat_params.foam_factor;
  1275.         if (cfg_def.shore_distance) {
  1276.             if (typeof water_mat_params.shallow_water_col == "object")
  1277.                 batch.shallow_water_col.set(water_mat_params.shallow_water_col);
  1278.             if (typeof water_mat_params.shallow_water_col_fac == "number")
  1279.                 batch.shallow_water_col_fac = water_mat_params.shallow_water_col_fac;
  1280.             if (typeof water_mat_params.shore_water_col == "object")
  1281.                 batch.shore_water_col.set(water_mat_params.shore_water_col);
  1282.             if (typeof water_mat_params.shore_water_col_fac == "number")
  1283.                 batch.shore_water_col_fac = water_mat_params.shore_water_col_fac;
  1284.         }
  1286.         if (typeof water_mat_params.norm_uv_velocity == "number")
  1287.             batch.water_norm_uv_velocity = water_mat_params.norm_uv_velocity;
  1289.         if (cfg_def.water_dynamic && batch.water_dynamic) {
  1290.             if (typeof water_mat_params.water_dynamic == "boolean") {
  1291.                 if (water_mat_params.water_dynamic)
  1292.                     m_batch.set_batch_directive(batch, "DYNAMIC", 1);
  1293.                 else
  1294.                     m_batch.set_batch_directive(batch, "DYNAMIC", 0);
  1295.             }
  1296.             if (typeof water_mat_params.sss_strength == "number") {
  1297.                 var waves_length = m_shaders.glsl_value(parseFloat(
  1298.                         water_mat_params.sss_strength));
  1299.                 m_batch.set_batch_directive(batch, "SSS_STRENGTH", waves_length);
  1300.             }
  1301.             if (typeof water_mat_params.sss_width == "number") {
  1302.                 var waves_length = m_shaders.glsl_value(parseFloat(
  1303.                         water_mat_params.sss_width));
  1304.                 m_batch.set_batch_directive(batch, "SSS_WIDTH", waves_length);
  1305.             }
  1306.             if (typeof water_mat_params.waves_height == "number") {
  1307.                 var waves_height = m_shaders.glsl_value(parseFloat(
  1308.                         water_mat_params.waves_height));
  1309.                 m_batch.set_batch_directive(batch, "WAVES_HEIGHT", waves_height);
  1310.             }
  1311.             if (typeof water_mat_params.waves_length  == "number") {
  1312.                 var waves_length = m_shaders.glsl_value(parseFloat(
  1313.                         water_mat_params.waves_length));
  1314.                 m_batch.set_batch_directive(batch, "WAVES_LENGTH", waves_length);
  1315.             }
  1316.             if (typeof water_mat_params.dst_noise_scale0 == "number") {
  1317.                 var dst_noise_scale0 = m_shaders.glsl_value(parseFloat(
  1318.                         water_mat_params.dst_noise_scale0));
  1319.                 m_batch.set_batch_directive(batch, "DST_NOISE_SCALE_0", dst_noise_scale0);
  1320.             }
  1321.             if (typeof water_mat_params.dst_noise_scale1 == "number") {
  1322.                 var dst_noise_scale1 = m_shaders.glsl_value(parseFloat(
  1323.                         water_mat_params.dst_noise_scale1));
  1324.                 m_batch.set_batch_directive(batch, "DST_NOISE_SCALE_1", dst_noise_scale1);
  1325.             }
  1326.             if (typeof water_mat_params.dst_noise_freq0 == "number") {
  1327.                 var dst_noise_freq0 = m_shaders.glsl_value(parseFloat(
  1328.                         water_mat_params.dst_noise_freq0));
  1329.                 m_batch.set_batch_directive(batch, "DST_NOISE_FREQ_0", dst_noise_freq0);
  1330.             }
  1331.             if (typeof water_mat_params.dst_noise_freq1 == "number") {
  1332.                 var dst_noise_freq1 = m_shaders.glsl_value(parseFloat(
  1333.                         water_mat_params.dst_noise_freq1));
  1334.                 m_batch.set_batch_directive(batch, "DST_NOISE_FREQ_1", dst_noise_freq1);
  1335.             }
  1336.             if (typeof water_mat_params.dir_min_shore_fac == "number") {
  1337.                 var dir_min_shore_fac = m_shaders.glsl_value(parseFloat(
  1338.                         water_mat_params.dir_min_shore_fac));
  1339.                 m_batch.set_batch_directive(batch, "DIR_MIN_SHR_FAC", dir_min_shore_fac);
  1340.             }
  1341.             if (typeof water_mat_params.dir_freq == "number") {
  1342.                 var dir_freq = m_shaders.glsl_value(parseFloat(
  1343.                         water_mat_params.dir_freq));
  1344.                 m_batch.set_batch_directive(batch, "DIR_FREQ", dir_freq);
  1345.             }
  1346.             if (typeof water_mat_params.dir_noise_scale == "number") {
  1347.                 var dir_noise_scale = m_shaders.glsl_value(parseFloat(
  1348.                         water_mat_params.dir_noise_scale));
  1349.                 m_batch.set_batch_directive(batch, "DIR_NOISE_SCALE", dir_noise_scale);
  1350.             }
  1351.             if (typeof water_mat_params.dir_noise_freq == "number") {
  1352.                 var dir_noise_freq = m_shaders.glsl_value(parseFloat(
  1353.                         water_mat_params.dir_noise_freq));
  1354.                 m_batch.set_batch_directive(batch, "DIR_NOISE_FREQ", dir_noise_freq);
  1355.             }
  1356.             if (typeof water_mat_params.dir_min_noise_fac == "number") {
  1357.                 var dir_min_noise_fac = m_shaders.glsl_value(parseFloat(
  1358.                         water_mat_params.dir_min_noise_fac));
  1359.                 m_batch.set_batch_directive(batch, "DIR_MIN_NOISE_FAC", dir_min_noise_fac);
  1360.             }
  1361.             if (typeof water_mat_params.dst_min_fac == "number") {
  1362.                 var dst_min_fac = m_shaders.glsl_value(parseFloat(
  1363.                         water_mat_params.dst_min_fac));
  1364.                 m_batch.set_batch_directive(batch, "DST_MIN_FAC", dst_min_fac);
  1365.             }
  1366.             if (typeof water_mat_params.waves_hor_fac == "number") {
  1367.                 var waves_hor_fac = m_shaders.glsl_value(parseFloat(
  1368.                         water_mat_params.waves_hor_fac));
  1369.                 m_batch.set_batch_directive(batch, "WAVES_HOR_FAC", waves_hor_fac);
  1370.             }
  1371.         }
  1372.         m_batch.update_shader(batch);
  1373.         m_scenes.recalculate_draw_data(batch);
  1374.     }
  1375. }
  1377. /**
  1378.  * Set parameters for a LINE object.
  1379.  * @method module:material.set_line_params
  1380.  * @param {Object3D} obj Line object 3D
  1381.  * @param {LineParams} line_params Line parameters
  1382.  * @example 
  1383.  * var m_mat = require("material");
  1384.  * var m_scenes = require("scenes");
  1385.  *
  1386.  * var empty = m_scenes.get_object_by_name("Empty");
  1387.  * m_mat.set_line_params(empty, {
  1388.  *     color: [1.0, 0.0, 0.0, 1.0],
  1389.  *     width: 5
  1390.  * });
  1391.  */
  1392. exports.set_line_params = function(obj, line_params) {
  1394.     if (!m_obj_util.is_line(obj)) {
  1395.         m_print.error("set_line_params(): Object \"" + obj.name 
  1396.                 + "\" is not a LINE object.");
  1397.         return;
  1398.     }
  1400.     var batch = m_batch.get_first_batch(obj);
  1401.     if (!batch) {
  1402.         m_print.error("set_line_params(): Couldn't set line parameters!");
  1403.         return;
  1404.     }
  1406.     if (m_util.isdef(line_params.color))
  1407.         batch.diffuse_color.set(line_params.color);
  1408.     if (m_util.isdef(line_params.width))
  1409.         batch.line_width = line_params.width;
  1410. }
  1412. /**
  1413.  * Get the parameters of a LINE object.
  1414.  * @method module:material.get_line_params
  1415.  * @param {Object3D} obj Line object 3D
  1416.  * @returns {?LineParams} Line parameters
  1417.  * @example var m_scenes = require("scenes");
  1418.  * var m_mat  = require("material");
  1419.  *
  1420.  * var line_object = m_scenes.get_object_by_name("MyLine");
  1421.  * var line_params = m_mat.get_line_params(line_object);
  1422.  */
  1423. exports.get_line_params = function(obj) {
  1425.     if (!m_obj_util.is_line(obj)) {
  1426.         m_print.error("get_line_params(): Object \"" + obj.name 
  1427.                 + "\" is not a LINE object.");
  1428.         return null;
  1429.     }
  1431.     var batch = m_batch.get_first_batch(obj);
  1432.     if (!batch) {
  1433.         m_print.error("get_line_params(): Couldn't get line parameters!");
  1434.         return null;
  1435.     }
  1437.     var line_params = {
  1438.         color : new Float32Array(batch.diffuse_color),
  1439.         width: batch.line_width
  1440.     }
  1442.     return line_params;
  1443. }
  1445. /**
  1446.  * Set value of the Value node in the object's material.
  1447.  * @method module:material.set_nodemat_value
  1448.  * @param {Object3D} obj Object 3D
  1449.  * @param {string[]} name_list List consisting of the material name, the names of
  1450.  * nested node groups (if any) and the name of the Value node itself. Should
  1451.  * have at least 2 elements ["Mat","Node"]. For a world node material the 
  1452.  * material name should be omitted.
  1453.  * @param {number} value The value to set the Value node to
  1454.  * @example 
  1455.  * var m_mat = require("material");
  1456.  * var m_scenes = require("scenes");
  1457.  *
  1458.  * var cube = m_scenes.get_object_by_name("Cube");
  1459.  * m_mat.set_nodemat_value(cube, ["MyMaterial", "Value.001"], 20);
  1460.  */
  1461. exports.set_nodemat_value = function(obj, name_list, value) {
  1463.     var is_dyn_mesh = m_obj_util.is_dynamic_mesh(obj);
  1464.     var is_world = m_obj_util.is_world(obj);
  1466.     var obj_name = is_world ? m_obj.get_world_name(obj) : obj.name;
  1468.     if (!is_dyn_mesh && !is_world) {
  1469.         m_print.error("set_nodemat_value(): Object \"" + obj_name 
  1470.                 + "\" is not a dynamic MESH or WORLD.");
  1471.         return;
  1472.     }
  1474.     if (is_dyn_mesh) {
  1475.         var mat_name = name_list[0];
  1476.         var node_name_prefix_offset = 1;
  1478.         var mat_batch = m_batch.find_batch_material_any(obj, mat_name, "MAIN") 
  1479.                 || m_batch.find_batch_material_any(obj, mat_name, "PARTICLES");
  1480.         if (!mat_batch) {
  1481.             m_print.error("set_nodemat_value(): Material \"" + mat_name 
  1482.                     + "\" wasn't found on the object \"" + obj_name + "\".");
  1483.             return;
  1484.         }
  1485.     } else if (is_world) {
  1486.         var active_scene = m_scenes.get_active();
  1487.         var mat_name = "";
  1488.         var node_name_prefix_offset = 0;
  1490.         var mat_batch = m_batch.get_batch_by_type(obj, "SKY", active_scene);
  1491.         if (!mat_batch) {
  1492.             m_print.error("set_nodemat_value(): Sky node material wasn't found on the world object \"" 
  1493.                     + obj_name + "\".");
  1494.             return;
  1495.         }
  1496.     }
  1498.     var node_name = m_batch.name_list_to_node_name(name_list, node_name_prefix_offset);
  1499.     var is_changed = m_obj.set_nodemat_value(obj, mat_name, node_name, value);
  1501.     if (!is_changed) {
  1502.         m_print.error("set_nodemat_value(): Value node \""
  1503.                 + name_list[name_list.length - 1]
  1504.                 + "\" was not found in the object \"" + obj_name + "\".");
  1505.     }
  1506. }
  1508. /**
  1509.  * Get value of the Value node in the object's material.
  1510.  * @method module:material.get_nodemat_value
  1511.  * @param {Object3D} obj Object 3D
  1512.  * @param {string[]} name_list List consisting of the material name, the names of
  1513.  * nested node groups (if any) and the name of the Value node itself. Should
  1514.  * have at least 2 elements ["Mat","Node"]. For a world node material the 
  1515.  * material name should be omitted.
  1516.  * @returns {number} Value.
  1517.  * @example var m_scenes = require("scenes");
  1518.  * var m_mat  = require("material");
  1519.  *
  1520.  * var cube = m_scenes.get_object_by_name("Cube");
  1521.  * var node_value = m_mat.get_nodemat_value(cube, ["MyMaterial", "MyValue"]);
  1522.  */
  1523. exports.get_nodemat_value = function(obj, name_list) {
  1525.     var is_dyn_mesh = m_obj_util.is_dynamic_mesh(obj);
  1526.     var is_world = m_obj_util.is_world(obj);
  1528.     var obj_name = is_world ? m_obj.get_world_name(obj) : obj.name;
  1530.     if (!is_dyn_mesh && !is_world) {
  1531.         m_print.error("get_nodemat_value(): Object \"" + obj_name 
  1532.                 + "\" is not a dynamic MESH or WORLD.");
  1533.         return 0;
  1534.     }
  1536.     if (is_dyn_mesh) {
  1537.         var mat_name = name_list[0];
  1538.         var node_name_prefix_offset = 1;
  1540.         var mat_batch = m_batch.find_batch_material_any(obj, mat_name, "MAIN") 
  1541.                 || m_batch.find_batch_material_any(obj, mat_name, "PARTICLES");
  1542.         if (!mat_batch) {
  1543.             m_print.error("get_nodemat_value(): Material \"" + mat_name 
  1544.                     + "\" wasn't found on the object \"" + obj_name + "\".");
  1545.             return 0;
  1546.         }
  1547.     } else if (is_world) {
  1548.         var active_scene = m_scenes.get_active();
  1549.         var mat_name = "";
  1550.         var node_name_prefix_offset = 0;
  1552.         var mat_batch = m_batch.get_batch_by_type(obj, "SKY", active_scene);
  1553.         if (!mat_batch) {
  1554.             m_print.error("get_nodemat_value(): Sky node material wasn't found on the world object \"" 
  1555.                     + obj_name + "\".");
  1556.             return 0;
  1557.         }
  1558.     }
  1560.     var node_name = m_batch.name_list_to_node_name(name_list, node_name_prefix_offset);
  1561.     var value = m_obj.get_nodemat_value(obj, mat_name, node_name);
  1563.     if (value === null) {
  1564.         m_print.error("get_nodemat_value(): Value node \"" 
  1565.                 + name_list[name_list.length - 1] 
  1566.                 + "\" was not found in the object \"" + obj_name + "\".");
  1567.     }
  1569.     return value;
  1570. }
  1572. /**
  1573.  * Set color of the RGB node in the object's material.
  1574.  * @method module:material.set_nodemat_rgb
  1575.  * @param {Object3D} obj Object 3D
  1576.  * @param {string[]} name_list List consisting of the material name, the names of
  1577.  * nested node groups (if any) and the name of the RGB node itself. For a world 
  1578.  * node material the material name should be omitted.
  1579.  * @param {number} r The value to set the red channel of the RGB node to [0..1]
  1580.  * @param {number} g The value to set the green channel of the RGB node to [0..1]
  1581.  * @param {number} b The value to set the blue channel of the RGB node to [0..1]
  1582.  * @example 
  1583.  * var m_mat = require("material");
  1584.  * var m_scenes = require("scenes");
  1585.  *
  1586.  * var cube = m_scenes.get_object_by_name("Cube");
  1587.  * m_mat.set_nodemat_rgb(cube, ["MyMaterial", "RGB.001"], 1, 0, 1);
  1588.  */
  1589. exports.set_nodemat_rgb = function(obj, name_list, r, g, b) {
  1591.     var is_dyn_mesh = m_obj_util.is_dynamic_mesh(obj);
  1592.     var is_world = m_obj_util.is_world(obj);
  1594.     var obj_name = is_world ? m_obj.get_world_name(obj) : obj.name;
  1596.     if (!is_dyn_mesh && !is_world) {
  1597.         m_print.error("set_nodemat_rgb(): Object \"" + obj_name 
  1598.                 + "\" is not a dynamic MESH or WORLD.");
  1599.         return;
  1600.     }
  1602.     if (is_dyn_mesh) {
  1603.         var mat_name = name_list[0];
  1604.         var node_name_prefix_offset = 1;
  1606.         var mat_batch = m_batch.find_batch_material_any(obj, mat_name, "MAIN") 
  1607.                 || m_batch.find_batch_material_any(obj, mat_name, "PARTICLES");
  1608.         if (!mat_batch) {
  1609.             m_print.error("set_nodemat_rgb(): Material \"" + mat_name 
  1610.                     + "\" wasn't found on the object \"" + obj_name + "\".");
  1611.             return;
  1612.         }
  1613.     } else if (is_world) {
  1614.         var active_scene = m_scenes.get_active();
  1615.         var mat_name = "";
  1616.         var node_name_prefix_offset = 0;
  1618.         var mat_batch = m_batch.get_batch_by_type(obj, "SKY", active_scene);
  1619.         if (!mat_batch) {
  1620.             m_print.error("set_nodemat_rgb(): Sky node material wasn't found on the world object \"" 
  1621.                     + obj_name + "\".");
  1622.             return;
  1623.         }
  1624.     }
  1626.     var node_name = m_batch.name_list_to_node_name(name_list, node_name_prefix_offset);
  1627.     var is_changed = m_obj.set_nodemat_rgb(obj, mat_name, node_name, r, g, b);
  1629.     if (!is_changed) {
  1630.         m_print.error("set_nodemat_rgb(): RGB node \"" 
  1631.                 + name_list[name_list.length - 1] 
  1632.                 + "\" was not found in the object \"" + obj_name + "\".");
  1633.     }
  1634. }
  1636. /**
  1637.  * Get color of the RGB node in the object's material.
  1638.  * @method module:material.get_nodemat_rgb
  1639.  * @param {Object3D} obj Object 3D
  1640.  * @param {string[]} name_list List consisting of the material name, the names of
  1641.  * nested node groups (if any) and the name of the RGB node itself.
  1642.  * For a world node material the material name should be omitted.
  1643.  * @param {Vec3} [dest] Destination color
  1644.  * @returns {?RGB} Destination color
  1645.  * @example var m_scenes = require("scenes");
  1646.  * var m_mat  = require("material");
  1647.  *
  1648.  * var cube = m_scenes.get_object_by_name("Cube");
  1649.  * var rgb_node_values = m_mat.get_nodemat_rgb(cube, ["MyMaterial", "MyRGB"]);
  1650.  */
  1651. exports.get_nodemat_rgb = function(obj, name_list, dest) {
  1653.     var is_dyn_mesh = m_obj_util.is_dynamic_mesh(obj);
  1654.     var is_world = m_obj_util.is_world(obj);
  1656.     var obj_name = is_world ? m_obj.get_world_name(obj) : obj.name;
  1658.     if (!is_dyn_mesh && !is_world) {
  1659.         m_print.error("get_nodemat_rgb(): Object \"" + obj_name 
  1660.                 + "\" is not a dynamic MESH or WORLD.");
  1661.         return null;
  1662.     }
  1664.     if (is_dyn_mesh) {
  1665.         var mat_name = name_list[0];
  1666.         var node_name_prefix_offset = 1;
  1668.         var mat_batch = m_batch.find_batch_material_any(obj, mat_name, "MAIN") 
  1669.                 || m_batch.find_batch_material_any(obj, mat_name, "PARTICLES");
  1670.         if (!mat_batch) {
  1671.             m_print.error("get_nodemat_rgb(): Material \"" + mat_name 
  1672.                     + "\" wasn't found on the object \"" + obj_name + "\".");
  1673.             return null;
  1674.         }
  1675.     } else if (is_world) {
  1676.         var active_scene = m_scenes.get_active();
  1677.         var mat_name = "";
  1678.         var node_name_prefix_offset = 0;
  1680.         var mat_batch = m_batch.get_batch_by_type(obj, "SKY", active_scene);
  1681.         if (!mat_batch) {
  1682.             m_print.error("get_nodemat_rgb(): Sky node material wasn't found on the world object \"" 
  1683.                     + obj_name + "\".");
  1684.             return null;
  1685.         }
  1686.     }
  1688.     if (!dest)
  1689.         dest = new Float32Array(3);
  1691.     var node_name = m_batch.name_list_to_node_name(name_list, node_name_prefix_offset);
  1692.     dest = m_obj.get_nodemat_rgb(obj, mat_name, node_name, dest);
  1694.     if (!dest) {
  1695.         m_print.error("get_nodemat_rgb(): RGB node \""
  1696.             + name_list[name_list.length - 1]
  1697.             + "\" was not found in the object \"" + obj_name + "\".");
  1698.     }
  1700.     return dest;
  1701. }
  1703. /**
  1704.  * Check if the object's material is a node material.
  1705.  * @method module:material.is_node_material
  1706.  * @param {Object3D} obj Object 3D
  1707.  * @param {string} mat_name Material name
  1708.  * @returns {boolean} The result of the checking.
  1709.  * @example var m_scenes = require("scenes");
  1710.  * var m_mat = require("material");
  1711.  *
  1712.  * var cube = m_scenes.get_object_by_name("Cube");
  1713.  * var has_nodes = m_mat.is_node_material(cube, "MyMaterial");
  1714.  */
  1715. exports.is_node_material = function(obj, mat_name) {
  1717.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  1718.         m_print.error("is_node_material(): Object \"" + obj.name 
  1719.                 + "\" is not a dynamic MESH.");
  1720.         return false;
  1721.     }
  1723.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  1724.     if (!batch) {
  1725.         m_print.error("is_node_material(): Material \"" + mat_name 
  1726.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  1727.         return false;
  1728.     }
  1730.     return batch.has_nodes;
  1731. }
  1733. /**
  1734.  * Check if the object's material is a water material.
  1735.  * @method module:material.is_water_material
  1736.  * @param {Object3D} obj Object 3D
  1737.  * @param {string} mat_name Material name
  1738.  * @returns {boolean} The result of the checking.
  1739.  * @example var m_scenes = require("scenes");
  1740.  * var m_mat = require("material");
  1741.  *
  1742.  * var cube = m_scenes.get_object_by_name("Cube");
  1743.  * var is_water = m_mat.is_water_material(cube, "MyMaterial");
  1744.  */
  1745. exports.is_water_material = function(obj, mat_name) {
  1746.     if (!m_obj_util.is_dynamic_mesh(obj)) {
  1747.         m_print.error("is_water_material(): Object \"" + obj.name 
  1748.                 + "\" is not a dynamic MESH.");
  1749.         return false;
  1750.     }
  1752.     var batch = m_batch.find_batch_material(obj, mat_name, "MAIN");
  1753.     if (!batch) {
  1754.         m_print.error("is_water_material(): Material \"" + mat_name 
  1755.                 + "\" wasn't found on the object \"" + obj.name + "\".");
  1756.         return false;
  1757.     }
  1759.     return batch.water && !batch.has_nodes;
  1760. }
  1762. }
  1764. var material_factory = register("material", Material);
  1766. export default material_factory;