SimFace focuses on simulating and visualizing patients' facelifts, where users will be able to use their own 3D face model to simulate a facelift based on their preference input scale.
- Upload and visualize 3D face models
- Simulate facelifts with adjustable parameters
- Real-time rendering and visualization using Three.js
- User-friendly interface with React and Bootstrap5
- 3D Graphics: Three.js, three-bvh-csg
- Front-end Framework: Tailwind CSS
- Frontend UI Library: React
- Web Application Framework: Node.js
- Development Server: Vite
To set up your development environment, follow these steps:
- Ensure you have Node.js installed on your machine. You can download it from Node.js.
- Clone the repository:
git clone https://github.com/yushengtzou/SimFace.git
- Navigate to the project directory:
cd SimFace - Install the dependencies:
npm install
To install and run the application locally:
- Build the project:
npm run build
- Start the development server:
npm run dev
- Open your web browser and navigate to
http://localhost:3000. - Upload your 3D face model using the provided interface.
- Adjust the facelift simulation parameters to see real-time changes.
We welcome contributions! Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature). - Make your changes and commit them (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature/your-feature). - Open a Pull Request.
- Done:
- Annotate points on 3D face model
- Curve fitting to form a closed curve
- To Do:
- Interactive cutting of 3D surface meshes
- Construct surface equation
- Manipulate surface equation parameters
This project is licensed and restricted to A-TOP Health BIOTECH, Ltd. Unauthorized use, distribution, or modification of this project is prohibited.