RU/createMarker

From Multi Theft Auto: Wiki

Эта функция создает маркер. Маркер - это 3D-модель в игровом мире, которая может обозначить какую-либо точку или область, и часто используется, чтобы давать игрокам указания, где именно можно выполнять определенные действия, например, заходить в здание.

Есть ограничения на максимальное число одновременно видимых маркеров, а именно:

  • Короны: 32
  • Чекпоинты, кольца, цилиндры и стрелки все в сумме: 32

Создавать можно практически неограниченное число маркеров (при условии, что хватает памяти и ограничения по числу элементов), однако игрок сможет увидеть только ближайшие из них, и не более указанных ограничений.

Синтаксис

Click to collapse [-]
Server
marker createMarker ( float x, float y, float z, [string theType, float size, int r, int g, int b, int a, visibleTo = getRootElement()] )

Обязательные аргументы

  • x: Вещественное число - координата X на карте.
  • y: Вещественное число - координата Y на карте.
  • z: Вещественное число - координата Z на карте.

Дополнительные аргументы

Примечание. При использовании необязательных аргументов Вам может потребоваться предоставить все аргументы перед тем аргументом, который Вы хотите использовать. Для более подробной информации ознакомьтесь с необязательными аргументами.

  • theType: Внешний вид маркера. Доступны следующие типы:
    • "checkpoint": Чекпоинт для гонок. Выглядит, как высокая, но не бесконечная светящаяся колонна. Чекпоинты привязываются к земле и становятся невидимыми после того, как над ними проедут на определенной высоте (по координате Z).
    • "ring": Кольцо в форме бублика, обычно используется для самолетов и вертолетов.
    • "cylinder": Небольшое светящееся кольцо. Они используются в одиночной игре для того, чтобы начать миссию.
    • "arrow": Стрелка, указывающая на землю. Такие же стрелки есть в одиночной игре на входе в те здания, в которые игрок может зайти, однако в MTA они по умолчанию не анимированы.
    • "corona": Светящийся шар.
  • size: Диаметр маркера в метрах.
  • r: Целое число - количество красного компонента в цвете маркера (0 - 255).
  • g: Целое число - количество красного компонента в цвете маркера (0 - 255).
  • b: Целое число - количество красного компонента в цвете маркера (0 - 255).
  • a: Целое число - прозрачность маркера (0 - 255 где 0 - полностью прозрачный, а 255 - полностью непрозрачный).
  • visibleTo: Только этот элемент и его потомки смогут увидеть маркер. См.visibility.
Click to collapse [-]
Client
marker createMarker ( float x, float y, float z, [string theType, float size, int r, int g, int b, int a] )

Обязательные аргументы

  • x: Вещественное число - координата X на карте.
  • y: Вещественное число - координата Y на карте.
  • z: Вещественное число - координата Z на карте.

Дополнительные аргументы

Примечание. При использовании необязательных аргументов Вам может потребоваться предоставить все аргументы перед тем аргументом, который Вы хотите использовать. Для более подробной информации ознакомьтесь с необязательными аргументами.

  • theType: Внешний вид маркера. Доступны следующие типы:
    • "checkpoint": Чекпоинт для гонок. Выглядит, как высокая, но не бесконечная светящаяся колонна. Чекпоинты привязываются к земле и становятся невидимыми после того, как над ними проедут на определенной высоте (по координате Z).
    • "ring": Кольцо в форме бублика, обычно используется для самолетов и вертолетов.
    • "cylinder": Небольшое светящееся кольцо. Они используются в одиночной игре для того, чтобы начать миссию.
    • "arrow": Стрелка, указывающая на землю. Такие же стрелки есть в одиночной игре на входе в те здания, в которые игрок может зайти, однако в MTA они по умолчанию не анимированы.
    • "corona": Светящийся шар.
  • size: Диаметр маркера в метрах.
  • r: Целое число - количество красного компонента в цвете маркера (0 - 255).
  • g: Целое число - количество красного компонента в цвете маркера (0 - 255).
  • b: Целое число - количество красного компонента в цвете маркера (0 - 255).
  • a: Целое число - прозрачность маркера (0 - 255 где 0 - полностью прозрачный, а 255 - полностью непрозрачный).

Вывод

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

Пример

Click to collapse [-]
Пример 1

Создает рядом с игроком маркер, когда он вводит команду 'createmarker':

-- эта функция вызывается при вводе 'createmarker':
function consoleCreateMarker ( thePlayer, commandName )
   if ( thePlayer ) then
      local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
      -- создаем цилиндрический маркер рядом с игроком
      local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
      if ( theMarker ) then -- проверяем, что успешно создали маркер
         outputConsole ( "Marker created successfully", thePlayer )
      else
         outputConsole ( "Failed to create marker", thePlayer )
      end
   end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
Click to collapse [-]
Пример 2

Создает маркер в точке 0, 0, 20:

createMarker ( 0, 0, 20 )

Смотрите также