Funkcja clamp(value, min, max)
w GDScript oraz innych językach programowania, jest używana do ograniczania wartości liczbowej do określonego przedziału. Jej działanie polega na tym, że jeżeli wartość value
przekracza zakres wyznaczony przez wartości minimalną (min
) i maksymalną (max
), to zostanie przycięta (ang. clamped) do najbliższego z tych limitów.
Składnia:
clamp(value, min, max)
value
: liczba, którą chcesz ograniczyć.min
: minimalna dopuszczalna wartość.max
: maksymalna dopuszczalna wartość.
Jak to działa:
- Jeśli
value
jest mniejsze niżmin
, funkcja zwrócimin
. - Jeśli
value
jest większe niżmax
, funkcja zwrócimax
. - Jeśli
value
mieści się w przedzialemin
imax
, funkcja zwrócivalue
bez zmian.
Przykład użycia:
var health = 120
health = clamp(health, 0, 100) # Ogranicza zdrowie do przedziału 0-100
print(health) # Wynik: 100
W tym przykładzie wartość zmiennej health
jest przycięta do maksymalnej wartości 100, ponieważ przekracza określony zakres. Jeżeli wartość zdrowia wynosiłaby np. 90, funkcja zwróciłaby oryginalną wartość, ponieważ 90 mieści się w przedziale od 0 do 100.
Zastosowanie:
Funkcja clamp
jest często używana w grach, gdzie potrzebujesz ograniczyć zmienne takie jak:
- Punkty życia (nie mogą być niższe niż 0 ani wyższe niż maksymalna wartość).
- Prędkość (utrzymanie prędkości postaci w określonych granicach).
- Pozycja kamery (zapobieganie wyjściu kamery poza ustalony obszar).