
#版本說明
筆者使用的是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);