ColorSequence

Overview

여러 색상 키포인트(ColorSequenceKeypoint)를 조합하여 색상이 자연스럽게 이어지는 그라데이션을 정의합니다.

각 키포인트는 특정 시점에서의 색상을 지정하며, 이 값들이 순차적으로 연결되어 부드러운 색상 전환 효과를 생성합니다. 이러한 구조는 파티클 효과, 트레일, 빔 등 시각적인 색상 변화를 강조하는 다양한 요소에서 공통적으로 활용됩니다.

Constructors

new

전달된 단일 색상을 전체 구간에 적용한 ColorSequence를 생성합니다. 결과적으로 시작과 종료 위치에 동일한 색상 값을 가진 두 개의 ColorSequenceKeypoint가 포함되며, 전 구간에서 색상 변화가 없는 일정한 색상을 유지합니다.

Parameters

Color3 color	ColorSequence의 모든 지점에 적용될 단일 색상 값입니다. 이 색상은 시작부터 끝까지 동일하게 유지됩니다.

Return

ColorSequence	전달된 색상이 설정된 새로운 ColorSequence입니다.

Code Samples

local Color = Color3.fromRGB(255, 0, 0)
local MyColorSequence = ColorSequence.new(Color)

new

ColorSequenceKeypoint로 구성된 배열을 받아 ColorSequence를 생성합니다.

각 키포인트는 시간 값이 증가하는 방향으로 정렬되어 있어야 하며, 순서가 뒤섞여 있어서는 안 됩니다. 시퀀스를 구성하려면 최소 두 개의 키포인트가 필요하고, 시작을 나타내는 키포인트는 반드시 0, 종료를 나타내는 키포인트는 반드시 1의 시간 값을 가져야 합니다.

Parameters

array colorSequenceKeyPoints	ColorSequenceKeypoint로 구성된 배열입니다. 각 키포인트는 ColorSequence 내에서의 위치(시간 값)와 해당 지점의 색상을 정의합니다. 키포인트들은 시간 값이 증가하는 순서로 정렬되어 있어야 하며, 최소 두 개 이상이 필요합니다. 또한 첫 번째 키포인트의 시간 값은 0, 마지막 키포인트의 시간 값은 1이어야 합니다.

Return

ColorSequence	전달된 색상이 설정된 새로운 ColorSequence입니다.

Code Samples

local Time1 = 0
local Time2 = 1

local ColorKeyPoints = 
{ 
    ColorSequenceKeypoint.new(Time1, Color3.fromRGB(255, 0, 0)), 
    ColorSequenceKeypoint.new(Time2, Color3.fromRGB(0, 255, 0))
}
local MyColorSequence = ColorSequence.new(ColorKeyPoints)

new

시작 지점에 c0 색상을, 종료 지점에 c1 색상을 배치한 ColorSequence를 생성합니다. 두 색상 사이에는 자연스러운 보간이 적용되어, 시작에서 끝으로 부드럽게 색상이 전환됩니다.

Parameters

Color3 c0	시퀀스의 시작 지점에 적용될 색상으로, 시간 값 0에 해당하는 위치의 색상을 정의합니다.
Color3 c1	시퀀스의 종료 지점에 적용될 색상으로, 시간 값 1에 해당하는 위치의 색상을 정의합니다.

Return

ColorSequence	전달된 색상이 설정된 새로운 ColorSequence입니다.

Code Samples

local StartColor = Color3.fromRGB(255, 0, 0)
local EndColor = Color3.fromRGB(0, 0, 255)
local ColorSequence = ColorSequence.new(StartColor, EndColor)

Properties

KeyPoints

array

ColorSequenceKeypoint로 구성된 배열을 반환합니다.

Code Samples

local Time1 = 0
local Time2 = 1

local ColorKeyPoints = 
{ 
    ColorSequenceKeypoint.new(Time1, Color3.fromRGB(255, 0, 0)), 
    ColorSequenceKeypoint.new(Time2, Color3.fromRGB(0, 255, 0))
}
local MyColorSequence = ColorSequence.new(ColorKeyPoints)

print(MyColorSequence.KeyPoints)

Methods