panorama.Base

Расширяет IPanorama.

Конструктор | Методы

Конструктор

panorama.Base()

Инициализирует панораму со стандартными параметрами.

Пример:

function Panorama () {
    ymaps.panorama.Base.call(this);
    // Проверяем, что с нашей панорамой все в порядке.
    this.validate();
}

ymaps.util.defineClass(Panorama, ymaps.panorama.Base, {
    getPosition: function () {
        // Давайте поместим нашу панораму в центр системы координат.
        return [0, 0, 0];
    },

    getCoordSystem: function () {
        return ymaps.coordSystem.cartesian;
    },

    getAngularBBox: function () {
        //  Мы сделаем нашу панораму полностью сферической.
        return [0.5 * Math.PI, 2 * Math.PI, -0.5 * Math.PI, 0];
    },

    getTileSize: function () {
        return [512, 512];
    },

    getTileLevels: function () {
        // Наша панорама будет иметь только одно изображение.
        return [{
            getTileUrl: function (x, y) {
                return '/' + x + '/' + y + '.jpg';
            },

            getImageSize: function () {
                return [4096, 2048];
            }
        }];
    }
});

Методы

Имя

Возвращает

Описание

getAngularBBox()

Обязательный к переопределению метод.

getConnectionArrows()

IPanoramaConnectionArrow[]

Возвращает пустой массив, как будто на панораме нет ни одной связи в виде стрелок.

getConnectionMarkers()

IPanoramaConnectionMarker[]

Возвращает пустой массив, как будто на панораме нет ни одной связи в виде маркера.

getConnections()

IPanoramaConnectionMarker[]

Внимание

Данный метод является устаревшим.

Данный метод является устаревшим. Вместо него переопределяйте метод panorama.Base.getConnectionMarkers.

getCoordSystem()

ICoordSystem

Возвращает географическую систему координат.

getDefaultDirection()

Number[]

Возвращает направление на "север" в горизонт.

getDefaultSpan()

Number[]

Возвращает область обзора 130 на 80 градусов в радианах.

getGraph()

null

Возвращает null, как будто на панораме нет быстрых переходов на другие панорамы (по графу).

getMarkers()

IPanoramaMarker[]

Возвращает пустой массив, как будто в панораме нет ни одного маркера.

getName()

String

Возвращает пустую строку.

getPosition()

Обязательный к переопределению метод.

getThoroughfares()

IPanoramaConnectionArrow[]

Внимание

Данный метод является устаревшим.

Данный метод является устаревшим. Вместо него переопределяйте метод panorama.Base.getConnectionArrows.

getTileLevels()

Обязательный к переопределению метод.

getTileSize()

Обязательный к переопределению метод.

validate()

Проверяет консистентность и корректность данных, возвращаемых методами объекта панорамы. Условия, которые проверяет этот метод:

  • позиции всех объектов имеют три компоненты (включая высоту);
  • размер тайла должен быть степенью двойки (например, 128, 256, 512 пикселей);
  • панорама является полным кругом (то есть ширина угловой области должна быть 2π);
  • каждый уровень масштабирования панорамного изображения содержит целое число тайлов по горизонтали (по вертикали это не обязательно).
    Если вызов этого метода гененирует ошибку для объекта панорамы, стабильная работа плеера с такой панорамой не гарантируется.

Описание методов

getAngularBBox

{} getAngularBBox()

Обязательный к переопределению метод.

getConnectionArrows

{IPanoramaConnectionArrow[]} getConnectionArrows()

Возвращает пустой массив, как будто на панораме нет ни одной связи (в виде стрелок).

getConnectionMarkers

{IPanoramaConnectionMarker[]} getConnectionMarkers()

Возвращает пустой массив, как будто на панораме нет ни одной связи (в виде маркера).

getConnections

{IPanoramaConnectionMarker[]} getConnections()

Данный метод является устаревшим. Вместо него переопределяйте метод panorama.Base.getConnectionMarkers.

**Данный метод является устаревшим. **

Возвращает пустой массив, как будто в панораме нет ни одной связи.

getCoordSystem

{ICoordSystem} getCoordSystem()

Возвращает географическую систему координат.

getDefaultDirection

{Number[]} getDefaultDirection()

Возвращает направление на "север" в горизонт.

getDefaultSpan

{Number[]} getDefaultSpan()

Возвращает область обзора 130 на 80 градусов в радианах.

getGraph

{null} getGraph()

Возвращаетnull, как будто на панораме нет ни одного быстрого перехода (по графу) на другие панорамы.

getMarkers

{IPanoramaMarker[]} getMarkers()

Возвращает пустой массив, как будто в панораме нет ни одного маркера.

getName

{String} getName()

Возвращает пустую строку.

getPosition

{} getPosition()

Обязательный к переопределению метод.

getThoroughfares

{IPanoramaConnectionArrow[]} getThoroughfares()

Данный метод является устаревшим. Вместо него переопределяйте метод panorama.Base.getConnectionArrows.

**Данный метод является устаревшим. **

Возвращает пустой массив, как будто в панораме нет ни одного перехода.

getTileLevels

{} getTileLevels()

Обязательный к переопределению метод.

getTileSize

{} getTileSize()

Обязательный к переопределению метод.

validate

{} validate()

Проверяет консистентность и корректность данных, возвращаемых методами объекта панорамы. Условия, которые проверяет этот метод:

  • позиции всех объектов имеют три компоненты (включая высоту);
  • размер тайла должен быть степенью двойки (например, 128, 256, 512 пикселей);
  • панорама является полным кругом (то есть ширина угловой области должна быть 2π);
  • каждый уровень масштабирования панорамного изображения содержит целое число тайлов по горизонтали (по вертикали это не обязательно).
    Если вызов этого метода гененирует ошибку для объекта панорамы, стабильная работа плеера с такой панорамой не гарантируется.