Channel
Represents a channel in a Photoshop document. You can access instances of channels using one of these methods:
Copied to your clipboard1// An array of component channels in the document2const componentChannels = app.activeDocument.componentChannels34// An array of active (selected) channels in the document5const activeChannels = app.activeDocument.activeChannels67// Reference a document's Red channel8const redChannel = app.activeDocument.channels[0]
Properties
Name | Type | Access | Min Version | Description |
---|---|---|---|---|
color | R W | 23.0 | The color of the channel. | |
histogram | number[] | R | 23.0 | A histogram containing the number of pixels at each color intensity level for this channel. The array contains 256 members. The target channel must be visible. |
kind | R W | 23.0 | The type or kind of the channel. | |
name | string | R W | 23.0 | The name of the channel. For component channels this name can be localized. Fixes in Photoshop 24.6 - For component channel it is no longer converted into lowercase and is same as in UI - For component channel it will throw an error if channel no longer exist in document |
opacity | number | R W | 23.0 | The opacity or solidity of the channel. |
parent | R | 23.0 | The containing document. | |
visible | boolean | R W | 23.0 | The visibility of the channel. |
Methods
duplicate
23.0async : Promise<void>
Duplicates the channel to the parent document, or a target document if specified.
Copied to your clipboard1// duplicate the channel2await channel.duplicate()34// duplicate to a different, compatible document5const newDoc = psApp.documents[1]6await channel.duplicate(newDoc)
Parameters
Name | Type | Description |
---|---|---|
targetDocument? | if specified, duplicate to a different document target. |
merge
23.0Promise<void>
Merges a Spot Color channel into the component channels.
remove
23.0Promise<void>
Deletes the channel.