babylon.materialHelper.ts 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428
  1. module BABYLON {
  2. export class MaterialHelper {
  3. public static PrepareDefinesForMergedUV(texture: BaseTexture, defines: any, key: string): void {
  4. defines._needUVs = true;
  5. defines[key] = true;
  6. if (texture.getTextureMatrix().isIdentity(true)) {
  7. defines[key + "DIRECTUV"] = texture.coordinatesIndex + 1;
  8. if (texture.coordinatesIndex === 0) {
  9. defines["MAINUV1"] = true;
  10. } else {
  11. defines["MAINUV2"] = true;
  12. }
  13. } else {
  14. defines[key + "DIRECTUV"] = 0;
  15. }
  16. }
  17. public static BindTextureMatrix(texture: BaseTexture, uniformBuffer: UniformBuffer, key: string): void {
  18. var matrix = texture.getTextureMatrix();
  19. if (!matrix.isIdentity(true)) {
  20. uniformBuffer.updateMatrix(key + "Matrix", matrix);
  21. }
  22. }
  23. public static PrepareDefinesForMisc(mesh: AbstractMesh, scene: Scene, useLogarithmicDepth: boolean, pointsCloud: boolean, fogEnabled: boolean, defines: any): void {
  24. if (defines._areMiscDirty) {
  25. defines["LOGARITHMICDEPTH"] = useLogarithmicDepth;
  26. defines["POINTSIZE"] = (pointsCloud || scene.forcePointsCloud);
  27. defines["FOG"] = (scene.fogEnabled && mesh.applyFog && scene.fogMode !== Scene.FOGMODE_NONE && fogEnabled);
  28. defines["NONUNIFORMSCALING"] = mesh.nonUniformScaling;
  29. }
  30. }
  31. public static PrepareDefinesForFrameBoundValues(scene: Scene, engine: Engine, defines: any, useInstances: boolean, forceAlphaTest = false): void {
  32. var changed = false;
  33. if (defines["CLIPPLANE"] !== (scene.clipPlane !== undefined && scene.clipPlane !== null)) {
  34. defines["CLIPPLANE"] = !defines["CLIPPLANE"];
  35. changed = true;
  36. }
  37. if (defines["ALPHATEST"] !== (engine.getAlphaTesting() || forceAlphaTest)) {
  38. defines["ALPHATEST"] = !defines["ALPHATEST"];
  39. changed = true;
  40. }
  41. if (defines["DEPTHPREPASS"] !== !engine.getColorWrite()) {
  42. defines["DEPTHPREPASS"] = !defines["DEPTHPREPASS"];
  43. changed = true;
  44. }
  45. if (defines["INSTANCES"] !== useInstances) {
  46. defines["INSTANCES"] = useInstances;
  47. changed = true;
  48. }
  49. if (changed) {
  50. defines.markAsUnprocessed();
  51. }
  52. }
  53. public static PrepareDefinesForAttributes(mesh: AbstractMesh, defines: any, useVertexColor: boolean, useBones: boolean, useMorphTargets = false): boolean {
  54. if (!defines._areAttributesDirty && defines._needNormals === defines._normals && defines._needUVs === defines._uvs) {
  55. return false;
  56. }
  57. defines._normals = defines._needNormals;
  58. defines._uvs = defines._needUVs;
  59. defines["NORMAL"] = (defines._needNormals && mesh.isVerticesDataPresent(VertexBuffer.NormalKind));
  60. if (defines._needNormals && mesh.isVerticesDataPresent(VertexBuffer.TangentKind)) {
  61. defines["TANGENT"] = true;
  62. }
  63. if (defines._needUVs) {
  64. defines["UV1"] = mesh.isVerticesDataPresent(VertexBuffer.UVKind);
  65. defines["UV2"] = mesh.isVerticesDataPresent(VertexBuffer.UV2Kind);
  66. } else {
  67. defines["UV1"] = false;
  68. defines["UV2"] = false;
  69. }
  70. if (useVertexColor) {
  71. defines["VERTEXCOLOR"] = mesh.useVertexColors && mesh.isVerticesDataPresent(VertexBuffer.ColorKind);
  72. defines["VERTEXALPHA"] = mesh.hasVertexAlpha;
  73. }
  74. if (useBones) {
  75. if (mesh.useBones && mesh.computeBonesUsingShaders && mesh.skeleton) {
  76. defines["NUM_BONE_INFLUENCERS"] = mesh.numBoneInfluencers;
  77. defines["BonesPerMesh"] = (mesh.skeleton.bones.length + 1);
  78. } else {
  79. defines["NUM_BONE_INFLUENCERS"] = 0;
  80. defines["BonesPerMesh"] = 0;
  81. }
  82. }
  83. if (useMorphTargets) {
  84. var manager = (<Mesh>mesh).morphTargetManager;
  85. if (manager) {
  86. defines["MORPHTARGETS_TANGENT"] = manager.supportsTangents && defines["TANGENT"];
  87. defines["MORPHTARGETS_NORMAL"] = manager.supportsNormals && defines["NORMAL"] ;
  88. defines["MORPHTARGETS"] = (manager.numInfluencers > 0);
  89. defines["NUM_MORPH_INFLUENCERS"] = manager.numInfluencers;
  90. } else {
  91. defines["MORPHTARGETS_TANGENT"] = false;
  92. defines["MORPHTARGETS_NORMAL"] = false;
  93. defines["MORPHTARGETS"] = false;
  94. defines["NUM_MORPH_INFLUENCERS"] = 0;
  95. }
  96. }
  97. return true;
  98. }
  99. public static PrepareDefinesForLights(scene: Scene, mesh: AbstractMesh, defines: any, specularSupported: boolean, maxSimultaneousLights = 4, disableLighting = false): boolean {
  100. if (!defines._areLightsDirty) {
  101. return defines._needNormals;
  102. }
  103. var lightIndex = 0;
  104. var needNormals = false;
  105. var needRebuild = false;
  106. var lightmapMode = false;
  107. var shadowEnabled = false;
  108. var specularEnabled = false;
  109. if (scene.lightsEnabled && !disableLighting) {
  110. for (var light of mesh._lightSources) {
  111. needNormals = true;
  112. if (defines["LIGHT" + lightIndex] === undefined) {
  113. needRebuild = true;
  114. }
  115. defines["LIGHT" + lightIndex] = true;
  116. defines["SPOTLIGHT" + lightIndex] = false;
  117. defines["HEMILIGHT" + lightIndex] = false;
  118. defines["POINTLIGHT" + lightIndex] = false;
  119. defines["DIRLIGHT" + lightIndex] = false;
  120. var type;
  121. if (light.getTypeID() === Light.LIGHTTYPEID_SPOTLIGHT) {
  122. type = "SPOTLIGHT" + lightIndex;
  123. } else if (light.getTypeID() === Light.LIGHTTYPEID_HEMISPHERICLIGHT) {
  124. type = "HEMILIGHT" + lightIndex;
  125. } else if (light.getTypeID() === Light.LIGHTTYPEID_POINTLIGHT) {
  126. type = "POINTLIGHT" + lightIndex;
  127. } else {
  128. type = "DIRLIGHT" + lightIndex;
  129. }
  130. defines[type] = true;
  131. // Specular
  132. if (specularSupported && !light.specular.equalsFloats(0, 0, 0)) {
  133. specularEnabled = true;
  134. }
  135. // Shadows
  136. defines["SHADOW" + lightIndex] = false;
  137. defines["SHADOWPCF" + lightIndex] = false;
  138. defines["SHADOWESM" + lightIndex] = false;
  139. defines["SHADOWCUBE" + lightIndex] = false;
  140. if (mesh && mesh.receiveShadows && scene.shadowsEnabled && light.shadowEnabled) {
  141. var shadowGenerator = light.getShadowGenerator();
  142. if (shadowGenerator) {
  143. shadowEnabled = true;
  144. shadowGenerator.prepareDefines(defines, lightIndex);
  145. }
  146. }
  147. if (light.lightmapMode != Light.LIGHTMAP_DEFAULT ) {
  148. lightmapMode = true;
  149. defines["LIGHTMAPEXCLUDED" + lightIndex] = true;
  150. defines["LIGHTMAPNOSPECULAR" + lightIndex] = (light.lightmapMode == Light.LIGHTMAP_SHADOWSONLY);
  151. } else {
  152. defines["LIGHTMAPEXCLUDED" + lightIndex] = false;
  153. defines["LIGHTMAPNOSPECULAR" + lightIndex] = false;
  154. }
  155. lightIndex++;
  156. if (lightIndex === maxSimultaneousLights)
  157. break;
  158. }
  159. }
  160. defines["SPECULARTERM"] = specularEnabled;
  161. defines["SHADOWS"] = shadowEnabled;
  162. // Resetting all other lights if any
  163. for (var index = lightIndex; index < maxSimultaneousLights; index++) {
  164. if (defines["LIGHT" + index] !== undefined) {
  165. defines["LIGHT" + index] = false;
  166. defines["HEMILIGHT" + lightIndex] = false;
  167. defines["POINTLIGHT" + lightIndex] = false;
  168. defines["DIRLIGHT" + lightIndex] = false;
  169. defines["SPOTLIGHT" + lightIndex] = false;
  170. defines["SHADOW" + lightIndex] = false;
  171. }
  172. }
  173. let caps = scene.getEngine().getCaps();
  174. if (defines["SHADOWFLOAT"] === undefined) {
  175. needRebuild = true;
  176. }
  177. defines["SHADOWFLOAT"] = shadowEnabled &&
  178. ((caps.textureFloatRender && caps.textureFloatLinearFiltering) ||
  179. (caps.textureHalfFloatRender && caps.textureHalfFloatLinearFiltering));
  180. defines["LIGHTMAPEXCLUDED"] = lightmapMode;
  181. if (needRebuild) {
  182. defines.rebuild();
  183. }
  184. return needNormals;
  185. }
  186. public static PrepareUniformsAndSamplersList(uniformsListOrOptions: string[] | EffectCreationOptions, samplersList?: string[], defines?: any, maxSimultaneousLights = 4): void {
  187. let uniformsList: string[];
  188. let uniformBuffersList: Nullable<string[]> = null;
  189. if ((<EffectCreationOptions>uniformsListOrOptions).uniformsNames) {
  190. var options = <EffectCreationOptions>uniformsListOrOptions;
  191. uniformsList = options.uniformsNames;
  192. uniformBuffersList = options.uniformBuffersNames;
  193. samplersList = options.samplers;
  194. defines = options.defines;
  195. maxSimultaneousLights = options.maxSimultaneousLights;
  196. } else {
  197. uniformsList = <string[]>uniformsListOrOptions;
  198. if (!samplersList) {
  199. samplersList = [];
  200. }
  201. }
  202. for (var lightIndex = 0; lightIndex < maxSimultaneousLights; lightIndex++) {
  203. if (!defines["LIGHT" + lightIndex]) {
  204. break;
  205. }
  206. uniformsList.push(
  207. "vLightData" + lightIndex,
  208. "vLightDiffuse" + lightIndex,
  209. "vLightSpecular" + lightIndex,
  210. "vLightDirection" + lightIndex,
  211. "vLightGround" + lightIndex,
  212. "lightMatrix" + lightIndex,
  213. "shadowsInfo" + lightIndex,
  214. "depthValues" + lightIndex,
  215. );
  216. if (uniformBuffersList) {
  217. uniformBuffersList.push("Light" + lightIndex);
  218. }
  219. samplersList.push("shadowSampler" + lightIndex);
  220. }
  221. if (defines["NUM_MORPH_INFLUENCERS"]) {
  222. uniformsList.push("morphTargetInfluences");
  223. }
  224. }
  225. public static HandleFallbacksForShadows(defines: any, fallbacks: EffectFallbacks, maxSimultaneousLights = 4): void {
  226. if (!defines["SHADOWS"]) {
  227. return;
  228. }
  229. for (var lightIndex = 0; lightIndex < maxSimultaneousLights; lightIndex++) {
  230. if (!defines["LIGHT" + lightIndex]) {
  231. break;
  232. }
  233. if (lightIndex > 0) {
  234. fallbacks.addFallback(lightIndex, "LIGHT" + lightIndex);
  235. }
  236. if (defines["SHADOW" + lightIndex]) {
  237. fallbacks.addFallback(0, "SHADOW" + lightIndex);
  238. }
  239. if (defines["SHADOWPCF" + lightIndex]) {
  240. fallbacks.addFallback(0, "SHADOWPCF" + lightIndex);
  241. }
  242. if (defines["SHADOWESM" + lightIndex]) {
  243. fallbacks.addFallback(0, "SHADOWESM" + lightIndex);
  244. }
  245. }
  246. }
  247. public static PrepareAttributesForMorphTargets(attribs: string[], mesh: AbstractMesh, defines: any): void {
  248. var influencers = defines["NUM_MORPH_INFLUENCERS"];
  249. if (influencers > 0 && Engine.LastCreatedEngine) {
  250. var maxAttributesCount = Engine.LastCreatedEngine.getCaps().maxVertexAttribs;
  251. var manager = (<Mesh>mesh).morphTargetManager;
  252. var normal = manager && manager.supportsNormals && defines["NORMAL"];
  253. var tangent = manager && manager.supportsTangents && defines["TANGENT"];
  254. for (var index = 0; index < influencers; index++) {
  255. attribs.push(VertexBuffer.PositionKind + index);
  256. if (normal) {
  257. attribs.push(VertexBuffer.NormalKind + index);
  258. }
  259. if (tangent) {
  260. attribs.push(VertexBuffer.TangentKind + index);
  261. }
  262. if (attribs.length > maxAttributesCount) {
  263. Tools.Error("Cannot add more vertex attributes for mesh " + mesh.name);
  264. }
  265. }
  266. }
  267. }
  268. public static PrepareAttributesForBones(attribs: string[], mesh: AbstractMesh, defines: any, fallbacks: EffectFallbacks): void {
  269. if (defines["NUM_BONE_INFLUENCERS"] > 0) {
  270. fallbacks.addCPUSkinningFallback(0, mesh);
  271. attribs.push(VertexBuffer.MatricesIndicesKind);
  272. attribs.push(VertexBuffer.MatricesWeightsKind);
  273. if (defines["NUM_BONE_INFLUENCERS"] > 4) {
  274. attribs.push(VertexBuffer.MatricesIndicesExtraKind);
  275. attribs.push(VertexBuffer.MatricesWeightsExtraKind);
  276. }
  277. }
  278. }
  279. public static PrepareAttributesForInstances(attribs: string[], defines: any): void {
  280. if (defines["INSTANCES"]) {
  281. attribs.push("world0");
  282. attribs.push("world1");
  283. attribs.push("world2");
  284. attribs.push("world3");
  285. }
  286. }
  287. // Bindings
  288. public static BindLightShadow(light: Light, scene: Scene, mesh: AbstractMesh, lightIndex: string, effect: Effect): void {
  289. if (light.shadowEnabled && mesh.receiveShadows) {
  290. var shadowGenerator = light.getShadowGenerator();
  291. if (shadowGenerator) {
  292. shadowGenerator.bindShadowLight(lightIndex, effect);
  293. }
  294. }
  295. }
  296. public static BindLightProperties(light: Light, effect: Effect, lightIndex: number): void {
  297. light.transferToEffect(effect, lightIndex + "");
  298. }
  299. public static BindLights(scene: Scene, mesh: AbstractMesh, effect: Effect, defines: any, maxSimultaneousLights = 4, usePhysicalLightFalloff = false) {
  300. var lightIndex = 0;
  301. for (var light of mesh._lightSources) {
  302. let scaledIntensity = light.getScaledIntensity();
  303. light._uniformBuffer.bindToEffect(effect, "Light" + lightIndex);
  304. MaterialHelper.BindLightProperties(light, effect, lightIndex);
  305. light.diffuse.scaleToRef(scaledIntensity, Tmp.Color3[0]);
  306. light._uniformBuffer.updateColor4("vLightDiffuse", Tmp.Color3[0], usePhysicalLightFalloff ? light.radius : light.range, lightIndex + "");
  307. if (defines["SPECULARTERM"]) {
  308. light.specular.scaleToRef(scaledIntensity, Tmp.Color3[1]);
  309. light._uniformBuffer.updateColor3("vLightSpecular", Tmp.Color3[1], lightIndex + "");
  310. }
  311. // Shadows
  312. if (scene.shadowsEnabled) {
  313. this.BindLightShadow(light, scene, mesh, lightIndex + "", effect);
  314. }
  315. light._uniformBuffer.update();
  316. lightIndex++;
  317. if (lightIndex === maxSimultaneousLights)
  318. break;
  319. }
  320. }
  321. public static BindFogParameters(scene: Scene, mesh: AbstractMesh, effect: Effect): void {
  322. if (scene.fogEnabled && mesh.applyFog && scene.fogMode !== Scene.FOGMODE_NONE) {
  323. effect.setFloat4("vFogInfos", scene.fogMode, scene.fogStart, scene.fogEnd, scene.fogDensity);
  324. effect.setColor3("vFogColor", scene.fogColor);
  325. }
  326. }
  327. public static BindBonesParameters(mesh?: AbstractMesh, effect?: Effect): void {
  328. if (mesh && mesh.useBones && mesh.computeBonesUsingShaders && mesh.skeleton) {
  329. var matrices = mesh.skeleton.getTransformMatrices(mesh);
  330. if (matrices && effect) {
  331. effect.setMatrices("mBones", matrices);
  332. }
  333. }
  334. }
  335. public static BindMorphTargetParameters(abstractMesh: AbstractMesh, effect: Effect): void {
  336. let manager = (<Mesh>abstractMesh).morphTargetManager;
  337. if (!abstractMesh || !manager) {
  338. return;
  339. }
  340. effect.setFloatArray("morphTargetInfluences", manager.influences);
  341. }
  342. public static BindLogDepth(defines: any, effect: Effect, scene: Scene): void {
  343. if (defines["LOGARITHMICDEPTH"]) {
  344. effect.setFloat("logarithmicDepthConstant", 2.0 / (Math.log((<Camera>scene.activeCamera).maxZ + 1.0) / Math.LN2));
  345. }
  346. }
  347. public static BindClipPlane(effect: Effect, scene: Scene): void {
  348. if (scene.clipPlane) {
  349. var clipPlane = scene.clipPlane;
  350. effect.setFloat4("vClipPlane", clipPlane.normal.x, clipPlane.normal.y, clipPlane.normal.z, clipPlane.d);
  351. }
  352. }
  353. }
  354. }