-
-
Notifications
You must be signed in to change notification settings - Fork 3.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Solves issue #4214 #6734
Solves issue #4214 #6734
Changes from all commits
ba0f02e
656f80c
c86235e
2e945b2
e820394
6b0957f
ceec746
69e7276
e0ed90a
f807ca7
3ea9737
6640e17
15ef523
fbd12d9
2e72d2e
517803e
9ebecea
bbb4a3f
53a6c4d
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -193,6 +193,116 @@ p5.prototype.perspective = function (...args) { | |
return this; | ||
}; | ||
|
||
|
||
/** | ||
* | ||
* Enable or disable perspective for lines in the WebGL renderer. | ||
* The behavior of `linePerspective()` is associated with the type of camera projection being used. | ||
* | ||
* - When using `perspective()`, which simulates realistic perspective, linePerspective | ||
* is set to `true` by default. This means that lines will be affected by the current | ||
* camera's perspective, resulting in a more natural appearance. | ||
* - When using `ortho()` or `frustum()`, which do not simulate realistic perspective, | ||
* linePerspective is set to `false` by default. In this case, lines will have a uniform | ||
* scale regardless of the camera's perspective, providing a more predictable and | ||
* consistent appearance. | ||
* - You can override the default behavior by explicitly calling `linePerspective()` after | ||
* using `perspective()`, `ortho()`, or `frustum()`. This allows you to customize the line | ||
* perspective based on your specific requirements. | ||
* | ||
* @method linePerspective | ||
* @for p5 | ||
* @param {boolean} enable - Set to `true` to enable line perspective, `false` to disable. | ||
* | ||
* @example | ||
* <div> | ||
* <code> | ||
* function setup() { | ||
* createCanvas(100, 100, WEBGL); | ||
* setAttributes({ antialias: true }); | ||
* strokeWeight(3); | ||
* describe( | ||
* 'rotated 3D boxes have their stroke weights affected if toggled back and forth with mouse clicks.' | ||
* ); | ||
* } | ||
* | ||
* function draw() { | ||
* background(220); | ||
* rotateY(PI/24); | ||
* rotateZ(PI/8); | ||
* translate(0, 0, 350); | ||
* for (let i = 0; i < 12; i++) { | ||
* translate(0, 0, -70); | ||
* box(30); | ||
* } | ||
* } | ||
* | ||
* function mousePressed() { | ||
* linePerspective(!linePerspective()); | ||
* } | ||
* </code> | ||
* </div> | ||
* | ||
* <div> | ||
* <code> | ||
* function setup() { | ||
* createCanvas(100, 100, WEBGL); | ||
* strokeWeight(4); | ||
* } | ||
* | ||
* function draw() { | ||
* background(220); | ||
* | ||
* // Using orthographic projection | ||
* ortho(); | ||
* | ||
* // Enable line perspective explicitly | ||
* linePerspective(true); | ||
* | ||
* // Draw a rotating cube | ||
* rotateX(frameCount * 0.01); | ||
* rotateY(frameCount * 0.01); | ||
* box(25); | ||
* | ||
* // Move to a new position | ||
* translate(0, -60, 0); | ||
* | ||
* // Using perspective projection | ||
* perspective(); | ||
* | ||
* // Disable line perspective explicitly | ||
* linePerspective(false); | ||
* | ||
* // Draw another rotating cube with perspective | ||
* rotateX(frameCount * 0.01); | ||
* rotateY(frameCount * 0.01); | ||
* box(25); | ||
* } | ||
* </code> | ||
* </div> | ||
* @alt | ||
* Demonstrates the dynamic control of line perspective in a 3D environment with rotating boxes. | ||
*/ | ||
/** | ||
* @method linePerspective | ||
* @return {boolean} The boolean value representing the current state of linePerspective(). | ||
*/ | ||
|
||
p5.prototype.linePerspective = function (enable) { | ||
p5._validateParameters('linePerspective', arguments); | ||
if (!(this._renderer instanceof p5.RendererGL)) { | ||
throw new Error('linePerspective() must be called in WebGL mode.'); | ||
} | ||
if (enable !== undefined) { | ||
// Set the line perspective if enable is provided | ||
this._renderer._curCamera.useLinePerspective = enable; | ||
} else { | ||
// If no argument is provided, return the current value | ||
return this._renderer._curCamera.useLinePerspective; | ||
} | ||
}; | ||
|
||
|
||
/** | ||
* Sets an orthographic projection for the current camera in a 3D sketch | ||
* and defines a box-shaped viewing frustum within which objects are seen. | ||
|
@@ -487,7 +597,7 @@ p5.Camera = class Camera { | |
this._renderer = renderer; | ||
|
||
this.cameraType = 'default'; | ||
|
||
this.useLinePerspective = true; | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Do you think calling There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Yes maybe, I think it makes sense to associate the behavior of There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think that makes sense! we can mention in the documentation for |
||
this.cameraMatrix = new p5.Matrix(); | ||
this.projMatrix = new p5.Matrix(); | ||
this.yScale = 1; | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we add a second overload to this function that has no parameters and returns the current value? Similar to
frameRate
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@davepagurek do you want me to validate its parameters too or this would work fine?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Validating parameters would be great too! Looks good so far.