@ps-generator-bridge/generator 0.1.0

package/jsx/Layer/getLayerPixmap.jsx

@@ -0,0 +1,337 @@
+/*global params, stringIDToTypeID, charIDToTypeID,
+    ActionDescriptor, ActionList, executeAction, DialogModes */
+
+// Required params:
+//   - documentId: The ID of the document requested
+//   - layerSpec: Either the layer ID of the desired layer as a number, or an object of the form
+//         {firstLayerIndex: number, lastLayerIndex: number, hidden: Array.<number>=} specifying the
+//         desired index range, inclusive, and (optionally) an array of indices to hide.
+//         Note that the number form takes a layer ID, *not* a layer index.
+//   - boundsOnly: Whether to only request the bounds fo the pixmap
+//   Either use absolute scaling by specifying which part of the doc should be transformed into what shape:
+//   - inputRect:  { left: ..., top: ..., right: ..., bottom: ... }
+//   - outputRect: { left: ..., top: ..., right: ..., bottom: ... }
+//   Or use relative scaling by specifying horizontal and vertical factors:
+//   - scaleX:     The x-dimension scale factor (e.g. 0.5 for half size) for the output pixmap
+//   - scaleY:     The y-dimension scale factor (e.g. 0.5 for half size) for the output pixmap
+//
+// Optional params:
+//   - useSmartScaling: setting to "true" causes shapes to be scaled in the "smart" way, which (confusingly)
+//         means that stroke effects (e.g. rounded rect corners) are *not* scaled. (Default: false)
+//   - includeAncestorMasks: setting to "true" causes exported layer to be clipped by any ancestor
+//         masks that are visible (Default: false)
+//   - convertToWorkingRGBProfile: If true, performs a color conversion on the pixels
+//         before they are sent to generator. The color is converted to the working RGB profile (specified for
+//         the document in PS). By default (when this setting is false), the "raw" RGB data is sent, which is
+//         what is usually desired. (Default: false)
+//   - useICCProfile: String with the ICC color profile to use. If set this overrides
+//         the convertToWorkingRGBProfile flag. A common value is "sRGB IEC61966-2.1". (Default: "")
+//   - getICCProfileData: If true then the final ICC profile for the image is included
+//         along with the returned pixamp (added after PS 16.1)
+//   - allowDither: controls whether any dithering could possibly happen in the color conversion
+//         to 8-bit RGB. If false, then dithering will definitely not occur, regardless of either
+//         the value of useColorSettingsDither and the color settings in Photoshop. (Default: false)
+//   - useColorSettingsDither: If allowDither is true, then this controls whether to (if true) defer to
+//         the user's color settings in PS, or (if false) to force dither in any case where a
+//         conversion to 8-bit RGB would otherwise be lossy. If allowDither is false, then the
+//         value of this parameter is ignored. (Default: false)
+//   - interpolationType: Force pixmap scaling to use the given interpolation method.
+//         If defined, the value should be one of the Generator.prototype.INTERPOLATION constants. Otherwise,
+//         Photoshop's default interpolation type (as specified in Preferences > Image Interpolation) is used.
+//         (Default: undefined)
+//   - forceSmartPSDPixelScaling: If true, forces PSD Smart objects to be scaled completely in pixel space
+//         (as opposed to scaling vectors, text, etc. in a smoother fashion.) In PS 15.0 and earlier
+//         pixel space scaling was the only option. So, setting this to "true" will replicate older behavior
+//         (Default: false)
+//   - clipToDocumentBounds: If true, crops returned pixels to the document bounds.
+//         By default, all pixels for the specified layers are returned, even if they lie outside the document
+//         bounds (e.g. if the document was cropped without "Delete Cropped Pixels" checked).
+//         Note that this option *cannot* be used with an inputRect/outputRect scaling. If inputRect/outputRect
+//         is set, this setting will be ignored and the pixels will not be cropped to document bounds.
+//         (Default: false)
+//   - clipBounds: crops retuned pixels to the given bounds
+//   - usePSClipping: if present use clipBounds to clip image
+//   - compId: number, layer comp ID (optionally and exclusive of compIndex)
+//   - compIndex: number, layer comp index (optionally and exclusive of compId)
+//   - maxDimension: number, maximal dimension of pixmap in pixels
+
+var DEFAULT_MAX_DIMENSION = 10000;
+
+var actionDescriptor = new ActionDescriptor(),
+  transform = null;
+
+// Add a transform if necessary
+if (params.inputRect && params.outputRect) {
+  transform = new ActionDescriptor();
+
+  // The part of the document to use
+  var inputRect = params.inputRect,
+    psInputRect = new ActionList();
+
+  psInputRect.putUnitDouble(charIDToTypeID("#Pxl"), inputRect.left);
+  psInputRect.putUnitDouble(charIDToTypeID("#Pxl"), inputRect.top);
+
+  psInputRect.putUnitDouble(charIDToTypeID("#Pxl"), inputRect.right);
+  psInputRect.putUnitDouble(charIDToTypeID("#Pxl"), inputRect.bottom);
+
+  transform.putList(stringIDToTypeID("rectangle"), psInputRect);
+
+  // Where to move the four corners
+  var outputRect = params.outputRect,
+    psOutputCorners = new ActionList();
+
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.left);
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.top);
+
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.right);
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.top);
+
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.right);
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.bottom);
+
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.left);
+  psOutputCorners.putUnitDouble(charIDToTypeID("#Pxl"), outputRect.bottom);
+
+  transform.putList(stringIDToTypeID("quadrilateral"), psOutputCorners);
+
+  // Absolute scaling may not keep the aspect ratio intact, in which case effects
+  // cannot be scaled. To be consistent, turn it off for all of absolute scaling
+  // transform.putBoolean(stringIDToTypeID("scaleStyles"), false);
+} else if (params.scaleX && params.scaleY && (params.scaleX !== 1 || params.scaleY !== 1)) {
+  transform = new ActionDescriptor();
+
+  if (!params.useSmartScaling) {
+    transform.putBoolean(stringIDToTypeID("forceDumbScaling"), true);
+  }
+
+  transform.putDouble(charIDToTypeID("Wdth"), params.scaleX * 100);
+  transform.putDouble(charIDToTypeID("Hght"), params.scaleY * 100);
+}
+
+if (transform) {
+  // interpolation and scaling options are only relevant in cases where a transform
+  // is going to happen. So, we only bother to set them if we're actually going
+  // to add a transform descriptor
+
+  if (!params.useSmartScaling) {
+    transform.putBoolean(stringIDToTypeID("forceDumbScaling"), true);
+  }
+
+  if (params.hasOwnProperty("interpolationType")) {
+    transform.putEnumerated(
+      stringIDToTypeID("interpolation"),
+      stringIDToTypeID("interpolationType"),
+      stringIDToTypeID(params.interpolationType)
+    );
+
+    actionDescriptor.putEnumerated(
+      stringIDToTypeID("interpolation"),
+      stringIDToTypeID("interpolationType"),
+      stringIDToTypeID(params.interpolationType)
+    );
+  }
+
+  if (params.hasOwnProperty("forceSmartPSDPixelScaling")) {
+    transform.putBoolean(
+      stringIDToTypeID("forceSmartPSDPixelScaling"),
+      !!params.forceSmartPSDPixelScaling
+    );
+  }
+
+  // actually add the transform descriptor to the main descriptor
+  actionDescriptor.putObject(
+    stringIDToTypeID("transform"),
+    stringIDToTypeID("transform"),
+    transform
+  );
+}
+
+actionDescriptor.putInteger(stringIDToTypeID("documentID"), params.documentId);
+actionDescriptor.putInteger(
+  stringIDToTypeID("width"),
+  params.maxDimension || DEFAULT_MAX_DIMENSION
+);
+actionDescriptor.putInteger(
+  stringIDToTypeID("height"),
+  params.maxDimension || DEFAULT_MAX_DIMENSION
+);
+actionDescriptor.putInteger(stringIDToTypeID("format"), 2);
+
+if (typeof params.layerSpec === "object") {
+  actionDescriptor.putInteger(stringIDToTypeID("firstLayer"), params.layerSpec.firstLayerIndex);
+  actionDescriptor.putInteger(stringIDToTypeID("lastLayer"), params.layerSpec.lastLayerIndex);
+  if (params.layerSpec.hasOwnProperty("hidden") && params.layerSpec.hidden.length > 0) {
+    var i,
+      hiddenIndiciesMap = {},
+      settingsList = new ActionList(),
+      hiddenLayerDesc = new ActionDescriptor(),
+      visibleLayerDesc = new ActionDescriptor(),
+      hiddenLayerSettings = new ActionDescriptor(),
+      lsID = stringIDToTypeID("layerSettings");
+
+    hiddenLayerSettings.putBoolean(stringIDToTypeID("enabled"), false);
+    hiddenLayerDesc.putObject(lsID, lsID, hiddenLayerSettings);
+
+    // We have to add a descriptor for every layer in order, so first
+    // build a map to make it easier to do this.
+    for (i = 0; i < params.layerSpec.hidden.length; ++i) {
+      hiddenIndiciesMap[params.layerSpec.hidden[i]] = true;
+    }
+
+    // Loop over every layer, and add either a hidden or visible descriptor
+    // based on the map we built.
+    for (i = params.layerSpec.firstLayerIndex; i <= params.layerSpec.lastLayerIndex; ++i) {
+      if (hiddenIndiciesMap[i]) {
+        settingsList.putObject(lsID, hiddenLayerDesc);
+      } else {
+        settingsList.putObject(lsID, visibleLayerDesc);
+      }
+    }
+
+    actionDescriptor.putList(stringIDToTypeID("layerSettings"), settingsList);
+  }
+} else {
+  actionDescriptor.putInteger(stringIDToTypeID("layerID"), params.layerSpec);
+}
+
+if (params.hasOwnProperty("compId")) {
+  actionDescriptor.putInteger(stringIDToTypeID("compID"), params.compId);
+} else if (params.hasOwnProperty("compIndex")) {
+  actionDescriptor.putInteger(stringIDToTypeID("compIndex"), params.compIndex);
+}
+
+// includeAncestors
+if (!params.includeAncestorMasks) {
+  actionDescriptor.putEnumerated(
+    stringIDToTypeID("includeAncestors"),
+    stringIDToTypeID("includeLayers"),
+    stringIDToTypeID("includeNone")
+  );
+} else {
+  actionDescriptor.putEnumerated(
+    stringIDToTypeID("includeAncestors"),
+    stringIDToTypeID("includeLayers"),
+    stringIDToTypeID("includeVisible")
+  );
+}
+
+// includeAdjustors
+var includeAdjustors = stringIDToTypeID("includeVisible");
+if (params.includeAdjustors != undefined) {
+  includeAdjustors = params.includeAdjustors
+    ? stringIDToTypeID("includeVisible")
+    : stringIDToTypeID("includeNone");
+}
+actionDescriptor.putEnumerated(
+  stringIDToTypeID("includeAdjustors"),
+  stringIDToTypeID("includeLayers"),
+  includeAdjustors
+);
+// includeChildren
+var includeChildren = stringIDToTypeID("includeVisible");
+if (params.includeChildren != undefined) {
+  includeChildren = params.includeChildren
+    ? stringIDToTypeID("includeVisible")
+    : stringIDToTypeID("includeNone");
+}
+actionDescriptor.putEnumerated(
+  stringIDToTypeID("includeChildren"),
+  stringIDToTypeID("includeLayers"),
+  includeChildren
+);
+
+// includeClipBase
+var includeClipBase = stringIDToTypeID("includeVisible");
+if (params.includeClipBase != undefined) {
+  includeClipBase = params.includeClipBase
+    ? stringIDToTypeID("includeVisible")
+    : stringIDToTypeID("includeNone");
+}
+actionDescriptor.putEnumerated(
+  stringIDToTypeID("includeClipBase"),
+  stringIDToTypeID("includeLayers"),
+  includeClipBase
+);
+
+// includeClipped
+var includeClipped = stringIDToTypeID("includeVisible");
+if (params.includeClipped != undefined) {
+  includeClipped = params.includeClipped
+    ? stringIDToTypeID("includeVisible")
+    : stringIDToTypeID("includeNone");
+}
+actionDescriptor.putEnumerated(
+  stringIDToTypeID("includeClipped"),
+  stringIDToTypeID("includeLayers"),
+  includeClipped
+);
+
+//
+if (params.hasOwnProperty("convertToWorkingRGBProfile")) {
+  actionDescriptor.putBoolean(
+    stringIDToTypeID("convertToWorkingRGBProfile"),
+    !!params.convertToWorkingRGBProfile
+  );
+}
+
+if (params.hasOwnProperty("useICCProfile")) {
+  actionDescriptor.putString(stringIDToTypeID("useICCProfile"), String(params.useICCProfile));
+}
+
+if (params.hasOwnProperty("getICCProfileData")) {
+  actionDescriptor.putBoolean(stringIDToTypeID("sendThumbnailProfile"), !!params.getICCProfileData);
+}
+
+// NOTE: on the PS side, allowDither and useColorSettingsDither default to "true" if they are
+// not set at all. However, in Generator, the common case will be that we do NOT want to dither,
+// regardless of the settings in PS. So, on the Generator side, we default to false (hence the !! on
+// the params properties).
+actionDescriptor.putBoolean(stringIDToTypeID("allowDither"), !!params.allowDither);
+actionDescriptor.putBoolean(
+  stringIDToTypeID("useColorSettingsDither"),
+  !!params.useColorSettingsDither
+);
+
+if (params.hasOwnProperty("clipToDocumentBounds")) {
+  actionDescriptor.putBoolean(
+    stringIDToTypeID("clipToDocumentBounds"),
+    !!params.clipToDocumentBounds
+  );
+}
+
+if (params.clipBounds) {
+  // The part of the document to use
+  var clipBounds = params.clipBounds,
+    psClipRect = new ActionDescriptor();
+
+  psClipRect.putUnitDouble(stringIDToTypeID("left"), charIDToTypeID("#Pxl"), clipBounds.left);
+  psClipRect.putUnitDouble(stringIDToTypeID("top"), charIDToTypeID("#Pxl"), clipBounds.top);
+
+  psClipRect.putUnitDouble(stringIDToTypeID("right"), charIDToTypeID("#Pxl"), clipBounds.right);
+  psClipRect.putUnitDouble(stringIDToTypeID("bottom"), charIDToTypeID("#Pxl"), clipBounds.bottom);
+
+  actionDescriptor.putObject(
+    stringIDToTypeID("clipBounds"),
+    stringIDToTypeID("clipBounds"),
+    psClipRect
+  );
+}
+
+if (params.boundsOnly) {
+  actionDescriptor.putBoolean(stringIDToTypeID("boundsOnly"), params.boundsOnly);
+}
+actionDescriptor.putBoolean(stringIDToTypeID("bounds"), params.bounds);
+//needs to be set explicitly as a boolean
+if (params.thread === true || params.thread === false) {
+  actionDescriptor.putBoolean(stringIDToTypeID("thread"), params.thread);
+}
+
+var result;
+try {
+  result = executeAction(
+    stringIDToTypeID("sendLayerThumbnailToNetworkClient"),
+    actionDescriptor,
+    DialogModes.NO
+  );
+} catch (error) {}
+result;

