Math - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 )

Pacchetto	Primo livello
Classe	public final class Math
Ereditarietà	Math Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe Math contiene i metodi e le costanti che rappresentano le funzioni matematiche e i valori comuni.

Utilizzate i metodi e le proprietà di questa classe per accedere e gestire le costanti e le funzioni matematiche. Tutte le proprietà e i metodi della classe Math sono statici e devono essere chiamati utilizzando la sintassi Math.method( parametro ) o Math.constant. In ActionScript, le costanti sono definite mediante la precisione massima dei numeri a virgola mobile EEE-754 a precisione doppia.

Diversi metodi della classe Math utilizzano come parametro la misura di un angolo espressa in radianti. Potete utilizzare l'equazione seguente per calcolare i valori dei radianti prima di chiamare il metodo e successivamente fornire il valore calcolato come parametro. In alternativa, potete fornire l'intera parte destra dell'equazione (con la misura in gradi dell'angolo al posto di degrees) come parametro per i radianti.

Per calcolare il valore in radianti, utilizzate la seguente formula:

 radians = degrees * Math.PI/180

Per calcolare i gradi dai radianti, utilizzate la seguente formula:

 degrees = radians * 180/Math.PI

Di seguito è riportato un esempio di come passare l'equazione come parametro per calcolare il seno di un angolo di 45°:

Math.sin(45 * Math.PI/180) è uguale a Math.sin(.7854)

Nota: le funzioni Math acos, asin, atan, atan2, cos, exp, log, pow, sin e sqrt possono restituire valori leggermente diversi a seconda degli algoritmi utilizzati dalla CPU o dal sistema operativo. I runtime Flash chiamano la CPU (o il sistema operativo, se la CPU non supporta i calcoli a virgola mobile) quando eseguono i calcoli per le funzioni elencate, e i risultati hanno mostrato lievi variazioni a seconda della CPU o del sistema operativo utilizzato.

Altri esempi

Uso della classe Math con i metodi di disegno

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		abs(val:Number):Number [statico] Calcola e restituisce un valore assoluto per il numero specificato dal parametro val.	Math
		acos(val:Number):Number [statico] Calcola e restituisce l'arcocoseno del numero specificato dal parametro val, espresso in radianti.	Math
		asin(val:Number):Number [statico] Calcola e restituisce l'arcoseno del numero specificato dal parametro val, espresso in radianti.	Math
		atan(val:Number):Number [statico] Calcola e restituisce il valore, espresso in radianti, dell'angolo la cui tangente è specificata nel parametro val.	Math
		atan2(y:Number, x:Number):Number [statico] Calcola e restituisce l'angolo, espresso in radianti, del punto y/x, misurato in senso antiorario partendo dall'asse x di un cerchio (dove 0,0 rappresenta il centro del cerchio).	Math
		ceil(val:Number):Number [statico] Restituisce il valore ceiling (letteralmente, soffitto) del numero o dell'espressione specificata.	Math
		cos(angleRadians:Number):Number [statico] Calcola e restituisce il coseno dell'angolo specificato, espresso in radianti.	Math
		exp(val:Number):Number [statico] Restituisce il valore della base del logaritmo naturale (e), elevato alla potenza dell'esponente specificato nel parametro x.	Math
		floor(val:Number):Number [statico] Restituisce il valore floor (letteralmente, pavimento) del numero o dell'espressione specificata nel parametro val.	Math
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		log(val:Number):Number [statico] Restituisce il logaritmo naturale del parametro val.	Math
		max(val1:Number, val2:Number, ... rest):Number [statico] Valuta val1 e val2 (o più valori) e restituisce il valore più grande.	Math
		min(val1:Number, val2:Number, ... rest):Number [statico] Valuta val1 e val2 (o più valori) e restituisce il valore più piccolo.	Math
		pow(base:Number, pow:Number):Number [statico] Calcola e restituisce base elevato alla potenza di pow.	Math
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		random():Number [statico] Restituisce un numero pseudo-casuale n, dove 0 <= n < 1.	Math
		round(val:Number):Number [statico] Arrotonda il valore del parametro val al numero intero più vicino per eccesso o per difetto e restituisce il valore.	Math
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		sin(angleRadians:Number):Number [statico] Calcola e restituisce il seno dell'angolo specificato, espresso in radianti.	Math
		sqrt(val:Number):Number [statico] Calcola e restituisce la radice quadrata del numero specificato.	Math
		tan(angleRadians:Number):Number [statico] Calcola e restituisce la tangente dell'angolo specificato.	Math
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

	Costante		Definito da
		E : Number = 2.71828182845905 [statico] Una costante matematica alla base dei logaritmi naturali, espressa come e.	Math
		LN10 : Number = 2.302585092994046 [statico] Una costante matematica per il logaritmo naturale di 10, espressa come loge10, con un valore approssimativo pari a 2,302585092994046.	Math
		LN2 : Number = 0.6931471805599453 [statico] Una costante matematica per il logaritmo naturale di 2, espressa come loge2, con un valore approssimativo pari a 0,6931471805599453.	Math
		LOG10E : Number = 0.4342944819032518 [statico] Una costante matematica per il logaritmo a base 10 della costante e (Math.E), espressa come log10e, con un valore approssimativo pari a 0,4342944819032518.	Math
		LOG2E : Number = 1.442695040888963387 [statico] Una costante matematica per il logaritmo a base 2 della costante e, espressa come log2e, con un valore approssimativo pari a 1,442695040888963387.	Math
		PI : Number = 3.141592653589793 [statico] Una costante matematica per il rapporto tra la circonferenza di un cerchio e il suo diametro, espressa come pi e con un valore pari a 3,141592653589793.	Math
		SQRT1_2 : Number = 0.7071067811865476 [statico] Una costante matematica per la radice quadrata di un mezzo, con un valore approssimativo pari a 0,7071067811865476.	Math
		SQRT2 : Number = 1.4142135623730951 [statico] Una costante matematica per la radice quadrata di 2, con un valore approssimativo pari a 1,4142135623730951.	Math

