RU/Resource:Customblips

Ресурс customblips позволяет вам создавать Blip-иконки на клиентской стороне, которые будут появляться на радаре и карте (F11). Собственные blip'ы могут быть представлены любой картинкой или GUI элементом.

Экспортированные клиентские функции

• createCustomBlip
  • Эта функция создает собственный blip с использованием функций DirectX для работы с изображениями. Если радиус stream ниже 180, то blip появится только когда будет видимым на радаре.

customblip exports.customblips:createCustomBlip ( float worldX, float worldY, int imageWidth, int imageHeight, string imagePath, [float streamRadius = 500] )

• guiConvertToCustomBlip
  • Эта функция создает собственный blip с использованием любого элемента GUI. Если радиус stream ниже 180, то blip появится только когда будет видимым на радаре.

gui-elem exports.customblips:guiConvertToCustomBlip ( gui-element blipGUI, float worldX, float worldY, [float streamRadius = 500] )

• getCustomBlipStreamRadius
  • Эта функция получает текущий радиус stream'а собственного blip. Заметьте, что радиус stream'a не влияет на карту (F11).

float exports.customblips:getCustomBlipStreamRadius ( customblip theBlip )

• setCustomBlipStreamRadius
  • Эта функция задает текущий раудиус stream'а собственного blip. Заметьте, что радиус stream'a не влияет на карту (F11).

bool exports.customblips:setCustomBlipStreamRadius ( customblip theBlip, float streamRadius )

• getCustomBlipPosition
  • Эта функция получает позицию собственного blip в игровом мире.

float worldX, float worldY exports.customblips:getCustomBlipPosition ( customblip theBlip )

• setCustomBlipPosition
  • Эта функция задает текущую позицию blip в игровом мире.

bool exports.customblips:setCustomBlipPosition ( customblip theBlip, float worldX, float worldY )

• setCustomBlipRadarScale
  • Эта функция задает масштаб (где 0 - невидимый, а 1 - 100% размер. Выход за пределы 1 увеличит размер) blip'а, когда он появляется на радаре, завсиит от размера, указанного при создании. Присвоение nil вернет стандартный размер GTA'шного радарного blip'а.

bool exports.customblips:setCustomBlipRadarScale ( customblip theBlip, float scale )

• setCustomBlipAlpha
  • Эта функция задает alpha (значения 0-1) blip'а, позволяя регулировку прозрачности.

bool exports.customblips:setCustomBlipAlpha ( customblip theBlip, float alpha )

• setCustomBlipVisible
  • Эта функция задает видимость blip'а. Невидимые blip'ы не будут прорисовываться.

bool exports.customblips:setCustomBlipAlpha ( customblip theBlip, bool visible )

• destroyCustomBlip
  • Эта функция удаляет собственный blip.

bool exports.customblips:destroyCustomBlip ( customblip theBlip )

Примеры

Пример 1 Этот образец создает blip, который пишет 'Spawn' на доме Toreno с использованием GUI

addEventHandler ( "onClientResourceStart", getResourceRootElement(getThisResource()),
	function()
		local blip = guiCreateButton ( 0, 0, 25, 20, "Spawn", false )
		guiSetFont(blip,"default-small")
		exports.customblips:guiConvertToCustomBlip ( blip, -700, 960, 10 )
	end
)

Пример 2 Этот образец создает картинку blip'а "icon.png" на координатах 0,0 - подразумевая, что раземр картинки - 20x20px.

addEventHandler ( "onClientResourceStart", getResourceRootElement(getThisResource()),
	function()
		exports.customblips:createCustomBlip ( 0,0, 20, 20, "icon.png" )
	end
)