NumberSequence

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

NumberSequence 數據類型代表從 0 到 1 一系列數值。數字值使用 NumberSequenceKeypoint 輸入型表達。這種類型在屬性中，例如 ParticleEmitter.Size 和 Beam.Transparency 中，用於定義時間過程中的數值變化。

平等

兩個 NumberSequence 對象只有在其 NumberSequenceKeypoint 值相等時才相等，即使兩個都會導致相似的圖表。

評估

NumberSequence 類型沒有內建方法來在特定時間/點獲得值，因為鑰匙點可以有隨機封裝。然而，假設你的鑰匙點值都是 0 ，你可以使用以下函數在特定時間進行評估。


local function evalNumberSequence(sequence: NumberSequence, time: number)
    -- 如果時間是 0 或 1，分別返回第一或最後值
    if time == 0 then
        return sequence.Keypoints[1].Value
    elseif time == 1 then
        return sequence.Keypoints[#sequence.Keypoints].Value
    end

    -- 否則，通過每個順序的鑰匙點對進行步驟
    for i = 1, #sequence.Keypoints - 1 do
        local currKeypoint = sequence.Keypoints[i]
        local nextKeypoint = sequence.Keypoints[i + 1]
        if time >= currKeypoint.Time and time < nextKeypoint.Time then
            -- 計算Alpha離散點之間的距離
            local alpha = (time - currKeypoint.Time) / (nextKeypoint.Time - currKeypoint.Time)
            -- 使用 alpha 返回點之間的值
            return currKeypoint.Value + (nextKeypoint.Value - currKeypoint.Value) * alpha
        end
    end
end

local numberSequence = NumberSequence.new{
    NumberSequenceKeypoint.new(0, 0),
    NumberSequenceKeypoint.new(0.5, 1),
    NumberSequenceKeypoint.new(1, 0),
}

print(evalNumberSequence(numberSequence, 0.65))  --> 0.7

概要

建構子

new(n : number)
返回具有開始和結束值設置為提供的 n 的 NumberSequence 。
new(n0 : number,n1 : number)
返回兩個關鍵點的 NumberSequence 值，其中 n0 為起始值，而 n1 為終值。
new(Keypoints : Array)
從 NumberSequence 列表中返回 NumberSequenceKeypoints 。

屬性

Keypoints:Array
一個排序為上升的 NumberSequenceKeypoint 值列表。

建構子

new

返回具有開始和結束值設置為提供的 n 的 NumberSequence 。


local numberSequence = NumberSequence.new(n)
-- 等值於
local numberSequence = NumberSequence.new{
    NumberSequenceKeypoint.new(0, n),
    NumberSequenceKeypoint.new(1, n)
}

參數

n: number

new

返回兩個關鍵點的 NumberSequence 值，其中 n0 為起始值，而 n1 為終值。


local numberSequence = NumberSequence.new(n0, n1)
-- 等值於
local numberSequence = NumberSequence.new{
    NumberSequenceKeypoint.new(0, n0),
    NumberSequenceKeypoint.new(1, n1)
}

參數

n0: number

n1: number

new

從 NumberSequence 列表中返回 NumberSequenceKeypoints 。關鍵點必須提供在非下降時間值順序中。至少必須提供兩個關鍵點，且它們必須具有時間值 0 (第一) 和 1 (最後)。


local numberSequence = NumberSequence.new{
    NumberSequenceKeypoint.new(0, 0),
    NumberSequenceKeypoint.new(0.5, 0.5, 0.25),
    NumberSequenceKeypoint.new(1, 1)
}

參數

Keypoints: Array

屬性

Keypoints

Array

包含 NumberSequenceKeypoint 值的陣列，用於 NumberSequence 。