babylon.materialHelper.ts 19 KB

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