Communitygithub.com

site-3d-premium

Directives pour créer des sites web 3D haut de gamme, mettant l'accent sur les shaders WebGL personnalisés, le post-traitement, les interactions physiques, les animations fluides, les préchargeurs et l'optimisation des appareils.

Qu'est-ce que site-3d-premium ?

Cette compétence fournit des directives architecturales et des modèles de code pour développer des sites web 3D premium et haut de gamme. Elle cible les développeurs souhaitant implémenter des effets visuels WebGL avancés, des pipelines de shaders personnalisés, des éléments physiques interactifs et des transitions de page immersives, tout en maintenant des performances élevées. La compétence couvre l'utilisation de bibliothèques telles que Three.js, React Three Fiber (R3F) et Spline, ainsi que des techniques de post-traitement comme le bloom, la profondeur de champ et le grain de film. Elle explique comment configurer une boucle de rendu robuste, intégrer des shaders GLSL, optimiser les actifs 3D avec compression Draco, et concevoir des préchargeurs interactifs pour améliorer l'expérience utilisateur. Des exemples concrets de code sont fournis pour un post-traitement dans R3F et un matériau shader personnalisé pour des effets liquides ou ondulatoires. Les meilleures pratiques incluent la limitation du ratio de pixels à 2, la désactivation de l'anticrénelage lors du post-traitement, et l'utilisation de rendu par instance. La compétence est compatible avec les environnements de développement web standards et nécessite une validation manuelle sur différents chipsets.

Compatible avec✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/premium-3d-website

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Site 3D Premium

Aperçu

Cette compétence fournit des directives architecturales et des modèles de code pour développer des sites web 3D haut de gamme et premium. Elle cible les développeurs souhaitant implémenter des effets visuels WebGL avancés, des pipelines de shaders personnalisés, des éléments physiques interactifs et des transitions de page immersives, tout en maintenant des performances élevées.

Quand utiliser cette compétence

  • Utilisez-la lors de la conception de sites web créatifs haut de gamme ou primés avec des éléments 3D.
  • Utilisez-la lors de l'intégration de Three.js, React Three Fiber (R3F) ou Spline avec des shaders personnalisés (GLSL).
  • Utilisez-la lors de l'implémentation d'effets de post-traitement tels que le bloom, la profondeur de champ ou le grain de film personnalisé.
  • Utilisez-la lors de la conception de préchargeurs interactifs et de stratégies de chargement d'actifs hautes performances.
  • Utilisez-la lors de l'optimisation de scènes 3D complexes pour la réactivité mobile et les performances.

Comment ça fonctionne

Étape 1 : Établir la boucle de rendu et l'architecture de la scène

La mise en place d'un contexte WebGL robuste avec une gestion appropriée du redimensionnement et des ratios de pixels adaptés aux performances est cruciale. Maintenez les ratios de pixels à un maximum de 2 pour éviter de rendre trop de pixels sur les écrans haute résolution.

Étape 2 : Implémenter les effets de shader et le post-traitement

Incorporez des pipelines de post-traitement (en utilisant EffectComposer ou @react-three/postprocessing) pour ajouter du bloom, de l'aberration chromatique, de la profondeur de champ ou du grain de film. Gardez le nombre de passes bas et combinez des shaders de fragment personnalisés pour minimiser les appels de dessin.

Étape 3 : Intégrer la physique interactive et le mouvement

Utilisez des frameworks physiques (tels que Cannon.js ou Rapier) ou des animations à ressort procédurales pour faire réagir les objets 3D aux entrées de la souris (survol, glisser-déposer, clic) avec un retour organique.

Étape 4 : Pipeline des actifs et préchargeur

Optimisez les modèles 3D (en utilisant la compression Draco) et chargez-les à l'aide de gestionnaires de chargement personnalisés. Affichez des préchargeurs interactifs pour divertir les utilisateurs pendant que les actifs lourds sont récupérés en arrière-plan.

Exemples

Exemple 1 : Post-traitement personnalisé dans React Three Fiber (R3F)

import { Canvas } from '@react-three/fiber';
import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';

