확장기능:3D

미디어위키 확장 기능 설명서

3D 출시 상태: 베타
구현	미디어
설명	3D 파일 형식을 지원합니다.
만든 이	Gilles Dubuc Matthias Mullie Mark Holmquist
최신 버전	0.0.1
호환성 정책	스냅샷은 미디어위키와 함께 릴리스됩니다. Master is not backward compatible.
MediaWiki	>= 1.42
라이선스	GNU General Public License 2.0 or later
다운로드	확장 기능 다운로드 Git [?]: Git master 다운로드 저장소 보기 (GitHub) 커밋 기록 repository contributors (GitHub) 코드 리뷰
변수 $wgMax3d2pngMemory $wg3dProcessEnviron $wgAjaxPatentPreview
사용된 훅 BeforePageDisplay UploadForm:getInitialPageText UploadFormInitDescriptor
Quarterly downloads	78 (Ranked 69th)
Vagrant 역할	three_d
이슈	미해결 작업 · 버그 보고

3D 확장자로는 3D 모델의 업로드와 볼 수 있는 기능을 지원합니다. 사용 방법에 대한 설명 문서는 Help:Extension:3D 를 참조하세요.

현재는 3D 인쇄 분야에서 일반적인 STL 파일 포맷을 지원하고 있습니다.

설치

Allow 3D file uploads

Tell MediaWiki that it can handle STL uploads. Add this to your LocalSettings.php:

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

Install Extension:3D

• 파일을 다운로드하고 3D 폴더를 extensions/ 디렉토리에 넣어 주세요.
• 아래의 코드를 LocalSettings.php 코드의 마지막에 추가합니다.

  wfLoadExtension( '3D' );
  

•  완료 – 위키의 ‘Special:Version’에 이동해서, 확장기능이 올바르게 설치된 것을 확인합니다.

Install 3d2png

3d2png is the thumbnail renderer for 3D files. It will render png thumbnails exactly like this extension will display the objects, using the same JS libraries running in Node.js instead of the browser.

To install, clone and activate the 3d2png repository:

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

On Linux, you'll also need to install a virtual framebuffer in order for 3d2png to be able to headlessly capture the 3D object.

apt-get install xvfb

After having successfully installed 3d2png, we'll need to tell Extension:3D how to call this thumbnail generator service. Add this to your LocalSettings.php, and make sure to update the paths to match your configuration:

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

Install Extension:MultimediaViewer

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';

Configuration

Patent agreement

Special:Upload

To add patent agreement selection options to Special:Upload, edit your wiki's MediaWiki:3d-patents page. 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. Check out commons:MediaWiki:3d-patents for an example.

Make sure to create the template(s) that will be added to the content. i.e. Template:3dpatent

Special:UploadWizard

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. When uploading one of your own, it'll also ask to confirm the 3d objects depicted are your own work. The template added to the upload content will be {{3dpatent}} or {{3dpatent|ownwork}} respectively.

To change the phrasing of these messages, these pages can be altered: MediaWiki:Mwe-upwiz-patent-dialog-text-warranty & MediaWiki:Mwe-upwiz-patent-dialog-text-license.

To change which file types require patent agreement, which template is added to the upload content or where the urls point to, change LocalSettings.php. Below are the default settings:

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

Extension:CommonsMetadata

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.

If you use any other template than 3dpatent, this will not be useful for you, as this is not currently configurable.