Ae 表达式语言引用：Marker Key

Marker Key（标记键属性和方法）组可以用于操作和获取标记相关的信息，诸如标记时间、注释、章节、URL 等。这些信息通常用于文本图层动态显示、动画驱动或交互式内容的生成。

marker 是一个对象。

//示例 1：第一个标记的时间marker.key(1).time


//示例 2：综合
  m = thisLayer.marker.nearestKey(time);  
  s = "time:" + timeToCurrentFormat(m.time) + "\r" +  
      "duration: " + m.duration + "\r" +  
      "key index: " + m.index + "\r" +  
      "comment:" + m.comment + "\r" +  
      "chapter:" + m.chapter + "\r" +  
      "URL:" + m.url + "\r" +  
      "frame target: " + m.frameTarget + "\r" +  
      "cue point name: " + m.cuePointName + "\r" +  
      "Event cue point? " + m.eventCuePoint + "\r";  
  for (param in m.parameters){  
       s += "parameter: " + param + " value: " + m.parameters[param] + "\r";  
  } 
  s

nearestKey(time)

返回与指定时间最接近的标记键。

参数：

time : 时间值，表示要查找标记的时间。

返回值：Object，返回一个 MarkerKey 对象，表示最接近指定时间的标记。

应用：

// 示例：获取最接近当前时间的图层标记，并显示它的时间和注释内容。
m = thisLayer.marker.nearestKey(time);
s = "time: " + timeToCurrentFormat(m.time) + "\r" +  
    "comment: " + m.comment + "\r";
s

comment

获取“标记”对话框中的注释内容字段。

返回值：String，标记的注释。

应用：

// 示例：获取并返回与当前时间最接近的标记的评论内容
m = thisLayer.marker.nearestKey(time);
m.comment

chapter

获取“标记”对话框中的章节内容字段。

返回值：String，标记的章节名称。

应用：

// 示例：返回与当前时间最接近的标记的章节名
m = thisLayer.marker.nearestKey(time);
m.chapter

url

获取“标记”对话框中的 URL 内容字段。

返回值：String，标记的 URL 地址。

应用：

// 示例：返回与当前时间最接近的标记的章节名
m = thisLayer.marker.nearestKey(time);
m.url

frameTarget

获取“标记”对话框中的帧目标内容字段。

返回值：String，标记的帧目标。

应用：

// 示例：获取并返回最接近当前时间的标记中的帧目标内容
m = thisLayer.marker.nearestKey(time);
m.frameTarget

protectedRegion

获取“合成标记”对话框中的受保护区域内容字段。

返回值：Boolean，如果为 True 时，表示该标记作为受保护的区域存在。

应用：

// 示例：返回第一个标记是否作为受保护的区域存在
m = thisComp.marker.key(1);
m.protectedRegion

eventCuePoint

判断标记是否为事件提示点。

返回值：Boolean，如果为 true，则表示该标记为事件类型的提示点；如果为 false，则表示为导航类型的提示点。

应用：

// 示例：最接近当前时间的标记是否为事件 Cue 点
m = thisLayer.marker.nearestKey(time);
m.eventCuePoint

cuePointName

获取“标记”对话框中的提示点名称内容字段。

返回值：String，标记的提示点名称。

应用：

// 示例：获取并返回最接近当前时间的标记的 Cue Point 名称
m = thisLayer.marker.nearestKey(time);
m.cuePointName

parameters

获取一个包含标记参数名称及其对应值的关联数组。

返回值：Object，包含标记的所有参数名称及其对应值。

应用：

//示例 1：如果有名为“背景颜色”的参数，则可以使用以下表达式在最近的标记中访问其值。
thisComp.marker.nearestKey(time).parameters["背景颜色"]


//示例 2：遍历并显示与当前标记相关的所有参数及其值
m = thisLayer.marker.nearestKey(time);
s = "";
for (param in m.parameters) {
  s += "parameter: " + param + " value: " + m.parameters[param] + "\r";
}
s

duration

获取标记的持续时间。

返回值：Number，标记的持续时间值，以秒为单位。

应用：

// 示例：获取当前时间点最接近的标记的持续时间值
m = thisLayer.marker.nearestKey(time); 
m.duration

time

获取标记的时间值。

返回值：Number，标记的时间，以秒为单位，表示标记在时间轴上的位置。

应用：

// 示例：获取当前时间点最接近的标记的时间值
m = thisLayer.marker.nearestKey(time);
m.time

index

获取标记的顺序索引值。

返回值：Number，标记的索引值。

应用：

// 示例：返回最接近当前时间的标记的索引值
m = thisLayer.marker.nearestKey(time);
m.index

“点赞有美意，赞赏是鼓励”