Nœuds mathématiquesMath Nodes

Dans le concepteur de nuanceur, les nœuds mathématiques effectuent des opérations mathématiques, notamment algébriques, logiques et trigonométriques.In the Shader Designer, math nodes perform algebraic, logic, trigonometric, and other mathematical operations.

Note

Lorsque vous utilisez des nœuds mathématiques dans le concepteur de nuanceur, la promotion de type est particulièrement évidente.When you work with math nodes in the Shader Designer, type promotion is especially evident. Pour découvrir comment la promotion de type affecte les paramètres d’entrée, consultez la section « Promotion of inputs (Promotion d’entrées) » de l’article Shader Designer Nodes (Nœuds du concepteur de nuanceur).To learn how type promotion affects input parameters, see the "Promotion of inputs" section in Shader Designer Nodes.

Informations de référence des nœuds mathématiquesMath node reference

NœudNode DétailsDetails PropriétésProperties
AbsAbs Calcule la valeur absolue de l’entrée spécifiée par composant.Computes the absolute value of the specified input per component.

Pour chaque composant d’entrée X, les valeurs négatives sont rendues positives afin que chaque composant du résultat ait une valeur positive.For each component of input X, negative values are made positive so that every component of the result has a positive value.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles déterminer la valeur absolue.The values for which to determine the absolute value.

Output:

Output : identique à l’entrée XOutput: same as input X
Valeur absolue par composant.The absolute value, per component.
Aucun.None
AjouterAdd Calcule la somme des entrées spécifiées par composant.Computes the component-wise sum of the specified inputs per component.

Pour chaque composant du résultat, les composants correspondants des entrées X et Y sont additionnés.For each component of the result, the corresponding components of input X and input Y are added together.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Une des valeurs à additionner.One of the values to add together.

Y : identique à l’entrée XY: same as input X
Une des valeurs à additionner.One of the values to add together.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Somme par composant.The sum, per component.
Aucun.None
PlafondCeil Calcule le plafond de l’entrée spécifiée par composant.Computes the ceiling of the specified input per component.

Le plafond d’une valeur est le plus petit entier supérieur ou égal à cette valeur.The ceiling of a value is the smallest integer that's greater than or equal to that value.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles calculer le plafond.The values for which to compute the ceiling.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Plafond par composant.The ceiling, per component.
Aucun.None
ClampClamp Fixe chaque composant de l’entrée spécifiée à une plage prédéfinie.Clamps each component of the specified input to a predefined range.

Pour chaque composant du résultat, les valeurs inférieures à la plage définie prennent la valeur minimale de la plage, les valeurs supérieures à la plage définie prennent la valeur maximale de la plage et les valeurs déjà comprises dans la plage demeurent inchangées.For each component of the result, values that are below the defined range are made equal to the minimum value in the range, values that are above the defined range are made equal to the maximum value in the range, and values that are in the range are not changed.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs à fixer.The values to clamp.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Valeur fixée par composant.The clamped value, per component.
MaxMax
Plus grande valeur possible de la plage.The largest possible value in the range.

MinMin
Plus petite valeur possible de la plage.The smallest possible value in the range.
CosCos Calcule le cosinus de l’entrée spécifiée, en radians, par composant.Computes the cosine of the specified input, in radians, per component.

Pour chaque composant du résultat, le cosinus du composant correspondant, qui est fourni en radians, est calculé.For each component of the result, the cosine of the corresponding component, which is provided in radians, is calculated. Le résultat compte des composants dont les valeurs sont comprises dans la plage [-1, 1].The result has components that have values in the range of [-1, 1].

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles calculer le cosinus, en radians.The values to compute the cosine of, in radians.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Cosinus par composant.The cosine, per component.
Aucun.None
CroixCross Calcule le produit vectoriel des vecteurs spécifiés à trois composants.Computes the cross product of the specified three-component vectors.

Vous pouvez utiliser le produit croisé pour calculer la normale d’une surface définie par deux vecteurs.You can use the cross product to compute the normal of a surface that's defined by two vectors.

Entrée :Input:

X: float3X: float3
Vecteur sur le côté gauche du produit vectoriel.The vector on the left-hand-side of the cross product.

Y: float3Y: float3
Vecteur sur le côté droit du produit vectoriel.The vector on the right-hand-side of the cross product.

Sortie :Output:

Output: float3Output: float3
Produit croisé.The cross product.
Aucun.None
DistanceDistance Calcule la distance entre les points spécifiés.Computes the distance between the specified points.

