Extension:3DAlloy/fr

Manuel des extensions MediaWiki

File:OOjs UI icon advanced-invert.svg 3DAlloy État de la version : stable
File:3DAlloy.png
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	<translate> Download master snapshot</translate> GitHub: <translate> project page</translate> <translate> git repository URL</translate> [<translate> help</translate> ] <translate> commit history</translate> <translate> Note:</translate> <translate> No [[<tvar name=1>Special:MyLanguage/Localisation#Translation resources</tvar>|localisation]] updates are provided by <tvar name=twn>translatewiki.net </tvar>.</translate> (for MW 1.33 and below use mw-1.33 branch) README
Exemple	Exemple de 3D Viewer sur la page du fichier
Expand Paramètres $wg3DAlloy
Expand Balises ‎<3d>
Expand Accroches utilisées ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile
Téléchargements trimestriels
Utilisé par les wikis publics

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

• <translate> <tvar name=1>Télécharger</tvar> and place the file(s) in a directory called <tvar name=name>3DAlloy/fr</tvar> in your <tvar name=ext>extensions/</tvar> folder.</translate>
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( '3DAlloy/fr' );
  

• Modifier le paramètre $wgFileExtensions  :

$wgFileExtensions = array_merge(
  $wgFileExtensions, array(
      'json', '3dj', '3djson', 'three',
      'buff', 'buffjson',
      'obj',
      'stl', 'stlb'
  )
);

• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

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.