Skip to content

malikmaky/spinning-donut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

Logo

Exploring a Spinning DoughnutAGPL License

Donut Math

This report dives into the creation of a rotating/spinning torus or doughnut.

The implementation contains fundamental mathematical concepts and techniques to generate an animated display of a three-dimensional object projected onto a two-dimensional surface, Through the manipulation of angles and coordinates, coupled with graphical rendering within a Windows Forms application.

Explanation Of Doughnut Math

The spinning torus, also known as a "doughnut”, is a shape formed by rotating a circle in three-dimensional space.

Mathematically, it is defined by two radiuses, R1 and R2, which determine the size and position of the torus.

App Screenshot

The torus is then projected onto a two-dimensional plane located a certain distance away from the viewer, resulting in a flattened representation that mimics the perception of depth.

Projecting A 3D Object Onto A 2D Screen

(x,y,z) is the object points in the 3D-Space, In order to project a 3D object onto a 2D screen,we imagine an imaginary flat surface positioned at a specific distance (denoted as z') from the viewer.

App Screenshot

This surface (z') acts as a reference onto which the 3D points, represented as (x, y, z), are projected, through this projection we determine their corresponding positions (x', y') on the 2D screen.

Note :

In the Since we’re looking from the side, we can only see the y and z axes, but the math works the same for the x axis.

We can notice that the origin, the y-axis, and the point (x, y, z) create a right triangle, and a similar right triangle is also formed with the points (x', y', z'). So we can use the Triangle Similarity Theorem and find out that relative proportions are maintained.

App Screenshot

For example :

if we want to see an object which is 10 units wide in our 3D space, set back 5 units from the viewer, then K1 should be chosen so that the projection of the point x=10, z=5 is still on the screen with x’ < 50 ==> 10K1/5 < 50 ==> K1 < 25.

  • To make cost-effective computations, we use the inverse of the z-coordinate denoted as z^(-1)=1/z by precomputing z^(-1), we can use it when computing the actual (x', y') positions.

  • Dividing once by z and then multiplying by z-1 twice is cheaper than dividing by z twice, this optimization helps in speeding up the rendering process.

Drawing The Torus

Circle of radius R1 centered at point (R2,0,0), θ — from 0 to 2π:

App Screenshot

Now we take that circle and rotate it around the y-axis by another angle, to rotate a 3D point around an axe the standard technique is to multiply by a rotation matrix.

App Screenshot

We also want the whole donut to spin around on at least two more axes for the animation.

Rotation about the x-axis by A and a rotation about the z-axis by B.

App Screenshot

Working through the above gets us an (x,y,z) point on the surface of our torus, rotated around two axes.

To actually get screen coordinates, we need to move the torus somewhere in front of the viewer (the viewer is at the origin) — so we just add some constant to z to move it backward.

So we have another constant to pick, call it K2, for the distance of the donut from the viewer, and our projection now looks like:

App Screenshot

  • K1 and K2 can be tweaked together to change the field of view and flatten or exaggerate the depth of the object.

Implementation

  • We use a bitmap to draw/represent the rotating donut points.
  • Mathematical calculations determine each point's position and color on the donut's surface, which is projected onto the 2D bitmap.
  • Double buffering ensures smooth animation by drawing frames onto a hidden buffer before displaying them seamlessly, this process creates a visually engaging spinning donut animation, showcasing the intersection of mathematics and computer graphics.

References

Donut Math : https://www.a1k0n.net/2011/07/20/donut-math.html

Rotation Matrix : https://en.wikipedia.org/wiki/Rotation_matrix

Demo

Check out the demo through this youtube video down bellow https://www.youtube.com/watch?v=40IfGnu9R9Q

Credits

This project is maintained by @malikmaky.

For any inquiries or feedback, please contact [email protected]

About

This repository dives into the creation and the logic of implementing a rotating/spinning torus or doughnut.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages