NumberSequence

Overview

여러 숫자 키포인트(NumberSequenceKeypoint)를 조합하여 값이 시간에 따라 자연스럽게 변화하는 시퀀스를 정의합니다.

각 키포인트는 특정 시점에서의 숫자 값을 지정하며, 이 값들이 순차적으로 연결되어 부드러운 수치 변화 효과를 생성합니다. 이러한 구조는 파티클 크기, 투명도, 강도 등 시간에 따른 수치 변화를 표현해야 하는 다양한 요소에서 공통적으로 활용됩니다.

Constructors

new

전달된 숫자 값을 사용하여 NumberSequence를 생성합니다. 시퀀스의 시작 지점과 종료 지점 모두에 동일한 값이 적용되며, 전체 구간에서 변화 없이 일정한 수치를 유지합니다.

Parameters

number InValue	NumberSequence의 모든 지점에 적용될 단일 숫자 값입니다. 이 값은 시작부터 끝까지 동일하게 유지됩니다.

Return

NumberSequence	전달된 숫자 값이 설정된 새로운 NumberSequence를 반환합니다.

Code Samples

local NumSequence = NumberSequence.new(5)

new

시작 지점에 n0 값, 종료 지점에 n1 값을 배치한 NumberSequence를 생성합니다. 시퀀스는 시작에서 끝까지 값이 자연스럽게 보간되어 변화합니다.

Parameters

number n0	시퀀스의 시작 지점에 적용될 값입니다. 시간 값 0에 해당하는 위치의 숫자를 정의합니다.
number n1	시퀀스의 종료 지점에 적용될 값입니다. 시간 값 1에 해당하는 위치의 숫자를 정의합니다.

Return

NumberSequence	전달된 숫자 값이 설정된 새로운 NumberSequence를 반환합니다.

Code Samples

local NumSequence = NumberSequence.new(1, 10)

new

NumberSequenceKeypoint로 구성된 배열을 받아 NumberSequence를 생성합니다.

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

Parameters

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

Return

NumberSequence	전달된 숫자 값이 설정된 새로운 NumberSequence를 반환합니다.

Code Samples

local Time1 = 0
local Time2 = 1

local KeyPoints = 
{
    NumberSequenceKeyPoint.new(Time1, 0), 
    NumberSequenceKeyPoint.new(Time2, 10) 
}
local NumSequence = NumberSequence.new(KeyPoints)

Properties

KeyPoints

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

Code Samples

local NumSequence = NumberSequence.new(1, 10)
local KeyPoints = NumSequence.KeyPoints

for _, keypoint in ipairs(KeyPoints) do
    print(keypoint.Time, keypoint.Value)
end

Methods