Erweiterung:3D

MediaWiki-Erweiterungen

3D Freigabestatus: Beta
Einbindung	Medien
Beschreibung	Bietet Unterstützung für 3D-Dateiformate.
Autor(en)	Gilles Dubuc Matthias Mullie Mark Holmquist
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	Erweiterung herunterladen Git [?]: Git master herunterladen Repository durchsuchen (GitHub) Ergänzungen und Änderungen Repository-Mitwirkende (GitHub) Code-Review
Hilfe	Help:Extension:3D/de
Parameter $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
Verwendete Hooks BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	100 (Ranked 60th)
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 Ordner extensions/ 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.