Solves issue #6519

Author: Garima3110

src/webgl/p5.Camera.js

@@ -122,36 +122,42 @@ p5.prototype.camera = function (...args) {
  * that are close to the camera appear their actual size while those
  * that are further away from the camera appear smaller.
  *
+ *
  * The parameters to this function define the viewing frustum
  * (the truncated pyramid within which objects are seen by the camera) through
  * vertical field of view, aspect ratio (usually width/height), and near and far
  * clipping planes.
  *
- * If no parameters are given, the default values are used, with a fixed location and a variable field of view.
- * @method  perspective
- * @for p5
- * @param  {Number} [fovy]  - camera frustum vertical field of view,
- *                           from bottom to top of view, in <a href="#/p5/angleMode">angleMode</a> units.
- *  The default value is now variable and based on the canvas size as:
- *  this.defaultEyeZ = 800;
- *  defaultCameraFOV = 2 * Math.atan(this._renderer.height / 2 / this.defaultEyeZ);
+ * If no parameters are given, the default values are used as:
  *
- * @param  {Number} [aspect] camera frustum aspect ratio .The default value = this._renderer.width / this._renderer.height;
- * @param  {Number} [near]   frustum near plane length or the near clipping plane. The default value = this.defaultEyeZ * 0.1;
- * @param  {Number} [far]    frustum far plane length or the far clipping plane. The default value = this.defaultEyeZ * 10;
  *
- * However,If you prefer a fixed field of view, you can use the old defaults:
+ * fov- The default field of view for the camera is such that the full height of renderer is visible when it is positioned at a default distance of 800 units from the camera.
  *
- * - Field of view: PI/3 (60 degrees)
- * - Canvas aspect ratio: width / height
- * - Near clipping plane: eyeZ / 10
- * - Far clipping plane: eyeZ * 10
+ * aspect- The default aspect ratio is the ratio of renderer's width to renderer's height.
  *
- * @example
- * Set a fixed field of view
- * perspective(PI/3, width / height, eyeZ / 10, eyeZ * 10);
- * where eyeZ is equal to ((height/2) / tan(PI/6)).
+ * near - The default value for the near clipping plane is 0.1 times the default distance from the camera to the point it is looking at i.e 800.
+ *
+ * far - The default value for the far clipping plane is 10 times the default distance from the camera to the point it is looking at i.e 800.
+ *
+ * If you prefer a fixed field of view, follow these steps:
  *
+ * 1.Choose your desired field of view angle (`fovy`). This is how wide the camera can see.
+ *
+ * 2.To position the camera correctly, use the formula:
+ *   cameraDistance = (height / 2) / tan(fovy / 2);
+ *   This ensures that you can see the entire width across horizontally and height across vertically at the fixed field of view.
+ *
+ * 3.Set the near value to  cameraDistance / 10 and the far value to  cameraDistance * 10 .
+ *
+ * 4.Simply, call perspective with the chosen field of view, canvas aspect ratio, and near/far values:
+ *    perspective(fovy, width / height, cameraDistance / 10, cameraDistance * 10);
+ * @method  perspective
+ * @for p5
+ * @param  {Number} [fovy]   camera frustum vertical field of view,
+ *                           from bottom to top of view, in <a href="#/p5/angleMode">angleMode</a> units.
+ * @param  {Number} [aspect] camera frustum aspect ratio
+ * @param  {Number} [near]   frustum near plane length
+ * @param  {Number} [far]    frustum far plane length
  * @chainable
  * @example
  * <div>
@@ -171,7 +177,7 @@ p5.prototype.camera = function (...args) {
  *
  *   rotateX(-0.3);
  *   rotateY(-0.2);
- *   translate(0, 0, -50);
+ *   translate(0, 0, -100);
  *
  *   push();
  *   translate(-15, 0, sin(frameCount / 30) * 95);