Extension:3DAlloy

From mediawiki.org
This page is a translated version of the page Extension:3DAlloy and the translation is 100% complete.
Manuel des extensions MediaWiki
3DAlloy
État de la version : stable
Implémentation Fonction d'analyseur , Balise , ContentHandler , Balise de lien
Description Ajoute un support pour voir des fichiers 3D sur MediaWiki
Auteur(s) Dolfinus
Dernière version 1.7 (2023-10-17)
MediaWiki 1.25+
Modifie la base
de données
Non
Licence Licence MIT
Téléchargement (for MW 1.33 and below use mw-1.33 branch)
README
Exemple Exemple de 3D Viewer sur la page du fichier
$wg3DAlloy
‎<3d>

Description

Extension MediaWiki permettant d'ajouter un visualisateur de modèles 3D aux pages des sites. Basé sur THREE.js, elle renvoie les images avec CanvasRenderer. Vous pouvez voir un exemple de page de modèle 3D ici.

Extensions de fichier supportées

Format des modèles THREE.js :

  • .json
  • .3djson
  • .3dj
  • .three

THREE.js format de la géométrie du tampon de modèle :

  • .buff
  • .buffjson

format de fichier OBJ :

  • .obj

format de fichier STL (binaire) :

  • .stl
  • .stlb

Installer

  • Télécharger et placez le(s) fichier(s) dans un répertoire appelé 3DAlloy dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( '3DAlloy' );
    
  • Modifier le paramètre $wgFileExtensions  :
$wgFileExtensions = array_merge(
  $wgFileExtensions, array(
      'json', '3dj', '3djson', 'three',
      'buff', 'buffjson',
      'obj',
      'stl', 'stlb'
  )
);
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Utilisation

Comme un gestionnaire d'images

[[File:Model.json|300x300px|color=,opacity=,...]]

Comme une fonction d'analyseur

{{#3d:Model.json}}
{{#3d:Model.json|width}}
{{#3d:Model.json|width|height}}
...
{{#3d:Model.json|width|height|color|opacity|zoom|pan|norotate|scale|z|style|class}}

Au lieu du nom du fichier téléversé vous pouvez utiliser une url pour le fichier situé sur un site externe.

Comme une balise d'analyseur

<3d file="Model.json" width="" height="" ... ></3d>

or

<3d width="" height="" ... >Model.json</3d>

Vous pouvez aussi utiliser une url à la place du nom court de fichier.

Paramètres

Nom Description Default value
width Largeur du canevas en pixels 300
height Hauteur du canevas en pixels 300
color Modèle de couleurs RVB en hexadécimal 0xff00ff
opacity Opacité du modèle, nombre décimal entre 0...1 0.8
zoom Si la valeur est true ou 1, le schéma peut être agrandi false
pan Si la valeur est true ou 1, le schéma peut être en panoramique false
norotate Si vrai ou à 1, le modèle ne tourne pas false
scale Echelle du modèle, nombre décimal entre 0 et 1. 1
z Coordonnée z du modèle 75
style Style CSS du canevas supplémentaire
class Classe HTML du canevas additionnel

La largeur et la hauteur ne peuvent pas être mis à la valeur 0 , donc la taille de l'affichage dépendra des dimensions de l'écran de l'utilisateur.

Configurer

Toutes les valeurs par défaut peuvent être modifiées dans votre fichier LocalSettings.php  :

$wg3DAlloy["width"]  = 500;
$wg3DAlloy["height"] = 400;
...
$wg3DAlloy["class"]  = 'someclass';

Touches de contrôle et de fonction

Action Contrôles
Rotation de l'appareil photo Glissez, maintenez le bouton gauche de la souris et déplacez
Zoom caméra (si le zoom est activé) Molette de la souris, tenir la molette et bouger, pincer
Panoramique caméra (si le panoramique est activé) Touche droite tenir et se déplacer
Rotation du modèle touches ←↑→↓
Réinitialisation de la rotation du modèle Touche d'accueil
Rotation du modèle jouer/suspendre Double cli, double frappe
Rotation de modèle lire/mettre en pause tous les modèles à la page Touches Entrée, Espace
Vitesse de rotation du modèle touches - et +

Les raccourcis clavier se désactivent automatiquement lorsque vous modifiez ou envoyez une page wiki.