Extension:3DAlloy/nl

MediaWiki Handleiding extensies

File:OOjs UI icon advanced-invert.svg 3DAlloy Release status: stabiel
File:3DAlloy.png
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	<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
Voorbeeld	Voorbeeld van 3D Viewer op bestandspagina
Expand Parameters $wg3DAlloy
Expand Labels ‎<3d>
Expand Gebruikte hooks ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile
Downloads kwartaal
Publieke wiki's die het gebruiken

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

• <translate> <tvar name=1>Download</tvar> and place the file(s) in a directory called <tvar name=name>3DAlloy/nl</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/nl' );
  

• $wgFileExtensions parameter wijzigen:

$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>

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.