VFXForge - Système d'Effets Visuels 3D

Application web interactive permettant d'appliquer des effets visuels spectaculaires à des modèles 3D en temps réel. Développé avec Three.js et WebGL 2.0, ce projet propose 12 effets variés allant des transformations de surface aux systèmes de particules complexes.

Liens rapides

• Application web : VFXForge
• Documentation : JSDoc API
• Wiki du projet : Documentation complète
• Dépôt GitLab : gitlab.unistra.fr/caballeroleon/vfxforge
• Issues : Bugs et fonctionnalités

Équipe de développement

Démarrage rapide

Prérequis

• Node.js v18+
• npm v9+ (recommandé)
• Clé SSH configurée pour GitLab

Installation

# Cloner le dépôt via SSH
git clone git@gitlab.unistra.fr:caballeroleon/vfxforge.git
cd vfxforge

# Installer les dépendances
npm install
Copy

Commandes disponibles

# Serveur de développement (http://localhost:5173/)
npm run dev

# Build de production (génère dist/)
npm run build

# Prévisualiser la build (http://localhost:4173/)
npm run preview
Copy

Documentation

La documentation complète du projet est disponible sur le Wiki GitLab, incluant :

• Architecture du système : Structure modulaire et dépendances
• Guides d'utilisation : Comment utiliser chaque effet
• API interne : Documentation des managers et des effets
• Conventions de code : Standards JavaScript et Git Flow
• Arborescence détaillée : Organisation des fichiers du projet

Structure simplifiée

vfxforge/
├── src/
│   ├── core/           # Logique centrale de l'application
│   │   ├── businessLogic/
│   │   ├── mainController/
│   │   └── render3D/
│   ├── effects/        # Effets visuels individuels
│   ├── shaders/        # Shaders GLSL (vertex + fragment)
│   ├── ui/             # Interface utilisateur (desktop/mobile)
│   └── utils/          # Utilitaires (i18n, etc.)
├── public/
│   ├── assets/         # Modèles 3D, icônes, images
│   └── textures/       # Textures et skyboxes
└── index.html
Copy

Fonctionnalités principales

• 12 effets visuels : Lave, cristallisation, glace, fourrure, explosion, feu, particules, etc.
• Internationalisation : Support français, anglais et espagnol
• Responsive : Interface adaptée desktop et mobile
• Performance optimisée : 60 FPS sur matériel mid-range
• Import de modèles : Support de formats 3D standards

Technologies utilisées

• Three.js - Rendu 3D
• WebGL 2.0 - Shaders GLSL
• Vite - Build tool et HMR
• TypeDoc - Documentation du code

Contribution

Avant de contribuer, veuillez consulter :

1. Conventions de code JavaScript
2. Standards Git Flow
3. Guide de contribution

Licence

Ce projet est développé dans un cadre académique à l'Université de Strasbourg.

Copyright © 2026 - Eduardo Caballero Leon, Emilie Igersheim, Olivier Pillods

Tous droits réservés. Projet universitaire - Master Informatique, Université de Strasbourg.

Dernière mise à jour : Janvier 2026