PL/outputChatBox: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (GabWas moved page PL/outputChatBox to PL/OutputChatBox)
mNo edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Server client function}}
{{PL/Shared function}}
{{PL/Note_box|Unikaj wyświetlania na czacie informacji takich jak poziom zdrowia, zbroi, tlenu, pieniędzy, itp, ponieważ może to po prostu zirytować graczy + odpowiada za to HUD.}}
__NOTOC__
__NOTOC__
Wysyła określony ciąg znaków do chatbox'a. Można go określić jako wiadomość do pewnego gracza(y) lub wszystkich graczy.
Funkcja ta umożliwia wyświetlenie na czacie dowolnego ciągu znaków, mniejszego niż 128. Istnieje również możliwość zdefiniowania, dla kogo ta wiadomość ma być widoczna.
Możemy zmienić kolor ciągu znaków przez ustawienie argumentu colorCoded na true. Przykład :
<syntaxhighlight lang="lua">[lua, N]outputChatBox ("#ff0000Witam #0000ffWas!", getRootElement(), 255, 255, 255, true)</syntaxhighlight>
Wyświetli nam '''<span style='color:red;'>Witam</span> <span style='color:blue'>Was!</span> '''
----


== Składnia ==
Przy korzystaniu z funkcji możemy dodatkowo ustalić, czy ma ona odczytywać zapis heksadecymedalny ('#RRGGBB'), dzięki któremu jesteśmy w stanie dowolnie pokolorować nasz tekst. Przykładowo:
<section name="Serwer" class="server" show="true">
<syntaxhighlight lang="lua">
outputChatBox ( "#FF0000Hello #00FF00World", getRootElement(), 255, 255, 255, true )
</syntaxhighlight>
zostanie wyświetlone jako: '''<span style='color:red;'>Hello</span> <span style='color:green'>World</span> '''
 
==Składnia (syntax)==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>
 
{{OOP||[[player]]:outputChat}}
==Wymagane argumenty==
==Wymagane argumenty==
*'''text:''' Ciąg znaków (litery lub liczby), które chcesz pokazać na czacie. Jeżeli długość przekroczy 128 znaków, wiadomość się nie ukaże.
*'''text:''' Ciąg znaków, który zostanie wyświetlony na czacie. Jeżeli jednak jego długość przekroczy 128 znaków, wiadomość nie zostanie wysłana.


==Opcjonalne argumenty==
==Opcjonalne argumenty==
*'''visibleTo:''' Dla kogo wiadomość ma zostać ukazana. Zobacz [[visibility]] .
{{PL/OptionalArg}}
*'''r:''' Wartość czerwonego koloru textu. Domyślna wartość to 231.
*'''visibleTo:''' Dzięki temu argumentowi, możesz zdecydować komu wyświetli się dana wiadomość (więcej informacji [[visibility|tutaj]]). Domyślnie ''false''.
*'''g:''' Wartość zielonego koloru textu. Domyślna wartość to 217.
*'''r:''' Wartość koloru czerwonego w tekście. Domyślnie ''231''.
*'''b:''' Wartość niebieskiego koloru textu. Domyślna wartość to 176.
*'''g:''' Wartość koloru zielonego w tekście. Domyślnie ''217''.
*'''colorCoded:''' Argument pozwalający (lub nie) na zmianę ciągu znaków przez dodanie tagu #rrggbb
*'''b:''' Wartość koloru niebieskiego w tekście. Domyślnie ''176''.
{{MessageBox|
*'''colorCoded:''' Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie ''false''.
  bordercolorhex = 00ADAD |
ⓘ Pamiętaj, że tagi '#RRGGBB' mogą składać się tylko z wielkich liter, więc małe litery nie będą akceptowane. Domyślna wartość RGB w tym przypadku to '#E7D9B0'.
  bordertype = |
  bgcolorhex = F9F9F9 |
  title = Notatka |
  subtext = #rrggbb format może zawierać litery od a do f ale mogą być to też duże litery. |
}}
</section>
</section>
<section name="Klient" class="client" show="true">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>
<syntaxhighlight lang="lua">bool outputChatBox ( string text [, int r=231, int g=217, int b=176, bool colorCoded=false ] )</syntaxhighlight>


==Wymagane argumenty==
==Wymagane argumenty==
*'''text:''' Ciąg znaków (litery lub liczby), które chcesz pokazać na czacie. Jeżeli długość przekroczy 128 znaków, wiadomość się nie ukaże.
*'''text:''' Ciąg znaków, który zostanie wyświetlony na czacie. Jeżeli jednak jego długość przekroczy 128 znaków, wiadomość nie zostanie wysłana.


