Bars - paski

Ten pakiet bardzo ułatwia dodawanie nowych pasków, dla wyświetlania np. wytrzymałości.

Zależności

• PermMem
• View

Inicjalizacja

Zainicjuj za pomocą flagi LeGo_Bars.

1

LeGo_Init(LeGo_Bars);

Implementacja

Bars.d na GitHubie

Funkcje

Bar_Create

Tworzy nowy pasek z instancji konstruktora.

1

func int Bar_Create(var int inst)

Parametry

• var int inst
  Instancja konstruktora klasy Bar

Zwracana wartość

Funkcja zwraca handler do nowego paska.

1
2

var int bar; bar = Bar_Create(GothicBar@); // Tworzy nowy pasek
Bar_SetPercent(bar, 50);                   // Ustawia jego wartość na 50%

1
2
3
4
5

func void Example_1()
{
    var int bar; bar = Bar_Create(GothicBar@); // Tworzy nowy pasek
    Bar_SetPercent(bar, 50);                   // Ustawia jego wartość na 50%
};

Bar_Delete

Usuwa pasek z ekranu i pamięci.

1

func void Bar_Delete(var int bar)

Parametry

• var int bar
  Handler zwrócony przez Bar_Create

Bar_SetMax

Zmienia maksymalna wartość paska, ale nie aktualizuje jego długości (tylko Bar_SetPercent, Bar_SetPromille i Bar_SetValue to robią)

1

func void Bar_SetMax(var int bar, var int max)

• var int bar
  Handler zwrócony przez Bar_Create

• var int max
  Nowa maksymalna wartość

Bar_SetValue

Ustawia wartość paska.

1

func void Bar_SetValue(var int bar, var int val)

• var int bar
  Handler zwrócony przez Bar_Create
• var int val
  Nowa wartość paska

Bar_SetPercent

Ustawia wartość paska, ale w procentach (0..100).

1

func void Bar_SetPercent(var int bar, var int perc)

• var int bar
  Handler zwrócony przez Bar_Create
• var int perc
  Nowa wartość paska w procentach

Bar_SetPromille

Ustawia wartość paska, ale w promilach (0..1000).

1

func void Bar_SetPromille(var int bar, var int pro)

• var int bar
  Handler zwrócony przez Bar_Create
• var int pro
  Nowa wartość paska w promilach

Bar_Hide

Ukrywa pasek, ale go nie usuwa.

1

func void Bar_Hide(var int bar)

• var int bar
  Handler zwrócony przez Bar_Create

Bar_Show

Wyświetla pasek ponownie po użyciu Bar_Hide.

1

func void Bar_Show(var int bar)

• var int bar
  Handler zwrócony przez Bar_Create

Bar_MoveTo

Przenosi pasek do danej pozycji wirtualnej.

1

func void Bar_MoveTo(var int bar, var int x, var int y)

• var int bar
  Handler zwrócony przez Bar_Create
• var int x
  Nowa pozycja w osi x
• var int y
  Nowa pozycja w osi y

Bar_MoveToPxl

Przenosi pasek do danej pozycji wyrażonej w pikselach.

1

func void Bar_MoveToPxl(var int bar, var int x, var int y)

• var int bar
  Handler zwrócony przez Bar_Create
• var int x
  Nowa pozycja w osi x
• var int y
  Nowa pozycja w osi y

Bar_SetAlpha

Ustawia przezroczystość paska.

1

func void Bar_SetAlpha(var int bar, var int alpha)

• var int bar
  Handler zwrócony przez Bar_Create
• var int alpha
  Wartość przezroczystości (0..255)

Bar_SetBarTexture

Ustawia teksturę wartości paska.

1

func void Bar_SetBarTexture(var int bar, var string barTex)

• var int bar
  Handler zwrócony przez Bar_Create
• var string barTex
  Nowa tekstura

Bar_SetBackTexture

Ustawia teksturę tła paska.

1

func void Bar_SetBackTexture(var int bar, var string backTex)

• var int bar
  Handler zwrócony przez Bar_Create
• var string backTex
  Nowa tekstura tła

Bar_Resize

Zmienia rozmiar istniejącego paska.

1

func void Bar_Resize(var int bar, var int width, var int height)

• var int bar
  Handler zwrócony przez Bar_Create
• var int width
  Nowa szerokość
• var int height
  Nowa szerokość

Bar_ResizePxl

Resize existing bar (in pixels).

1

func void Bar_ResizePxl(var int bar, var int x, var int y)

• var int bar
  Handler zwrócony przez Bar_Create
• var int x
  Nowa szerokość w pikselach
• var int y
  Nowa szerokość w pikselach

Przykłady

Dedykowany pasek doświadczenia

Pakiet Bars implementuje klasę Bar. Która wygląda tak:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

class Bar
{
    var int x;          // Pozycja na ekranie w osi X (środka paska)
    var int y;          // Pozycja na ekranie w osi Y (środka paska)
    var int barTop;     // Pasek odstępu tła - góra/dół
    var int barLeft;    // Pasek odstępu tła - lewo/prawo
    var int width;      // Szerokość
    var int height;     // Wysokość
    var string backTex; // Tekstura tła
    var string barTex;  // Tekstura wartości paska
    var int value;      // Początkowa wartość
    var int valueMax;   // Maksymalna wartość
};

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

prototype GothicBar(Bar)
{
    x = Print_Screen[PS_X] / 2;
    y = Print_Screen[PS_Y] - 20;
    barTop = 3;
    barLeft = 7;
    width = 180;
    height = 20;
    backTex = "Bar_Back.tga";
    barTex = "Bar_Misc.tga";
    value = 100;
    valueMax = 100;
};

O wiele łatwiej jest skonfigurować nową instancję przy użyciu tego prototypu. GothicBar bez zmian można znaleźć jako instancję GothicBar@, którą użyliśmy do stworzenia paska w powyższym przykładzie. GothicBar znajduje się na środku ekranu i wygląda tak samo, jak pasek wyświetlany podczas nurkowania.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

// Instancja stworzona z pomocą prototypu GothicBar 
instance Bar_1(GothicBar)
{
    x = 100;
    y = 20;
};

func void Example_1()
{
    // Example_1 może być wywołany np. w Init_Global
    FF_ApplyOnce(Loop_1);
};

func void Loop_1()
{
    // Example_1 uruchamia tę pętlę.
    // Tutaj pasek powinien być stworzony raz
    // a potem sparowany z punktami doświadczenia:
    var int MyBar;
    if(!Hlp_IsValidHandle(MyBar))
    {
        MyBar = Bar_Create(Bar_1); // Our Bar_1
    };
    // Reszta jest chyba oczywista:
    Bar_SetMax(MyBar, hero.exp_next);
    Bar_SetValue(MyBar, hero.exp);
};