Math - Adobe ActionScript® 3 (AS3 ) — dokumentacja interfejsu API

Pakiet	Najwyższy poziom
Klasa	public final class Math
Dziedziczenie	Math Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Klasa Math obejmuje metody i stałe odpowiadające typowym funkcjom matematycznym oraz ich wartościom.

Za pomocą metod i właściwości tej klasy można uzyskać dostęp sterować stałymi i funkcjami matematycznymi. Wszystkie właściwości i metody klasy Math są statyczne i należy je wywoływać za pomocą składni Math.method( parameter ) lub Math.constant. W narzędziu ActionScript stałe są zdefiniowane z podwójną precyzją liczb zmiennoprzecinkowych IEEE-754.

Klika metod klasy Math wykorzystują jako parametry jednostkę pomiaru kąta — radiany. Za pomocą poniższego równania można obliczyć wartości w radianach zanim metoda zostanie wywołana, a następnie udostępnić obliczoną wartość jako parametr, albo przekazać w parametrze radian całą prawą stronę równania (z wartością kąta w stopniach w miejsce zmiennej degrees).

Aby obliczyć wartość w radianach, należy użyć następującej formuły:

 radians = degrees * Math.PI/180

Aby z wartości w radianach uzyskać wartość w stopniach, należy użyć następującej formuły:

 degrees = radians * 180/Math.PI

Poniżej przedstawiono przykład udostępnienia równania jako parametru, w celu obliczenia sinusa kąta o wartości 45°:

Równanie Math.sin(45 * Math.PI/180) jest równoznaczne równaniu Math.sin(.7854)

Uwaga: Dla funkcji matematycznych: acos, asin, atan, atan2, cos, exp, log, pow, sin oraz sqrt, wyświetlane wartości mogą być różne w zależności od algorytmu użytego przez procesor lub system operacyjny. Podczas wykonywania obliczeń dla umieszczonych na liście funkcji środowisko wykonawcze Flash wykorzystuje procesor główny (lub system operacyjny, jeśli procesor nie obsługuje obliczeń wykonywanych na liczbach zmiennoprzecinkowych). Wyniki obliczeń mogą się nieznacznie różnić w zależności od procesora czy systemu operacyjnego.

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		abs(val:Number):Number [statyczny] Oblicza i zwraca wartość bezwzględną dla liczby określonej przez parametr val.	Math
		acos(val:Number):Number [statyczny] Oblicza i zwraca wartość arcus cosinus dla liczby określonej przez parametr (w radianach).	Math
		asin(val:Number):Number [statyczny] Oblicza i zwraca wartość arcus sinus dla liczby określonej przez parametr val (w radianach).	Math
		atan(val:Number):Number [statyczny] Oblicza i zwraca wartość kąta, którego tanges jest określony przez parametr val (w radianach).	Math
		atan2(y:Number, x:Number):Number [statyczny] Oblicza i zwraca wartość kąta odpowiadającego danemu punktowi x/y (w radianach) — mierzony względem osi x przeciwnie do ruchu wskazówek zegara (gdzie punkt o współrzędnych 0,0 określa środek okręgu).	Math
		ceil(val:Number):Number [statyczny] Zwraca górne zaokrąglenie podanej liczby lub wartości podanego wyrażenia.	Math
		cos(angleRadians:Number):Number [statyczny] Oblicza i zwraca cosinus danego kąta (w radianach).	Math
		exp(val:Number):Number [statyczny] Zwraca wartość podstawy logarytmu naturalnego (e) podniesioną do danej potęgi (określonej przez parametr x).	Math
		floor(val:Number):Number [statyczny] Zwraca podłogę podanej liczby lub wartości podanego wyrażenia.	Math
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		log(val:Number):Number [statyczny] Zwraca logarytm naturalny wartości parametru val.	Math
		max(val1:Number, val2:Number, ... rest):Number [statyczny] Porównuje wartości przynajmniej dwóch parametrów val1 i val2 i zwraca największą z nich.	Math
		min(val1:Number, val2:Number, ... rest):Number [statyczny] Porównuje wartości przynajmniej dwóch parametrów val1 i val2 i zwraca najmniejszą z nich.	Math
		pow(base:Number, pow:Number):Number [statyczny] Oblicza i zwraca wartość base podniesioną do potęgi pow.	Math
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		random():Number [statyczny] Zwraca pseudolosową liczbę n, gdzie 0 <= n < 1.	Math
		round(val:Number):Number [statyczny] Zaokrągla w górę lub w dół wartość parametru val do najbliższej liczby całkowitej i zwraca jej wartości.	Math
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		sin(angleRadians:Number):Number [statyczny] Oblicza i zwraca sinus danego kąta (w radianach).	Math
		sqrt(val:Number):Number [statyczny] Oblicza i zwraca wartość pierwiastka kwadratowego danej liczby.	Math
		tan(angleRadians:Number):Number [statyczny] Oblicza i zwraca tanges danego kąta.	Math
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Stałe publiczne

	Stała		Zdefiniowane przez
		E : Number = 2.71828182845905 [statyczny] Stała matematyczna będąca podstawą logarytmu naturalnego, oznaczana jako e.	Math
		LN10 : Number = 2.302585092994046 [statyczny] Stała matematyczna równa logarytmowi naturalnemu z dziesięciu, czyli w przybliżeniu 2.302585092994046.	Math
		LN2 : Number = 0.6931471805599453 [statyczny] Stała matematyczna równa logarytmowi naturalnemu liczby 2, czyli w przybliżeniu 0,6931471805599453.	Math
		LOG10E : Number = 0.4342944819032518 [statyczny] Stała matematyczna, zapisywana jako log10e, równa logarytmowi dziesiętnemu z liczby e (Math.E), czyli w przybliżeniu 0,4342944819032518.	Math
		LOG2E : Number = 1.442695040888963387 [statyczny] Stała matematyczna, zapisywana jako log2e, równa logarytmowi o podstawie 2 liczby e (Math.E), czyli w przybliżeniu 1,42695040888963387.	Math
		PI : Number = 3.141592653589793 [statyczny] Stała matematyczna, zapisywana jako pi, reprezentująca stosunek obwodu koła do jego średnicy i mająca wartość 3,141592653589793.	Math
		SQRT1_2 : Number = 0.7071067811865476 [statyczny] Stała matematyczna równa pierwiastkowi kwadratowemu z jednej drugiej, czyli w przybliżeniu 0,7071067811865476.	Math
		SQRT2 : Number = 1.4142135623730951 [statyczny] Stała matematyczna równa pierwiastkowi kwadratowemu z 2, czyli w przybliżeniu 1,4142135623730951.	Math

