Extension:3DAlloy/nl
3DAlloy Release status: stabiel |
|
---|---|
Implementatie | Parser functie , Tag , ContentHandler , Link opmaak |
Beschrijving | Voegt ondersteuning toe voor 3D-bestanden die worden weergegeven op uw MediaWiki |
Auteur(s) | Dolfinus |
Laatste versie | 1.7 (2023-10-17) |
MediaWiki | 1.25+ |
Database wijzigingen | Nee |
Licentie | MIT Licentie |
Download | Master snapshot downloaden NB: README |
Voorbeeld | Voorbeeld van 3D Viewer op bestandspagina |
$wg3DAlloy |
|
<3d> |
|
Beschrijving
MediaWiki-extensie waarmee 3D-modellen-viewers kunnen worden toegevoegd aan pagina's van de site. Gebaseerd op THREE.js, rendert afbeelding met CanvasRenderer. Hier ziet u een voorbeeld 3D model pagina.
Ondersteunde bestandsformaten
Modelformaat van THREE.js:
- .json
- .3djson
- .3dj
- .three
Modelformaat buffer geometrie van THREE.js:
- .buff
- .buffjson
Bestandsformaat OBJ:
- .obj
Bestandsformaat STL (binair):
- .stl
- .stlb
Installeren
- Download en plaats de bestanden in een map
3DAlloy
in de mapextensions/
. - Voeg de volgende code onderaan het bestand LocalSettings.php toe:
wfLoadExtension( '3DAlloy' );
- $wgFileExtensions parameter wijzigen:
$wgFileExtensions = array_merge(
$wgFileExtensions, array(
'json', '3dj', '3djson', 'three',
'buff', 'buffjson',
'obj',
'stl', 'stlb'
)
);
- Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
Gebruik
Een handler voor afbeeldingen
[[File:Model.json|300x300px|color=,opacity=,...]]
Een Parser functie
{{#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}}
In plaats van de geüploade bestandsnaam kunt u een url gebruiken voor een bestand dat zich op een externe site bevindt.
Als parser tag
<3d file="Model.json" width="" height="" ... ></3d>
or
<3d width="" height="" ... >Model.json</3d>
U kunt ook url gebruiken in plaats van de korte bestandsnaam.
Parameters
Naam | Beschrijving | Default value |
---|---|---|
width | Canvas breedte in pixels | 300 |
height | Canvas hoogte in pixels | 300 |
color | Model RGB-kleur als hex | 0xff00ff |
opacity | Model opacity als decimaal tussen 0...1 | 0.8 |
zoom | Als het waar is of 1, kan de canvas gezoomd worden. | false |
pan | Als het waar is of 1, kan het canvas worden gedraaid (pan) | false |
norotate | Als het waar is of 1, kan het model niet worden gedraaid (rotate) | false |
scale | Model scale als decimaal tussen 0...1 | 1 |
z | Model z coördinaat | 75 |
style | Extra canvas CSS-stijl | |
class | Extra canvas HTML-class |
Breedte en hoogte kunnen worden ingesteld op de waarde 0, dus de grootte van de viewer wordt ingesteld op basis van de afmetingen van het gebruikersscherm.
Configureren
Alle standaardwaarden kunnen worden gewijzigd in uw bestand LocalSettings.php :
$wg3DAlloy["width"] = 500;
$wg3DAlloy["height"] = 400;
...
$wg3DAlloy["class"] = 'someclass';
Bediening en sneltoetsen
Actie | Bediening |
---|---|
Camera draaien | Swip (vegen), linkertoets muis vasthouden en bewegen |
Camera zoom (indien zoom is ingeschakeld) | Muiswiel, hou-wiel en bewegen, knijpen |
Camera pan (indien pan ingeschakeld) | Houd de rechtse toets ingedrukt en beweeg. |
Model draaien | ←↑→↓ keys |
Model rotatie herstellen | Thuisknop |
Model rotatie speel/pauze | Dubbel klikken, dubbel tikken |
Model rotatie speel/pauze alle modellen op de pagina | Enter, Spatie toetsen |
Model rotatie snelheid | - en ̟+ toetsen |
Hotkeys wordt automatisch uitgeschakeld wanneer u een wiki-pagina aanpast of verzend.