🧊 3D Engine (for Casio Fx Calculator)

A lightweight 3D wireframe renderer designed to run on Casio fx-9750GIII (and similar models) using the fxSDK and gint libraries.
This project allows you to display and rotate 3D models (.ve format) directly on the calculator’s 128×64 monochrome screen.

---

⚙️ Build Instructions

1. Make sure you have fxSDK and gint properly installed.
   📦 fxSDK Installation Guide
   📦 gint Library

2. Download or clone the project.

3. Extract the files, then open a terminal inside the project folder.

4. Navigate to the src directory:

   cd src

5. Build the project:

   fxsdk build-fx

6. Flash the .g1a output file to your Casio calculator.

⚠️ Note: You can use the already built file 3DEngine.g1a

---

💾 Usage

1. Place your .ve model files in the main memory of the calculator.

2. Run the 3D Engine app — it will automatically detect all .ve models.

3. Use these buttons:

   • 🔁 [Tan] (Down Arrow) → Switch between available model files.
   • ⬆️⬇️⬅️➡️ → Rotate the model in 3D space.

---

📄 What Is a .ve File?

The .ve file is a very simple text-based 3D model format created specifically for this project. It defines:

• Vertices (points in 3D space)
• Edges (connections between points)

Example:

V
-1 -1 -1
-1 -1  1
 1 -1 -1
 1 -1  1
E
1 2
1 3
2 4
3 4

Where:

• V = start of vertices section
• E = start of edges section
• Numbers after E represent vertex indices (1-based)

---

🧠 How to Generate .ve Models (AI Method)

You can generate .ve models using AI with two different prompts:

1️⃣ Using an Image

Open prompt_with_photo.txt and copy its contents. Then, give an AI model (like Claude, ChatGPT, or any advanced one) an image of a simple object — it will generate the .ve file for you.

2️⃣ Without an Image

Open prompt_without_photo.txt and copy its contents. Then, simply write the name or description of the object you want at the end of the prompt (e.g., “a simple chair” or “a heart shape”).

⚠️ Tips:

• Use simple models only — keep vertex counts small for best performance.
• Claude or GPT-5 models usually produce the cleanest .ve outputs.

---

🖥️ Display Notes

• Screen size: 128×64 pixels
• The engine automatically scales models to fit this resolution.
• Models are rendered as wireframes for maximum clarity.

---

💡 Summary

Feature	Description
Platform	Casio fx-9750GIII
Rendering	3D Wireframe
File Format	.ve (Vertices + Edges)
Controls	Arrows for rotation, [Tan] for switching models
Dependencies	fxSDK + gint
Output	.g1a Add-in app