Color3

顯示已棄用項目

*此內容是使用 AI（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，不區分大小寫。如果存在，將忽略先前的標籤（#）。這個功能會將給定的字串解釋為網站常見的十六進位顏色格式 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