Skip to content

Latest commit

 

History

History
122 lines (96 loc) · 5.73 KB

README.md

File metadata and controls

122 lines (96 loc) · 5.73 KB
Raw
logo

Interactive Low Poly Environment

This project showcases an interactive computer graphics environment built using Three.js. The focus is on graphical rendering, modelling, and creating a visually captivating experience. The environment features procedurally generated objects, 3D models, and special animations. Explore the world with its low poly aesthetic, interact with various elements, and enjoy dynamic animations and special effects. The project utilises Three.js for rendering, GLSL for shaders, and glTF for 3D models, ensuring a rich and immersive experience.

Roadmap

  • Set up the environment with necessary tools and libraries
  • Design and implement the main island
  • Implement different scene modes
    • Camera perspective toggle system
    • Automatic lighting adjustment based on the user's time
  • Create lake terrain using a displacementMap (depth-based colour adaptation)
  • Implement different materials (Basic, Lambert, Phong) for desired aesthetic and metallic appearances
  • Handle static elements
    • House
    • Fence
    • Lamp posts
    • Aeroplane
    • Carousel
  • Handle procedurally generated elements
    • Stones
    • Grass
    • Trees
    • Clouds
    • Campfire
    • Firefly colonies
  • Create custom shader material for the campfire
  • Create custom shader material for the firefly colonies
  • Develop aeroplane and carousel animations
  • Implement resource disposal and window resizing functionalities
  • Import cat and dog 3D glTF models
  • Design and optimise GUI
  • Polish and refine visuals, animations, and effects
  • Deploy the environment
  • Use noise perturbations to shape clouds
  • Increase resolution of water surface texture
  • Populate night mode skybox with shining stars

Stack

  • Three.js
  • GLSL
  • glTF

Project structure

$PROJECT_ROOT
│   # Images
├── images
│   # JavaScript files
├── js
│   # 3D models
├── obj
│   # Textures
├── textures
│   # Key scripts
└── ...

Highlights

environment showcase

environment showcase

campfire

3D models

Environment elements: in-depth review

The interactive low poly environment offers a rich array of captivating elements that enhance the immersive experience:

  • Static Objects: The main island serves as the centrepiece, featuring both bottom and top terrains, along with a visually stunning lake. The lake terrain utilises a displacementMap, adapting its colour based on visual depth. Additionally, water surfaces are meticulously designed to avoid a flat appearance.
  • Lamp Posts: The environment is illuminated by lamp posts that come to life at night. Each lamp post consists of a spotlight to create a torch-like effect on the ground, while a pointLight brings forth the glow of a lighted bulb.
  • Procedurally Generated Objects: These objects are meticulously crafted with attention to detail:
    • Stones: A main large stone serves as the focal point, complemented by up to four smaller stones arranged artistically.
    • Grass: The landscape is adorned with intricate grass structures, featuring a central stem surrounded by five smaller stems.
    • Trees: The environment boasts two types of trees: pine trees and unique blob trees. The trunks of both tree types are procedurally generated, while blob trees showcase dynamically generated leaf groups, adding a touch of randomness and natural variation.
    • Clouds: Experience the ethereal beauty of procedurally generated clouds. Each cloud "block" consists of four to six clouds, creating a mesmerising and ever-changing sky.
    • Campfire: Witness the magic of a flickering campfire that comes to life at night. The campfire's foundation and fire are procedurally generated, ensuring that each instance is unique. Custom shader materials and flame textures contribute to the realistic fire effect, enhanced by orange and red spotlights.
    • Fireflies Colonies: As darkness descends, enchanting firefly colonies illuminate the environment. Custom shader materials bring these fireflies to life, utilising Points and their UV coordinates. A spotlight strategically placed near each colony casts a soft glow, generating a captivating and randomised animation.
  • Other: The environment incorporates various materials tailored to specific needs and computational efficiency. Basic, Lambert, and Phong materials are employed based on their characteristics, allowing for the desired low poly aesthetic and metallic appearances where needed. Proper resource disposal and window resizing are implemented to ensure optimal performance. Furthermore, the environment seamlessly adjusts its lighting based on the computer's time, providing an automatic and immersive transition between day and night.

Getting started

  1. Clone this folder
  2. Start a local live server (e.g., if you have Python 3.x installed)
python -m http.server
  1. This will serve files from the current directory at localhost under port 8000, i.e in the address bar type:
http://localhost:8000/

Attributions

License

MIT © Roberto Nacu