Le résultat est une valeur scalaire positive.The result is a positive scalar value.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Un des points dont il convient de déterminer la distance les séparant.One of the points to determine the distance between.

Y : identique à l’entrée XY: same as input X
Un des points dont il convient de déterminer la distance les séparant.One of the points to determine the distance between.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Distance.The distance.
Aucun.None
DiviserDivide Calcule le quotient des entrées spécifiées.Computes the component-wise quotient of the specified inputs.

Pour chaque composant du résultat, le composant correspondant de l’entrée X est divisé par le composant correspondant de l’entrée Y.For each component of the result, the corresponding component of input X is divided by the corresponding component of input Y.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs de dividende.The dividend values.

Y : identique à l’entrée XY: same as input X
Valeurs de diviseur.The divisor values.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Quotient par composant.The quotient, per component.
Aucun.None
PointDot Calcule le produit scalaire des vecteurs spécifiés.Computes the dot product of the specified vectors.

Le résultat est une valeur scalaire.The result is a scalar value. Le produit scalaire permet de déterminer l’angle entre deux vecteurs.You can use the dot product to determine the angle between two vectors.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Un des termes.One of the terms.

Y : identique à l’entrée XY: same as input X
Un des termes.One of the terms.

Sortie :Output:

Output: floatOutput: float
Produit scalaire.The dot product.
Aucun.None
PlancherFloor Calcule la valeur plancher de l’entrée spécifiée par composant.Computes the floor of the specified input per component.

Pour chaque composant du résultat, la valeur correspond à la plus grande valeur entière inférieure ou égale au composant correspondant de l’entrée.For each component of the result, its value is the largest whole integer value that's less than or equal to the corresponding component of the input. Chaque composant du résultat est un entier.Every component of the result is a whole integer.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles calculer le plancher.The values for which to compute the floor.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Valeur plancher par composant.The floor, per component.
Aucun.None
FmodFmod Calcule le modulo (reste) des entrées spécifiées.Computes the component-wise modulus (remainder) of the specified inputs.

Pour chaque composant du résultat, un multiple (nombre entier) entier, m, du composant correspondant de l’entrée Y est soustrait du composant correspondant de l’entrée X, laissant un reste.For each component of the result, some integral (whole-number) multiple, m, of the corresponding component of input Y is subtracted from the corresponding component of input X, leaving a remainder. Le multiple, m, est choisi de telle façon que le reste soit inférieur au composant correspondant de l’entrée Y et qu’il ait le même signe que le composant correspondant de l’entrée X.The multiple, m, is chosen such that the remainder is less than the corresponding component of input Y and has the same sign as the corresponding component of input X. Par exemple, fmod(-3.14, 1.5) correspond à -0,14.For example, fmod(-3.14, 1.5) is -0.14.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs de dividende.The dividend values.

Y : identique à l’entrée XY: same as input X
Valeurs de diviseur.The divisor values.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Modulo par composant.The modulus, per component.
Aucun.None
FracFrac Supprime la partie entière (nombre entier) de l’entrée spécifiée par composant.Removes the integral (whole-number) part of the specified input per component.

Pour chaque composant du résultat, la partie entière du composant correspondant de l’entrée est supprimée, mais la partie fractionnaire et le signe sont conservés.For each component of the result, the integral part of the corresponding component of the input is removed, but the fractional part and sign are retained. Cette valeur fractionnaire est comprise dans la plage [0, 1).This fractional value falls in the range [0, 1). Par exemple, la valeur -3,14 devient la valeur -0,14.For example, the value -3.14 becomes the value -0.14.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles calculer la partie fractionnaire.The values for which to compute the fractional part.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Partie fractionnaire par composant.The fractional part, per component.
Aucun.None
LerpLerp Interpolation linéaire.Linear Interpolation. Calcule la moyenne pondérée des entrées spécifiées.Computes the component-wise weighted average of the specified inputs.

Pour chaque composant du résultat, moyenne pondérée des composants correspondants des entrées X et Y.For each component of the result, the weighted average of the corresponding components of the inputs X and Y. La pondération fournie par Percent, un scalaire, est appliquée uniformément à tous les composants.The weight is provided by Percent, a scalar, and is uniformly applied to all components. Vous pouvez l’utiliser pour procéder à l’interpolation entre les points, les couleurs, les attributs et les autres valeurs.You can use this to interpolate between points, colors, attributes, and other values.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeur d’origine.The originating value. Lorsque Percent correspond à zéro, le résultat est égal à cette entrée.When Percent is zero, the result is equal to this input.