Descrizione dei metodi

abs

()

metodo

public static function abs(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce un valore assoluto per il numero specificato dal parametro val.

Parametri

val:Number — Il numero di cui viene restituito il valore assoluto.

Restituisce

Number — Il valore assoluto del parametro specificato.

acos

()

metodo

public static function acos(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce il coseno dell'arco del numero specificato dal parametro val, espresso in radianti.

Parametri

val:Number — Un numero compreso tra -1 e 1.

Restituisce

Number — Il coseno dell'arco del parametro val.

asin

()

metodo

public static function asin(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce il seno dell'arco del numero specificato dal parametro val, espresso in radianti.

Parametri

val:Number — Un numero compreso tra -1 e 1.

Restituisce

Number — Un numero compreso tra pi negativo diviso 2 e pi positivo diviso 2.

atan

()

metodo

public static function atan(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce il valore, espresso in radianti, dell'angolo la cui tangente è specificata nel parametro val. Il valore restituito è compreso tra pi negativo diviso 2 e pi positivo diviso 2.

Parametri

val:Number — Un numero che rappresenta la tangente di un angolo.

Restituisce

Number — Un numero compreso tra pi negativo diviso 2 e pi positivo diviso 2.

atan2

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce l'angolo, espresso in radianti, del punto y/x, misurato in senso antiorario partendo dall'asse x di un cerchio (dove 0,0 rappresenta il centro del cerchio). Il valore restituito è compreso tra pi positivo e pi negativo. Il primo parametro per atan2 è sempre la coordinata y.

Parametri

	`y:Number` — La coordinata y del punto.

	`x:Number` — La coordinata x del punto.

Restituisce

Number — Un numero.

Elementi API correlati

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

ceil

()

metodo

public static function ceil(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il valore ceiling (letteralmente, soffitto) del numero o dell'espressione specificata. Il valore ceiling di un numero è il primo intero superiore o uguale al numero.

Parametri

val:Number — Un numero o un'espressione.

Restituisce

Number — Un numero intero che è sia più vicino che superiore o uguale al parametro val.

Elementi API correlati

Math.floor()
Math.round()

cos

()

metodo

public static function cos(angleRadians:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce il coseno dell'angolo specificato, espresso in radianti. Per calcolare un radiante, vedete la descrizione della classe Math.

Parametri

angleRadians:Number — Un numero che rappresenta un angolo misurato in radianti.

Restituisce

Number — Un numero compreso tra -1 e 1.

Elementi API correlati

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

exp

()

metodo

public static function exp(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il valore della base del logaritmo naturale (e), elevato alla potenza dell'esponente specificato nel parametro x. La costante Math.E può fornire il valore di e.

Parametri

val:Number — L'esponente; un numero o un'espressione.

Restituisce

Number — e elevato alla potenza del parametro val.

Elementi API correlati

Math.E

floor

()

metodo

public static function floor(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il valore floor (letteralmente, pavimento) del numero o dell'espressione specificata nel parametro val. Il valore floor è il primo intero inferiore o uguale al numero o all'espressione specificata.

Parametri

val:Number — Un numero o un'espressione.

Restituisce

Number — Il numero intero che è sia più vicino che inferiore o uguale al parametro val.

log

()

metodo

public static function log(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il logaritmo naturale del parametro val.

Parametri

val:Number — Un numero o un'espressione con un valore maggiore di 0.

Restituisce

Number — Il logaritmo naturale del parametro val.

max

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Valuta val1 e val2 (o più valori) e restituisce il valore più grande.

Parametri

	`val1:Number` — Un numero o un'espressione.

	`val2:Number` — Un numero o un'espressione.

	`... rest` — Un numero o un'espressione. `Math.max()` è in grado di accettare più argomenti.

Restituisce

Number — Il maggiore tra i parametri val1 e val2 (o più valori).

Elementi API correlati

Math.min()

min

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Valuta val1 e val2 (o più valori) e restituisce il valore più piccolo.

Parametri

	`val1:Number` — Un numero o un'espressione.

	`val2:Number` — Un numero o un'espressione.

	`... rest` — Un numero o un'espressione. `Math.min()` è in grado di accettare più argomenti.

Restituisce

Number — Il più piccolo tra i parametri val1 e val2 (o più valori).

Elementi API correlati

Math.max()

pow

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce base elevato alla potenza di pow.

Parametri

	`base:Number` — Un numero da elevare alla potenza del parametro `pow`.

	`pow:Number` — Un numero che specifica la potenza alla quale viene elevato il parametro `base`.

Restituisce

Number — Il valore di base elevato alla potenza di pow.

random

()

metodo

public static function random():Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce un numero pseudo-casuale n, dove 0 <= n < 1. Il numero restituito viene calcolato in modo non conosciuto e "pseudo-casuale", poiché il calcolo contiene inevitabilmente alcuni elementi di non casualità.

Restituisce

Number — Un numero pseudo-casuale.

Elementi API correlati

flash.crypto.generateRandomBytes()

round

()

metodo

public static function round(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Arrotonda il valore del parametro val al numero intero più vicino per eccesso o per difetto e restituisce il valore. Se val è equidistante dai due numeri interi più vicini (ovvero se termina con .5), il valore viene arrotondato al numero intero più alto.

Parametri

val:Number — Il numero da arrotondare.

Restituisce

Number — Il parametro val arrotondato al numero intero più vicino.

Elementi API correlati

Math.ceil()
Math.floor()

sin

()

metodo

public static function sin(angleRadians:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce il seno dell'angolo specificato, espresso in radianti. Per calcolare un radiante, vedete la descrizione della classe Math.

Parametri

angleRadians:Number — Un numero che rappresenta un angolo misurato in radianti.

Restituisce

Number — Un numero; il seno dell'angolo specificato (compreso tra -1 e 1).

Elementi API correlati

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

sqrt

()

metodo

public static function sqrt(val:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce la radice quadrata del numero specificato.

Parametri

val:Number — Un numero o un'espressione maggiore o uguale a 0.

Restituisce

Number — Se il parametro val è superiore o uguale a zero, un numero; in caso contrario NaN (Not a Number, Non un numero).

tan

()

metodo

public static function tan(angleRadians:Number):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Calcola e restituisce la tangente dell'angolo specificato. Per calcolare un radiante, vedete la descrizione della classe Math.

Parametri

angleRadians:Number — Un numero che rappresenta un angolo misurato in radianti.

Restituisce

Number — La tangente del parametro angleRadians.

Elementi API correlati

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

Descrizione delle costanti

E

Costante

public static const E:Number = 2.71828182845905

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica alla base dei logaritmi naturali, espressa come e. Il valore approssimativo di e è 2,71828182845905.

LN10

Costante

public static const LN10:Number = 2.302585092994046

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per il logaritmo naturale di 10, espressa come log_e10, con un valore approssimativo pari a 2.302585092994046.

LN2

Costante

public static const LN2:Number = 0.6931471805599453

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per il logaritmo naturale di 2, espressa come log_e2, con un valore approssimativo pari a 0,6931471805599453.

LOG10E

Costante

public static const LOG10E:Number = 0.4342944819032518

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per il logaritmo a base 10 della costante e (Math.E), espressa come log₁₀e, con un valore approssimativo pari a 0,4342944819032518.

Il metodo Math.log() calcola il logaritmo naturale di un numero. La moltiplicazione del risultato di Math.log() per Math.LOG10E consente di ottenere il logaritmo a base 10.

LOG2E

Costante

public static const LOG2E:Number = 1.442695040888963387

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per il logaritmo a base 2 della costante e, espressa come log2e, con un valore approssimativo pari a 1,442695040888963387.

Il metodo Math.log calcola il logaritmo naturale di un numero. La moltiplicazione del risultato di Math.log() per Math.LOG2E consente di ottenere il logaritmo a base 2.

PI

Costante

public static const PI:Number = 3.141592653589793

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per il rapporto tra la circonferenza di un cerchio e il suo diametro, espressa come pi e con un valore pari a 3,141592653589793.

SQRT1_2

Costante

public static const SQRT1_2:Number = 0.7071067811865476

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per la radice quadrata di un mezzo, con un valore approssimativo pari a 0,7071067811865476.

SQRT2

Costante

public static const SQRT2:Number = 1.4142135623730951

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Una costante matematica per la radice quadrata di 2, con un valore approssimativo pari a 1,4142135623730951.

Note legali | Informativa sulla privacy online

Math - AS3

Pacchettix

Elementi del linguaggio

Appendici

Classi 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