PL/outputChatBox

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

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

BETA: FROM VERSION 1.5.8 r20788 ONWARDS
BETA: FROM VERSION 1.5.8 r20788 ONWARDS