FileEX: Translated to PL

2024-04-19T11:38:02Z

Translated to PL

New page

{{PL/Resource page}}
__NOTOC__
Scoreboard (lista graczy) oparty o DirectX wyświetla dostępnych graczy na serwerze oraz drużyny (teamy). Na liście graczy znajdziemy informacje o nich takie jak nick, drużyna czy ping. Scoreboard posiada także wbudowany oparty o javascript interfejs web, dzięki czemu scoreboard dostępny jest także z poziomu przeglądarki. Zasób ten powstał jako lepsza alternatywa dla starego [[PL/Resource:OldScoreboard|scoreboard'u]] stworzonego przez [[User:jbeta|jbeta]].

Główna różnica względem starego scoreboard'u polega na tym, że ten został w pełni oparty o funkcje rysowania DirectX dostępne w MTA.

Gdy dodajesz kolumnę do scoreboardu to jako jej treść będzie pobierana element data o takiej samej nazwie jak nazwa kolumny. Czyli jeśli dodasz kolumnę "punkty" to w jej treści wyświetlana będzie wartość elementdaty o nazwie "punkty".

Dostępny do pobrania na stronie [http://community.mtasa.com/index.php?p=resources&s=details&id=419 MTA community].

==Kolory poszczególnych komórek==
Obsługiwane są niestandardowe kolory w postaci #RRGGBB w komórkach z nazwami drużyny czy graczy. Należy to najpierw włączyć w konfiguracji zasobu w polu ''allowColorcodedNames''. Pozostałe komórki nie wspierają niestandardowych kolorów, ale zamiast tego w ustawieniach XML dostępna jest opcja ''content_color'', która pozwala ustalić kolor wszystkich innych komórek niż te zawierające nazwy. Ustawienia mogą być zmieniane przez użytkownika za pomocą przycisku '''settings...'''. W pliku ''dxscoreboard_clientsettings.lua'' znajdziesz też inne ustawienia.

==Eksportowane funkcje i zdarzenia==
<section name="Server" class="server" show="true">
===Funkcje===
<syntaxhighlight lang="lua">
bool scoreboardAddColumn ( string name, [ element forElement = getRootElement(), int width = 70, string friendlyName = name, int priority = slot after "name" column ] )
</syntaxhighlight>
*'''name:''' Nazwa kolumny, która musi być jednocześnie nazwą elementdaty z której pobrane zostaną dane do wyświetlenia. Nie jest to wyświetlana nazwa.
*'''forElement:''' Gracz dla którego ma zostać dodana kolumna.
*'''width:''' Szerokość kolumny w pikselach.
*'''friendlyName:''' Nazwa kolumny, która będzie wyświetlana na liście.
*'''priority:''' Slot kolumny po kolumnie "name" (1-500). Jeśli dany slot nie jest wolny to kolumna z tego slotu zostanie przesunięta dalej.
 

<syntaxhighlight lang="lua">
bool scoreboardRemoveColumn ( string name, [ element forElement = getRootElement() ] )
</syntaxhighlight>
*'''name:''' Nazwa kolumny.
*'''forElement:''' Gracz dla którego kolumna ma zostać usunięta.
 

<syntaxhighlight lang="lua">
bool scoreboardClearColumns ( [ element forElement = getRootElement() ] )
</syntaxhighlight>
*'''forElement:''' Gracz, dla którego kolumna ma zostać wyczyszczona.
 

<syntaxhighlight lang="lua">
bool scoreboardResetColumns ( [ element forElement = getRootElement() ] )
</syntaxhighlight>
*'''forElement:''' Gracz dla którego kolumny powinny zostać zresetowane (zostaje tylko nick i ping)
 

<syntaxhighlight lang="lua">
bool scoreboardSetForced ( bool forced, [ element forElement = getRootElement() ] )
</syntaxhighlight>
*'''forced:''' Wartość określająca czy scoreboard ma zostać wymuszony.
*'''forElement:''' Gracz dla którego scoreboard ma zostać wymuszony lub nie.
 

<syntaxhighlight lang="lua">
bool scoreboardSetSortBy ( string name, [ bool descending = true, element forElement = getRootElement() ] )
</syntaxhighlight>
*'''name:''' Nazwa kolumny, można też podać ''nil'' aby wyłączyć sortowanie.
*'''descending:''' Wartość określająca czy sortowanie ma być malejące.
*'''forElement:''' Gracz dla którego ma zostać zastosowane sortowanie.
 

<syntaxhighlight lang="lua">
int scoreboardGetColumnPriority ( string name )
</syntaxhighlight>
*'''name:''' Nazwa kolumny.
'''Zwraca priorytet (slot) kolumny (1-500).'''
 

<syntaxhighlight lang="lua">
bool scoreboardSetColumnPriority ( string name, int priority, [ element forElement = getRootElement() ] )
</syntaxhighlight>
*'''name:''' Nazwa kolumny.
*'''priority:''' Slot kolumny po kolumnie "name" (1-500). Jeśli dany slot nie jest wolny to kolumna z tego slotu zostanie przesunięta dalej.
*'''forElement:''' Gracz dla którego ma zostać ustawiony
 

<syntaxhighlight lang="lua">
int scoreboardGetColumnCount ()
</syntaxhighlight>
*''Brak argumentów.''
'''Zwraca liczbę kolumn.'''
 

<syntaxhighlight lang="lua">
bool scoreboardForceTeamsVisible( bool enabled )
</syntaxhighlight>
*'''enabled:''' Wartość określająca czy nagłówek/kolumna drużyny powinien być zawsze widoczny (ustawienia klienta są ignorowane).
 

<syntaxhighlight lang="lua">
bool scoreboardForceTeamsHidden( bool enabled )
</syntaxhighlight>
*'''enabled:''' Wartość określająca czy nagłówek/kolumna drużyny powinien być zawsze ukryty (ustawienia klienta są ignorowane).
 

<syntaxhighlight lang="lua">
bool isPrioritySlotFree( int slot )
</syntaxhighlight>
*'''slot:''' Slot, który ma zostać sprawdzony.
'''Sprawdza czy podany slot jest wolny.'''
 

<syntaxhighlight lang="lua">
int getNextFreePrioritySlot( [ int startAt = 1 ] )
</syntaxhighlight>
*'''startAt:''' Od której kolumny mamy zacząć szukać wolnego slotu.
'''Znajduje najbliższy wolny slot.'''
 

'''Notatka: ''' Funkcje ze starego zasobu [[PL/Resource:OldScoreboard|scoreboard]] są dostępne także w tym zasobie
<syntaxhighlight lang="lua">
bool addScoreboardColumn ( string columnName, element visibleToElement, int columnPosition, float columnSize )
bool removeScoreboardColumn ( string columnName )
bool setPlayerScoreboardForced ( player thePlayer, bool forced )
bool resetScoreboardColumns ()
</syntaxhighlight>
</section>
<section name="Client" class="client" show="true">
===Funkcje===
<syntaxhighlight lang="lua">
bool scoreboardAddColumn ( string name, [ int width = 70, string friendlyName = name, int priority = slot after "name" column, function textFunction = nil ] )
</syntaxhighlight>
*'''name:''' Nazwa kolumny, która musi być jednocześnie nazwą elementdaty z której pobrane zostaną dane do wyświetlenia. Nie jest to wyświetlana nazwa.
*'''width:''' Szerokość kolumny w pikselach.
*'''friendlyName:''' Nazwa kolumny, która będzie wyświetlana na liście.
*'''priority:''' Slot kolumny po kolumnie "name" (1-500). Jeśli dany slot nie jest wolny to kolumna z tego slotu zostanie przesunięta dalej.
*'''textFunction:''' Funkcja w postaci tekstu, która zostanie wykonana przed wyświetleniem zawartości kolumny. Przykładowo ta funkcja zamieni znak "_" na spację w kolumnie z nickami graczy jeśli dodamy ją do kolumny "name".
<syntaxhighlight lang="lua">
function fixName( playerName )
return playerName:gsub( "_", " " )
end
</syntaxhighlight>
 

<syntaxhighlight lang="lua">
bool scoreboardRemoveColumn ( string name )
</syntaxhighlight>
*'''name:''' Nazwa kolumny.
 

<syntaxhighlight lang="lua">
bool scoreboardClearColumns ()
</syntaxhighlight>
*''Brak argumentów.''
 

<syntaxhighlight lang="lua">
bool scoreboardResetColumns ()
</syntaxhighlight>
*''Brak argumentów.''
 

<syntaxhighlight lang="lua">
bool scoreboardSetForced ( bool forced )
</syntaxhighlight>
*'''forced:''' Wartość określająca czy scoreboard ma zostać wymuszony.
 

<syntaxhighlight lang="lua">
bool scoreboardSetColumnTextFunction ( string name, function textFunction )
</syntaxhighlight>
*'''name:''' Nazwa kolumny.
*'''textFunction:''' Funkcja w postaci tekstu, która zostanie wykonana przed wyświetleniem zawartości kolumny. Przykładowo ta funkcja zamieni znak "_" na spację w kolumnie z nickami graczy jeśli dodamy ją do kolumny "name".
<syntaxhighlight lang="lua">
function fixName( playerName )
return playerName:gsub( "_", " " )
end
</syntaxhighlight>
 

<syntaxhighlight lang="lua">
bool scoreboardSetSortBy ( string name, [ bool descending = true ] )
</syntaxhighlight>
*'''name:''' Nazwa kolumny, można podać ''nil'', aby wyłączyć sortowanie.
*'''descending:''' Wartość określająca czy sortowanie ma być malejące.
 

<syntaxhighlight lang="lua">
int scoreboardGetColumnPriority ( string name )
</syntaxhighlight>
*'''name:''' Nazwa kolumny.
'''Zwraca priorytet (slot) kolumny (1-500)'''
 

<syntaxhighlight lang="lua">
bool scoreboardSetColumnPriority ( string name, int priority )
</syntaxhighlight>
*'''name:''' Nazwa kolumy
*'''priority:''' Slot kolumny po kolumnie "name" (1-500). Jeśli dany slot nie jest wolny to kolumna z tego slotu zostanie przesunięta dalej.
 

<syntaxhighlight lang="lua">
int scoreboardGetColumnCount ()
</syntaxhighlight>
*''Brak argumentów.''
'''Zwraca ilość kolumn.'''
 

<syntaxhighlight lang="lua">
bool isPrioritySlotFree( int slot )
</syntaxhighlight>
*'''slot:''' Slot który chcemy sprawdzić.
'''Sprawdza czy podany slot jest wolny.'''
 

<syntaxhighlight lang="lua">
int getNextFreePrioritySlot( [ int startAt = 1 ] )
</syntaxhighlight>
*'''startAt:''' Od której kolumny mamy zacząć szukać wolnego slotu.
'''Znajduje najbliższy wolny slot.''
 

<syntaxhighlight lang="lua">
int, int scoreboardGetTopCornerPosition ()
</syntaxhighlight>
'''Zwraca pozycję absolutną lewego górnego rogu scoreboard. Jeśli nie jest rysowany na ekranie zwraca false.'''
 

<syntaxhighlight lang="lua">
int, int scoreboardGetSize ()
</syntaxhighlight>
'''Zwraca absolutny rozmiar (szerokość, wysokość) scoreboardu. Jeśli nie jest rysowany na ekranie zwraca false.'''
 

<syntaxhighlight lang="lua">
table scoreboardGetSelectedRows ()
</syntaxhighlight>
'''Zwraca tabelę zawierającą wszystkie wybrane wiersze (element, którym może być drużyna lub gracz). Może również zwrócić pustą tabelę, jeśli nie wybrano wierszy.''
 

'''Notatka: ''' Funkcje ze starego zasobu [[PL/Resource:OldScoreboard|scoreboard]] są dostępne także w tym zasobie
<syntaxhighlight lang="lua">
bool setScoreboardForced ( bool forced )
</syntaxhighlight>

===Zdarzenia===
====onClientPlayerScoreboardClick====
<syntaxhighlight lang="lua">
bool selected, int cursorX, int cursorY
</syntaxhighlight>
*'''selected:''' Określa czy wiersz został zaznaczony (''true'') czy nie (''false'').
*'''cursorX:''' Pozycja absolutna kursora w osi X.
*'''cursorY:''' Pozycja absolutna kursora w osi Y.
'''Wywoływany kiedy gracz kliknie LPM na wiersz z kolumny graczy lub drużyn''' 
''' ''source'' to element, który został kliknięty. Może to być [[player]] lub [[team]].'''
</section>

Funkcje te możesz także wywołać z poziomu innego zasobu używając funkcji [[call]] lub wskazanych tam metod.
<syntaxhighlight lang="lua">
call ( getResourceFromName ( "dxscoreboard" ), "scoreboardAddColumn", "Wanted level" )

-- Taka składnia jest także poprawna. Po więcej informacji sprawdź artykuł o funkcji call.
exports.dxscoreboard:scoreboardAddColumn( "Wanted level" )
</syntaxhighlight>

Wartości w kolumnach wyświetlane są na podstawie elementdaty o tej samej nazwie. Możesz użyć [[setElementData]], aby zmienić wyświetlaną wartość u danego gracza:
<syntaxhighlight lang="lua">
-- 3 zostanie wyświetlona w kolumnie "wanted level" u danego gracza
-- Pod warunkiem, że kolumna o takiej nazwie została dodana do scoreboard'u
setElementData ( player, "Wanted level", 3 )
</syntaxhighlight>

[[en:Resource:Scoreboard]]

PL/Resource:scoreboard - Revision history

FileEX: Translated to PL