GlobalMap GS / API / Работа с общими настройками
Работа с общими настройками
Свойства
| Свойство |
Тип |
Описание |
| scene |
String |
Путь к используемой сцене |
| lonlat |
Pos |
Получить координаты точки поверхности сцены, на которые указывает курсор |
| constants |
Consts |
Получить доступ к объекту с названиями доступных режимов |
| camera |
Camera |
Получить доступ к объекту «камера», позволяющий управлять камерой пользователя |
| factory |
Factory |
Получить доступ к объекту «factory», позволяющий создавать новые объекты |
| measure |
Measure |
Получить доступ к объекту «measure», позволяющий рисовать линии поверх карты |
| settings |
Settings |
Получить доступ к объекту «settings», содержащий настройки запуска GlobalMap GS |
| bookmarkLayer |
BookmarkLayer |
Получить доступ к объекту «bookmarkLayer» |
| mode |
String |
Вывести текущий режим работы GlobalMap GS |
| modeFlat |
bool |
Вкл/выкл режим двухмерной карты |
| modeCar |
bool |
Вкл/выкл режим управления автомобилем |
| toolbar |
bool |
Вкл/выкл панель инструментов |
| clouds |
bool |
Вкл/выкл облачность |
| sky |
bool |
Вкл/выкл небо |
| atmosphere |
bool |
Вкл/выкл атмосферу |
| smartLand |
bool |
Вкл/выкл режим Smartland |
| time |
double |
Вывести время работы приложения в мс |
| version |
String |
Вывести версию GlobalMap GS |
| timer |
bool |
Вкл/выкл таймер анимации приложения |
Установить фокус
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.catchFocus() |
bool |
|
Установить фокус |
Взлететь над слоем за указанное время (в мс)
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.flyUpOverLayer(Layer*, double) |
bool |
|
Взлететь над слоем за указанное время (в мс) |
Взлететь над BoundaryBox за указанное время (в мс)
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.flyUpOverBbox(Bbox*, double) |
bool |
|
Взлететь над BoundaryBox за указанное время (в мс) |
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.addButton(String, String, int, int) |
Button* |
Название, путь к изображению кнопки, координаты кнопки на экране |
Добавить кнопку |
Добавить контрол редактирования 3D объектов
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.addControl(ControlInstanceEdit* control) |
void |
|
Добавить контрол редактирования 3D объектов |
Удалить контрол редактирования 3D объектов
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.deleteControl(ControlInstanceEdit* control) |
void |
|
Удалить контрол редактирования 3D объектов |
Проиграть «маршрут»
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.playTrack(String, bool) |
bool |
Название маршрута, необходимость подлета к началу маршрута |
Проиграть «маршрут» |
Cохранить заголовок сцены и заголовки слоев в единый xml файл,
используется в для сетевой версии
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.saveXML() |
bool |
|
Cохранить заголовок сцены и заголовки слоев в единый xml файл,
используется для сетевой версии |
Подготовить для выполнения команду.
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.shellExecute(String,bool) |
ExternalProcess* |
Command — имя команды,bool — автовыполнение |
Подготовить для выполнения команду без передачи аргументов. |
| shellExecute(String command,StringList args,bool autoExecute) |
ExternalProcess* |
Command — имя команды,args — список аргументов,bool — автовыполнение |
Подготовить для выполнения команду с передачей аргументов. |
Запустить команду на открытие файла
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| gm.shellOpen(String command) |
bool |
Command — команда |
Запустить команду на открытие файла |
Класс Consts
Класс объектов, содержащих названия доступных режимов работы пользователя
Свойства
| Свойство |
Тип |
Описание |
| modeZoomIn |
String |
Режим приближения |
| modeZoomOut |
String |
Режим отдадления |
| modeMove |
String |
Режим передвижения в одной плоскости |
| modeRotate |
String |
Режим вращения |
| gm.constants |
Consts |
Объект с названиями доступных режимов |
GlobalMap GS / API / Работа с аудио
Работа с аудио
Класс «AudioOutput»
Класс объектов «AudioOutput » позволяет работать со звуковыми файлами.
Свойства
| Свойство |
Тип |
Описание |
| src |
String |
Путь до звукового файла |
| error |
String |
Описание последней ошибки |
| state |
String |
Текущее состояние (пауза, проигрывание, ошибка и т.д) |
| totalTime |
qint64 |
Длительность подключенного звукового файла в миллисекундах |
| volume |
qreal |
Уровень громкости (от 0 до 1) |
| mute |
bool |
Заглушение громкости проигрывания |
Проиграть загруженный файл
Метод
| Метод |
Возвращает |
Описание |
| gm.AudioOutput.play() |
void |
Проиграть загруженный файл |
Прекратить проигрывание загруженного файла
Метод
| Метод |
Возвращает |
Описание |
| gm.AudioOutput.stop() |
void |
Прекратить проигрывание загруженного файла |
Остановить проигрывание загруженного файла
Метод
| Метод |
Возвращает |
Описание |
| gm.AudioOutput.pause() |
void |
Остановить проигрывание загруженного файла |
Сбросить на начало проигрывание загруженного файла
Метод
| Метод |
Возвращает |
Описание |
| gm.AudioOutput.reset() |
void |
Сбросить на начало проигрывание загруженного файла |
Создать новый объект для работы со звуковыми файлами
Метод
| Метод |
Возвращает |
Описание |
| gm.factory.newAudio() |
AudioOutput* |
Создать новый объект для работы со звуковыми файлами |
Примеры работы
var a = gm.factory.newAudio();
a.src = "file:///d:/downloads/mp3tones/1.mp3"
a.play();
a.reset();
a.play();
var a = gm.factory.newAudio();
a.src = "file:///d:/downloads/mp3tones/1.mp3"
a.finished.connect(function() {a.reset(); a.play(); });
a.play();
var a = gm.factory.newAudio();
a.src = "file:///d:/downloads/mp3tones/1.mp3"
a.play();
a.pause();
a.play();
a.stop();
a.deleteLater();
Раздвижное меню правой панели.
Методы
| Метод |
Описание |
| hide() |
Скрыть меню |
| show() |
Показать меню |
Раздвижное меню со слоями правой панели.
События
| Событие |
Описание |
Параметры |
| «layerAccordion:created» |
Произошло создание виджета. |
— |
| «layerAccordion:groupCheckBoxClick» |
Произошел клик на checkBox группы слоев. |
action — String, «off all» или «turn all»,groupId — id группы слоев |
Элемент меню со слоями правой панели.
Методы
| Метод |
Описание |
| turned() |
Возвращает true или false, включен ли слой |
| turnDefaultLayer() |
Включение слоя при фиксированной ссылке |
| turnLayer() |
Включение слоя |
| turnLayer() |
Включение слоя |
| offLayer() |
Выключение слоя |
| turnCheckBox() |
Активация checkBox |
| offCheckBox() |
Деактивация checkBox |
События
| Событие |
Описание |
Параметры |
| «layerItem:layerClick» |
Произошло нажатие на checkBox слоя. |
— |
| «offLayer» |
На карте выключен слой. |
layer — объект слоя |
| «turnLayer» |
На карте включен слой. |
layer — объект слоя |
Легенда слоя.
Список группы слоев.
События
| Событие |
Описание |
Параметры |
| «layerList:created» |
Произошло создание виджета. |
groupId — id группы слоев |
| «layerList:turnedAllCheckbox» |
Включены все checkbox группы слоев. |
block- DOM элемент списка |
| «layerList:offSomeCheckbox» |
Выключены все checkbox группы слоев. |
block- DOM элемент списка |
Поиск слоев.
Результат поиска слоев.
Методы
| Метод |
Описание |
| resize(parentHeight) |
parentHeight — высота родителя.
Перерисовать результаты поиска. |
События
| Событие |
Описание |
Параметры |
| «foundLayerTurn» |
Включен один из найденных слоев. |
layer- объект слоя |
| «foundLayerOff» |
Выключен один из найденных слоев. |
layer- объект слоя |
Виджет нумерации страниц.
Методы
| Метод |
Описание |
| hide() |
Скрыть. |
| show() |
Показать. |
События
| Событие |
Описание |
Параметры |
| «pagination:pageClick» |
Произошел клик на страницу пагинации. |
page — номер страницы |
Виджет вкладок правой панели. Объект в системе GP.widgets.tabs.
Методы
| Метод |
Описание |
Параметры |
| addTab(options) |
Добавить вкладку. |
options{
name,
image,
imageWhite,
divId
}
|
| removeTab(divId) |
Показать. |
divId — id внутренней части вкладки. |
| hide() |
Скрыть правую панель. |
— |
| show() |
Показать правую панель. |
— |
События
| Событие |
Описание |
Параметры |
| «tab:resize» |
Изменены размеры правой панели. |
— |
| «tab:remove:item» |
Удалена вкладка. |
divId — id внутренней части вкладки. |
| «tab:layerAccordionCreated» |
Создалось меню со списком слоев. |
— |
| «tab:rightPanelHide» |
Правая панель свернулась. |
— |
| «tab:rightPanelShow» |
Правая панель раскрылась. |
— |
GlobalMap GS / API / Работа с камерой
Работа с камерой
Класс «Camera»
Класс объектов «Camera» позволяет управлять камерой пользователя.
Свойства
| Свойство |
Тип |
Описание |
| height |
double |
Высота |
| lon |
double |
Долгота |
| lat |
double |
Широта |
| time |
double |
Время перелета (в мс) |
| matrix |
String |
Географическая матрица камеры |
| geomatrix |
String |
Геоцентрическая матрица камеры |
| scale |
double |
Размер ближайшего к камере пикселя сцены в метрах |
| angle |
double |
Угол поворота камеры |
| mousePosition |
Pos |
Позиция курсора мышки |
Перелет камеры к указанной позиции
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| moveTo(double, double, double, double) |
bool |
Долгота, широта, высота (необязательно, останется текущая),
время перелета (в мс, необязательно, останется текущее) |
Перелет камеры к указанной позиции |
Вращение камеры на заданный угол по оси
Методы
| Метод |
Возвращает |
Параметры |
Описание |
| rotateX(double, double) |
void |
|
Вращение камеры на заданный угол по оси Х |
| rotateY(double, double) |
void |
|
Вращение камеры на заданный угол по оси Y |
| rotateZ(double, double) |
void |
|
Вращение камеры на заданный угол по оси Z |
Вращение камеры по заданной оси на заданный угол
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| rotate(double, int, double) |
void |
Угол, ось(1 — Х, 2 — Y, 3 — Z), время перелета(необязательно) |
Вращение камеры по заданной оси на заданный угол |
Изменение положения камеры
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| translate(double, double, double) |
void |
Cмещение по оси Х, смещение по оси Y, время перелета(необязательно) |
Изменение положения камеры |
| translateX(double, double) |
void |
Cмещение по оси Х, время перелета(необязательно) |
Изменение положения камеры по оси Х |
| gm.camera.translateY(double, double) |
void |
Cмещение по оси Y, время перелета(необязательно |
Изменение положения камеры по оси Y |
Высота в заданной точке
Метод
| Метод |
Возвращает |
Параметры |
Описание |
| pointHeight(double, double) |
double |
Долгота, широта |
Высота в заданной точке |
Класс Pos
Класс объектов для хранения географических координат
Свойства
| Свойство |
Тип |
Описание |
| lon |
double |
Долгота |
| lat |
double |
Широта |
| height |
double |
Высота |
Создание нового объекта позиции
Метод
| Метод |
Возвращает |
Описание |
| gm.factory.newPos() |
Pos* |
Создание нового объекта позиции |
GlobalMap / API / Работа с точками
Работа с точками
Класс «Measure»
Класс объектов «measure» позволяет рисовать линии поверх карты.
Свойства
| Свойство |
Тип |
Описание |
| enabled |
bool |
Включено/выключено |
| color |
String |
Цвет |
| pointColor |
String |
Цвет точек |
| renderTime |
int |
Время рендеринга |
| pointNumber |
int |
Количество точек |
| distance |
double |
Расстояние, на котором объект становится виден |
Добавление новой точки
Метод
| Метод |
Возвращает |
Описание |
| addPoint(Pos*) |
bool |
Добавление новой точки |
Удаление последней добавленной точки
Метод
| Метод |
Возвращает |
Описание |
| deleteLastPoint() |
bool |
Удаление последней добавленной точки |
Удаление всех точек
Метод
| Метод |
Возвращает |
Описание |
| clearPoints() |
bool |
Удаление всех точек |
Вспомогательные классы
класс GeoPortal.HashMap();
Класс ассоативного массива.
Методы
| Метод |
Описание |
| getCount() |
возвращает количество элементов |
| add(key, value) |
добавление элемента в HashMap |
| getKeys() |
возвращает массив ключей |
| containsKey(key) |
возвращает true|false: существует ли ключ |
| contains(value) |
возвращает true|false: существует ли значение |
| findKey(value) |
найти ключ по значению |
| get(key) |
найти значение по ключу |
| removeByKey(key) |
удалить по ключу |
| clear() |
очистить HashMap |
| getValues() |
получить все значения |
| getArray(isKey) |
получить массивом
isKey:
true - ключи
false - значения
|
each(
function(key,value,length){
},
context)
|
вызов функции function в контексте context для каждого элемента HashMap |
События
| Событие |
Описание |
Параметры |
| «add» |
Добавлен элемент. |
me — массив,key — ключ элемента, value — значение элемента |
| «replace» |
Заменен элемент. |
me — массив,key — ключ элемента, value — значение элемента,
old — замененный элемент |
| «remove» |
Удален элемент элемент. |
me — массив,key — ключ элемента, value — значение элемента |
| «clear» |
Ассоциативный массив очищен. |
me — массив |
Объект GP.Browser. Определение браузера.
Свойства
| Свойство |
Описание |
| ie |
true, если браузер Internet Explorer |
| ieVersion |
Версия Internet Explore, -1 если браузер не ie. |
