2gl

2gl

Узкоспециализированная библиотека WebGL для использования в проектах 2GIS

Документация

• Для работы с матрицами и векторами используется библиотека glMatrix
• Работа с геометрическими объектами, например, Plane, Line3, Ray, взята из three.js

На данный момент может работать со следующими типами объектов для отображения:

1. Basic mesh - меш, закрашивается в один цвет
2. Complex mesh - меш, для которого можно установить: цвета для каждой из вершин, освещение, текстуру и определять для какой из вершин будет использоваться текстура
3. Sprite - спрайт, к камере расположен всегда одной гранью, удалённость не влияет на размеры изображения
4. MultiSprite - мультиспрайт представляет собой множество спрайтов, которые рисуются в один draw call

Examples

• Basic mesh performance
• Complex mesh performance
• Sprite performance
• MultiSprite performance

Установка

• npm install 2gl

Подключение

Есть несколько способов подключения библиотеки:

• Напрямую через тег, скрипт 2gl.js лежит в папке dist и содержит все компоненты библиотеки:

<script src="2gl.js"></script>

• Если вы используете сборщики, например, browserify или webpack:

var dgl = require('2gl'); // CommonJS
import dgl from '2gl'; // ES6

• Можно подключать только нужные компоненты для уменьшения размера:

var Mesh = require('2gl/Mesh');
var AmbientLight = require('2gl/lights/AmbientLight');

Development

• npm install
• npm start

Checking examples locally

• Install http-server
• Run http-server at the root project directory
• Open http://localhost:8080/ and navigate to some *.html demo at the examples directory

Release

• Create a new release, this will run the release workflow