package/jsx/Layer/getSelection.jsx

@@ -0,0 +1,6 @@
+try {
+  const bounds = app.activeDocument.selection.bounds;
+  bounds;
+} catch (e) {
+  throw new Error("请先选中一个选区");
+}

package/jsx/Layer/layer.jsx

@@ -0,0 +1,284 @@
+var id = params.layerID;
+var layerBounds = undefined;
+
+function Layer(id) {
+  this.id = id;
+}
+
+// --------- 实例方法 -----------------
+/**
+ * 获取当前实例图层的名称
+ * @return {string}
+ */
+Layer.prototype.name = function () {
+  var layerReference = new ActionReference();
+  layerReference.putProperty(charIDToTypeID("Prpr"), charIDToTypeID("Nm  "));
+  layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var descriptor = executeActionGet(layerReference);
+  return descriptor.getString(charIDToTypeID("Nm  "));
+};
+
+/**
+ * 获取当前实例图层的层级
+ * @return {number}
+ */
+Layer.prototype.index = function () {
+  var layerReference = new ActionReference();
+  layerReference.putProperty(charIDToTypeID("Prpr"), charIDToTypeID("ItmI"));
+  layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var descriptor = executeActionGet(layerReference);
+  return descriptor.getInteger(charIDToTypeID("ItmI"));
+};
+
+/**
+ * 获取当前实例图层的类型
+ * @return {number}
+ */
+Layer.prototype.kind = function () {
+  var layerReference = new ActionReference();
+  layerReference.putProperty(charIDToTypeID("Prpr"), stringIDToTypeID("layerKind"));
+  layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var descriptor = executeActionGet(layerReference);
+  return descriptor.getInteger(stringIDToTypeID("layerKind"));
+};
+
+/**
+ * 获取当前实例图层的尺寸
+ * @return {{x: number, width: number, y: number, height: number}}
+ */
+Layer.prototype.bounds = function () {
+  var layerReference = new ActionReference();
+  layerReference.putProperty(charIDToTypeID("Prpr"), stringIDToTypeID("bounds"));
+  layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var layerDescriptor = executeActionGet(layerReference);
+  var rectangle = layerDescriptor.getObjectValue(stringIDToTypeID("bounds"));
+  var left = rectangle.getUnitDoubleValue(charIDToTypeID("Left"));
+  var top = rectangle.getUnitDoubleValue(charIDToTypeID("Top "));
+  var right = rectangle.getUnitDoubleValue(charIDToTypeID("Rght"));
+  var bottom = rectangle.getUnitDoubleValue(charIDToTypeID("Btom"));
+  return { x: left, y: top, width: right - left, height: bottom - top };
+};
+
+/**
+ * 判断当前图层的显示/隐藏
+ * @return {boolean}
+ */
+Layer.prototype.visible = function () {
+  var layerReference = new ActionReference();
+  layerReference.putProperty(charIDToTypeID("Prpr"), charIDToTypeID("Vsbl"));
+  layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var descriptor = executeActionGet(layerReference);
+  if (descriptor.hasKey(charIDToTypeID("Vsbl")) == false) return false;
+  return descriptor.getBoolean(charIDToTypeID("Vsbl"));
+};
+
+/**
+ * 获取形状图层的填充颜色
+ * @return {null|*[]}
+ */
+Layer.prototype.solidFill = function () {
+  var kind = this.kind();
+  if (kind === 4) {
+    // 只有形状图层才能获取到图层填充属性
+    var layerReference = new ActionReference();
+    // 形状图层的填充和其它属性在adjuestment下面
+    layerReference.putProperty(charIDToTypeID("Prpr"), stringIDToTypeID("adjustment"));
+    layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+    var descriptor = executeActionGet(layerReference);
+    var adjustment = descriptor.getList(stringIDToTypeID("adjustment")); // adjustment是一个ActionList
+    var result = [];
+    for (var i = 0; i < adjustment.count; i++) {
+      var item = adjustment.getObjectValue(i);
+      var color = item.getObjectValue(stringIDToTypeID("color"));
+      var red = color.getInteger(stringIDToTypeID("red"));
+      var green = color.getInteger(stringIDToTypeID("grain"));
+      var blue = color.getInteger(stringIDToTypeID("blue"));
+      result.push({ red: red, green: green, blue: blue });
+    }
+    return result;
+  }
+  return null;
+};
+
+/**
+ * 获取图层描边效果
+ * @return {{size: *, color: {red: *, green: *, blue: *}, opacity: *}|null}
+ */
+Layer.prototype.strokeFx = function () {
+  var layerReference = new ActionReference();
+  // 所有的图层效果，都在layerEffects下面
+  layerReference.putProperty(charIDToTypeID("Prpr"), stringIDToTypeID("layerEffects"));
+  layerReference.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var descriptor = executeActionGet(layerReference);
+  var layerEffects = descriptor.getList(stringIDToTypeID("layerEffects"));
+  var frameFX = layerEffects.getObjectValue(stringIDToTypeID("frameFX"));
+  var enabled = frameFX.getBoolean(stringIDToTypeID("enabled"));
+  if (enabled) {
+    var size = frameFX.getInteger(stringIDToTypeID("size"));
+    var opacity = frameFX.getInteger(stringIDToTypeID("opacity"));
+    var color = frameFX.getObjectValue(stringIDToTypeID("color"));
+    var red = color.getInteger(stringIDToTypeID("red"));
+    var green = color.getInteger(stringIDToTypeID("grain"));
+    var blue = color.getInteger(stringIDToTypeID("blue"));
+    return {
+      size: size,
+      opacity: opacity,
+      color: { red: red, green: green, blue: blue },
+    };
+  }
+  return null;
+};
+
+/**
+ * 选中当前实例图层
+ */
+Layer.prototype.select = function () {
+  var current = new ActionReference();
+  current.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  var desc = new ActionDescriptor();
+  desc.putReference(charIDToTypeID("null"), current);
+  executeAction(charIDToTypeID("slct"), desc, DialogModes.NO);
+};
+
+/**
+ * 显示当前实例对象图层
+ */
+Layer.prototype.show = function () {
+  var desc1 = new ActionDescriptor();
+  var list1 = new ActionList();
+  var ref1 = new ActionReference();
+  ref1.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  list1.putReference(ref1);
+  desc1.putList(charIDToTypeID("null"), list1);
+  executeAction(charIDToTypeID("Shw "), desc1, DialogModes.NO);
+};
+
+/**
+ * 隐藏当前实例对象图层
+ */
+Layer.prototype.hide = function () {
+  var current = new ActionReference();
+  var desc242 = new ActionDescriptor();
+  var list10 = new ActionList();
+  current.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  list10.putReference(current);
+  desc242.putList(charIDToTypeID("null"), list10);
+  executeAction(charIDToTypeID("Hd  "), desc242, DialogModes.NO);
+};
+
+/**
+ * 栅格化当前实例图层
+ */
+Layer.prototype.rasterize = function () {
+  var desc7 = new ActionDescriptor();
+  var ref4 = new ActionReference();
+  ref4.putIdentifier(charIDToTypeID("Lyr "), this.id);
+  desc7.putReference(charIDToTypeID("null"), ref4);
+  executeAction(stringIDToTypeID("rasterizeLayer"), desc7, DialogModes.NO);
+};
+
+/**
+ * 修改图层名称
+ * @param newNameString
+ */
+Layer.prototype.setName = function (newNameString) {
+  var desc26 = new ActionDescriptor();
+  var ref13 = new ActionReference();
+  // 只能对当前选中的图层操作
+  ref13.putEnumerated(charIDToTypeID("Lyr "), charIDToTypeID("Ordn"), charIDToTypeID("Trgt"));
+  desc26.putReference(charIDToTypeID("null"), ref13);
+  var desc27 = new ActionDescriptor();
+  desc27.putString(charIDToTypeID("Nm  "), newNameString);
+  desc26.putObject(charIDToTypeID("T   "), charIDToTypeID("Lyr "), desc27);
+  executeAction(charIDToTypeID("setd"), desc26, DialogModes.NO);
+};
+
+// --------- 类方法 -----------------
+/**
+ * 获取选中的图层列表
+ * @return Layer[]
+ */
+Layer.getSelectedLayers = function () {
+  var targetLayersTypeId = stringIDToTypeID("targetLayersIDs");
+  var selectedLayersReference = new ActionReference();
+  selectedLayersReference.putProperty(charIDToTypeID("Prpr"), targetLayersTypeId);
+  selectedLayersReference.putEnumerated(
+    charIDToTypeID("Dcmn"),
+    charIDToTypeID("Ordn"),
+    charIDToTypeID("Trgt")
+  );
+  var desc = executeActionGet(selectedLayersReference);
+  var layers = [];
+  if (desc.hasKey(targetLayersTypeId)) {
+    // have selected layers
+    var list = desc.getList(targetLayersTypeId);
+    for (var i = 0; i < list.count; i++) {
+      var ar = list.getReference(i);
+      var layerId = ar.getIdentifier();
+      layers.push(new Layer(layerId));
+    }
+  }
+
+  // WIN CC2019的情况下，默认一个背景图层，会获取到ID是0
+  if (layers.length === 1 && layers[0].id === "0") {
+    layers = [];
+    selectedLayersReference = new ActionReference();
+    selectedLayersReference.putProperty(charIDToTypeID("Prpr"), charIDToTypeID("LyrI"));
+    selectedLayersReference.putEnumerated(
+      charIDToTypeID("Lyr "),
+      charIDToTypeID("Ordn"),
+      charIDToTypeID("Trgt")
+    );
+    var descriptor = executeActionGet(selectedLayersReference);
+    var id = descriptor.getInteger(charIDToTypeID("LyrI"));
+    layers.push(new Layer(id));
+  }
+
+  return layers;
+};
+
+/**
+ * 根据名称获取图层
+ */
+Layer.getLayersByName = function () {
+  try {
+    var ref = new ActionReference();
+    ref.putName(charIDToTypeID("Lyr "), name);
+    var layerDesc = executeActionGet(ref);
+    var layerId = layerDesc.getInteger(charIDToTypeID("LyrI"));
+    return new Layer(layerId);
+  } catch (e) {
+    $.writeln(e.toSting());
+    return null;
+  }
+};
+
+/**
+ * 高效的遍历图层方法
+ */
+Layer.loopLayers = function (callback) {
+  var ref = new ActionReference();
+  // 当前文档的图层数量属性key
+  ref.putProperty(charIDToTypeID("Prpr"), charIDToTypeID("NmbL"));
+  ref.putEnumerated(charIDToTypeID("Dcmn"), charIDToTypeID("Ordn"), charIDToTypeID("Trgt"));
+  var desc = executeActionGet(ref);
+  var layerCount = desc.getInteger(charIDToTypeID("NmbL"));
+  $.writeln("count: " + layerCount);
+  // 索引起始值，会受是否有背景图层影响，需要做一下处理
+  var i = 0;
+  try {
+    activeDocument.backgroundLayer;
+  } catch (e) {
+    i = 1;
+  }
+  // 开始逐级遍历图层index，根据index来获取到图层实例
+  for (i; i < layerCount; i++) {
+    var ref = new ActionReference();
+    ref.putIndex(charIDToTypeID("Lyr "), i);
+    var desc = executeActionGet(ref);
+    var id = desc.getInteger(stringIDToTypeID("layerID"));
+    var layer = new Layer(id);
+    // 根据需要进行操作
+    callback && callback(layer);
+  }
+};

