Path Property 路徑屬性

AE_內建表達式

#版本說明

筆者使用的是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);
Tags: