[INC] Colors v.1.0.5

Colors
Функции для легкого управления цветом чата

Описание:
Этот файл позволяет разработчикам легко управлять цветами шрифта чата в различных игровых модах, использовать теги цветов, использовать теги в файлах перевода и автоматически заменять цвета в моде, которые не поддерживают их (любой цвет, который не поддерживается, будет заменен на зеленый цвет).

Функции:
  1. CPrintToChat
  2. CPrintToChatAll
  3. CPrintToChatEx
  4. CPrintToChatAllEx
  5. CRemoveTags
  6. CSkipNextClient

Регулярные фунции:
PHP код:
/**
 * Prints a message to a specific client in the chat area.
 * Supports color tags.
 *
 * @param client      Client index.
 * @param szMessage   Message (formatting rules).
 * @return              No return
 * 
 * On error/Errors:   If the client is not connected an error will be thrown.
 */
stock CPrintToChat(client, const String:szMessage[], any:...)

/**
 * Prints a message to all clients in the chat area.
 * Supports color tags.
 *
 * @param client      Client index.
 * @param szMessage   Message (formatting rules)
 * @return              No return
 */
stock CPrintToChatAll(const String:szMessage[], any:...)  
Tags: {default}, {green}, {yellow}, {lightgreen}, {red}, {blue}, {olive}.

Основные цвета: default, green (желтый в L4D), olive.
Командные цвета: lightgreen, red, blue.

Таблица цветов:

Примечания:
  • You can use only one team color (like lightgreen, red or blue) in the message.
  • In hl2dm colors are different for classic deathmatch and team deathmatch.
  • If some color is not supported by the mod it will be automatically replaced with green
  • You can use these functions instead of default SM function, they are supports formatting (%d, %s, %t, etc.)
  • Green color is yellow in L4D and yellow is green in all other games. You can use tag that you prefer.
  • There must be at least one player in each team for proper red and blue colors working. Otherwise these tags will be replaced with green.


Team color based functions:
PHP код:
/** 
 * Prints a message to a specific client in the chat area. 
 * Supports color tags and teamcolor tag. 
 * 
 * @param client      Client index. 
 * @param author      Author index whose color will be used for teamcolor tag. 
 * @param szMessage   Message (formatting rules). 
 * @return              No return 
 *  
 * On error/Errors:   If the client or author are not connected an error will 
 *                    be thrown. 
 */ 
stock CPrintToChatEx(clientauthor, const String:szMessage[], any:...) 

/** 
 * Prints a message to all clients in the chat area. 
 * Supports color tags and teamcolor tag. 
 * 
 * @param author      Author index whos color will be used for teamcolor tag. 
 * @param szMessage   Message (formatting rules). 
 * @return              No return 
 *  
 * On error/Errors:   If the author is not connected an error will 
 *                    be thrown. 
 */ 
stock CPrintToChatAllEx(author, const String:szMessage[], any:...)  
Tags: {default}, {green}, {yellow}, {olive}, {teamcolor}.

Основные цвета: default, green (желтый в L4D), olive.
Командные цвета: based on author's team color.

Примечания:
  • Author index is any client index whose team color you want to be used for {teamcolor} tag
  • Tag {teamcolor} replaces {red}, {blue} and {lightgreen} tags
  • All notes for regular functions are used for these function too.

Другое:
PHP код:
/**
 * Removes color tags from the string.
 *
 * @param szMessage   String.
 * @param maxlength   Maximum length of the string buffer.
 * @return              No return
 */
stock CRemoveTags(String:szMessage[], maxlength)

/**
 * This function should only be used right in front of
 * CPrintToChatAll or CPrintToChatAllEx and it tells
 * to those funcions to skip specified client when printing
 * message to all clients. After message is printed client will
 * no more be skipped.
 * 
 * @param client   Client index
 * @return           No return
 */
stock CSkipNextClient(client)  
FAQ

1. Как использовать цвет?
Просто пометьте текст тегом цвета
PHP код:
CPrintToChat(client"This text is {green}green{default} and this is {red}red");  
Что получится: 

2. Можно ли использовать красный синий и зеленый цвет в одной строке?
Нет. Можно использовать только один цвет команды в строке. (Либо синий либо красный)

3. Какой формат работы функции?
Они работают точно так же, как по умолчанию SM функции (например, PrintToChat)
PHP код:
CPrintToChatAll("This number {green}%d{default} is green"5);  
Что получится: 

4. Можно ли использовать цвета в файлах перевода?
Да, можно.
Пример:
Код:
"Phrases"
{
 "My phrase"
 {
 "en" "My {green}phrase"
 "ru" "Моя {green}фраза"
 }
}
В коде:
PHP код:
CPrintToChatAll("%t""My phrase");  
Что получается: 

5. Как его установить?
Потожить colors.inc в папку sourcemod/scripting/include
Добавить в код:
PHP код:
#include <colors>  
6. Можно ли использовать серый цвет?

Можно. Но для этого требуется хотябы один игрок в наблюдателях.

7. Почему иногда красный-синий цвета иногда показывает зеленым?

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

Оригинал

Источник: http://hlmod.ru/forum/rasshireniya/268-inc-colors-v-1-0-5-a.html

[INC] Colors v.1.0.5

СКАЧАТЬ (2.7Kb)

Пожаловаться на файл
  • Комментарии ВКонтакте
  • Комментарии на сайте

По просмотрам По дате По рейтингу По комментарием
© 2008-2017 nkp-team
 Все права защищены
моды для minecraft
скачать css v34