Extension:3DAlloy
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 Note : 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 dossierextensions/
. - 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.