Color3

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Le type de données Color3 décrit une couleur utilisant des composants rouges, verts et bleus dans la plage de 0 à 1.Contrairement au type de données BrickColor qui décrit les couleurs nommées, Color3 est utilisé pour la coloration précise d'objets sur l'écran à travers des propriétés comme BasePart.Color et GuiObject.BackgroundColor3 .

Résumé

Constructeurs

Propriétés

  • La valeur rouge de la couleur.

  • La valeur verte de la couleur.

  • La valeur bleue de la couleur.

Méthodes

Constructeurs

new

Renvoie un Color3 avec les valeurs rouges, vertes et bleues données. Les paramètres devraient être dans la plage de 0 à 1.


local red = Color3.new(1, 0, 0)
local green = Color3.new(0, 1, 0)
local blue = Color3.new(0, 0, 1)

Paramètres

red: number
Valeur par défaut : 0
green: number
Valeur par défaut : 0
blue: number
Valeur par défaut : 0

fromRGB

Crée un Color3 avec les composants rouges, verts et bleus donnés.Contrairement à la plupart des autres fonctions Color3 5, les paramètres de cette fonction devraient se situer dans la plage de 0 à 255.


local red = Color3.fromRGB(255, 0, 0)
local green = Color3.fromRGB(0, 255, 0)
local blue = Color3.fromRGB(0, 0, 255)

Paramètres

red: number
Valeur par défaut : 0
green: number
Valeur par défaut : 0
blue: number
Valeur par défaut : 0

fromHSV

Crée un Color3 avec la teinte, la saturation et la valeur données. Les paramètres devraient être dans la plage de 0 à 1.


local red = Color3.fromHSV(1, 1, 1)
local green = Color3.fromHSV(0.3333333, 1, 1)
local white = Color3.fromHSV(0, 0, 1)

Paramètres

hue: number
saturation: number
value: number

fromHex

Renvoie un nouveau Color3 à partir d'un format hexadécimal à six ou trois caractères, insensible à la casse.Un hashtag précédent ( # ) est ignoré, s'il est présent.Cette fonction interprète la chaîne donnée comme une couleur web hex typique dans le format RRGGBB ou RGB (abréviation de RRGGBB ).Par exemple, #FFAA00 produit une couleur orange et est identique à #FA0 .


local red = Color3.fromHex("FF0000")
local magenta = Color3.fromHex("ec008c")
local black = Color3.fromHex("000")
local white = Color3.fromHex("#FFF")

Paramètres

hex: string

Propriétés

La valeur rouge de la couleur.

La valeur verte de la couleur.

La valeur bleue de la couleur.

Méthodes

Lerp

Retourne un Color3 interpolé entre deux couleurs. La valeur alpha devrait être dans la plage de 0 à 1.


local white = Color3.new(1, 1, 1)
local black = Color3.new(0, 0, 0)
local gray10 = white:Lerp(black, 0.1)
print(gray10) --> 0.9, 0.9, 0.9
local gray50 = white:Lerp(black, 0.5)
print(gray50) --> 0.5, 0.5, 0.5
local gray85 = white:Lerp(black, 0.85)
print(gray85) --> 0.15, 0.15, 0.15

Paramètres

color: Color3
alpha: number

Retours

ToHSV

Retourne la teinte, la saturation et la valeur d'un Color3 . Cette fonction est l'opération inversée du constructeur Color3.fromHSV().


local red = Color3.fromRGB(255, 0, 0)
local green = Color3.fromRGB(0, 255, 0)
local redH, redS, redV = red:ToHSV()
print(redH, redS, redV) --> 1 1 1
local greenH, greenS, greenV = green:ToHSV()
print(greenH, greenS, greenV) --> 0.3333333 1 1

ToHex

Convertit la couleur en une chaîne hexadécimale à six caractères représentant la couleur dans le format RRGGBB.Il n'est pas préfixé avec un octothorpe ( # ).

La chaîne renvoyée peut être fournie à Color3.fromHex() pour produire la couleur originale.


local red = Color3.fromRGB(255, 0, 0)
local magenta = Color3.fromRGB(236, 0, 140)
local redHex = red:ToHex()
print(redHex) --> ff0000
local magentaHex = magenta:ToHex()
print(magentaHex) --> ec008c

Retours