File size: 2,852 Bytes
42717a3
9e7cb97
 
42717a3
 
 
9e7cb97
42717a3
 
 
 
 
9e7cb97
69604ee
9e7cb97
 
 
69604ee
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
---
title: ๐ŸŒ3D-AFrame๐ŸŽฎVR
emoji: ๐ŸŒ๐ŸŽฎ
colorFrom: indigo
colorTo: yellow
sdk: streamlit
sdk_version: 1.45.0
app_file: app.py
pinned: false
license: mit
---

# ๐ŸŒ3D-AFrame๐ŸŽฎVR: Your Ultimate Virtual Reality Playground! ๐Ÿš€

Welcome, future VR explorers! Get ready to dive into a world where AI meets 3D in an epic virtual reality adventure. 
This app, powered by Aframe, is your ticket to creating, manipulating, and exploring 3D objects in a dynamic, sunlit environment. 
Let's break down how this magic happens!

## ๐ŸŽฎ Game Instructions

### Level 1: Entering the VR World
1. ๐Ÿ“ Choose your starting point: Enter the directory path in the sidebar.
2. โฌ†๏ธ Summon your 3D objects: Use the uploader to add files (obj, glb, webp, png, mp4).
3. ๐ŸŒŸ Watch as your objects come to life, bouncing and rotating in the 3D space!

### Level 2: Mastering the Controls
- ๐Ÿ–ฑ๏ธ Left-click and drag: Move objects around like a VR wizard!
- ๐ŸŽฎ WASD keys: Navigate the 3D space like a pro gamer.
- ๐Ÿ–ฒ๏ธ Mouse wheel: Zoom in and out for epic close-ups or panoramic views.
- ๐Ÿ–ฑ๏ธ Right-click and drag: Rotate the view and discover new angles.

### Level 3: Illuminating Your World
- ๐ŸŒž Three magical light sources move around, creating a dynamic sunny environment.
- ๐ŸŽจ Golden, coral, and turquoise lights dance around, bringing your objects to life!

## ๐Ÿง  Behind the Scenes: How It All Works

1. **File Upload and Processing:**
   - The app scans your chosen directory for 3D files.
   - New files are encoded and added to the A-Frame scene.

2. **3D Object Creation:**
   - Each file becomes a 3D entity with random initial position and rotation.
   - Objects are given bouncing behavior for extra coolness!

3. **Dynamic Lighting:**
   - Three moving light sources are created using the `moving-light` component.
   - They move within bounds, creating a realistic, ever-changing illumination.

4. **User Interaction:**
   - The `draggable` component allows you to click and move objects.
   - Camera controls (both UI buttons and WASD keys) let you explore the space.

5. **Scene Rendering:**
   - All elements are combined into an A-Frame scene.
   - The scene is embedded in the Streamlit app for seamless integration.

## ๐Ÿš€ Power-Ups and Special Features

- **AI Integration:** Claude 3.5 Sonnet is your AI companion, ready to assist with 3D creation and manipulation.
- **Real-time Updates:** The scene updates in real-time as you add or move objects.
- **Cross-Platform:** Works on various devices, bringing VR to everyone!

## ๐Ÿ† Challenge Mode

Can you create a complex 3D scene with multiple objects, perfectly lit and arranged? Show off your VR design skills and share your creations!

Ready to start your 3D-VR-AI adventure? Jump in and let your imagination run wild in this AI-powered virtual playground! ๐ŸŒˆ๐ŸŽ‰