babylon.materialHelper.ts 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423
  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) {
  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. if ((<any>mesh).morphTargetManager) {
  85. var manager = (<Mesh>mesh).morphTargetManager;
  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. var uniformsList: string[], uniformBuffersList: string[], samplersList: string[], defines: any;
  188. if ((<EffectCreationOptions>uniformsListOrOptions).uniformsNames) {
  189. var options = <EffectCreationOptions>uniformsListOrOptions;
  190. uniformsList = options.uniformsNames;
  191. uniformBuffersList = options.uniformBuffersNames;
  192. samplersList = options.samplers;
  193. defines = options.defines;
  194. maxSimultaneousLights = options.maxSimultaneousLights;
  195. } else {
  196. uniformsList = <string[]>uniformsListOrOptions;
  197. }
  198. for (var lightIndex = 0; lightIndex < maxSimultaneousLights; lightIndex++) {
  199. if (!defines["LIGHT" + lightIndex]) {
  200. break;
  201. }
  202. uniformsList.push(
  203. "vLightData" + lightIndex,
  204. "vLightDiffuse" + lightIndex,
  205. "vLightSpecular" + lightIndex,
  206. "vLightDirection" + lightIndex,
  207. "vLightGround" + lightIndex,
  208. "lightMatrix" + lightIndex,
  209. "shadowsInfo" + lightIndex,
  210. "depthValues" + lightIndex,
  211. );
  212. if (uniformBuffersList) {
  213. uniformBuffersList.push("Light" + lightIndex);
  214. }
  215. samplersList.push("shadowSampler" + lightIndex);
  216. }
  217. if (defines["NUM_MORPH_INFLUENCERS"]) {
  218. uniformsList.push("morphTargetInfluences");
  219. }
  220. }
  221. public static HandleFallbacksForShadows(defines: any, fallbacks: EffectFallbacks, maxSimultaneousLights = 4): void {
  222. if (!defines["SHADOWS"]) {
  223. return;
  224. }
  225. for (var lightIndex = 0; lightIndex < maxSimultaneousLights; lightIndex++) {
  226. if (!defines["LIGHT" + lightIndex]) {
  227. break;
  228. }
  229. if (lightIndex > 0) {
  230. fallbacks.addFallback(lightIndex, "LIGHT" + lightIndex);
  231. }
  232. if (defines["SHADOW" + lightIndex]) {
  233. fallbacks.addFallback(0, "SHADOW" + lightIndex);
  234. }
  235. if (defines["SHADOWPCF" + lightIndex]) {
  236. fallbacks.addFallback(0, "SHADOWPCF" + lightIndex);
  237. }
  238. if (defines["SHADOWESM" + lightIndex]) {
  239. fallbacks.addFallback(0, "SHADOWESM" + lightIndex);
  240. }
  241. }
  242. }
  243. public static PrepareAttributesForMorphTargets(attribs: string[], mesh: AbstractMesh, defines: any): void {
  244. var influencers = defines["NUM_MORPH_INFLUENCERS"];
  245. if (influencers > 0) {
  246. var maxAttributesCount = Engine.LastCreatedEngine.getCaps().maxVertexAttribs;
  247. var manager = (<Mesh>mesh).morphTargetManager;
  248. var normal = manager.supportsNormals && defines["NORMAL"];
  249. var tangent = manager.supportsTangents && defines["TANGENT"];
  250. for (var index = 0; index < influencers; index++) {
  251. attribs.push(VertexBuffer.PositionKind + index);
  252. if (normal) {
  253. attribs.push(VertexBuffer.NormalKind + index);
  254. }
  255. if (tangent) {
  256. attribs.push(VertexBuffer.TangentKind + index);
  257. }
  258. if (attribs.length > maxAttributesCount) {
  259. Tools.Error("Cannot add more vertex attributes for mesh " + mesh.name);
  260. }
  261. }
  262. }
  263. }
  264. public static PrepareAttributesForBones(attribs: string[], mesh: AbstractMesh, defines: any, fallbacks: EffectFallbacks): void {
  265. if (defines["NUM_BONE_INFLUENCERS"] > 0) {
  266. fallbacks.addCPUSkinningFallback(0, mesh);
  267. attribs.push(VertexBuffer.MatricesIndicesKind);
  268. attribs.push(VertexBuffer.MatricesWeightsKind);
  269. if (defines["NUM_BONE_INFLUENCERS"] > 4) {
  270. attribs.push(VertexBuffer.MatricesIndicesExtraKind);
  271. attribs.push(VertexBuffer.MatricesWeightsExtraKind);
  272. }
  273. }
  274. }
  275. public static PrepareAttributesForInstances(attribs: string[], defines: any): void {
  276. if (defines["INSTANCES"]) {
  277. attribs.push("world0");
  278. attribs.push("world1");
  279. attribs.push("world2");
  280. attribs.push("world3");
  281. }
  282. }
  283. // Bindings
  284. public static BindLightShadow(light: Light, scene: Scene, mesh: AbstractMesh, lightIndex: string, effect: Effect): void {
  285. if (light.shadowEnabled && mesh.receiveShadows) {
  286. var shadowGenerator = light.getShadowGenerator();
  287. if (shadowGenerator) {
  288. shadowGenerator.bindShadowLight(lightIndex, effect);
  289. }
  290. }
  291. }
  292. public static BindLightProperties(light: Light, effect: Effect, lightIndex: number): void {
  293. light.transferToEffect(effect, lightIndex + "");
  294. }
  295. public static BindLights(scene: Scene, mesh: AbstractMesh, effect: Effect, defines: any, maxSimultaneousLights = 4, usePhysicalLightFalloff = false) {
  296. var lightIndex = 0;
  297. for (var light of mesh._lightSources) {
  298. let scaledIntensity = light.getScaledIntensity();
  299. light._uniformBuffer.bindToEffect(effect, "Light" + lightIndex);
  300. MaterialHelper.BindLightProperties(light, effect, lightIndex);
  301. light.diffuse.scaleToRef(scaledIntensity, Tmp.Color3[0]);
  302. light._uniformBuffer.updateColor4("vLightDiffuse", Tmp.Color3[0], usePhysicalLightFalloff ? light.radius : light.range, lightIndex + "");
  303. if (defines["SPECULARTERM"]) {
  304. light.specular.scaleToRef(scaledIntensity, Tmp.Color3[1]);
  305. light._uniformBuffer.updateColor3("vLightSpecular", Tmp.Color3[1], lightIndex + "");
  306. }
  307. // Shadows
  308. if (scene.shadowsEnabled) {
  309. this.BindLightShadow(light, scene, mesh, lightIndex + "", effect);
  310. }
  311. light._uniformBuffer.update();
  312. lightIndex++;
  313. if (lightIndex === maxSimultaneousLights)
  314. break;
  315. }
  316. }
  317. public static BindFogParameters(scene: Scene, mesh: AbstractMesh, effect: Effect): void {
  318. if (scene.fogEnabled && mesh.applyFog && scene.fogMode !== Scene.FOGMODE_NONE) {
  319. effect.setFloat4("vFogInfos", scene.fogMode, scene.fogStart, scene.fogEnd, scene.fogDensity);
  320. effect.setColor3("vFogColor", scene.fogColor);
  321. }
  322. }
  323. public static BindBonesParameters(mesh: AbstractMesh, effect: Effect): void {
  324. if (mesh && mesh.useBones && mesh.computeBonesUsingShaders) {
  325. var matrices = mesh.skeleton.getTransformMatrices(mesh);
  326. if (matrices) {
  327. effect.setMatrices("mBones", matrices);
  328. }
  329. }
  330. }
  331. public static BindMorphTargetParameters(abstractMesh: AbstractMesh, effect: Effect): void {
  332. if (!abstractMesh || !(<Mesh>abstractMesh).morphTargetManager) {
  333. return;
  334. }
  335. effect.setFloatArray("morphTargetInfluences", (<Mesh>abstractMesh).morphTargetManager.influences);
  336. }
  337. public static BindLogDepth(defines: any, effect: Effect, scene: Scene): void {
  338. if (defines["LOGARITHMICDEPTH"]) {
  339. effect.setFloat("logarithmicDepthConstant", 2.0 / (Math.log(scene.activeCamera.maxZ + 1.0) / Math.LN2));
  340. }
  341. }
  342. public static BindClipPlane(effect: Effect, scene: Scene): void {
  343. if (scene.clipPlane) {
  344. var clipPlane = scene.clipPlane;
  345. effect.setFloat4("vClipPlane", clipPlane.normal.x, clipPlane.normal.y, clipPlane.normal.z, clipPlane.d);
  346. }
  347. }
  348. }
  349. }