export default function PremiumComposer() {
  return (
    <Canvas dpr={[1, 2]} gl={{ powerPreference: "high-performance", antialias: false }}>
      <ambientLight intensity={0.5} />
      <mesh>
        <boxGeometry />
        <meshStandardMaterial emissive="orange" emissiveIntensity={2.0} />
      </mesh>
      
      <EffectComposer disableNormalPass>
        <DepthOfField focusDistance={0} focalLength={0.02} bokehScale={2} height={480} />
        <Bloom luminanceThreshold={0.3} luminanceSmoothing={0.9} height={300} />
        <Vignette eskil={false} offset={0.1} darkness={1.1} />
      </EffectComposer>
    </Canvas>
  );
}

Exemple 2 : Matériau shader GLSL personnalisé pour des effets liquides/ondulatoires

import * as THREE from 'three';

const CustomWavyMaterial = new THREE.ShaderMaterial({
  vertexShader: `
    varying vec2 vUv;
    uniform float uTime;
    void main() {
      vUv = uv;
      vec3 pos = position;
      pos.z += sin(pos.x * 5.0 + uTime) * 0.1;
      pos.z += cos(pos.y * 5.0 + uTime) * 0.1;
      gl_Position = projectionMatrix * modelViewMatrix * vec4(pos, 1.0);
    }
  `,
  fragmentShader: `
    varying vec2 vUv;
    uniform float uTime;
    uniform vec3 uColor;
    void main() {
      float pulse = 0.5 + 0.5 * sin(uTime + vUv.x * 10.0);
      gl_FragColor = vec4(uColor * pulse, 1.0);
    }
  `,
  uniforms: {
    uTime: { value: 0.0 },
    uColor: { value: new THREE.Color('#3b82f6') }
  }
});

Meilleures pratiques

  • ✅ Définissez dpr={[1, 2]} pour limiter le ratio de pixels de l'appareil à un maximum de 2.
  • ✅ Désactivez l'anticrénelage sur le WebGLRenderer lorsque le post-traitement est actif pour éviter les pénalités de performance dues au double anticrénelage.
  • ✅ Cuisinez l'occlusion ambiante, l'éclairage et les ombres dans des textures à l'aide de Blender ou d'autres logiciels 3D plutôt que d'utiliser des lumières dynamiques et des ombres en temps réel.
  • ✅ Utilisez le rendu par instance (THREE.InstancedMesh ou les <Instances> de R3F) pour les scènes contenant plusieurs maillages identiques.
  • ❌ Évitez d'utiliser des modèles GLTF/OBJ non compressés. Compressez toujours les modèles à l'aide de Draco ou Meshopt.
  • ❌ Évitez les cartes d'ombres en temps réel (telles que THREE.DirectionalLightShadow) sur les appareils mobiles ou bas de gamme en raison du surcoût de performance important.

Limitations

  • Cette compétence ne remplace pas la validation, les tests ou l'examen d'experts spécifiques à l'environnement.
  • Arrêtez-vous et demandez des clarifications si les entrées, autorisations ou limites de sécurité requises sont absentes.
  • Les mathématiques complexes des shaders et les limites de simulation physique avancée nécessitent des tests manuels sur différents chipsets d'appareils.

Notes de sécurité

  • Vérifiez que les URL des modèles 3D externes (chargées via GLTFLoader) sont hébergées sur des CDN sécurisés et de confiance (HTTPS).
  • N'exécutez pas de scripts shell arbitraires non validés et n'utilisez pas de packages NPM non épinglés pour optimiser les actifs.

Pièges courants

  • Problème : Ralentissement/chute de fréquence d'images sévère sur les écrans mobiles ou haute résolution (Retina). Solution : Assurez-vous que le ratio de pixels est limité à 2 (renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))) et désactivez les passes de post-traitement inutilisées.
  • Problème : Temps de chargement longs et écrans blancs pendant l'initialisation. Solution : Utilisez un gestionnaire de chargement (THREE.LoadingManager) et affichez un préchargeur interactif et réactif pour maintenir l'engagement de l'utilisateur.

Compétences associées

  • @3d-web-experience - Concepts fondamentaux de WebGL, Three.js et Spline.
  • @scroll-experience - Intégration d'animations 3D avec des contrôleurs de défilement.
  • @performance-optimizer - Réglage général des performances d'exécution du code.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés