RU/Resource:Customblips: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{RU/Resource page}} __NOTOC__ Ресурс '''customblips''' позволяет вам создавать Blip-иконки на клиентской стороне, котор...")
 
m (Reverted edits by Bonzo (talk) to last revision by Vincent)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RU/Resource page}}
{{RU/Resource page}}
__NOTOC__
__NOTOC__
Ресурс '''customblips''' позволяет вам создавать Blip-иконки на клиентской стороне, которые будут появляться на радаре и карте (F11). Собственные blip'ы могут быть представлены любой картинкой или GUI элементом.
Ресурс '''customblips''' позволяет вам создавать Blip-иконки на клиентской стороне, которые будут появляться на радаре и карте (F11). Данные blip'ы могут быть представлены любой картинкой или GUI элементом.


==Экспортированные клиентские функции==
==Экспортированные клиентские функции==
* '''createCustomBlip'''
* '''createCustomBlip'''
** Эта функция создает собственный blip с использованием функций DirectX для работы с изображениями. Если радиус stream ниже 180, то blip появится только когда будет видимым на радаре.
** Эта функция создает свой blip с использованием DirectX-функций для работы с изображениями. Если радиус stream ниже 180, то blip появится только при непосредственной близости на радаре.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
customblip exports.customblips:createCustomBlip ( float worldX, float worldY, int imageWidth, int imageHeight, string imagePath, [float streamRadius = 500] )
customblip exports.customblips:createCustomBlip ( float worldX, float worldY, int imageWidth, int imageHeight, string imagePath, [float streamRadius = 500] )
Line 12: Line 12:


* '''guiConvertToCustomBlip'''
* '''guiConvertToCustomBlip'''
** Эта функция создает собственный с использованием любого элемента GUI. Если радиус stream ниже 180, то blip появится только когда будет видимым на радаре.
** Эта функция создает свой blip с использованием любого из элементов GUI. Если радиус stream ниже 180, то blip появится только при непосредственной близости на радаре.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
gui-elem exports.customblips:guiConvertToCustomBlip ( gui-element blipGUI, float worldX, float worldY, [float streamRadius = 500] )
gui-elem exports.customblips:guiConvertToCustomBlip ( gui-element blipGUI, float worldX, float worldY, [float streamRadius = 500] )
Line 19: Line 19:


* '''getCustomBlipStreamRadius'''
* '''getCustomBlipStreamRadius'''
** Эта функци получает текущий радиус stream'а собсвтенного blip. Заметьте, что радиус stream'a не влияет на карту (F11).
** Эта функция получает текущий радиус stream своего blip. Заметьте, что радиус stream не влияет на карту (F11).
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float exports.customblips:getCustomBlipStreamRadius ( customblip theBlip )
float exports.customblips:getCustomBlipStreamRadius ( customblip theBlip )
Line 26: Line 26:


* '''setCustomBlipStreamRadius'''
* '''setCustomBlipStreamRadius'''
** Эта функция задает текущий раудиус stream'а собственного blip. Заметьте, что радиус stream'a не влияет на карту (F11).
** Эта функция задает текущий раудиус stream указанного blip. Заметьте, что радиус stream не влияет на карту (F11).
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool exports.customblips:setCustomBlipStreamRadius ( customblip theBlip, float streamRadius )
bool exports.customblips:setCustomBlipStreamRadius ( customblip theBlip, float streamRadius )
Line 33: Line 33:


* '''getCustomBlipPosition'''
* '''getCustomBlipPosition'''
** Эта функция получает позицию собственного blip в игровом мире.
** Эта функция получает позицию своего blip в игровом мире.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float worldX, float worldY exports.customblips:getCustomBlipPosition ( customblip theBlip )
float worldX, float worldY exports.customblips:getCustomBlipPosition ( customblip theBlip )
Line 47: Line 47:


* '''setCustomBlipRadarScale'''
* '''setCustomBlipRadarScale'''
** Эта функция задает масштаб (где 0 - невидимый, а 1 - 100% размер. Выход за пределы 1 увеличит размер) blip, когда он появляется на радаре, завсиит от размера, указанного при создании. Присвоение nil вернет стандартный размер GTA'шного радарного blip.
** Эта функция задает масштаб (где 0 - невидимый, а 1 - 100% размер. Выход за пределы 1 увеличит размер) blip, когда он появляется на радаре; зависит от размера, указанного при создании. Присвоение nil вернет стандартный размер GTA'шного радарного blip.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool exports.customblips:setCustomBlipRadarScale ( customblip theBlip, float scale )
bool exports.customblips:setCustomBlipRadarScale ( customblip theBlip, float scale )
Line 54: Line 54:


* '''setCustomBlipAlpha'''
* '''setCustomBlipAlpha'''
** Эта функция задает alpha (значения 0-1) blip, позволяя регулировку прозрачности.
** Эта функция задает alpha (значения 0-1) blip, позволяя регулировать прозрачность.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool exports.customblips:setCustomBlipAlpha ( customblip theBlip, float alpha )
bool exports.customblips:setCustomBlipAlpha ( customblip theBlip, float alpha )
Line 61: Line 61:


* '''setCustomBlipVisible'''
* '''setCustomBlipVisible'''
** Эта функция задает видимость blip. Невидимые blipне будут прорисовываться.
** Эта функция задает видимость blip. Невидимые blip не будут прорисовываться.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool exports.customblips:setCustomBlipAlpha ( customblip theBlip, bool visible )
bool exports.customblips:setCustomBlipAlpha ( customblip theBlip, bool visible )
Line 68: Line 68:


* '''destroyCustomBlip'''
* '''destroyCustomBlip'''
** Эта функция удаляет собственный blip.
** Эта функция удаляет свой blip.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool exports.customblips:destroyCustomBlip ( customblip theBlip )
bool exports.customblips:destroyCustomBlip ( customblip theBlip )
Line 88: Line 88:


'''Пример 2'''
'''Пример 2'''
Этот образец создает картинку blip"icon.png" на координатах 0,0 - подразумевая, что раземр картинки - 20x20px.
Этот образец создает картинку-blip "icon.png" на координатах 0,0 - подразумевая, что размер картинки - 20x20px.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler ( "onClientResourceStart", getResourceRootElement(getThisResource()),
addEventHandler ( "onClientResourceStart", getResourceRootElement(getThisResource()),

Latest revision as of 03:07, 1 April 2016

Ресурс 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 не влияет на карту (F11).
float exports.customblips:getCustomBlipStreamRadius ( customblip theBlip )


  • setCustomBlipStreamRadius
    • Эта функция задает текущий раудиус stream указанного blip. Заметьте, что радиус stream не влияет на карту (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
)