RU/Resource:Customblips: Difference between revisions
Jump to navigation
Jump to search
(Created page with "{{RU/Resource page}} __NOTOC__ Ресурс '''customblips''' позволяет вам создавать Blip-иконки на клиентской стороне, котор...") |
|||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{RU/Resource page}} | {{RU/Resource page}} | ||
__NOTOC__ | __NOTOC__ | ||
Ресурс '''customblips''' позволяет вам создавать Blip-иконки на клиентской стороне, которые будут появляться на радаре и карте (F11). | Ресурс '''customblips''' позволяет вам создавать Blip-иконки на клиентской стороне, которые будут появляться на радаре и карте (F11). Данные blip'ы могут быть представлены любой картинкой или GUI элементом. | ||
==Экспортированные клиентские функции== | ==Экспортированные клиентские функции== | ||
* '''createCustomBlip''' | * '''createCustomBlip''' | ||
** Эта функция создает | ** Эта функция создает свой 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''' | ||
** Эта функция создает | ** Эта функция создает свой 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 не влияет на карту (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 | ** Эта функция задает текущий раудиус 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 в игровом мире. | ||
<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 | ** Эта функция задает масштаб (где 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 не будут прорисовываться. | ||
<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. | ||
<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 | Этот образец создает картинку-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 )