Y : identique à l’entrée XY: same as input X
Valeur terminale.The terminal value. Lorsque Percent correspond à un, le résultat est égal à cette entrée.When Percent is one, the result is equal to this input.

Percent: floatPercent: float
Pondération scalaire exprimée en pourcentage de la distance de l’entrée X vers l’entrée Y.A scalar weight that's expressed as a percentage of the distance from input X towards input Y.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Valeur colinéaire avec les entrées spécifiées.A value that's collinear with the specified inputs.
Aucun.None
Multiplier AjouterMultiply Add Calcule la multiplication/addition des entrées spécifiées.Computes the component-wise multiply-add of the specified inputs.

Pour chaque composant du résultat, le produit des composants correspondants des entrées M et A est ajouté au composant correspondant de l’entrée B.For each component of the result, the product of the corresponding components of the inputs M and A is added to the corresponding component of input B. Cette série d’opérations est observable dans des formules courantes, par exemple dans la formule de calcul de la pente d’une droite à partir d’un point (point-slope) et dans la formule de mise à l’échelle et de compensation d’une entrée.This operation sequence is found in common formulas—for example, in the point-slope formula of a line, and in the formula to scale and then bias an input.

Entrée :Input:

M : float, float2, float3 ou float4M: float, float2, float3, or float4
Une des valeurs à multiplier.One of the values to multiply together.

A : identique à l’entrée MA: same as input M
Une des valeurs à multiplier.One of the values to multiply together.

B : identique à l’entrée MB: same as input M
Valeurs à ajouter au produit des deux autres entrées.The values to add to the product of the other two inputs.

Sortie :Output:

Output : identique à l’entrée MOutput: same as input M
Résultat de la multiplication/addition par composant.The result of the multiply-add, per component.
Aucun.None
MaxMax Calcule le maximum des entrées spécifiées.Computes the component-wise maximum of the specified inputs.

Pour chaque composant du résultat, c’est le plus grand des composants correspondants des entrées qui est pris.For each component of the result, the greater of the corresponding components of the inputs is taken.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Une des valeurs pour lesquelles calculer le maximum.One of the values for which to compute the maximum.

Y : identique à l’entrée XY: same as input X
Une des valeurs pour lesquelles calculer le maximum.One of the values for which to compute the maximum.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Valeur maximale par composant.The maximum value, per component.
Aucun.None
MinMin Calcule le minimum des entrées spécifiées.Computes the component-wise minimum of the specified inputs.

Pour chaque composant du résultat, c’est le plus petit des composants correspondants des entrées qui est pris.For each component of the result, the lesser of the corresponding components of the inputs is taken.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Une des valeurs pour lesquelles calculer le minimum.One of the values for which to compute the minimum.

Y : identique à l’entrée XY: same as input X
Une des valeurs pour lesquelles calculer le minimum.One of the values for which to compute the minimum.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Valeur minimale par composant.The minimum value, per component.
Aucun.None
MultiplierMultiply Calcule le produit des entrées spécifiées.Computes the component-wise product of the specified inputs.

Pour chaque composant du résultat, les composants correspondants des entrées X et Y sont multipliés.For each component of the result, the corresponding components of the inputs X and Y are multiplied together.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Une des valeurs à multiplier.One of the values to multiply together.

Y : identique à l’entrée XY: same as input X
Une des valeurs à multiplier.One of the values to multiply together.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Produit par composant.The product, per component.
Aucun.None
NormaliserNormalize Normalise le vecteur spécifié.Normalizes the specified vector.

Un vecteur normalisé conserve la direction du vecteur d’origine, mais pas son amplitude.A normalized vector retains the direction of the original vector, but not its magnitude. Vous pouvez utiliser des vecteurs normalisés pour simplifier les calculs pour lesquels l’amplitude d’un vecteur n’est pas importante.You can use normalized vectors to simplify calculations where the magnitude of a vector is not important.

Entrée :Input:

X : float2, float3 ou float4X: float2, float3, or float4
Vecteur à normaliser.The vector to normalize.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Vecteur normalisé.The normalized vector.
Aucun.None
Un moinsOne Minus Calcule la différence entre 1 et l’entrée spécifiée par composant.Computes the difference between 1 and the specified input per component.

