adobe-photoshop/generator-core — pull request #238 by joelrbrandt (2014-07-26 23:27:48+00:00)
Title: add getFullTextStyles and getDefaultLayerFX options to getDocumentInfo

As it is currently implemented, the `getDocumentInfo` call only returns layer effects settings that differ from the default settings for each layer effect. If a layer effect is applied, but has all of the default settings, then `getDocumentInfo` just states that the layer effect is applied.

PS 14.2 added a `getDefaultLayerFX` option to the underlying KVLR `sendDocumentInfoToNetworkClient` command that we never bubbled up to the Generator API. This PR bubbles it up. It also opportunistically adds the `getFullTextStyles` option, and improves documentation of all of the options.

A bit more discussion on why this setting is useful:

Without turning this option on, the data reported for drop shadow effects (for example) can be confusing. By default, the drop shadow effect has "use global light" checked. So, changing the angle (with this box checked) changes the global light angle instead of anything in the layer effect, and it looks like the layer effect has completely default settings.

That change in angle is reported elsewhere in the document info as something like:

```json
"globalLight": {
"angle": 147,
"altitude": 30
}
```

If you uncheck this box (and change the angle to something other than 120, which is the default) then you'll finally get something like this in the effects settings:

```json
"layerEffects": {
"dropShadow": {
"enabled": true,
"useGlobalAngle": false,
"localLightingAngle": {
"value": 32,
"units": "angleUnit"
}
}
}
```

Anyway, if the user just sets `getDefaultLayerFX` to `true`, all becomes clear.