package/jsx/Layer/saveEngineDataToLayer.jsx

@@ -0,0 +1,26 @@
+const layerName = params.layerName;
+const data = params.data;
+const config = params.config;
+
+function saveEngineData(layerName, data, config) {
+  config = config || {};
+
+  const refLay_gs = new ActionReference();
+  refLay_gs.putProperty(charIDToTypeID("Prpr"), stringIDToTypeID("generatorSettings"));
+  refLay_gs.putName(stringIDToTypeID("layer"), layerName);
+
+  const settingsDesc = new ActionDescriptor();
+  settingsDesc.putString(stringIDToTypeID("data"), data);
+
+  if (config.engine) settingsDesc.putString(stringIDToTypeID("engine"), config.engine);
+  if (config.version) settingsDesc.putString(stringIDToTypeID("version"), config.version);
+
+  const setDescriptor = new ActionDescriptor();
+  setDescriptor.putReference(stringIDToTypeID("null"), refLay_gs);
+  setDescriptor.putObject(stringIDToTypeID("to"), stringIDToTypeID("null"), settingsDesc);
+  setDescriptor.putString(charIDToTypeID("Prpr"), "engineData");
+  executeAction(charIDToTypeID("setd"), setDescriptor, DialogModes.NO);
+}
+try {
+  saveEngineData(layerName, data, config);
+} catch (error) {}