Skip to content

Commit

Permalink
XD 27 updates
Browse files Browse the repository at this point in the history
  • Loading branch information
@peterflynn
peterflynn committed Feb 11, 2020
1 parent e2c8707 commit 07abf2c
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 0 deletions.
9 changes: 9 additions & 0 deletions changes.md
View file
@@ -1,5 +1,14 @@
# Change Log

XD Release 27.0.12 (February 2020)
-------------------------------------
XD 27 is a minor update for plugin developers, with one new added API:

* Get and set [`SceneNode.blendMode`](./reference/scenegraph.md#SceneNode-blendMode)

[Read more about XD 27 new features for end users on the Adobe blog](https://theblog.adobe.com/announcing-mac-os-voice-control-adobe-xd).


XD Release 26.0.12 (January 2020)
-------------------------------------

Expand Down
16 changes: 16 additions & 0 deletions reference/scenegraph.md
View file
Expand Up @@ -136,6 +136,7 @@ Base class of all scenegraph nodes. Nodes will always be an instance of some _su
* *[.selected](#SceneNode-selected) : <code>boolean</code>*
* *[.visible](#SceneNode-visible) : <code>boolean</code>*
* *[.opacity](#SceneNode-opacity) : <code>number</code>*
* *[.blendMode](#SceneNode-blendMode) : <code>string</code>*
* *[.transform](#SceneNode-transform) : <code>!Matrix</code>*
* *[.translation](#SceneNode-translation) : <code>!{x:number, y:number}</code>*
* *[.rotation](#SceneNode-rotation) : <code>number</code>*
Expand Down Expand Up @@ -258,6 +259,21 @@ Node's opacity setting. The overall visual opacity seen in the document is deter

* * *

<a name="SceneNode-blendMode"></a>

### *sceneNode.blendMode : <code>string</code>*
**Default**: `BLEND_MODE_PASSTHROUGH`
**Since**: XD 27

Blend mode determines how a node is composited onto the content below it.

_Note:_ for leaf nodes (GraphicNode), the XD UI may show leaf nodes as blend mode "Normal" even when the underlying value is `BLEND_MODE_PASSTHROUGH`. This is because "Pass Through" and "Normal" are essentially equivalent for leaf nodes -- they only differ
in appearance when a node has children.

**Kind**: instance property of [<code>SceneNode</code>](#SceneNode)

* * *

<a name="SceneNode-transform"></a>

### *sceneNode.transform : <code>\![Matrix](Matrix.md)</code>*
Expand Down

4 comments on commit 07abf2c

@ericdrobinson
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@peterflynn The only documented blend mode is BLEND_MODE_PASSTHROUGH. What are the other available modes for this property?

@peterflynn
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ericdrobinson a list of symbolic constants for the values of this will be coming in the next release, but unfortunately didn't make it in time for XD 27. For now, you can look at the dropdown in XD's UI to see the full list of possible values and read this API to see what string value each one corresponds to.

@ericdrobinson
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For now, you can look at the dropdown in XD's UI to see the full list of possible values and read this API to see what string value each one corresponds to.

To be clear, you are suggesting the following:

  1. Create a simple plugin that, when run, outputs the value returned by the API as accessed on an appropriate (non-leaf) SceneNode element.
  2. Set the blend mode on the SceneNode to something new.
  3. Run the plugin.
  4. Repeat from step 2 until all options are exhausted.

Is this correct?

@peterflynn
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep! Or you can wait until XD's March release when the list of values will be better formalized.

Please sign in to comment.