Erweiterung:3D
3D Freigabestatus: Beta |
|
---|---|
Einbindung | Medien |
Beschreibung | Bietet Unterstützung für 3D-Dateiformate. |
Autor(en) | |
Letzte Version | 0.0.1 |
Kompatibilitätspolitik | Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel. |
MediaWiki | >= 1.43 |
Lizenz | GNU General Public License 2.0 oder neuer |
Herunterladen | |
Hilfe | Help:Extension:3D/de |
|
|
Quarterly downloads | 101 (Ranked 53rd) |
Vagrant-Rolle | three_d |
Probleme | Offene Aufgaben · Einen Fehler melden |
Die 3D-Erweiterung bietet dem Nutzer eines Wikis Unterstützung beim Hochladen und Betrachten von 3D-Modellen. Siehe Hilfe:Erweiterung:3D für Dokumentation zur Verwendung.
Es unterstützt derzeit das STL-Dateiformat, das im 3D-Druckbereich üblich ist.
Installation
Erlaube 3D-Datei-Uploads
Sag MediaWiki, dass es STL-Uploads verarbeiten kann. Füge dies zu deinem LocalSettings.php
:
$wgTrustedMediaFormats[] = 'application/sla';
$wgFileExtensions[] = 'stl';
Installiere Erweiterung:3D
- Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens
3D
im Ordnerextensions/
ablegen. - Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
wfLoadExtension( '3D' );
- Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
3d2png installieren
3d2png ist der Thumbnail-Renderer für 3D-Dateien. Er rendert png-Thumbnails genau so, wie diese Erweiterung die Objekte anzeigt, indem er die gleichen JS-Bibliotheken verwendet, die in Node.js statt im Browser laufen.
Um zu installieren, klone und aktiviere das 3d2png-Repository:
git clone https://gerrit.wikimedia.org/r/3d2png
cd 3d2png
npm install
Unter Linux musst du zudem einen virtuellen Framebuffer installieren, damit 3d2png das 3D-Objekt kopflos erfassen kann.
apt-get install xvfb
Nachdem wir 3d2png erfolgreich installiert haben, müssen wir Extension:3D mitteilen, wie der Thumbnail-Generatordienst aufgerufen werden soll.
Füge dies zu deinen LocalSettings.php
hinzu und stelle sicher, dass du die Pfade an deine Konfiguration anpasst:
$wg3dProcessor = [
'/usr/bin/xvfb-run',
'-a',
'-s',
'-ac -screen 0 1280x1024x24',
'/path-to-your-repository/3d2png.js'
];
Installiere Erweiterung:MultimediaViewer
MultimediaViewer ist keine feste Abhängigkeit von der 3D-Erweiterung, du musst ihn jedoch installieren, wenn du mit den 3D-Modellen interagieren (verschieben, schwenken, zoomen) willst.
Nach der Installation des MultimediaViewers musst du den STL-Dateityp mit der richtigen Viewer-Erweiterung verknüpfen, indem du diese in deine LocalSettings.php
-Datei einfügst:
$wgMediaViewerExtensions['stl'] = 'mmv.3d';
Konfiguration
Patentvereinbarung
Spezial:Upload
Um die Auswahlmöglichkeiten für Patentvereinbarungen zu Spezial:Upload hinzuzufügen, bearbeite die MediaWiki:3d-patents
-Seite deines Wikis.
Jede Zeile auf dieser Seite wird in eine <Option> umgewandelt, wobei alles nach dem letzten |
-Zeichen der Text und alles davor die Vorlage ist, die dem Upload-Inhalt hinzugefügt wird.
Ein Beispiel dafür ist commons:MediaWiki:3d-patents.
Stelle sicher, dass du die Vorlage(n) durchführst, die dem Inhalt hinzugefügt wird (werden). z.B. Template:3dpatent
Spezial:UploadWizard
Spezial:UploadWizard unterstützt zudem Patentvereinbarungen, wenn auch etwas weniger flexibel. Wenn du eine STL-Datei eines Drittanbieters hochlädst, wird ein Dialog angezeigt, der bestätigt, dass dein Upload keine Patente verletzt. Wenn du ein eigenes hochlädst, musst du zudem bestätigen, dass es sich bei den abgebildeten 3D-Objekten um dein eigenes Werk handelt. Die Vorlage, die dem Upload-Inhalt hinzugefügt wird, kostet {{3dpatent}} bzw. {{3dpatent|ownwork}}.
Um die Formulierung dieser Nachrichten zu ändern, können diese Seiten geändert werden: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty
& MediaWiki:Mwe-upwiz-patent-dialog-text-license
.
Um zu ändern, für welche Dateitypen eine Patentvereinbarung erforderlich ist, welche Vorlage zum Upload-Inhalt hinzugefügt wird oder wohin die URLs zeigen, ändere LocalSettings.php
. Unten sind die Standardeinstellungen:
$wgUploadWizardConfig['patents'] = [
'extensions' => [ 'stl' ],
'template' => '3dpatent',
'url' => [
'legalcode' => '//wikimediafoundation.org/wiki/Wikimedia_3D_file_patent_license',
'warranty' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
'license' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing',
'weapons' => '//meta.wikimedia.org/wiki/Wikilegal/3D_files_and_3D_printing#Weapons',
],
];
Erweiterung:CommonsMetadata
Und schließlich bietet Erweiterung:CommonsMetadata eine Möglichkeit, 3D-Uploads ohne die besagte Patentlizenz zu verfolgen, die allerdings nicht konfigurierbar ist.
Es wird nur nach Uploads mit dem Mime-Typ application/sla
(derzeit die einzigen, die von Extension:3D unterstützt werden) gesucht, denen die Vorlage 3dpatent
fehlt.
Passende Dateien, die diese Vorlage nicht in ihrem Inhalt haben, werden automatisch zu Category:Files_with_no_machine-readable_patent
hinzugefügt.
Wenn du eine andere Vorlage als 3dpatent
verwendest, wird dir das nichts nützen, da dies derzeit nicht konfigurierbar ist.
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |