Jaber at 16:42, 19 February 2016

2016-02-19T16:42:27Z

← Older revision		Revision as of 16:42, 19 February 2016
Line 86:		Line 86:
	{{RU/Marker functions}}		{{RU/Marker functions}}
	[[en:createMarker]]		[[en:createMarker]]
			[[ar:createMarker]]

Damage22 at 16:48, 8 July 2010

2010-07-08T16:48:02Z

← Older revision		Revision as of 16:48, 8 July 2010
Line 85:		Line 85:
	==Смотрите также==		==Смотрите также==
	{{RU/Marker functions}}		{{RU/Marker functions}}
	[[en:~~getRootElement~~]]		[[en:createMarker]]

Damage22 at 16:45, 8 July 2010

2010-07-08T16:45:46Z

← Older revision		Revision as of 16:45, 8 July 2010
Line 85:		Line 85:
	==Смотрите также==		==Смотрите также==
	{{RU/Marker functions}}		{{RU/Marker functions}}
			[[en:getRootElement]]

Damage22: Created page with 'NOTOC {{RU/Server client function}} Эта функция создает маркер. Маркер - это 3D-модель в игровом мире, которая мож…'

2010-07-08T16:44:41Z

Created page with '__NOTOC__ {{RU/Server client function}} Эта функция создает маркер. Маркер - это 3D-модель в игровом мире, которая мож…'

New page

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

Есть ограничения на максимальное число одновременно видимых маркеров, а именно:
* Короны: 32
* Чекпоинты, кольца, цилиндры и стрелки все в сумме: 32

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

==Синтаксис==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
marker createMarker ( float x, float y, float z, [string theType, float size, int r, int g, int b, int a, visibleTo = getRootElement()] )
</syntaxhighlight>

===Обязательные аргументы===
* '''x''': Вещественное число - координата X на карте.
* '''y''': Вещественное число - координата Y на карте.
* '''z''': Вещественное число - координата Z на карте.

===Дополнительные аргументы===
{{RU/OptionalArg}}
* '''theType''': Внешний вид маркера. Доступны следующие типы:
{{RU/Marker_types}}
* '''size''': Диаметр маркера в метрах.
* '''r''': Целое число - количество красного компонента в цвете маркера (0 - 255).
* '''g''': Целое число - количество красного компонента в цвете маркера (0 - 255).
* '''b''': Целое число - количество красного компонента в цвете маркера (0 - 255).
* '''a''': Целое число - прозрачность маркера (0 - 255 где 0 - полностью прозрачный, а 255 - полностью непрозрачный).
* '''visibleTo''': Только этот элемент и его потомки смогут увидеть маркер. См.[[visibility]].
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
marker createMarker ( float x, float y, float z, [string theType, float size, int r, int g, int b, int a] )
</syntaxhighlight>

===Обязательные аргументы===
* '''x''': Вещественное число - координата X на карте.
* '''y''': Вещественное число - координата Y на карте.
* '''z''': Вещественное число - координата Z на карте.

===Дополнительные аргументы===
{{RU/OptionalArg}}
* '''theType''': Внешний вид маркера. Доступны следующие типы:
{{RU/Marker_types}}
* '''size''': Диаметр маркера в метрах.
* '''r''': Целое число - количество красного компонента в цвете маркера (0 - 255).
* '''g''': Целое число - количество красного компонента в цвете маркера (0 - 255).
* '''b''': Целое число - количество красного компонента в цвете маркера (0 - 255).
* '''a''': Целое число - прозрачность маркера (0 - 255 где 0 - полностью прозрачный, а 255 - полностью непрозрачный).
</section>

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

==Пример==
<section name="Пример 1" class="server" show="true">
Создает рядом с игроком маркер, когда он вводит команду 'createmarker':
<syntaxhighlight lang="lua">
-- эта функция вызывается при вводе '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 )
</syntaxhighlight>
</section>

<section name="Пример 2" class="both" show="true">
Создает маркер в точке 0, 0, 20:
<syntaxhighlight lang="lua">
createMarker ( 0, 0, 20 )
</syntaxhighlight>
</section>

==Смотрите также==
{{RU/Marker functions}}

RU/createMarker - Revision history

Jaber at 16:42, 19 February 2016

Damage22 at 16:48, 8 July 2010

Damage22 at 16:45, 8 July 2010

Damage22: Created page with '__NOTOC__ {{RU/Server client function}} Эта функция создает маркер. Маркер - это 3D-модель в игровом мире, которая мож…'

Damage22: Created page with 'NOTOC {{RU/Server client function}} Эта функция создает маркер. Маркер - это 3D-модель в игровом мире, которая мож…'