PL/outputChatBox: Difference between revisions

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

@@ 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__
-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>
+{{OOP||[[player]]:outputChat}}
 ==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==
-*'''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 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 (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==
-*'''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>
-== 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">
-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>
-'''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">
-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>
-'''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">
-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
-addEventHandler("onPlayerChat", getRootElement(), colorChat)
+addEventHandler ( "onPlayerJoin", root, graczWchodziNaSerwer )
+</syntaxhighlight>
 </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]]

PL/outputChatBox: Difference between revisions

Latest revision as of 21:34, 19 July 2016

Składnia (syntax)

Wymagane argumenty

Opcjonalne argumenty

Wymagane argumenty

Opcjonalne argumenty

Wynik

Przykłady

Zobacz także

Navigation menu

Search