Extension:3DAlloy

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	Télécharger un instantané de la branche master GitHub: page du projet URL du dépôt git [aide ] historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net . (for MW 1.33 and below use mw-1.33 branch) README
Exemple	Exemple de 3D Viewer sur la page du fichier
Paramètres $wg3DAlloy
Balises ‎<3d>
Accroches utilisées ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile

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'
  )
);

•  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.