Szczegół metody

abs

()

metoda

public static function abs(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca wartość bezwzględną dla liczby określonej przez parametr val.

Parametry

val:Number — Liczba, której wartość bezwzględna została zwrócona.

Zwraca

Number — Wartość bezwzględna określonego parametru.

acos

()

metoda

public static function acos(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca wartość arcus cosinus dla liczby określonej przez parametr val (w radianach).

Parametry

val:Number — Liczba z zakresu od –1,0 do 1,0.

Zwraca

Number — Wartość arcus cosinus parametru val.

asin

()

metoda

public static function asin(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca wartość arcus sinus dla liczby określonej przez parametr val (w radianach).

Parametry

val:Number — Liczba z zakresu od –1,0 do 1,0.

Zwraca

Number — Liczba z zakresu wartości od ujemnego pi podzielonego przez liczbę 2 do dodatniego pi podzielonego przez liczbę 2.

atan

()

metoda

public static function atan(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca wartość kąta, którego tanges jest określony przez parametr val (w radianach). Zwrócona wartość należy do zakresu wartości od ujemnego pi podzielonego przez liczbę 2 do dodatniego pi podzielonego przez liczbę 2.

Parametry

val:Number — Liczba reprezentująca tangens kąta.

Zwraca

Number — Liczba z zakresu wartości od ujemnego pi podzielonego przez 2 do dodatniego pi podzielonego przez 2.

atan2

()

metoda

public static function atan2(y:Number, x:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca kąt odpowiadający danemu punktowi y/x (w radianach) — mierzony względem osi x przeciwnie do ruchu wskazówek zegara(gdzie punkt o współrzędnych 0,0 określa środek okręgu). Zwrócona wartość należy do zakresu wartości od dodatniego do ujemnego pi. Należy pamiętać, że pierwszy parametr dla funkcji atan2 należy do współrzędnej y.

Parametry

	`y:Number` — Współrzędna y punktu.

	`x:Number` — Współrzędna x punktu.

Zwraca

Number — Liczba.

Powiązane elementy interfejsu API

Math.acos()
Math.asin()
Math.atan()
Math.cos()
Math.sin()
Math.tan()

ceil

()

metoda

public static function ceil(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca górne zaokrąglenie podanej liczby lub wartości podanego wyrażenia. Najbliższa zaokrąglona w górę liczba całkowita, która jest większa lub równa danej liczbie.

Parametry

val:Number — Liczba lub wyrażenie.

Zwraca

Number — Liczba całkowita, która jest jednocześnie najbliższa i większa lub równa parametrowi val.

Powiązane elementy interfejsu API

Math.floor()
Math.round()

cos

()

metoda

public static function cos(angleRadians:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca cosinus danego kąta (w radianach). Obliczenia w radianach zostały omówione w opisie ogólnym klasy Math.

Parametry

angleRadians:Number — Liczba określająca kąt (w radianach).

Zwraca

Number — Liczba z zakresu od -1,0 do 1,0.

Powiązane elementy interfejsu API

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.sin()
Math.tan()

exp

()

metoda

public static function exp(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca podstawę logarytmu naturalnego (e) podniesioną do danej potęgi(określonej za pomocą parametru x). Stała Math.E udostępnia wartość logarytmu e.

Parametry

val:Number — Eksponent; liczba lub wyrażenie.

Zwraca

Number — Logarytm e podniesiony do potęgi określonej przez parametr val.

Powiązane elementy interfejsu API

Math.E

floor

()

metoda

public static function floor(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca dolne zaokrąglenie podanej liczby lub wartości podanego wyrażenia określonego przez parametr val. Najbliższa zaokrąglona w dół liczba całkowita, która jest mniejsza lub równa danej liczbie lub wartości wyrażenia.

Parametry

val:Number — Liczba lub wyrażenie.

Zwraca

Number — Liczba całkowita, która jest jednocześnie najbliższa i mniejsza lub równa parametrowi val.

log

()

metoda

public static function log(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca logarytm naturalny wartości parametru val.

Parametry

val:Number — Liczba lub wyrażenie o wartości większej od 0.

Zwraca

Number — Logarytm naturalny wartości parametru val.

max

()

metoda

public static function max(val1:Number, val2:Number, ... rest):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Porównuje wartości przynajmniej dwóch parametrów val1 i val2 i zwraca największą z nich.

Parametry

	`val1:Number` — Liczba lub wyrażenie.

	`val2:Number` — Liczba lub wyrażenie.

	`... rest` — Liczba lub wyrażenie. Metoda `Math.max()` może przyjmować wiele argumentów.

Zwraca

Number — Największa z wartości przynajmniej dwóch parametrów val1 i val2.

Powiązane elementy interfejsu API

Math.min()

min

()

metoda

public static function min(val1:Number, val2:Number, ... rest):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Porównuje wartości przynajmniej dwóch parametrów val1 i val2 i zwraca najmniejszą z nich.

Parametry

	`val1:Number` — Liczba lub wyrażenie.

	`val2:Number` — Liczba lub wyrażenie.

	`... rest` — Liczba lub wyrażenie. Metoda `Math.min()` może przyjmować wiele argumentów.

Zwraca

Number — Najmniejsza z wartości przynajmniej dwóch parametrów val1 i val2.

Powiązane elementy interfejsu API

Math.max()

pow

()

metoda

public static function pow(base:Number, pow:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca wartość base podniesioną do potęgi pow.

Parametry

	`base:Number` — Liczba podniesiona do potęgi wartości parametru `pow`.

	`pow:Number` — Liczba określająca potęgę, do której podnoszona jest wartość parametru `base`.

Zwraca

Number — Wartość base podniesiona do potęgi pow.

random

()

metoda

public static function random():Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca pseudolosową liczbę n, gdzie 0 <= n < 1. Zwrócona liczba jest obliczana w sposób niejawny i „pseudolosowy”, ponieważ obliczenie zawiera pewien element nielosowości.

Zwraca

Number — Pseudolosowa liczba.

Powiązane elementy interfejsu API

flash.crypto.generateRandomBytes()

round

()

metoda

public static function round(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zaokrągla w górę lub w dół wartość parametru val do najbliższej liczby całkowitej i zwraca jej wartości. Jeśli wartość parametru val może zostać zaokrąglona zarówno w górę jak i w dół (czyli liczba zawiera ułamek dziesiętny równy 0,5), zostaje ona zaokrąglona w górę do wartości liczby całkowitej.

Parametry

val:Number — Liczba, która zostanie zaokrąglona.

Zwraca

Number — Wartość parametru val zaokrąglona do najbliższej liczby całkowitej.

Powiązane elementy interfejsu API

Math.ceil()
Math.floor()

sin

()

metoda

public static function sin(angleRadians:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca sinus danego kąta (w radianach). Obliczenia w radianach zostały omówione w opisie ogólnym klasy Math.

Parametry

angleRadians:Number — Liczba określająca kąt (w radianach).

Zwraca

Number — Liczba; sinus danego kąta mierzony w radianach (liczba z zakresu -1,0 i 1,0).

Powiązane elementy interfejsu API

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.cos()
Math.tan()

sqrt

()

metoda

public static function sqrt(val:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca wartość pierwiastka kwadratowego z danej liczby.

Parametry

val:Number — Liczba lub wartość wyrażenia większa lub równa 0.

Zwraca

Number — Jeśli wartość parametru val jest większa lub równa zero, wskazaną wartością będzie liczba; w przeciwnym razie wartością będzie NaN (nie liczba).

tan

()

metoda

public static function tan(angleRadians:Number):Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Oblicza i zwraca tangens danego kąta. Obliczenia w radianach zostały omówione w opisie ogólnym klasy Math.

Parametry

angleRadians:Number — Liczba określająca kąt (w radianach).

Zwraca

Number — Tanges parametru angleRadians.

Powiązane elementy interfejsu API

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.cos()
Math.sin()

Szczegół stałej

E

Stała

public static const E:Number = 2.71828182845905

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna będąca podstawą logarytmu naturalnego, oznaczona jako e. Przybliżona wartość logarytmu e to 2,71828182845905.

LN10

Stała

public static const LN10:Number = 2.302585092994046

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna, zapisywana jako log_e10, równa logarytmowi naturalnemu z dziesięciu, czyli w przybliżeniu 2,302585092994046.

LN2

Stała

public static const LN2:Number = 0.6931471805599453

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna, zapisywana jako log_e2, równa logarytmowi naturalnemu z dwu czyli w przybliżeniu 0,6931471805599453.

LOG10E

Stała

public static const LOG10E:Number = 0.4342944819032518

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna, zapisywana jako log₁₀e, równa logarytmowi dziesiętnemu z liczby e (Math.E), czyli w przybliżeniu 0,4342944819032518.

Metoda Math.log() oblicza logarytm naturalny z liczby. Aby otrzymać logarytm dziesiętny, należy pomnożyć wynik uzyskany za pomocą metody Math.log() przez wartość Math.LOG10E.

LOG2E

Stała

public static const LOG2E:Number = 1.442695040888963387

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna, zapisywana jako log2e, równa logarytmowi o podstawie 2 z liczby e, czyli w przybliżeniu 1,442695040888963387.

Metoda Math.log oblicza logarytm naturalny z liczby. Aby otrzymać logarytm o podstawie 2, należy pomnożyć wynik uzyskany za pomocą metody Math.log() przez wartość Math.LOG2E.

PI

Stała

public static const PI:Number = 3.141592653589793

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna, zapisywana jako pi, reprezentująca stosunek obwodu koła do jego średnicy i równa 3,141592653589793.

SQRT1_2

Stała

public static const SQRT1_2:Number = 0.7071067811865476

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna równa pierwiastkowi kwadratowemu z jednej drugiej, czyli w przybliżeniu 0,7071067811865476.

SQRT2

Stała

public static const SQRT2:Number = 1.4142135623730951

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Stała matematyczna równa pierwiastkowi kwadratowemu z 2, czyli w przybliżeniu 1,4142135623730951.

Informacje prawne | Zasady prywatności online

Math - AS3

Pakietyx

Elementy językowe

Dodatki

Klasy x

abs

acos

asin

atan

atan2

ceil

cos

exp

floor

log

max

min

pow

random

round

sin

sqrt

tan

E

LN10

LN2

LOG10E

LOG2E

PI

SQRT1_2

SQRT2