Extension:3DAlloy/nl

MediaWiki Handleiding extensies

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 GitHub: projectpagina git repository URL [help ] commit geschiedenis NB: Er zijn geen lokalisatie updates beschikbaar bij translatewiki.net . (voor MediaWiki 1.33 en ouder, gebruik de branch MediaWiki 1.33) README
Voorbeeld	Voorbeeld van 3D Viewer op bestandspagina
Parameters $wg3DAlloy
Labels ‎<3d>
Gebruikte hooks ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile

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 map extensions/.
• 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.