Функция OffsetXY()

Назначение

Возвращает копию исходного объекта, смещенного на заданные значения по осям X и Y.

Синтаксис

OffsetXY(object, xoffset, yoffset, units)

где:

object - смещаемый объект,

xoffset и yoffset - рассстояния вдоль осей x и y на которые смещается объект и units - строка, представляющая единицы измерения расстояния.

Возвращаемое значение

Объект

Описание

Эта функция создает новый объект, являющийся копией исходного объекта, заданного параметром object, смещенного на величину xoffset вдоль оси X и на величину yoffset вдоль оси Y. Строка units, аналогично параметрам в воператорах ObjectLen или Perimeter, является единицей измерения расстояния. Для параметра distance применяется способ расчетов Spherical. Поэтому если объект построен в План-схеме, будет выведено сообщение об ошибке, так как тип расстояний Spherical не подходит для план-схемы. Это показано при возвращении пустого объекта NULL. Используемая система координат - это система координат исходного объекта.

Измерения сделанные на сфере и на плоскости, различаются. Так, при перемещении объекта по карте, построенной в проекции “Долгота/Широта”, его форма не изменится, но поменяется площадь. Это происходит из-за того, что фактическое смещение измеряется в градусах, а соответствующее им расстояние в различных местах земного шара отличается.

Для функций Offset, фактическое смещение рассчитано в некоторой установленной точке на объекте (например, центр описывающего прямоугольника), и затем это значение преобразовано из исходных единиц в единицы текущей системы координаты. Если система координаты - Широта/Долгота, преобразование в градусы использует фиксированное число десятичных знаков. Фактическое преобразованное измерение расстояния могло измениться в различных местах объекта. Расстояние от исходного объекта до нового смещенного объекта будет вычислено с гарантированной точностью, если в них используются измерения с фиксированным числом знаков.

Пример

OffsetXY(Rect, 92, -22, “mi”)

Функция SphericalOffsetXY()

Назначение

Возвращает копию исходного объекта, смещенного на некоторые значения по осям X и Y, при этом используются сферические вычисления расстояний.

Синтаксис

SphericalOffsetXY(object, xoffset, yoffset, units)

где:

object - смещаемый объект,

xoffset и yoffset - рассстояния вдоль осей x и y на которые смещается объект и units - строка, представляющая единицы измерения расстояния.

Возвращаемое значение

Объект

Описание

Эта функция создает новый объект, являющийся копией исходного объекта, заданного параметром object, смещенного на величину xoffset вдоль оси X и на величину yoffset вдоль оси Y. Строка units, аналогично параметрам в воператорах ObjectLen или Perimeter, является единицей измерения расстояния. Для параметра distance применяется способ расчетов Spherical. Поэтому если объект построен в План-схеме, будет выведено сообщение об ошибке, так как тип расстояний Spherical не подходит для план-схемы. Это показано при возвращении пустого объекта NULL. Используемая система координат - это система координат исходного объекта.

Измерения сделанные на сфере и на плоскости, различаются. Так, при перемещении объекта по карте, построенной в проекции “Долгота/Широта”, его форма не изменится, но поменяется площадь. Это происходит из-за того, что фактическое смещение измеряется в градусах, а соответствующее им расстояние в различных местах земного шара отличается.

Для функций Offset, фактическое смещение рассчитано в некоторой установленной точке на объекте (например, центр описывающего прямоугольника), и затем это значение преобразовано из исходных единиц в единицы текущей системы координаты. Если система координаты - Широта/Долгота, преобразование в градусы использует фиксированное число десятичных знаков. Фактическое преобразованное измерение расстояния могло измениться в различных местах объекта. Расстояние от исходного объекта до нового смещенного объекта будет вычислено с гарантированной точностью, если в них используются измерения с фиксированным числом знаков.

Пример

SphericalOffsetXY(Rect, 92, -22, “mi”)

Функция CartesianOffsetXY()

Назначение

Возвращает копию исходного объекта, смещенного на определенное расстояние по осям X и Y, рассчитанное по декартовым алгоритмам.

Синтаксис

CartesianOffsetXY(object, xoffset, yoffset, units)

где:

object - смещаемый объект,

xoffset и yoffset - рассстояния вдоль осей x и y на которые смещается объект и units - строка, представляющая единицы измерения расстояния.

Возвращаемое значение

Объект

Описание

Эта функция создает новый объект, являющийся копией исходного объекта, заданного параметром object, смещенного на величину xoffset вдоль оси X и на величину yoffset вдоль оси Y. Строка units, аналогично параметрам в воператорах ObjectLen или Perimeter, является единицей измерения расстояния. Для параметра distance имеет значение Cartesian. Поэтому если исходноый объект построен в “Широта/Долгота”, будет выведено сообщение об ошибке, поскольку декартоаый тип подсчета расстояний не подходит для “Широта/Долгота”. Это показано при возвращении пустого объекта NULL. Используемая система координат - это система координат исходного объекта.

Измерения сделанные на сфере и на плоскости, различаются. Так, при перемещении объекта по карте, построенной в проекции “Долгота/Широта”, его форма не изменится, но поменяется площадь. Это происходит из-за того, что фактическое смещение измеряется в градусах, а соответствующее им расстояние в различных местах земного шара отличается.

Для функций Offset, фактическое смещение рассчитано в некоторой установленной точке на объекте (например, центр описывающего прямоугольника), и затем это значение преобразовано из исходных единиц в единицы текущей системы координаты. Если система координаты - Широта/Долгота, преобразование в градусы использует фиксированное число десятичных знаков. Фактическое преобразованное измерение расстояния могло измениться в различных местах объекта. Расстояние от исходного объекта до нового смещенного объекта будет вычислено с гарантированной точностью, если в них используются измерения с фиксированным числом знаков.

Пример

CartesianOffsetXY(Rect, 92, -22, “mi”)

Функция LayerInfo( )

Мы добавили новый Layer_Info_Type, для корректной работы с WMS-таблицами.

Назначение

Возвращает информацию о слое в окне Карты.

Синтаксис

LayerInfo( map_window_id , layer_number , attribute )

map_window_id - идентификатор окна Карты

layer_number - число слоев в текущем окне Карты (например, 1 для верхнего слоя); для определения числа слоев в окне Карты, вызывайте MapperInfo( )

attribute - код, определяющий тип возвращаемой информации; смотрите таблицу в документации к MapBasic 7.5

Внимание: Для получения информации о значениях, об ограничениях, кодах атрибутов, для вывода описания и примеров, смотрите документацию MapBasic 7.5.