Ae 表达式语言引用:Text

B站影视 2025-02-01 08:01 2

摘要: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).font

createStyle

创建一个新的文本样式对象。

参数:无

返回值 :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.isAllCaps

setAllCaps(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.strokeWidth

setStrokeWidth(value)

设置文本的描边宽度。

参数:

value :Number,描边宽度的值,以像素为单位。

返回值 :Object,返回修改后的样式对象。

应用:

//示例:设置描边宽度为 2 pxtext.sourceText.style.setStrokeWidth(2);

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

来源:天磊教育

相关推荐