==Opcjonalne argumenty==
==Opcjonalne argumenty==
*'''visibleTo:''' Dla kogo wiadomość ma zostać ukazana. Zobacz [[visibility]] .
{{PL/OptionalArg}}
*'''r:''' Wartość czerwonego koloru textu. Domyślna wartość to 231.
*'''r:''' Wartość koloru czerwonego w tekście. Domyślnie ''231''.
*'''g:''' Wartość zielonego koloru textu. Domyślna wartość to 217.
*'''g:''' Wartość koloru zielonego w tekście. Domyślnie ''217''.
*'''b:''' Wartość niebieskiego koloru textu. Domyślna wartość to 176.
*'''b:''' Wartość koloru niebieskiego w tekście. Domyślnie ''176''.
*'''colorCoded:''' Argument pozwalający (lub nie) na zmianę ciągu znaków przez dodanie tagu #rrggbb
*'''colorCoded:''' Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie ''false''.
{{MessageBox|
ⓘ Pamiętaj, że tagi '#RRGGBB' mogą składać się tylko z wielkich liter, więc małe litery nie będą akceptowane. Domyślna wartość RGB w tym przypadku to '#E7D9B0'.
  bordercolorhex = 00ADAD |
 
  bordertype = |
  bgcolorhex = F9F9F9 |
  title = Notatka |
  subtext = #rrggbb format może zawierać litery od a do f ale mogą być to też duże litery. |
}}
</section>
</section>


== Zwracanie ==
==Wynik==
Zwraca ''true'' jeśli wiadomość została poprawnie wyświetlona. Zwraca ''false'' jeżeli argumenty były błędne i wiadomość nie została wyświetlona.
Zwraca ''true'' jeśli wiadomość została pomyślnie wyświetlona. Zwraca ''false'', jeżeli któryś z argumentów został nieprawidłowo wypełniony.


== Przykłady ==
==Przykłady==
<section name="Serwer" class="server" show="true">
<section name="Server" class="server" show="true">
'''Przykład 1 :''' Ten przykład wyśle wiadomość do wszystkich graczy
'''Przykład nr 1:''' Ten przykład wyświetla wiadomość wszystkim graczom na serwerze, przy czym nazwy kolorów mają swoje barwy.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
x = 10
outputChatBox ( "Czerwony #00FF00Zielony #0000FFNiebieski", getRootElement(), 255, 0, 0, true )
y = 3
outputChatBox("Zjadłem "..x.." klusek i wypiłem "..y.." szklanki wody.")
</syntaxhighlight>
</syntaxhighlight>
'''Przykład 2 :''' Ten przykład wyśle prostą kolorową wiadomość do wszystkich graczy
 
'''Przykład nr 2:''' Ten przykład wyświetla wiadomość graczowi o nicku "ktostam".
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
outputChatBox("Czarno #00ff00zielone", getRootElement(), 0, 0, 0, true)  
gracz = getPlayerFromName ( "ktostam" ) -- szukamy gracza o nicku "ktostam"
if gracz then -- jeżeli go znaleźliśmy, kontynuujemy...
  outputChatBox ( "Cześć ktosiu!", gracz ) -- ...i wyświetlamy mu wiadomość
end
</syntaxhighlight>
</syntaxhighlight>
'''Przykład 3 :''' Ten przykład zablokuje tagi kolorów w czacie i będzie wysyłał białe wiadomości
 
'''Przykład nr 3:''' Ten przykład wyświetla wiadomość powitalną graczowi wchodzącemu na serwer.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function colorChat ( message, theType )
function graczWchodziNaSerwer()
if theType == 0 then --sprawdzamy czy to normalna wiadomość (nie /me lub teamchat)
  outputChatBox ( "Witaj na serwerze!", source, 255, 0, 0 )
message = string.gsub(message, "#%x%x%x%x%x%x", "") --usuwamy tagi kolorów
local r,g,b = getPlayerNametagColor ( source ) --pobieramy kolor nicku gracza
local chatterName = getPlayerName ( source ) --pobieramy jego nick
--wysyłamy z nickiem w kolorze, a resztę na biało
outputChatBox ( chatterName..":#FFFFFF "..message, getRootElement(), r, g, b, true )
end
end
end
addEventHandler("onPlayerChat", getRootElement(), colorChat)
addEventHandler ( "onPlayerJoin", root, graczWchodziNaSerwer )
</syntaxhighlight>
</section>
</section>


<br/>
''Autor: [[User:GabWas|GabWas]], utworzono: 23:32 19 Lip 2016 (CEST)''
<br/>''Author: [[User:GabWas|GabWas]], created: 21:32 19 Jul 2016 (UTC)''


----
==Zobacz także==
--[[User:MACIEKW89|MACIEKW89]] 01:10, 21 December 2013 (UTC)MACIEKW89
{{Server functions}}
[[cs:outputChatBox]]
[[ru:outputChatBox]]

