Docs: More JSDoc. (#30733)

Author: Mugen87

examples/jsm/shaders/ACESFilmicToneMappingShader.js

@@ -1,11 +1,15 @@
+/** @module ACESFilmicToneMappingShader */
+
 /**
- * ACES Filmic Tone Mapping Shader by Stephen Hill
- * source: https://github.com/selfshadow/ltc_code/blob/master/webgl/shaders/ltc/ltc_blit.fs
+ * ACES Filmic Tone Mapping Shader by Stephen Hill.
+ * Reference: [ltc_blit.fs]{@link https://github.com/selfshadow/ltc_code/blob/master/webgl/shaders/ltc/ltc_blit.fs}
+ *
+ * This implementation of ACES is modified to accommodate a brighter viewing environment.
+ * The scale factor of 1/0.6 is subjective. See discussion in #19621.
  *
- * this implementation of ACES is modified to accommodate a brighter viewing environment.
- * the scale factor of 1/0.6 is subjective. see discussion in #19621.
+ * @constant
+ * @type {Object}
  */
-
 const ACESFilmicToneMappingShader = {
 
 	name: 'ACESFilmicToneMappingShader',

examples/jsm/shaders/AfterimageShader.js

@@ -1,9 +1,11 @@
+/** @module AfterimageShader */
+
 /**
- * Afterimage shader
- * I created this effect inspired by a demo on codepen:
- * https://codepen.io/brunoimbrizi/pen/MoRJaN?page=1&
+ * Inspired by [Three.js FBO motion trails]{@link https://codepen.io/brunoimbrizi/pen/MoRJaN?page=1&}.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const AfterimageShader = {
 
 	name: 'AfterimageShader',

examples/jsm/shaders/BasicShader.js

@@ -1,7 +1,11 @@
+/** @module BasicShader */
+
 /**
- * Simple test shader
+ * Simple shader for testing.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const BasicShader = {
 
 	name: 'BasicShader',

examples/jsm/shaders/BleachBypassShader.js

@@ -1,9 +1,13 @@
+
+/** @module BleachBypassShader */
+
 /**
- * Bleach bypass shader [http://en.wikipedia.org/wiki/Bleach_bypass]
- * - based on Nvidia example
- * http://developer.download.nvidia.com/shaderlibrary/webpages/shader_library.html#post_bleach_bypass
+ * Bleach bypass shader [http://en.wikipedia.org/wiki/Bleach_bypass] based on
+ * [Nvidia Shader library]{@link http://developer.download.nvidia.com/shaderlibrary/webpages/shader_library.html#post_bleach_bypass}.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const BleachBypassShader = {
 
 	name: 'BleachBypassShader',

examples/jsm/shaders/BlendShader.js

@@ -1,7 +1,11 @@
+/** @module BlendShader */
+
 /**
- * Blend two textures
+ * Blends two textures.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const BlendShader = {
 
 	name: 'BlendShader',

examples/jsm/shaders/BokehShader.js

@@ -1,9 +1,12 @@
+/** @module BokehShader */
+
 /**
- * Depth-of-field shader with bokeh
- * ported from GLSL shader by Martins Upitis
- * http://artmartinsh.blogspot.com/2010/02/glsl-lens-blur-filter-with-bokeh.html
+ * Depth-of-field shader with bokeh ported from
+ * [GLSL shader by Martins Upitis]{@link http://artmartinsh.blogspot.com/2010/02/glsl-lens-blur-filter-with-bokeh.html}.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const BokehShader = {
 
 	name: 'BokehShader',

examples/jsm/shaders/BokehShader2.js

@@ -2,12 +2,16 @@ import {
 	Vector2
 } from 'three';
 
+/** @module BokehShader2 */
+
 /**
- * Depth-of-field shader with bokeh
- * ported from GLSL shader by Martins Upitis
- * http://blenderartists.org/forum/showthread.php?237488-GLSL-depth-of-field-with-bokeh-v2-4-(update)
+ * Depth-of-field shader with bokeh ported from
+ * [GLSL shader by Martins Upitis]{@link http://blenderartists.org/forum/showthread.php?237488-GLSL-depth-of-field-with-bokeh-v2-4-(update)}.
  *
  * Requires #define RINGS and SAMPLES integers
+ *
+ * @constant
+ * @type {Object}
  */
 const BokehShader = {
 

examples/jsm/shaders/BrightnessContrastShader.js

@@ -1,10 +1,13 @@
+/** @module BrightnessContrastShader */
+
 /**
- * Brightness and contrast adjustment
- * https://github.com/evanw/glfx.js
- * brightness: -1 to 1 (-1 is solid black, 0 is no change, and 1 is solid white)
- * contrast: -1 to 1 (-1 is solid gray, 0 is no change, and 1 is maximum contrast)
+ * Brightness and contrast adjustment {@link https://github.com/evanw/glfx.js}.
+ * Brightness: -1 to 1 (-1 is solid black, 0 is no change, and 1 is solid white)
+ * Contrast: -1 to 1 (-1 is solid gray, 0 is no change, and 1 is maximum contrast)
+ *
+ * @constant
+ * @type {Object}
  */
-
 const BrightnessContrastShader = {
 
 	name: 'BrightnessContrastShader',

examples/jsm/shaders/ColorCorrectionShader.js

@@ -2,10 +2,14 @@ import {
 	Vector3
 } from 'three';
 
+/** @module ColorCorrectionShader */
+
 /**
- * Color correction
+ * Color correction shader.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const ColorCorrectionShader = {
 
 	name: 'ColorCorrectionShader',

examples/jsm/shaders/ColorifyShader.js

@@ -2,10 +2,14 @@ import {
 	Color
 } from 'three';
 
+/** @module ColorifyShader */
+
 /**
- * Colorify shader
+ * Colorify shader.
+ *
+ * @constant
+ * @type {Object}
  */
-
 const ColorifyShader = {
 
 	name: 'ColorifyShader',