Erweiterung:3D

This page is a translated version of the page Extension:3D and the translation is 97% complete.
Outdated translations are marked like this.
MediaWiki-Erweiterungen
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
  • $wgMax3d2pngMemory
  • $wg3dProcessEnviron
  • $wgAjaxPatentPreview
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.