Context 模組

簡介

以下方法僅適用於 JavaScript Utility、JavaScript Shape、JavaScript Deformer、JavaScript Emitter 和 JavaScript Modifier。此模組中的所有內容都在 ctx 命名空間中，因此方法需要加上 ctx. 前綴，例如 var index = ctx.index;

成員函式

index → int

目前點索引。在使用 Duplicator（或其他產生索引的圖層，如 Connect Shape 或 Trails）時可用。

count → int

點的總數。在使用 Duplicator（或其他產生索引的圖層，如 Connect Shape 或 Trails）時可用。

positionX → number

目前點的 X 位置。在使用 Duplicator（或其他產生索引的圖層，如 Connect Shape 或 Trails）時可用。

positionY → number

目前點的 Y 位置。在使用 Duplicator（或其他產生索引的圖層，如 Connect Shape 或 Trails）時可用。

attributeId → string

正在計算的屬性的 ID。

layerId → string

正在計算的圖層的 ID。

saveObject(name:string, objectLiteralToSave:object)

儲存物件以供後續使用。此功能的典型用例是建立求解器——例如，需要知道先前值的指令碼。

要儲存的值必須是物件。

如果要儲存路徑以供後續使用，請在儲存/載入時使用 path.toObject()/ path.fromObject(obj) 方法。

// Simple examplectx.saveObject("test", {"someKey": 10});// A path example// Create a pathvar path = new cavalry.Path();path.moveTo(0.,0.);path.lineTo(0.,-100.);path.lineTo(300.,-100.);// Save itctx.saveObject("path", path.toObject());// Safety check that there is a saved valueif (ctx.hasObject("path")) {    // Load the object    let previous = ctx.loadObject("path");    // set the path from the object    path.fromObject(previous);}

loadObject(name:string) → object

載入已儲存的物件。

ctx.saveObject("test", {"someKey": 10});var textObj = ctx.loadObject("test");console.log(textObj["someKey"])

hasObject(name:string) → bool

如果已儲存名為 name 的物件且可載入，則回傳 true。

ctx.saveObject("test", {"someKey": 10});if (ctx.hasObject("test")) {    /// do something}

niceName() → string

取得請求 JavaScript Utility 提供值的圖層的顯示名稱。

console.log(ctx.niceName);

transformationMatrix() → matrix

回傳上游本地 2D 變換矩陣，如果沒有則回傳 null。

/*1. Create a Shape.2. On the Shape's Deformers attribute, click the + button and choose JavaScript Deformer.3. Copy the below in the JavaScript Deformer's Expression.*/var tm = ctx.transformationMatrix();console.log(tm.position().x);

globalTransformationMatrix() → matrix

回傳上游全域 2D 變換矩陣，如果沒有則回傳 null。

/*1. Create a Shape.2. On the Shape's Deformers attribute, click the + button and choose JavaScript Deformer.3. Copy the below into the JavaScript Deformer's Expression.4. Group the Shape.*/var tm = ctx.globalTransformationMatrix();console.log(tm.position().x);