Pour chaque composant du résultat, le composant correspondant de l’entrée est soustrait de 1.For each component of the result, the corresponding component of the input is subtracted from 1.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs à soustraire de 1.The values to be subtracted from 1.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Différence entre 1 et l’entrée spécifiée, par composant.The difference between 1 and the specified input, per component.
Aucun.None
PuissancePower Calcule l’élévation à une puissance des entrées spécifiées.Computes the component-wise exponentiation (power) of the specified inputs.

Pour chaque composant du résultat, le composant correspondant de l’entrée X est élevé à la puissance du composant correspondant de l’entrée Y.For each component of the result, the corresponding component of input X is raised to the power of the corresponding component of the input Y.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs de baseThe base values

Y : identique à l’entrée XY: same as input X
Valeurs d’exposant.The exponent values.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Élévation à une puissance, par composant.The exponentiation, per component.
Aucun.None
SaturerSaturate Fixe chaque composant de l’entrée spécifiée à la plage [0, 1].Clamps each component of the specified input to the range [0, 1].

Vous pouvez utiliser cette plage pour représenter des pourcentages et d’autres mesures relatives dans les calculs.You can use this range to represent percentages and other relative measurements in calculations. Pour chaque composant du résultat, les valeurs du composant correspondant de l’entrée qui sont inférieures à 0 prennent la valeur 0, les valeurs supérieures à 1 prennent la valeur 1, et les valeurs comprises dans la plage demeurent inchangées.For each component of the result, the corresponding component values of the input that are less than 0 are made equal to 0, values that are larger than 1 are made equal to 1, and values that are in the range are not changed.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs à saturer.The values to saturate.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Valeur saturée par composant.The saturated value, per component.
Aucun.None
SinSin Calcule le sinus de l’entrée spécifiée, en radians, par composant.Computes the sine of the specified input, in radians, per component.

Pour chaque composant du résultat, le sinus du composant correspondant, qui est fourni en radians, est calculé.For each component of the result, the sine of the corresponding component, which is provided in radians, is calculated. Le résultat compte des composants dont les valeurs sont comprises dans la plage [-1, 1].The result has components that have values in the range [-1, 1].

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles calculer le sinus, en radians.The values to compute the sine of, in radians.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Sinus par composant.The sine, per component.
Aucun.None
RacSqrt Calcule la racine carrée de l’entrée spécifiée par composant.Computes the square root of the specified input, per component.

Pour chaque composant du résultat, la racine carrée du composant correspondant est calculée.For each component of the result, the square root of the corresponding component is calculated.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs pour lesquelles calculer la racine carrée.The values for which to compute the square root.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Racine carrée par composant.The square root, per component.
Aucun.None
SoustraireSubtract Calcule la différence des entrées spécifiées.Computes the component-wise difference of the specified inputs.

Pour chaque composant du résultat, le composant correspondant de l’entrée Y est soustrait du composant correspondant de l’entrée X.For each component of the result, the corresponding component of input Y is subtracted from the corresponding component of input X. Vous pouvez l’utiliser pour calculer le vecteur qui s’étend de la première entrée à la seconde.You can use this to compute the vector that extends from the first input to the second.

Entrée :Input:

X : float, float2, float3 ou float4X: float, float2, float3, or float4
Valeurs à partir desquelles il convient d’effectuer une soustraction.The values to be subtracted from.

Y : identique à l’entrée XY: same as input X
Valeurs à soustraire de l’entrée X.The values to subtract from input X.

Sortie :Output:

Output : identique à l’entrée XOutput: same as input X
Différence par composant.The difference, per component.
Aucun.None
Transformer le vecteur 3DTransform 3D Vector Transforme le vecteur 3D spécifié dans un autre espace.Transforms the specified 3-D vector into a different space.

Vous pouvez l’utiliser pour placer des points ou des vecteurs dans un espace commun afin de pouvoir les utiliser pour effectuer des calculs explicites.You can use this to bring points or vectors into a common space so that you can use them to perform meaningful calculations.

Entrée :Input:

Vector: float3Vector: float3
Vecteur à transformer.The vector to transform.

Sortie :Output:

Output: float3Output: float3
Vecteur transformé.The transformed vector.
Depuis le systèmeFrom System
Espace natif du vecteur.The native space of the vector.

Vers le systèmeTo System
Espace dans lequel transformer le vecteur.The space to transform the vector into.