Kiterjesztés:3DAlloy

MediaWiki-kiterjesztések kézikönyve

3DAlloy Kiadási állapot: stabil
Megvalósítás	Parser function , Tag , ContentHandler , Link markup
Leírás	Hozzáadja a 3D fájlok megtekintésének támogatását a MediaWikiben
Szerző(k)	Dolfinus
Legfrissebb verzió	1.10 (2025-10-27)
MediaWiki	1.43+
Adatbázis-változtatások	Nem
Licenc	MIT License
Letöltés	Master pillanatképek letöltése GitHub: projektlap git-tároló URL-je [segítség ] hozzájárulások Megjegyzés: Nem érhetőek el lokalizációs frissítések a translatewiki.net által. (for MW 1.33 and below use mw-1.33 branch) README
Példa	[https://en.crystalls.info/File:Cube.json Példa a 3D Viewerre a fájloldalon]
Paraméterek $wg3DAlloy
Címkék ‎<3d>
Hooks used ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile

Leírás

MediaWiki kiterjesztés, mely lehetővé teszi a 3D modellek megtekintésének hozzáadását az oldalakhoz. A THREE.js alapján, a képet CanvasRendererrel rendereli. Ott látható példa 3D modell oldal.

Támogatott fájlkiterjesztések

THREE.js modellformátum:

• .json
• .3djson
• .3dj
• .three

THREE.js modell puffer geometria formátum:

• .buff
• .buffjson

OBJ fájlformátum:

• .obj

STL (bináris) fájlformátum:

• .stl
• .stlb

Telepítés

• Letöltés a kiterjesztés fájljait, és mentsd el az extensions/ mappán belüli 3DAlloy könyvtárba.
• Add hozzá az alábbi kódot a LocalSettings.php fájlod aljára:

  wfLoadExtension( '3DAlloy' );
  

• $wgFileExtensions paraméter módosítása:

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

• Kész – A Special:Version oldalon ellenőrizheted, hogy a kiterjesztés ténylegesen feltelepült-e.

Használat

Mint Képkezelő

[[File:Model.json|300x300px|color=,opacity=,...]]

Mint Parser funkció

{{#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}}

A feltöltött fájlnév helyett használhatod a külső webhelyen található fájl URL-címét.

Mint Parser tag

<3d file="Model.json" width="" height="" ... ></3d>

or

<3d width="" height="" ... >Model.json</3d>

A rövid fájlnév helyett url-t is használhatsz.

Paraméterek

Név	Leírás	Default value
width	A vászon szélessége pixelben	300
height	A vászon magassága pixelben	300
color	Modell RGB szín hexa alakban	0xff00ff
opacity	Modell átlátszósága tizedesjegyként 0...1 között	0.8
zoom	Ha igaz vagy 1, akkor a vászon nagyítható	false
pan	Ha igaz vagy 1, akkor a vászon mozgatható	false
norotate	Ha igaz vagy 1, akkor a modell nem forgatható	false
scale	Modell skála tizedesjegyként 0...1 között	1
z	Modell z koordinátája	75
style	További vászon CSS-stílus
class	További vászon HTML osztály

A szélesség és a magasság beállítható 0 értékre, így a megjelenítő mérete a felhasználó képernyőméreteinek megfelelően lesz beállítva.

Beállítása

Minden alapértelmezett érték megváltoztatható az LocalSettings.php fájlban:

$wg3DAlloy["width"]  = 500;
$wg3DAlloy["height"] = 400;
...
$wg3DAlloy["class"]  = 'someclass';

Vezérlők és gyorsbillentyűk

Művelet	Vezérlők
Kamera forgatása	Húzás, bal egérgomb lenyomva tartása és mozgatása
Kamera zoom (ha a zoom engedélyezve van)	Egérgörgő, tartsd lenyomva a kereket és mozgasd, nyomd meg
Kamera pásztázás (ha a pásztázás engedélyezve van)	Jobb billentyű lenyomva tartása és mozgatáss
A modell forgatása	←↑→↓ billentyűk
Modell forgatásának visszaállítása	Start gomb
A modell forgatásának lejátszása/szüneteltetése	Dupla kattintás, dupla érintés
Az összes modell forgatásának lejátszása/szüneteltetése az oldalon	Enter, szóköz billentyűk
A modell forgási sebessége	- és + billentyűk

A gyorsbillentyűk automatikusan kikapcsolódnak a wiki oldal szerkesztése vagy betöltődése közben.