摘要:Text (文本属性和方法)组主要用于获取和修改 After Effects 中文本图层的样式,包括字体、大小、颜色、行间距、字间距等属性。通过设置和获取不同的文本样式属性,可以动态调整文本外观,如启用仿粗体、仿斜体、描边和填充等效果,从而实现灵活的文本动画和
Text (文本属性和方法)组主要用于获取和修改 After Effects 中文本图层的样式,包括字体、大小、颜色、行间距、字间距等属性。通过设置和获取不同的文本样式属性,可以动态调整文本外观,如启用仿粗体、仿斜体、描边和填充等效果,从而实现灵活的文本动画和样式定制。
提示 1:
建议使用 JavaScript 表达式引擎。
Ae 菜单:文件/
提示 2:
由于所有的 set 方法都将返回样式对象,因此可以使用一种短格式的设置方式。
// 示例:短格式text.sourceText.style.setFillColor(hexToRgb("00FF00")).setApplyStroke(1).setStrokeWidth(5).setStrokeColor([1,0,0]).setFontSize(200);sourceText
获取或设置文本图层的源文本内容。
返回值 :返回一个 TextDocument 对象,包含文本内容及相关样式。
应用:
//示例 1:获取文本内容var textContent = text.sourceText;textContent//示例 2:设置文本内容text.sourceText = "新文本";Font...
用于选择文本图层使用的字体。
返回值 :返回 PostScript 名称(英文)字符串。比如,SimSun。
style
获取索引是 0 的字符的样式对象。
相当于 getStyleAt(0)。
返回值 :Object,字符样式对象。
应用:
//示例 1:指定为另一个文本图层的第 0 个字符的样式thisComp.layer("mediaTEA").text.sourceText.style//示例 2:为样式设置特定值(短格式)style.setFontSize(80).setFauxBold(true).setFauxItalic(true)getStyleAt(charIndex, t=time)
获取指定时间点上某个字符的样式。
参数:
charIndex :Number,字符索引值。提示:字符索引从 0 开始。
t :可选,指定时间,以秒为单位。默认为 time。
返回值 :Object,返回指定字符的样式对象。
应用:
// 示例 1:获取第一字符在第 2 秒的样式text.sourceText.getStyleAt(0, 2);// 示例 2:text.sourceText.getStyleAt(3).fontSize;text.sourceText.getStyleAt(0).fontcreateStyle
创建一个新的文本样式对象。
参数:无
返回值 :TextStyle 对象,包含文本样式的所有属性。
应用:
// 示例 1:创建样式并设置特定值(长格式)styleA = thisComp.layer("mediaTEA").text.sourceText.createStyle;styleB = styleA.setFontSize(200);styleC = styleB.setFont("Arual");styleC;//示例 2:创建样式并设置特定值(短格式)styleA = thisComp.layer("mediaTEA").text.sourceText.createStyle;styleA.setFontSize(100).setFont("Arual");setText(value)
设置文本图层的内容(字符串)。
参数:
value :String,文本内容。
返回值 :Object,返回修改后的样式对象。
应用:
//示例 1:设置本图层的文本内容style.setText("mediaTEA");//设置为别的图层的文本内容style.setText(thisComp.layer("mediaTEA").text.sourceText);fontSize
获取文本的字体大小。
返回值 :Number,字体大小值。
应用:
//示例 1:本图层的字体大小style.fontSize;//示例 2:返回别的文本图层的文本字体大小thisComp.layer("M").text.sourceText.style.fontSize;setFontSize(value)
设置文本的字体大小。
参数:
value :Number,字体大小。
startIndex :可选,Number,起始字符索引。
endIndex :可选,Number,结束字符索引。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:设置前三个字符的字体大小为 100pxtext.sourceText.style.setFontSize(100, 0, 3);font
获取文本的字体名称。
返回值 :String,PostScript 字体名称(英文字符串)。
应用:
// 示例:获取当前字体text.sourceText.style.font;setFont(value)
设置文本的字体。
参数:
value :字体名称(英文字符串 String)。如 "Arial", "Helvetica"。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:设置字体为 Arialtext.sourceText.style.setFont("Arial");isFauxBold
检查文本是否启用了“仿粗体”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:style.isFauxBold;setFauxBold(value)
设置文本的“仿粗体”。不是真正的粗体,而是通过增加笔画厚度来模拟。
参数:
value :Boolean,true 表示启用,false 表示不启用。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:为字符设置仿粗体text.sourceText.style.setFauxBold(true);isFauxItalic
检查文本是否启用了“仿斜体”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:style.isFauxItalic;setFauxItalic(value)
设置文本的“仿斜体”。
参数:
value :Boolean,true 表示启用,false 表示不启用。
startIndex :可选,Number,起始字符索引。
endIndex :可选,Number,结束字符索引。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例 1:为字符设置斜体style.setFauxItalic(true);// 示例 2:将前三个字符设置为仿斜体text.sourceText.style.setFauxItalic(true,0,3)isAllCaps
检查文本是否启用了“全部大写字母”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:style.isAllCapssetAllCaps(value)
设置英文文本的“全部大写字母”。
参数:
value :Boolean,true 表 示启用“全部大写字母”,false 表示不启用。
startIndex :可选,Number,起始字符索引。
endIndex :可选,Number,结束字符索引。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例 1:将文本转换为全大写text.sourceText.style.setAllCaps(true);// 示例 2:设置前 2 个字符为大写字母style.setAllCaps(true,0,2)isSmallCaps
检查文本是否启用了“小型大写字母”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:检查是否启用小型大写text.sourceText.style.isAllCaps;setSmallCaps(value)
设置是否启用“小型大写字母”。
参数:
value :Boolean,true 表 示启用“小型大写字母”,false 表示不启用。
startIndex :可选,Number,起始字符索引。
endIndex :可选,Number,结束字符索引。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例 1:将文本转换为小型大写text.sourceText.style.setSmallCaps(true);// 示例 2:设置前三个字符为小型大写text.sourceText.style.setSmallCaps(true,0,3)tracking
获取文本的字符间距值。
返回值 :Number,字符间距值。
应用:
// 示例:获取字间距text.sourceText.style.tracking;setTracking(value)
设置文本的字符间距值。
参数:
value :Number,字符间距值,以像素为单位 。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:设置字符间距为 10pxtext.sourceText.style.setTracking(10);leading
获取文本的行间距值。
返回值 :Number,行间距值。
应用:
// 示例:获取行间距text.sourceText.style.leading;setLeading(value)
设置文本的行间距值。
参数:
value :Number,行间距值,以像素为单位 。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:设置行间距为 20pxtext.sourceText.style.setLeading(20);autoLeading
检查是否启用“自动行距”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:获取自动行间距设置text.sourceText.style.autoLeading;setAutoLeading(value)
设置是否启用“自动”行距。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:text.sourceText.style.setAutoLeading(true);baselineShift
获取文本的基线偏移值。
返回值 :Number,表示基线偏移的像素值。
应用:
// 示例:text.sourceText.style.baselineShift;setBaselineShift(value)
设置文本的基线偏移值,可以用来调节字符相对于基线的位置。
参数:
value :Number,基线偏移的值,以像素为单位 。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:设置基线偏移为 5pxtext.sourceText.style.setBaselineShift(5);applyFill
检查文本是否启用了“填充”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:text.sourceText.style.applyFill;setApplyFill(value)
设置是否启用文本的“填充”。
参数:
value :Boolean,true 表示启用,false 表示不启用。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:启用文本的填充text.sourceText.style.setApplyFill(true)fillColor
获取文本的填充颜色值。
返回值 :Array,RGB 数组(范围从 0 到 1.0),例如 [1, 0, 0] 表示红色。
应用:
//示例 1:填充为白色时,则返回 [1,1,1]style.fillColor;//示例 2:返回绿色通道的值style.fillColor[1];//示例 3:每个值仅保留 1 位小数arr = style.fillColor;var roundedArr = arr.map(function(num) { //用于遍历数组中的每个元素return parseFloat(num.toFixed(1)); // num.toFixed(1): 将每个浮点数保留 1 位小数,并返回字符串。parseFloat: 将字符串转换回浮点数。});roundedArr;setFillColor(value)
设置文本的填充颜色。
参数:
value :RGB 数组或十六进制值,例如 [1.0, 0.0, 0.0] 表示红色,或者使用 hexToRgb 转换十六进制颜色 。
返回值 :Object,返回修改后的样式对象。
应用:
//示例:设设置填充颜色为红色style.setFillColor([1,0,0]);applyStroke
检查文本是否启用了“描边”。
返回值 :Boolean,启用,返回 true;未启用,返回 false。
应用:
// 示例:获取是否应用描边text.sourceText.style.applyStroke;setApplyStroke(value)
设置是否启用文本的“描边”。
参数:
value :Boolean,启用,返回 true;未启用,返回 false。
返回值 :Object,返回修改后的样式对象。
应用:
// 示例:启用描边text.sourceText.style.setApplyStroke(true);strokeColor
获取文本描边颜色的值。
返回值 :Array,同 fillColor 一样返回 RGB 值(范围从 0 到 1.0)。
应用:
// 示例:获取描边颜色text.sourceText.style.strokeColor;setStrokeColor(value)
设置文本的描边颜色。
参数:
value :RGB 数组或十六进制值,例如 [1.0, 0.0, 0.0] 表示红色,或者使用 hexToRgb 转换十六进制颜色 。
返回值 :Object,返回修改后的样式对象。
应用:
//示例:设置描边颜色为红色text.sourceText.style.setStrokeColor([1.0, 0.0, 0.0]);strokeWidth
获取文本的描边宽度值。
返回值 :Number,表示描边宽度的像素值。
应用:
//示例:显示描边宽度的值style.strokeWidthsetStrokeWidth(value)
设置文本的描边宽度。
参数:
value :Number,描边宽度的值,以像素为单位。
返回值 :Object,返回修改后的样式对象。
应用:
//示例:设置描边宽度为 2 pxtext.sourceText.style.setStrokeWidth(2);“点赞有美意,赞赏是鼓励”
来源:天磊教育