PL/outputChatBox: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Server client function}}__NOTOC__
{{PL/Shared function}}
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.
{{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.}}
Możemy zmienić kolor ciągu znaków przez ustawienie argumentu colorCoded na true. Przykład :
__NOTOC__
<syntaxhighlight lang="lua">[lua, N]outputChatBox ("#ff0000Witam #0000ffWas!", getRootElement(), 255, 255, 255, true)</syntaxhighlight>
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.
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==
*'''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==
*'''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.
{{PL/OptionalArg}}
*'''visibleTo:''' Dla kogo wiadomość ma zostać ukazana. Zobacz [[visibility]] .
*'''visibleTo:''' Dzięki temu argumentowi, możesz zdecydować komu wyświetli się dana wiadomość (więcej informacji [[visibility|tutaj]]). Domyślnie ''false''.
*'''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>
<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==
*'''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==
*'''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.
{{PL/OptionalArg}}
*'''visibleTo:''' Dla kogo wiadomość ma zostać ukazana. Zobacz [[visibility]] .
*'''r:''' Wartość koloru czerwonego w tekście. Domyślnie ''231''.
*'''r:''' Wartość czerwonego koloru textu. Domyślna wartość to 231.
*'''g:''' Wartość koloru zielonego w tekście. Domyślnie ''217''.
*'''g:''' Wartość zielonego koloru textu. Domyślna wartość to 217.
*'''b:''' Wartość koloru niebieskiego w tekście. Domyślnie ''176''.
*'''b:''' Wartość niebieskiego koloru textu. Domyślna wartość to 176.
*'''colorCoded:''' Boolean decydujący o tym, czy tagi '#RRGGBB' mają być używane. Domyślnie ''false''.
*'''colorCoded:''' Argument pozwalający (lub nie) na zmianę ciągu znaków przez dodanie tagu #rrggbb
ⓘ 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'.
{{MessageBox|
 
  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==
<section name="Server" class="server" show="true">
'''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">
outputChatBox ( "Czerwony #00FF00Zielony #0000FFNiebieski", getRootElement(), 255, 0, 0, true )
</syntaxhighlight>


== Przykłady ==
'''Przykład nr 2:''' Ten przykład wyświetla wiadomość graczowi o nicku "ktostam".
<section name="Serwer" class="server" show="true">
'''Przykład 1 : Ten przykład wyśle wiadomość do wszystkich graczy'''
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
x = 10
gracz = getPlayerFromName ( "ktostam" ) -- szukamy gracza o nicku "ktostam"
y = 3
if gracz then -- jeżeli go znaleźliśmy, kontynuujemy...
outputChatBox("Zjadłem "..x.." klusek i wypiłem "..y.." szklanki wody.")
  outputChatBox ( "Cześć ktosiu!", gracz ) -- ...i wyświetlamy mu wiadomość
end
</syntaxhighlight>
 
'''Przykład nr 3:''' Ten przykład wyświetla wiadomość powitalną graczowi wchodzącemu na serwer.
<syntaxhighlight lang="lua">
function graczWchodziNaSerwer()
  outputChatBox ( "Witaj na serwerze!", source, 255, 0, 0 )
end
addEventHandler ( "onPlayerJoin", root, graczWchodziNaSerwer )
</syntaxhighlight>
</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==
{{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