Source: render/Renderer.js

  1. import { RenderTargetBack } from './RenderTargetBack.js';
  2. import { WebGLCore } from './WebGL/WebGLCore.js';
  3. import { ShadowMapPass } from './prePass/ShadowMapPass.js';
  5. /**
  6.  * A simple forward renderer.
  7.  * @constructor
  8.  * @memberof zen3d
  9.  * @param {HTMLCanvasElement} view - The canvas elements.
  10.  * @param {Object} [options=] - The {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/getContext options for webgl context}.
  11.  */
  12. function Renderer(view, options) {
  13. 	var defaultContextParams = {
  14. 		antialias: true, // antialias
  15. 		alpha: false, // effect performance, default false
  16. 		// premultipliedAlpha: false, // effect performance, default false
  17. 		stencil: true
  18. 	};
  20. 	var gl = view.getContext("webgl2", options || defaultContextParams) || view.getContext("webgl", options || defaultContextParams);
  22. 	this.glCore = new WebGLCore(gl);
  24. 	console.info("ForwardRenderer use WebGL Version: " + this.glCore.capabilities.version);
  26. 	this.backRenderTarget = new RenderTargetBack(view);
  28. 	this.shadowMapPass = new ShadowMapPass();
  30. 	/**
  31.      * Defines whether the shadow pass should automatically update.
  32.      * @type {boolean}
  33.      * @default true
  34.      */
  35. 	this.shadowAutoUpdate = true;
  37. 	/**
  38.      * If {@link zen3d.Renderer.shadowAutoUpdate} is set true and this set true, shadow will update and set this to false automatically.
  39.      * @type {boolean}
  40.      * @default false
  41.      */
  42. 	this.shadowNeedsUpdate = false;
  44. 	/**
  45.      * Defines whether the scene should automatically update its matrix.
  46.      * @type {boolean}
  47.      * @default true
  48.      */
  49. 	this.matrixAutoUpdate = true;
  51. 	/**
  52.      * Defines whether the scene should automatically update its lights.
  53.      * @type {boolean}
  54.      * @default true
  55.      */
  56. 	this.lightsAutoUpdate = true;
  58. 	/**
  59.      * Defines whether the renderer should automatically clear its output before rendering a frame.
  60.      * @type {boolean}
  61.      * @default true
  62.      */
  63. 	this.autoClear = true;
  64. }
  66. /**
  67.  * Render a scene using a camera.
  68.  * The render is done to the renderTarget (if specified) or to the canvas as usual.
  69.  * @param {zen3d.Scene} scene - The scene.
  70.  * @param {zen3d.Camera} camera - The camera.
  71.  * @param {zen3d.RenderTargetBase} [renderTarget=] - The render is done to the renderTarget (if specified) or to the canvas as usual.
  72.  * @param {boolean} [forceClear=false] - If set true, the depth, stencil and color buffers will be cleared before rendering even if the renderer's autoClear property is false.
  73.  */
  74. Renderer.prototype.render = function(scene, camera, renderTarget, forceClear) {
  75. 	this.matrixAutoUpdate && scene.updateMatrix();
  76. 	this.lightsAutoUpdate && scene.updateLights();
  78. 	if (this.shadowAutoUpdate || this.shadowNeedsUpdate) {
  79. 		this.shadowMapPass.render(this.glCore, scene);
  81. 		this.shadowNeedsUpdate = false;
  82. 	}
  84. 	if (renderTarget === undefined) {
  85. 		renderTarget = this.backRenderTarget;
  86. 	}
  87. 	this.glCore.renderTarget.setRenderTarget(renderTarget);
  89. 	if (this.autoClear || forceClear) {
  90. 		this.glCore.clear(true, true, true);
  91. 	}
  93. 	this.glCore.render(scene, camera);
  95. 	if (!!renderTarget.texture) {
  96. 		this.glCore.renderTarget.updateRenderTargetMipmap(renderTarget);
  97. 	}
  98. }
  100. export { Renderer };