Latest revision as of 21:34, 19 July 2016

Uwaga: Unikaj wyświetlania na czacie informacji takich jak poziom zdrowia, zbroi, tlenu, pieniędzy, itp, ponieważ może to po prostu zirytować graczy + odpowiada za to HUD.

Funkcja ta umożliwia wyświetlenie na czacie dowolnego ciągu znaków, mniejszego niż 128. Istnieje również możliwość zdefiniowania, dla kogo ta wiadomość ma być widoczna.

Przy korzystaniu z funkcji możemy dodatkowo ustalić, czy ma ona odczytywać zapis heksadecymedalny ('#RRGGBB'), dzięki któremu jesteśmy w stanie dowolnie pokolorować nasz tekst. Przykładowo:

outputChatBox ( "#FF0000Hello #00FF00World", getRootElement(), 255, 255, 255, true )

zostanie wyświetlone jako: Hello World

Składnia (syntax)

Click to collapse [-]
Server
bool outputChatBox ( string text [, element visibleTo=getRootElement(), int r=231, int g=217, int b=176, bool colorCoded=false ] )

OOP Syntax Help! I don't understand this!

Method: player:outputChat(...)


Wymagane argumenty

  • text: Ciąg znaków, który zostanie wyświetlony na czacie. Jeżeli jednak jego długość przekroczy 128 znaków, wiadomość nie zostanie wysłana.

Opcjonalne argumenty

UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.

  • visibleTo: Dzięki temu argumentowi, możesz zdecydować komu wyświetli się dana wiadomość (więcej informacji tutaj). Domyślnie false.
  • r: Wartość koloru czerwonego w tekście. Domyślnie 231.
  • g: Wartość koloru zielonego w tekście. Domyślnie 217.
  • b: Wartość koloru niebieskiego w tekście. Domyślnie 176.
  • colorCoded: Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie false.

ⓘ Pamiętaj, że tagi '#RRGGBB' mogą składać się tylko z wielkich liter, więc małe litery nie będą akceptowane. Domyślna wartość RGB w tym przypadku to '#E7D9B0'.

Click to collapse [-]
Client
bool outputChatBox ( string text [, int r=231, int g=217, int b=176, bool colorCoded=false ] )

Wymagane argumenty

  • text: Ciąg znaków, który zostanie wyświetlony na czacie. Jeżeli jednak jego długość przekroczy 128 znaków, wiadomość nie zostanie wysłana.

Opcjonalne argumenty

UWAGA: Kiedy korzystasz z opcjonalnych argumentów, musisz uzupełnić wszystkie argumenty przed tym, którego chcesz użyć. Aby uzyskać więcej informacji na ten temat, zajrzyj tutaj.

  • r: Wartość koloru czerwonego w tekście. Domyślnie 231.
  • g: Wartość koloru zielonego w tekście. Domyślnie 217.
  • b: Wartość koloru niebieskiego w tekście. Domyślnie 176.
  • colorCoded: Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie false.

ⓘ Pamiętaj, że tagi '#RRGGBB' mogą składać się tylko z wielkich liter, więc małe litery nie będą akceptowane. Domyślna wartość RGB w tym przypadku to '#E7D9B0'.

Wynik

Zwraca true jeśli wiadomość została pomyślnie wyświetlona. Zwraca false, jeżeli któryś z argumentów został nieprawidłowo wypełniony.

Przykłady

Click to collapse [-]
Server

Przykład nr 1: Ten przykład wyświetla wiadomość wszystkim graczom na serwerze, przy czym nazwy kolorów mają swoje barwy.

outputChatBox ( "Czerwony #00FF00Zielony #0000FFNiebieski", getRootElement(), 255, 0, 0, true )

Przykład nr 2: Ten przykład wyświetla wiadomość graczowi o nicku "ktostam".

gracz = getPlayerFromName ( "ktostam" ) -- szukamy gracza o nicku "ktostam"
if gracz then -- jeżeli go znaleźliśmy, kontynuujemy...
   outputChatBox ( "Cześć ktosiu!", gracz ) -- ...i wyświetlamy mu wiadomość
end

Przykład nr 3: Ten przykład wyświetla wiadomość powitalną graczowi wchodzącemu na serwer.

function graczWchodziNaSerwer()
   outputChatBox ( "Witaj na serwerze!", source, 255, 0, 0 )
end
addEventHandler ( "onPlayerJoin", root, graczWchodziNaSerwer )


Autor: GabWas, utworzono: 23:32 19 Lip 2016 (CEST)
Author: GabWas, created: 21:32 19 Jul 2016 (UTC)

Zobacz także