更新日志
脚本功能的新增与变更内容。
After Effects 25
Section titled “After Effects 25”After Effects 25.2 Beta build 98 (2025年2月)
Section titled “After Effects 25.2 Beta build 98 (2025年2月)”- 新增脚本方法和属性：
- 更新：LightLayer.lightSource
After Effects 25.0 Beta build 26 (2024年8月)
Section titled “After Effects 25.0 Beta build 26 (2024年8月)”- 新增脚本方法和属性：
- 新增：CharacterRange.pasteFrom()
- 新增：FontObject.hasGlyphsFor()
- 新增：FontObject.otherFontsWithSameDict()
- 新增：FontsObject.getCTScriptForString()
- 新增：FontsObject.getDefaultFontForCTScript()
- 新增：FontsObject.setDefaultFontForCTScript()
After Effects 24
Section titled “After Effects 24”- 新增脚本方法和属性：
- 新增：FontsObject.favoriteFontFamilyList
- 新增：FontsObject.fontsDuplicateByPostScriptName
- 新增：FontsObject.freezeSyncSubstitutedFonts
- 新增：FontsObject.mruFontFamilyList
- 新增：FontsObject.substitutedFontReplacementMatchPolicy
- 新增：FontsObject.pollForAndPushNonSystemFontFoldersChanges()
- 新增：TextDocument.boxAutoFitPolicy
- 新增：TextDocument.boxFirstBaselineAlignment
- 新增：TextDocument.boxFirstBaselineAlignmentMinimum
- 新增：TextDocument.boxInsetSpacing
- 新增：TextDocument.boxOverflow
- 新增：TextDocument.boxVerticalAlignment
- 新增脚本方法和属性：
- 新增：Project.replaceFont()
- 新增：Project.usedFonts
After Effects 24.4 Beta build 25 (2024年3月)
Section titled “After Effects 24.4 Beta build 25 (2024年3月)”- 新增脚本方法和属性：
- 新增：CharacterRange 对象
- 新增：ParagraphRange 对象
- 新增：ComposedLineRange 对象
- 新增：TextDocument.characterRange()
- 新增：TextDocument.composedLineCharacterIndexesAt()
- 新增：TextDocument.composedLineCount
- 新增：TextDocument.composedLineRange()
- 新增：TextDocument.paragraphCharacterIndexesAt()
- 新增：TextDocument.paragraphCount
- 新增：TextDocument.paragraphRange()
- 变更：app.purge() - PurgeTarget.ALL_CACHES 现在包括磁盘缓存
- 新增或变更的脚本方法和属性：
- 新增：LayerCollection.addVerticalText()
- 新增：LayerCollection.addVerticalBoxText()
- 新增：TextDocument.lineOrientation
- 新增：FontsObject.fontServerRevision
- 新增：FontsObject.getFontByID()
- 新增：FontObject.fontID
- 新增脚本方法和属性：
- 新增：getEnumAsString()
- 新增：app.fonts
- 新增：Fonts 对象
- 新增：FontsObject.allFonts
- 新增：FontsObject.fontsWithDefaultDesignAxes
- 新增：FontsObject.getFontsByFamilyNameAndStyleName()
- 新增：FontsObject.getFontsByPostScriptName()
- 新增：FontsObject.missingOrSubstitutedFonts
- 新增：Font 对象
- 新增：FontObject.designAxesData
- 新增：FontObject.designVector
- 新增：FontObject.familyPrefix
- 新增：FontObject.hasDesignAxes
- 新增：FontObject.hasSameDict()
- 新增：FontObject.postScriptNameForDesignVector()
- 新增：FontObject.familyName
- 新增：FontObject.fullName
- 新增：FontObject.isFromAdobeFonts
- 新增：FontObject.isSubstitute
- 新增：FontObject.location
- 新增：FontObject.nativeFamilyName
- 新增：FontObject.nativeFullName
- 新增：FontObject.nativeStyleName
- 新增：FontObject.postScriptName
- 新增：FontObject.styleName
- 新增：FontObject.technology
- 新增：FontObject.type
- 新增：FontObject.version
- 新增：FontObject.writingScripts
- 新增：TextDocument.autoHyphenate
- 新增：TextDocument.autoKernType
- 新增：TextDocument.baselineDirection
- 新增：TextDocument.composerEngine
- 新增：TextDocument.digitSet
- 新增：TextDocument.direction
- 新增：TextDocument.endIndent
- 新增：TextDocument.everyLineComposer
- 新增：TextDocument.firstLineIndent
- 新增：TextDocument.fontBaselineOption
- 新增：TextDocument.fontCapsOption
- 新增：TextDocument.fontObject
- 新增：TextDocument.hangingRoman
- 新增：TextDocument.kerning
- 新增：TextDocument.leadingType
- 新增：TextDocument.ligature
- 新增：TextDocument.lineJoinType
- 新增：TextDocument.noBreak
- 新增：TextDocument.spaceAfter
- 新增：TextDocument.spaceBefore
- 新增：TextDocument.startIndent
- 脚本属性更新：
- 更新：TextDocument.fauxBold
- 更新：TextDocument.fauxItalic
- 更新：TextDocument.justification
After Effects 23
Section titled “After Effects 23”- 新增脚本方法和属性：
- 新增：AVLayer.setTrackMatte()
- 新增：AVLayer.removeTrackMatte()
- 新增：AVLayer.trackMatteLayer
- 脚本属性更新：
- 更新：AVLayer.trackMatteType
- 更新：AVLayer.isTrackMatte
- 更新：AVLayer.hasTrackMatte
After Effects 22
Section titled “After Effects 22”- 新增脚本方法：
- 新增：Property.keyLabel()
- 新增：Property.setLabelAtKey()
- 新增脚本方法：
- 新增：Layer.doSceneEditDetection()
- 新增脚本方法：
- 新增：Layer.id
- 新增：Project.layerByID()
- 新增：Property.essentialPropertySource
- 脚本访问渲染队列通知：
- 新增：RenderQueue.queueNotify
- 新增：RenderQueueItem.queueItemNotify
- 脚本访问多帧渲染，最大CPU百分比覆盖：
- 新增：app.setMultiFrameRenderingConfig()
After Effects 18
Section titled “After Effects 18”- 支持媒体替换的脚本方法和属性：
- 新增：AVItem.isMediaReplacementCompatible
- 新增：AVLayer.addToMotionGraphicsTemplate()
- 新增：AVLayer.addToMotionGraphicsTemplateAs()
- 新增：AVLayer.canAddToMotionGraphicsTemplate()
- 新增：Property.alternateSource
- 新增：Property.canSetAlternateSource
- 新增：Property.setAlternateSource()
- 新增相关匹配名称
- 新增Essential Properties 属性组的匹配名称。
After Effects 17
Section titled “After Effects 17”- 脚本访问形状图层描边锥度、描边波浪、偏移路径副本、偏移路径副本偏移：
- 新增相关匹配名称
- 修复允许CompItem.displayStartTime使用负值的问题：
- 新增CompItem.displayStartFrame
- 现在与在合成设置对话框中设置起始时间码时允许的有效范围一致（-3:00:00:00至23:59:00:00）。
- 脚本创建和修改下拉菜单控制项：
- 新增：Property.isDropdownEffect
- 新增：Property.setPropertyParameters()
After Effects 16
Section titled “After Effects 16”After Effects 16.1
Section titled “After Effects 16.1”- 脚本访问ViewOptions对象的参考线和标尺布尔值：
- 新增：ViewOptions.guidesLocked
- 新增：ViewOptions.guidesSnap
- 新增：ViewOptions.guidesVisibility
- 新增：ViewOptions.rulers
- 脚本访问添加、删除和设置现有参考线：
- 新增：Item.addGuide()
- 新增：Item.removeGuide()
- 新增：Item.setGuide()
- 脚本访问额外的EGP属性属性：
- 新增：CompItem.motionGraphicsTemplateControllerCount
- 新增：CompItem.getMotionGraphicsTemplateControllerName()
- 新增：CompItem.setMotionGraphicsControllerName()
- 新增：Property.addToMotionGraphicsTemplateAs()
- 脚本访问标记标签和受保护区域属性：
- 新增：MarkerValue.label
- 新增：MarkerValue.protectedRegion
- 脚本访问额外的项目色彩管理设置：
- 新增：Project.workingSpace
- 新增：Project.workingGamma
- 新增：Project.listColorProfiles()
- 新增：Project.linearizeWorkingSpace
- 新增：Project.compensateForSceneReferredProfiles
- 脚本访问表达式引擎属性：
- 新增：Project.expressionEngine
- 新增项目方法Project.setDefaultImportFolder()，用于设置在文件导入对话框中显示的默认文件夹。
- 新增应用程序属性app.disableRendering，通过与大写锁定键相同的机制禁用渲染。
After Effects 15
Section titled “After Effects 15”- Project.autoFixExpressions()现在可以修复单引号（例如(‘效果名称’)）以及双引号中的表达式名称引用。
- 修复CompItem.exportAsMotionGraphicsTemplate()未按预期返回布尔值的问题。
- 脚本访问动态图形模板：
- 新增：CompItem.motionGraphicsTemplateName
- 新增：CompItem.exportAsMotionGraphicsTemplate()
- 新增：CompItem.openInEssentialGraphics()
- 新增：Property.addToMotionGraphicsTemplate()
- 新增：Property.canAddToMotionGraphicsTemplate()
After Effects 14
Section titled “After Effects 14”After Effects 14.2.1 (CC 2017.2) (2017年6月)
Section titled “After Effects 14.2.1 (CC 2017.2) (2017年6月)”- ScriptUI面板中的按钮已恢复为After Effects 14.1及之前版本中看到的矩形外观。
- AVItem.setProxyToNone()脚本方法不再因错误消息”After Effects错误：AEGP尝试添加无效素材”而失败。
- System.callSystem()脚本方法现在会等待命令调用的所有任务完成，而不是在命令耗时过长时失败。
- 脚本访问文本行距：
- 新增：TextDocument.leading
- 脚本访问团队项目（Beta）：
- 新增：Project.newTeamProject()
- 新增：Project.openTeamProject()
- 新增：Project.shareTeamProject()
- 新增：Project.syncTeamProject()
- 新增：Project.closeTeamProject()
- 新增：Project.convertTeamProjectToProject()
- 新增：Project.listTeamProjects()
- 新增：Project.isTeamProjectOpen()
- 新增：Project.isAnyTeamProjectOpen()
- 新增：Project.isTeamProjectEnabled()
- 新增：Project.isLoggedInToTeamProject()
- 新增：Project.isSyncCommandEnabled()
- 新增：Project.isShareCommandEnabled()
- 新增：Project.isResolveCommandEnabled()
- 新增：Project.resolveConflict()
- Windows上的HiDPI显示器上，ScriptUI面板中的下拉菜单不再被裁剪。
- ScriptUI嵌入式面板中的按钮、滑块、展开三角形（“twirly arrow”）、滚动条、进度条、单选按钮和复选框的外观已更新，以匹配After Effects原生控件的外观。
- 当AVLayer.compPointToSource()脚本方法与3D文本图层一起使用时，After Effects不再崩溃。
- 快速方框模糊效果的匹配名称是”ADBE Box Blur2”。旧的匹配名称”ADBE Box Blur”将继续工作：当用于添加效果时，“ADBE Box Blur”将应用快速方框模糊效果，但使用旧名称”Box Blur”；迭代参数将设置为新的默认值3。
- 脚本访问工具：
- 新增：Project.toolType
- 脚本访问合成标记：
- 新增：CompItem.markerProperty
- 脚本访问AME中的队列：
- 新增：RenderQueue.queueInAME()
- 脚本访问可用的GPU加速选项：
- 新增：app.availableGPUAccelTypes
After Effects 13
Section titled “After Effects 13”- 通过脚本启用GPU效果渲染：
- 新增：Project.gpuAccelType
- 新增高斯模糊效果，匹配名为
ADBE Gaussian Blur 2
- 脚本访问文本基线：
- 新增：baselineLocs
- 新增生成随机数的脚本方法：
- 新增：generateRandomNumber()
- 使用 copyToComp() 脚本方法时，当图层有父级时不再导致After Effects崩溃。
- valueAtTime() 脚本方法现在会等待耗时的表达式（如
sampleImage）完成计算后再返回结果。 - ScriptUI面板现在可以在Windows的高DPI显示器上正确显示和调整大小。
- 当点击带有标签页的scriptUI对话框中的确定或取消按钮时，After Effects不再崩溃。
- 文本图层的脚本改进（只读）：
- 返回布尔值：
- 新增：fauxBold
- 新增：fauxItalic
- 新增：allCaps
- 新增：smallCaps
- 新增：superscript
- 新增：subscript
- 返回浮点数：
- 新增：verticalScale
- 新增：horizontalScale
- 新增：baselineShift
- 新增：tsume
- 返回位置坐标数组（仅段落文本图层）：
- 新增：boxTextPos
- 图层空间/合成空间转换：
- 新增：sourcePointToComp()
- 新增：compPointToSource()
- 文本图层的脚本改进（只读）：
- 返回字符串：
- 新增：fontLocation
- 新增：fontStyle
- 新增：fontFamily
- 实现”使用旧版UI”切换选项
- 脚本访问渲染设置和输出模块设置：
- 新增：RenderQueueItem对象的 getSetting、setSetting 方法
- 新增：RenderQueueItem对象的 getSettings、setSettings 方法
- 新增：OutputModule对象的 getSetting、setSetting 方法
- 新增：OutputModule对象的 getSettings、setSettings 方法
- 通过ID获取项目项：Project.itemByID()
- 实现CEP面板
After Effects 12
Section titled “After Effects 12”- 访问效果的内部版本字符串：
- 新增：应用程序效果对象的version属性，参见 app.effects
- 获取和设置预览模式的能力：
- 新增：ViewOptions.fastPreview
- 访问图层采样方法（参见 samplingQuality）
- 更改首选项和设置方法（参见 Settings对象）
- ScriptUI现在基于与主应用程序相同的控件。
After Effects 11
Section titled “After Effects 11”- 新增：访问 Viewer对象 和控件：
- 新增：app.activeViewer
- 新增：AVLayer.openInViewer() 在图层查看器中打开图层
- 新增：CompItem.openInViewer() 在合成查看器中打开合成
- 新增：FootageItem.openInViewer() 在素材查看器中打开素材项
- 新增：Property.canSetExpression
- 新增：AVLayer.environmentLayer
- 新增：MaskPropertyGroup.maskFeatherFalloff
- 通过脚本访问形状羽化属性：
- 新增：Shape.featherSegLocs
- 新增：Shape.featherRelSegLocs
- 新增：Shape.featherRadii
- 新增：Shape.featherInterps
- 新增：Shape.featherTensions
- 新增：Shape.featherTypes
- 新增：Shape.featherRelCornerAngles
After Effects 10
Section titled “After Effects 10”- 新增到 Project对象：
- Project.framesCountType
- Project.feetFramesFilmType
- Project.framesUseFeetFrames
- Project.footageTimecodeDisplayStartType
- Project.timeDisplayType
- 从 Project对象 中移除：
timecodeDisplayType属性timecodeBaseType属性timecodeNTSCDropFrame属性timecodeFilmType属性TimecodeDisplayType枚举TimecodeFilmType枚举TimecodeBaseType枚举- 新增：CompItem.dropFrame
- 新增对段落框文本的支持：
- 新增 LayerCollection.addBoxText()
- 新增 TextDocument.boxText
- 新增 TextDocument.pointText
- 新增 TextDocument.boxTextSize
- 新增 LightLayer.lightType
After Effects 9
Section titled “After Effects 9”- 新增：app.isoLanguage
- 新增：MarkerValue.duration
- 新增：OutputModule.includeSourceXMP
- 新增：Project.xmpPacket
- 新增以下与”分离维度”功能相关的Property方法和属性：
- Property.dimensionsSeparated
- Property.getSeparationFollower()
- Property.isSeparationFollower
- Property.isSeparationLeader
- Property.separationDimension
- Property.separationLeader
- 新增 TextDocument对象 访问，包括：
- 新增：TextDocument.applyFill
- 新增：TextDocument.applyStroke
- 新增：TextDocument.fillColor
- 新增：TextDocument.font
- 新增：TextDocument.fontSize
- 新增：TextDocument.justification
- 新增：TextDocument.resetCharStyle()
- 新增：TextDocument.resetParagraphStyle()
- 新增：TextDocument.strokeColor
- 新增：TextDocument.strokeOverFill
- 新增：TextDocument.strokeWidth