素材
Footage
footage("myFile")
要将项目面板中的素材项用作表达式中的对象，请使用全局素材方法，例如 footage("myFile")。
你也可以使用图层的 source 属性访问素材对象，前提是该图层的源是素材项（即 thisLayer.source）。
在本页中，我们将使用 footage("myFile") 作为调用这些项的示例，但请注意，任何返回 素材对象 的方法都可以使用。
属性
Footage.duration
footage("myFile").duration
描述
返回素材项的持续时间，单位为秒。
类型
数字
Footage.frameDuration
footage("myFile").frameDuration
描述
返回素材项中一帧的持续时间，单位为秒。
类型
数字
Footage.height
footage("myFile").height
描述
返回素材项的高度，单位为像素。
类型
数字
Footage.name
footage("myFile").name
描述
返回素材项的名称，如项目面板中所示。
类型
字符串
Footage.ntscDropFrame
footage("myFile").ntscDropFrame
::: note 该方法添加于 After Effects CS5.5 :::
描述
如果时间码是丢帧格式，则返回 true。
类型
布尔值
Footage.pixelAspect
footage("myFile").pixelAspect
描述
返回素材项的像素宽高比。
类型
数字
Footage.sourceData
footage("myFile").sourceData
描述
返回 JSON 文件的数据作为 sourceData 对象的数组。
JSON 文件的结构将决定数组的大小和复杂性。
可以通过数据的层次结构属性引用各个数据流。
类型
sourceData 对象的数组；只读。
示例
给定一个名为 “Color” 的数据流，以下代码将返回第一个数据对象中 “Color” 的值：
footage("sample.json").sourceData[0].Color通常的用法是将 JSON 文件的 sourceData 分配给一个变量，然后引用所需的数据流。例如：
const myData = footage("sample.json").sourceData;myData[0].Color;Footage.sourceText
footage("myFile").sourceText
描述
以字符串形式返回 JSON 文件的内容。
可以使用 eval() 方法将字符串转换为 sourceData 对象的数组，与 Footage.sourceData 属性的结果相同，从中可以通过数据的层次结构属性引用各个数据流。
类型
字符串，JSON 文件的内容；只读。
示例
const myData = eval(footage("sample.json").sourceText);myData.sampleValue;Footage.width
footage("myFile").width
描述
返回素材项的宽度，单位为像素。
类型
数字
函数
Footage.dataKeyCount()
footage("myFile").dataKeyCount(dataPath)
描述
返回 MGJSON 文件中指定动态数据流的样本数量。
接受一个数组值来定义层次结构中所需动态数据流的路径。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
dataPath | 数组 | 必需。层次结构中静态或动态数据流的路径。 |
返回
动态数据流中的样本数量。
示例
返回第一个子项的样本数量：
footage("sample.mgjson").dataKeyCount([0])返回第二个组的样本数量：
footage("sample.mgjson").dataKeyCount([1][0])Footage.dataKeyTimes()
footage("myFile").dataKeyTimes(dataPath[, t0=startTime][, t1=endTime])
描述
返回 MGJSON 文件中指定动态数据流样本的时间，单位为秒。
可选地指定要返回样本的时间范围。默认情况下，返回动态数据流中 startTime 和 endTime 之间的所有样本的时间，如 MGJSON 文件中数据流的 samplesTemporalExtent 属性所定义。
接受一个数组值来定义层次结构中所需动态数据流的路径。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
dataPath | 数组 | 必需。层次结构中静态或动态数据流的路径。 |
t0 | 数字 | 可选。要返回样本的时间范围的开始时间，单位为秒。默认为 startTime。 |
t1 | 数字 | 可选。要返回样本的时间范围的结束时间，单位为秒。默认为 endTime。 |
返回
表示样本时间的数字数组。
示例
返回第一个子项在 1 秒到 3 秒之间的样本时间：
footage("sample.mgjson").dataKeyTimes([0], 1, 3)Footage.dataKeyValues()
footage("myFile").dataKeyValues(dataPath[, t0=startTime][, t1=endTime])
描述
返回 MGJSON 文件中指定动态数据流样本的值。
可选地指定要返回样本的时间范围。默认情况下，返回动态数据流中 startTime 和 endTime 之间的所有样本的值，如 MGJSON 文件中数据流的 samplesTemporalExtent 属性所定义。
接受一个数组值来定义层次结构中所需动态数据流的路径。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
dataPath | 数组 | 必需。层次结构中静态或动态数据流的路径。 |
t0 | 数字 | 可选。要返回样本的时间范围的开始时间，单位为秒。默认为 startTime。 |
t1 | 数字 | 可选。要返回样本的时间范围的结束时间，单位为秒。默认为 endTime。 |
返回
表示样本值的数字数组。
示例
返回第一个子项在 1 秒到 3 秒之间的样本值：
footage("sample.mgjson").dataKeyValues([0], 1, 3)Footage.dataValue()
footage("myFile").dataValue(dataPath)
描述
返回 MGJSON 文件中指定静态或动态数据流的值。
接受一个数组值来定义层次结构中所需数据流的路径。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
dataPath | 数组 | 必需。层次结构中静态或动态数据流的路径。 |
返回
数据流的值。
示例
返回第一个子项的数据：
footage("sample.mgjson").dataValue([0])返回第二个组中第一个子项的数据：
footage("sample.mgjson").dataValue([1][0])