Jump to content

Kiterjesztés:3DAlloy

From mediawiki.org
This page is a translated version of the page Extension:3DAlloy and the translation is 100% complete.
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.7 (2023-10-17)
MediaWiki 1.25+
Adatbázis-változtatások Nem
Licenc MIT License
Letöltés (for MW 1.33 and below use mw-1.33 branch)
README
Példa Példa a 3D Viewerre a fájloldalon
$wg3DAlloy
‎<3d>

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'
  )
);
  • Yes 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.