Extension:3DAlloy

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:3DAlloy and the translation is 100% complete.

Other languages:
English • ‎Nederlands • ‎dansk • ‎français • ‎русский • ‎中文 • ‎日本語
Справка по расширениям MediaWiki
OOjs UI icon advanced.svg
3DAlloy
Статус релиза: стабильный
3DAlloy.png
Реализация Parser function , Tag , ContentHandler , Link markup
Описание Добавляет в MediaWiki возможность просмотра 3D-файлов
Автор(ы) Dolfinus
Последняя версия 1.0 (2017-02-05)
MediaWiki 1.25+
Изменения БД Нет
Лицензия MIT License
Загрузка Загрузить расширение
README
Пример Example of 3D Viewer at file page
$wg3DAlloy
<3d>
Переведите расширение 3DAlloy если оно доступно на translatewiki.net
Проверьте использование и версию.

Описание

Расширение MediaWiki, позволяющее загружать и отображать на вики 3D-модели. Основано на библиотеке THREE.js, отрисовка происходит на Canvas. Пример страницы с моделью.

Поддерживаемые типы файлов

Формат THREE.js

  • .json
  • .3djson
  • .3dj * .three

Формат THREE.js (буферизованный)

  • .buff
  • .buffjson

Формат OBJ

  • .obj

Формат STL (бинарный)

  • .stl
  • .stlb

Установка

Загрузите последний снимок и извлеките его в папку с расширениями. Затем подключите расширение в файле LocalSettings.php по примеру ниже:

wfLoadExtension( '3DAlloy' );

$wgFileExtensions = array_merge(
  $wgFileExtensions, array(
      'json', '3dj', '3djson', 'three',
      'buff', 'buffjson',
      'obj',
      'stl', 'stlb'
  )
);

А также добавьте следующие строки в файл includes/mime.types:

application/json json 3djson 3dj three buff buffjson
application/obj obj
application/stl stl stlb

А также добавьте в файл includes/mime.info:

application/json [TEXT]
application/obj       [TEXT]
application/stl       [TEXT]

Использование

Как средство просмотра

[[File:Model.json|300x300px|color=,opacity=,...]]

Как функция

{{#3d:Model.json}}
{{#3d:Model.json|width}}
{{#3d:Model.json|width|height}}
...
{{#3d:Model.json|width|height|color|opacity|norotate|scale|z|style|class}}

Вместо имени загруженного на сайт файла можно использовать URL файла с других сайтов.

Как тег

<3d file="Model.json" width="" height="" ... ></3d>
or
<3d width="" height="" ... >Model.json</3d>

Также можно указать полный путь к файлу вместо его названия.

Параметры

Название Описание Default value
width Ширина области отрисовки (в пикселях) 300
height Высота области отрисовки (в пикселях) 300
color RGB цвет модели (в формате hex) 0xff00ff
opacity Непрозрачность модели как дробь в диапазоне 0..1 0.8
norotate Если задано значение 1 или true, отключает вращение модели false
scale Масштаб модели в процентах 100
z Высота модели над плоскостью 75
style Дополнительные CSS стили области рисования
class Дополнительные HTML классы для области рисования

Высота и ширина могут иметь значение 0 - тогда размер области будет автоматически подстроен под разрешение экрана пользовательского устройства.

Настройка

Все значения по-умолчанию могут быть заданы в файле LocalSettings.php:

$wg3DAlloy["width"]  = 500;
$wg3DAlloy["height"] = 400;
...
$wg3DAlloy["class"]  = 'someclass';

Управление и горячие клавиши

Действие Элементы управления
Поворот камеры "Свайп", удержание левой кнопки мыши и перемещение
Сдвиг камеры Удержание правой кнопки мыши и ее перемещение
Масштабирование камеры Поворот колеса мыши, нажатие на среднюю кнопку мыши (колесо) и перемещение, "щипок"
Поворот модели Клавиши ←↑→↓
Сброс текущего поворота модели Клавиша Home
Включение/остановка вращения модели Двойное нажатие левой кнопкой мыши, двойной тап
Включение/остановка вращения всех моделей на странице Клавиши Enter и пробел
Скорость вращения модели Клавиши - и +

Горячие кавиши автоматически отключаются при редактировании страницы