Extension:3D

MediaWiki 拡張機能マニュアル

3D リリースの状態: ベータ
実装	メディア
説明	3Dファイルをサポートします。
作者	Gilles Dubuc Matthias Mullie Mark Holmquist
最新バージョン	0.0.1
互換性の方針	MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。
MediaWiki	>= 1.43
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
ヘルプ	Help:Extension:3D/ja
パラメーター $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
使用するフック BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
四半期ごとのダウンロード数	100 (Ranked 54th)
Vagrant role	three_d
問題点	未解決のタスク · バグを報告

3D拡張では、3Dモデルのアップロードと閲覧機能をサポートします。 使用法の説明文書は、Help:Extension:3d を参照してください。

現在は、3D印刷の分野で一般的なSTLファイルフォーマットをサポートしています。

STLアップロードを扱い可能にするためには、以下をLocalSettings.phpに追加してください :

$wgTrustedMediaFormats[] = 'application/sla';
$wgFileExtensions[] = 'stl';

• ダウンロードして、ファイルをextensions/フォルダー内の3Dという名前のディレクトリ内に配置します。
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( '3D' );
  

•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

3d2pngは3Dファイル用のサムネイルレンダラーです。当拡張機能のオブジェクトの表示と同じように、ブラウザではなくNode.jsで動作するJSライブラリでpngサムネイルをレンダリングします。

3d2pngをインストール・複製・アクティベートする :

git clone https://gerrit.wikimedia.org/r/3d2png
cd 3d2png
npm install

apt-get install xvfb

After having successfully installed 3d2png, we'll need to tell Extension:3D how to call this thumbnail generator service. 以下をLocalSettings.phpに追加し、ローカルの設定に合わせてパスを更新してください :

$wg3dProcessor = [
    '/usr/bin/xvfb-run',
    '-a',
    '-s',
    '-ac -screen 0 1280x1024x24',
    '/path-to-your-repository/3d2png.js'
];

MultimediaViewer is not a hard dependency of the 3D extension, but you will need to install it if you want to interact (move, pan, zoom) with the 3D models. After installing MultimediaViewer, you will need to associate the STL file type with the correct viewer extension, by adding this to your LocalSettings.php file:

$wgMediaViewerExtensions['stl'] = 'mmv.3d';

Special:Uploadにライセンス契約の選択オプションを追加するためには、wikiのMediaWiki:3d-patentsページを使ってください。 Every line on that page will be turned into an <option>, where everything after the last | character is the text, and everything before is the template that will be added to the upload content. 例としてcommons:MediaWiki:3d-patentsをチェックしてください。

コンテンツに追加されるテンプレートの作成は必須です。例 : Template:3dpatent

Special:UploadWizard also supports patent agreement, though slightly less flexible. When uploading a third party STL file, a dialog will be displayed to confirm your upload does not infringe any patents. 自分の3Dファイルをアップロードする際には、ファイルが自分のものであるかの確認も必要です。 アップロードコンテンツに追加されるテンプレートは、それぞれについて{{3dpatent}}か{{3dpatent|ownwork}}です。

$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',
	],
];

Lastly, Extension:CommonsMetadata provides a way to track 3D uploads without said patent license, though it is not configurable at all. It will just check for uploads with a application/sla MIME type (currently the only ones supported by Extension:3D) that lack the 3dpatent template. Matching files lacking this template in their content will automatically be added to Category:Files_with_no_machine-readable_patent.

3dpatent以外のテンプレートを利用している場合、設定ができないので機能が役立ちません。

この拡張機能は 1 つ以上のウィキメディアのプロジェクトで使用されています。 これはおそらく、この拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。 この拡張機能がインストールされている場所を確認するには、ウィキメディアの設定ファイル CommonSettings.php および InitialiseSettings.php 内で、この拡張機能の名前を探してください。 特定のウィキにインストールされている拡張機能の完全な一覧は、そのウィキの Special:Version ページにあります。

この拡張機能は以下のウィキ ファーム/ウィキ ホスト/パッケージに含まれています: Miraheze WikiForge これは正式な一覧ではありません。 一部のウィキ ファーム/ウィキ ホスト/パッケージは、ここに記載されていなくてもこの拡張機能を含んでいる場合があります。 必ずご利用のウィキ ファーム、ウィキ ホスト、バンドルで確認してください。