Path Property 路徑屬性

#版本說明

筆者使用的是Adobe After Effects 2022，隨著版本變化更新，以下內容或多或少會有不同，可以使用跟筆者相同的版本，減少問題的發生。

---

name

類型：

說明：路徑名稱名稱

参数：

返回：字符串

示範：

thisComp.layer("Solid 1").mask("Mask 1").name 
//返回Mask 1

---

points(t = time)

類型：

說明：獲取路徑上所有頂點的 x、y 坐標。

参数：t （可選）數字。路徑的時間（以秒為單位）。默認值為time（當前時間）。

返回：嵌套數組，四捨五入到小數點後四位。

示範：

thisComp.layer("Solid 1").mask("Mask 1").maskPath.points(t = time) 
//返回[[200,100],[100,200],[200,300],[300,200]]

---

inTangents(t = time)

類型：

說明：獲取路徑上所有入點手柄的二維坐標。坐標值是相對於父點。 [0,0] 代表在入點處不產生彎曲。

参数：t （可選）數字。採樣路徑的合成時間（以秒為單位）。默認值為時間（當前時間）。

返回：嵌套數組，四捨五入到小數點後四位。

示範：

thisComp.layer("純色 1").mask("蒙版 1").maskPath.inTangents()
//返回[[-200,0],[200,-100]]

---

outTangents(t = time)

類型：

說明：獲取路徑上所有出點手柄的二維坐標。坐標值是相對於父點。 [0,0] 代表在入點處不產生彎曲。

参数：t （可選）數字。採樣路徑的合成時間（以秒為單位）。默認值為時間（當前時間）。

返回：嵌套數組，四捨五入到小數點後四位。

示範：

thisComp.layer("純色 1").mask("蒙版 1").maskPath.outTangents()
//返回[[-200,0],[200,-100]]

---

isClosed()

類型：

說明：路徑是開放的還是閉合的。如果路徑是閉合的，則返回 true；如果路徑是開放的，則返回 false。

参数：無

返回：布爾值

示範：

thisComp.layer("Solid 1").mask("Mask 1").maskPath.isClosed() 
//閉合，返回true

---

pointOnPath(percentage = 0.5, t = time)

類型：

說明：獲取路徑上任意點的 x、y 坐標。該點表示為路徑弧線長度的百分比。第一個點為 0%，最後一個點為 100%。

如果路徑是閉合的，那麼 0% 和 100% 將返回相同的坐標。

参数：

• 百分比 （可選）0 到 1 之間的數字。默認值為 0.5。
• t （可選）數字。採樣路徑的合成時間（以秒為單位）。默認值為時間（當前時間）。

返回：數組。

注意：蒙版與形狀，返回的點依據不一樣。詳見Path.points()的其他說明

示範：

thisComp.layer("Turquoise Solid 1").mask("Mask 1").maskPath.pointOnPath(0.5) 
//第50%個點，也就是第三個點。返回[200,300]

---

normalOnPath(percentage = 0.5, t = time)

類型：

說明：

獲取路徑上任意點的出點手柄的標準化矢量 x、y 坐標。

標準化矢量：x² +y² = 1

参数：

返回：數組。

示範：

thisComp.layer("Solid 1").mask("Mask 1").maskPath.tangentOnPath(0.5) 
//返回[1,0]

---

tangentOnPath(percentage = 0.5, t = time)

類型：

說明：

獲取路徑上經過計算的任意點的法線的標準化矢量 x、y 坐標。

標準化矢量：x² +y² = 1

参数：

• 百分比 （可選）0 到 1 之間的數字。採樣沿路徑的弧長的百分比。值小於 0 和大於 1 的部分會被剪掉。默認值為 0.5。
• t （可選）數字。採樣路徑的合成時間（以秒為單位）。默認值為時間（當前時間）。

返回：數偶數組。

示範：

thisComp.layer("Solid 1").mask("Mask 1").maskPath.tangentOnPath(0.5) 
//返回[0,1]

---

createPath(points = [[0,0], [100,0], [100,100], [0,100]], inTangents = [], outTangents = [], is_closed = true)

類型：

說明：根據坐標點和切線點創建路徑對象。

参数：

• points：路徑點的 [x,y] 坐標的複合數組,如 [ [x1,y1] , [x2,y2] ]。必需，除非不傳遞任何參數，例如，createPath()。
• is_closed （可選）布爾值。決定蒙版是否為閉合。如果為 true，最後一個點會連接到第一個點。默認為 true。
• inTangents，複合數組，表示路徑入點手柄的 [x，y] 位移坐標。必需，
• outTangents，複合數組，表示路徑出點手柄的 [x，y] 位移坐標。必需，

返回：路徑對象

示範：

示例1：以下表達式將通過不傳遞 inTangents 或 outTangents 參數，刪除"蒙版 1"的曲線：

myMask = mask("Mask 1").path;
myMask.createPath(myMask.points());

示例2：下面的示例通過傳遞"蒙版 1"的 points 和 tangents，並通過將 is_closed 設置為 false 來將其轉換為開放路徑：

myMask = mask("Mask 1").path;
myMask.createPath(myMask.points(), myMask.inTangents(), myMask.outTangents(), false);