Color3

显示已弃用

*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按 此处。

Color3 数据类型描述了使用红色、绿色和蓝色组件在 0 到 1 范围内的颜色。与描述命名颜色的 BrickColor 数据类型不同, Color3 用于通过属性如 BasePart.Color 和 GuiObject.BackgroundColor3 精确地颜色对象在屏幕上。

概要

构造工具

属性

方法

构造工具

new

返回带有给定红色、绿色和蓝色值的 Color3 。参数应该在 0 到 1 之间。

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

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

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

参数

red: number
默认值：0
green: number
默认值：0
blue: number
默认值：0

fromRGB

创建一个 Color3 与给定的红色、绿色和蓝色组件。与大多数其他 Color3 函数不同，此函数的参数应在 0 到 255 之间。

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

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

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

参数

red: number
默认值：0
green: number
默认值：0
blue: number
默认值：0

fromHSV

创建一个具有给定色调、饱和度和值的 Color3 。参数应该在 0 到 1 之间。

local red = Color3.fromHSV(1, 1, 1)

local green = Color3.fromHSV(0.3333333, 1, 1)

local white = Color3.fromHSV(0, 0, 1)

参数

hue: number
saturation: number
value: number

fromHex

从六位或三位十六进制格式中返回一个新的 Color3 ，不区分大小写。如果存在，以前的标签（#）将被忽略。这个函数将给定的字符串解释为典型的 web hex 颜色，格式为 RRGGBB 或 RGB (简称为 RRGGBB )。例如，#FFAA00 产生了橙色，与 #FA0 相同。

local red = Color3.fromHex("FF0000")

local magenta = Color3.fromHex("ec008c")

local black = Color3.fromHex("000")

local white = Color3.fromHex("#FFF")

参数

hex: string

属性

R

number

颜色的红值。

G

number

颜色的绿色值。

B

number

颜色的蓝值。

方法

Lerp

Color3

返回两种颜色之间插入的 Color3 值。值 alpha 应在 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

参数

color: Color3
alpha: number

返回

Color3

ToHSV

number

返回 Color3 的色调、饱和度和值。这个函数是 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

返回

number
number
number

ToHex

string

将颜色转换为六位十六进制字符串，用于在格式 RRGGBB 中表示颜色。它不以 octothorpe 前缀（#）。

返回的字符串可以提供给 Color3.fromHex() 来生成原始颜色。

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

返回

string