First README revision

This commit is contained in:
Joseph Ferano 2023-08-15 13:14:29 +07:00
parent f5a304e4f2
commit 354ed1a1b7

View File

@ -1,32 +1,12 @@
### FPS Scene #+OPTIONS: toc:nil
You can walk around the scene with simple FPS controls. * PQ Torus Knot
Open `scene.html` with an http server, you can use the following;
```python3 -m http.server 8000``` ** About
Unfortunately, elm-reactor has issues with loading obj files so that's why the [[https://ferano.io/3d-fp/][Live Link]]
python server is needed.
![alt text](screenshots/elm-fps.png "FPS Scene") This is an attempt to implement the [[https://en.wikipedia.org/wiki/Torus_knot][PQ Torus Knot]] in the Elm programming language.
##### Controls
Mouse - Look Rotation
WASD - Player movement
◀ ▼ ▲ ▶ - Move the Robot
N and M - Rotate robot left and right
Y and H - Rotate robot arm up and down
U and J - Rotate robot hand up and down
### PQTorusknot
Either open up `torus.html`, or use the command `elm-reactor`, if you want to be able to modify the source file and compile; Either open up `torus.html`, or use the command `elm-reactor`, if you want to be able to modify the source file and compile;
@ -37,3 +17,29 @@ Alternatively, here's the Ellie link
https://ellie-app.com/vVTgpBj77ra1 https://ellie-app.com/vVTgpBj77ra1
![alt text](screenshots/elm-knot.png "PQ Torus Knot") ![alt text](screenshots/elm-knot.png "PQ Torus Knot")
** Showcase
** Building with Elm 0.18.0
To install the binaries manually, follow this short guide; - [[https://sirfitz.medium.com/install-elm-0-18-0-in-2021-3f64ce298801][Install Binaries]]
If you want to use =npm= instead; - =npm install -g elm@elm0.18.0=
If you use =npm=, note that you will likely need an older version of Node.js, so
it is recommended to use [[https://github.com/nvm-sh/nvm][nvm]] for that. I have not attempted this method
personally, fyi.
Once you have the Elm compiler, go ahead and run
=elm make Torus.elm=
And that should first pull in all the dependencies then generate an =index.html=
file.
Alternatively, you can use ~elm-reactor~, run the command and open up your browser
to ~https://localhost:8000~ and then click on ~Torus.elm~ in the nice project
webview provided.
** License
This project is licensed under the terms of the MIT license. For more
information, see the included LICENSE file.