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: funciton () {
        // Пусть у нашей панорамы будет только одно изображение.
        return [{
            getTileUrl: function (x, y) {
                return '/' + x + '/' + y + '.jpg';
            },

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

Методы

Имя Возвращает Описание
getAngularBBox ()

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

getConnectionArrows ()

IPanoramaConnectionArrow []

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

getConnectionMarkers ()

IPanoramaConnectionMarker []

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

getConnections ()

IPanoramaConnectionMarker []

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

Данный метод является устаревшим. Вместо него переопределяйте метод <xref href="panorama.Base.xml#method_detail/getConnectionMarkers">panorama.Base.getConnectionMarkers</xref>.

getCoordSystem ()

ICoordSystem

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

getDefaultDirection ()

Number[]

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

getDefaultSpan ()

Number[]

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

getGraph ()

null

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

getMarkers ()

IPanoramaMarker []

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

getName ()

String

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

getPosition ()

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

getThoroughfares ()

IPanoramaConnectionArrow []

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

Данный метод является устаревшим. Вместо него переопределяйте метод <xref href="panorama.Base.xml#method_detail/getConnectionArrows">panorama.Base.getConnectionArrows</xref>.

getTileLevels ()

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

getTileSize ()

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

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

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

getAngularBBox

{} getAngularBBox()

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

getConnectionArrows

{IPanoramaConnectionArrow[]} getConnectionArrows()

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

getConnectionMarkers

{IPanoramaConnectionMarker[]} getConnectionMarkers()

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

getConnections

{IPanoramaConnectionMarker[]} getConnections()

Данный метод является устаревшим. Вместо него переопределяйте метод <xref href="panorama.Base.xml#method_detail/getConnectionMarkers">panorama.Base.getConnectionMarkers</xref>.

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

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

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()

Данный метод является устаревшим. Вместо него переопределяйте метод <xref href="panorama.Base.xml#method_detail/getConnectionArrows">panorama.Base.getConnectionArrows</xref>.

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

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

getTileLevels

{} getTileLevels()

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

getTileSize

{} getTileSize()

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

validate

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