psd_tools.api.adjustments¶

Adjustment and fill layers.

Example:

if layer.kind == 'brightnesscontrast':
    print(layer.brightness)

if layer.kind == 'gradientfill':
    print(layer.gradient_kind)

Fill layers¶

Fill layers are similar to ShapeLayer except that the layer might not have an associated vector mask. The layer therefore expands the entire canvas of the PSD document.

Fill layers all inherit from FillLayer.

Example:

if isinstance(layer, psd_tools.layers.FillLayer):
    image = layer.compose()

SolidColorFill¶

class psd_tools.api.adjustments.SolidColorFill(*args)[source]¶

Solid color fill.

bbox¶: (left, top, right, bottom) tuple.

blend_mode¶

Blend mode of this layer. Writable.

Example:

from psd_tools.constants import BlendMode
if layer.blend_mode == BlendMode.NORMAL:
    layer.blend_mode = BlendMode.SCREEN

Returns:	`BlendMode`.

bottom¶

Bottom coordinate.

Returns:	int

clip_layers¶

Clip layers associated with this layer.

To compose clipping layers:

from psd_tools import compose
clip_mask = compose(layer.clip_layers)

Returns:	list of layers

clipping_layer¶

Clipping flag for this layer. Writable.

Returns:	bool

compose(force=False, bbox=None, layer_filter=None)¶

Deprecated, use composite().

Compose layer and masks (mask, vector mask, and clipping layers).

Note that the resulting image size is not necessarily equal to the layer size due to different mask dimensions. The offset of the composed image is stored at .info[‘offset’] attribute of PIL.Image.

Parameters:	bbox – Viewport bounding box specified by (x1, y1, x2, y2) tuple.
Returns:	`PIL.Image`, or None if the layer has no pixel.

composite(viewport=None, force=False, color=1.0, alpha=0.0, layer_filter=None, apply_icc=False)¶

Composite layer and masks (mask, vector mask, and clipping layers).

Parameters:

viewport – Viewport bounding box specified by (x1, y1, x2, y2) tuple. Default is the layer’s bbox.
force – Boolean flag to force vector drawing.
color – Backdrop color specified by scalar or tuple of scalar. The color value should be in [0.0, 1.0]. For example, (1., 0., 0.) specifies red in RGB color mode.
alpha – Backdrop alpha in [0.0, 1.0].
layer_filter – Callable that takes a layer as argument and returns whether if the layer is composited. Default is is_visible().

Returns:

PIL.Image.

data¶: Color in Descriptor(RGB).

effects¶

Layer effects.

Returns:	`Effects`

has_clip_layers()¶

Returns True if the layer has associated clipping.

Returns:	bool

has_effects()¶

Returns True if the layer has effects.

Returns:	bool

has_mask()¶

Returns True if the layer has a mask.

Returns:	bool

has_origination()¶

Returns True if the layer has live shape properties.

Returns:	bool

has_pixels()¶

Returns True if the layer has associated pixels. When this is True, topil method returns PIL.Image.

Returns:	bool

has_stroke()¶: Returns True if the shape has a stroke.

has_vector_mask()¶

Returns True if the layer has a vector mask.

Returns:	bool

height¶

Height of the layer.

Returns:	int

is_group()¶

Return True if the layer is a group.

Returns:	bool

is_visible()¶

Layer visibility. Takes group visibility in account.

Returns:	bool

kind¶

Kind of this layer, such as group, pixel, shape, type, smartobject, or psdimage. Class name without layer suffix.

Returns:	str

layer_id¶

Layer ID.

Returns:	int layer id. if the layer is not assigned an id, -1.

left¶

Left coordinate. Writable.

Returns:	int

mask¶

Returns mask associated with this layer.

Returns:	`Mask` or None

name¶

Layer name. Writable.

Returns:	str

numpy(channel=None, real_mask=True)¶

Get NumPy array of the layer.

Parameters:	channel – Which channel to return, can be ‘color’, ‘shape’, ‘alpha’, or ‘mask’. Default is ‘color+alpha’.
Returns:	`numpy.ndarray` or None if there is no pixel.

offset¶

(left, top) tuple. Writable.

Returns:	tuple

opacity¶

Opacity of this layer in [0, 255] range. Writable.

Returns:	int

origination¶

Property for a list of live shapes or a line.

Some of the vector masks have associated live shape properties, that are Photoshop feature to handle primitive shapes such as a rectangle, an ellipse, or a line. Vector masks without live shape properties are plain path objects.

See psd_tools.api.shape.

Returns:	List of `Invalidated`, `Rectangle`, `RoundedRectangle`, `Ellipse`, or `Line`.

parent¶: Parent of this layer.

right¶

Right coordinate.

Returns:	int

size¶

(width, height) tuple.

Returns:	tuple

stroke¶: Property for strokes.

tagged_blocks¶

Layer tagged blocks that is a dict-like container of settings.

See psd_tools.constants.Tag for available keys.

Returns:	`TaggedBlocks` or None.

Example:

from psd_tools.constants import Tag
metadata = layer.tagged_blocks.get_data(Tag.METADATA_SETTING)

top¶

Top coordinate. Writable.

Returns:	int

topil(channel=None, apply_icc=False)¶

Get PIL Image of the layer.

Parameters:	channel – Which channel to return; e.g., 0 for ‘R’ channel in RGB image. See `ChannelID`. When None, the method returns all the channels supported by PIL modes. apply_icc – Whether to apply ICC profile conversion to sRGB.
Returns:	`PIL.Image`, or None if the layer has no pixels.

Example:

from psd_tools.constants import ChannelID

image = layer.topil()
red = layer.topil(ChannelID.CHANNEL_0)
alpha = layer.topil(ChannelID.TRANSPARENCY_MASK)

Note

Not all of the PSD image modes are supported in PIL.Image. For example, ‘CMYK’ mode cannot include alpha channel in PIL. In this case, topil drops alpha channel.

vector_mask¶

Returns vector mask associated with this layer.

Returns:	`VectorMask` or None

visible¶

Layer visibility. Doesn’t take group visibility in account. Writable.

Returns:	bool

width¶

Width of the layer.

Returns:	int

PatternFill¶

class psd_tools.api.adjustments.PatternFill(*args)[source]¶

Pattern fill.

bbox¶: (left, top, right, bottom) tuple.

blend_mode¶

Blend mode of this layer. Writable.

Example:

from psd_tools.constants import BlendMode
if layer.blend_mode == BlendMode.NORMAL:
    layer.blend_mode = BlendMode.SCREEN

Returns:	`BlendMode`.

bottom¶

Bottom coordinate.

Returns:	int

clip_layers¶

Clip layers associated with this layer.

To compose clipping layers:

from psd_tools import compose
clip_mask = compose(layer.clip_layers)

Returns:	list of layers

clipping_layer¶

Clipping flag for this layer. Writable.

Returns:	bool

compose(force=False, bbox=None, layer_filter=None)¶

Deprecated, use composite().

Compose layer and masks (mask, vector mask, and clipping layers).

Note that the resulting image size is not necessarily equal to the layer size due to different mask dimensions. The offset of the composed image is stored at .info[‘offset’] attribute of PIL.Image.

Parameters:	bbox – Viewport bounding box specified by (x1, y1, x2, y2) tuple.
Returns:	`PIL.Image`, or None if the layer has no pixel.

composite(viewport=None, force=False, color=1.0, alpha=0.0, layer_filter=None, apply_icc=False)¶

Composite layer and masks (mask, vector mask, and clipping layers).

Parameters:

viewport – Viewport bounding box specified by (x1, y1, x2, y2) tuple. Default is the layer’s bbox.
force – Boolean flag to force vector drawing.
color – Backdrop color specified by scalar or tuple of scalar. The color value should be in [0.0, 1.0]. For example, (1., 0., 0.) specifies red in RGB color mode.
alpha – Backdrop alpha in [0.0, 1.0].
layer_filter – Callable that takes a layer as argument and returns whether if the layer is composited. Default is is_visible().

Returns:

PIL.Image.

data¶: Pattern in Descriptor(PATTERN).

effects¶

Layer effects.

Returns:	`Effects`

has_clip_layers()¶

Returns True if the layer has associated clipping.

Returns:	bool

has_effects()¶

Returns True if the layer has effects.

Returns:	bool

has_mask()¶

Returns True if the layer has a mask.

Returns:	bool

has_origination()¶

Returns True if the layer has live shape properties.

Returns:	bool

has_pixels()¶

Returns True if the layer has associated pixels. When this is True, topil method returns PIL.Image.

Returns:	bool

has_stroke()¶: Returns True if the shape has a stroke.

has_vector_mask()¶

Returns True if the layer has a vector mask.

Returns:	bool

height¶

Height of the layer.

Returns:	int

is_group()¶

Return True if the layer is a group.

Returns:	bool

is_visible()¶

Layer visibility. Takes group visibility in account.

Returns:	bool

kind¶

Kind of this layer, such as group, pixel, shape, type, smartobject, or psdimage. Class name without layer suffix.

Returns:	str

layer_id¶

Layer ID.

Returns:	int layer id. if the layer is not assigned an id, -1.

left¶

Left coordinate. Writable.

Returns:	int

mask¶

Returns mask associated with this layer.

Returns:	`Mask` or None

name¶

Layer name. Writable.

Returns:	str

numpy(channel=None, real_mask=True)¶

Get NumPy array of the layer.

Parameters:	channel – Which channel to return, can be ‘color’, ‘shape’, ‘alpha’, or ‘mask’. Default is ‘color+alpha’.
Returns:	`numpy.ndarray` or None if there is no pixel.

offset¶

(left, top) tuple. Writable.

Returns:	tuple

opacity¶

Opacity of this layer in [0, 255] range. Writable.

Returns:	int

origination¶

Property for a list of live shapes or a line.

Some of the vector masks have associated live shape properties, that are Photoshop feature to handle primitive shapes such as a rectangle, an ellipse, or a line. Vector masks without live shape properties are plain path objects.

See psd_tools.api.shape.

Returns:	List of `Invalidated`, `Rectangle`, `RoundedRectangle`, `Ellipse`, or `Line`.

parent¶: Parent of this layer.

right¶

Right coordinate.

Returns:	int

size¶

(width, height) tuple.

Returns:	tuple

stroke¶: Property for strokes.

tagged_blocks¶

Layer tagged blocks that is a dict-like container of settings.

See psd_tools.constants.Tag for available keys.

Returns:	`TaggedBlocks` or None.

Example:

from psd_tools.constants import Tag
metadata = layer.tagged_blocks.get_data(Tag.METADATA_SETTING)

top¶

Top coordinate. Writable.

Returns:	int

topil(channel=None, apply_icc=False)¶

Get PIL Image of the layer.

Parameters:	channel – Which channel to return; e.g., 0 for ‘R’ channel in RGB image. See `ChannelID`. When None, the method returns all the channels supported by PIL modes. apply_icc – Whether to apply ICC profile conversion to sRGB.
Returns:	`PIL.Image`, or None if the layer has no pixels.

Example:

from psd_tools.constants import ChannelID

image = layer.topil()
red = layer.topil(ChannelID.CHANNEL_0)
alpha = layer.topil(ChannelID.TRANSPARENCY_MASK)

Note

Not all of the PSD image modes are supported in PIL.Image. For example, ‘CMYK’ mode cannot include alpha channel in PIL. In this case, topil drops alpha channel.

vector_mask¶

Returns vector mask associated with this layer.

Returns:	`VectorMask` or None

visible¶

Layer visibility. Doesn’t take group visibility in account. Writable.

Returns:	bool

width¶

Width of the layer.

Returns:	int

GradientFill¶

class psd_tools.api.adjustments.GradientFill(*args)[source]¶

Gradient fill.

bbox¶: (left, top, right, bottom) tuple.

blend_mode¶

Blend mode of this layer. Writable.

Example:

from psd_tools.constants import BlendMode
if layer.blend_mode == BlendMode.NORMAL:
    layer.blend_mode = BlendMode.SCREEN

Returns:	`BlendMode`.

bottom¶

Bottom coordinate.

Returns:	int

clip_layers¶

Clip layers associated with this layer.

To compose clipping layers:

from psd_tools import compose
clip_mask = compose(layer.clip_layers)

Returns:	list of layers

clipping_layer¶

Clipping flag for this layer. Writable.

Returns:	bool

compose(force=False, bbox=None, layer_filter=None)¶

Deprecated, use composite().

Compose layer and masks (mask, vector mask, and clipping layers).

Note that the resulting image size is not necessarily equal to the layer size due to different mask dimensions. The offset of the composed image is stored at .info[‘offset’] attribute of PIL.Image.

Parameters:	bbox – Viewport bounding box specified by (x1, y1, x2, y2) tuple.
Returns:	`PIL.Image`, or None if the layer has no pixel.

composite(viewport=None, force=False, color=1.0, alpha=0.0, layer_filter=None, apply_icc=False)¶

Composite layer and masks (mask, vector mask, and clipping layers).

Parameters:

viewport – Viewport bounding box specified by (x1, y1, x2, y2) tuple. Default is the layer’s bbox.
force – Boolean flag to force vector drawing.
color – Backdrop color specified by scalar or tuple of scalar. The color value should be in [0.0, 1.0]. For example, (1., 0., 0.) specifies red in RGB color mode.
alpha – Backdrop alpha in [0.0, 1.0].
layer_filter – Callable that takes a layer as argument and returns whether if the layer is composited. Default is is_visible().

Returns:

PIL.Image.

data¶: Gradient in Descriptor(GRADIENT).

effects¶

Layer effects.

Returns:	`Effects`

gradient_kind¶

Kind of the gradient, one of the following:

Linear

Radial

Angle

Reflected

Diamond

has_clip_layers()¶

Returns True if the layer has associated clipping.

Returns:	bool

has_effects()¶

Returns True if the layer has effects.

Returns:	bool

has_mask()¶

Returns True if the layer has a mask.

Returns:	bool

has_origination()¶

Returns True if the layer has live shape properties.

Returns:	bool

has_pixels()¶

Returns True if the layer has associated pixels. When this is True, topil method returns PIL.Image.

Returns:	bool

has_stroke()¶: Returns True if the shape has a stroke.

has_vector_mask()¶

Returns True if the layer has a vector mask.

Returns:	bool

height¶

Height of the layer.

Returns:	int

is_group()¶

Return True if the layer is a group.

Returns:	bool

is_visible()¶

Layer visibility. Takes group visibility in account.

Returns:	bool

kind¶

Kind of this layer, such as group, pixel, shape, type, smartobject, or psdimage. Class name without layer suffix.

Returns:	str

layer_id¶

Layer ID.

Returns:	int layer id. if the layer is not assigned an id, -1.

left¶

Left coordinate. Writable.

Returns:	int

mask¶

Returns mask associated with this layer.

Returns:	`Mask` or None

name¶

Layer name. Writable.

Returns:	str

numpy(channel=None, real_mask=True)¶

Get NumPy array of the layer.

Parameters:	channel – Which channel to return, can be ‘color’, ‘shape’, ‘alpha’, or ‘mask’. Default is ‘color+alpha’.
Returns:	`numpy.ndarray` or None if there is no pixel.

offset¶

(left, top) tuple. Writable.

Returns:	tuple

opacity¶

Opacity of this layer in [0, 255] range. Writable.

Returns:	int

origination¶

Property for a list of live shapes or a line.

Some of the vector masks have associated live shape properties, that are Photoshop feature to handle primitive shapes such as a rectangle, an ellipse, or a line. Vector masks without live shape properties are plain path objects.

See psd_tools.api.shape.

Returns:	List of `Invalidated`, `Rectangle`, `RoundedRectangle`, `Ellipse`, or `Line`.

parent¶: Parent of this layer.

right¶

Right coordinate.

Returns:	int

size¶

(width, height) tuple.

Returns:	tuple

stroke¶: Property for strokes.

tagged_blocks¶

Layer tagged blocks that is a dict-like container of settings.

See psd_tools.constants.Tag for available keys.

Returns:	`TaggedBlocks` or None.

Example:

from psd_tools.constants import Tag
metadata = layer.tagged_blocks.get_data(Tag.METADATA_SETTING)

top¶

Top coordinate. Writable.

Returns:	int

topil(channel=None, apply_icc=False)¶

Get PIL Image of the layer.

Parameters:	channel – Which channel to return; e.g., 0 for ‘R’ channel in RGB image. See `ChannelID`. When None, the method returns all the channels supported by PIL modes. apply_icc – Whether to apply ICC profile conversion to sRGB.
Returns:	`PIL.Image`, or None if the layer has no pixels.

Example:

from psd_tools.constants import ChannelID

image = layer.topil()
red = layer.topil(ChannelID.CHANNEL_0)
alpha = layer.topil(ChannelID.TRANSPARENCY_MASK)

Note

Not all of the PSD image modes are supported in PIL.Image. For example, ‘CMYK’ mode cannot include alpha channel in PIL. In this case, topil drops alpha channel.

vector_mask¶

Returns vector mask associated with this layer.

Returns:	`VectorMask` or None

visible¶

Layer visibility. Doesn’t take group visibility in account. Writable.

Returns:	bool

width¶

Width of the layer.

Returns:	int

Adjustment layers¶

Adjustment layers apply image filtering to the composed result. All adjustment layers inherit from AdjustmentLayer. Adjustment layers do not have pixels, and currently ignored in compose. Attempts to call topil on adjustment layers always return None.

Just as any other layer, adjustment layers might have an associated mask or vector mask. Adjustment can appear in other layers’ clipping layers.

Example:

if isinstance(layer, psd_tools.layers.AdjustmentLayer):
    print(layer.kind)

BrightnessContrast¶

class psd_tools.api.adjustments.BrightnessContrast(*args)[source]¶

Brightness and contrast adjustment.

automatic¶

brightness¶

contrast¶

lab¶

mean¶

use_legacy¶

vrsn¶

Curves¶

class psd_tools.api.adjustments.Curves(*args)[source]¶

Curves adjustment.

data¶

Raw data.

Returns:	`Curves`

extra¶

Exposure¶

class psd_tools.api.adjustments.Exposure(*args)[source]¶

Exposure adjustment.

exposure¶

Exposure.

Returns:	float

gamma¶

Gamma.

Returns:	float

offset¶

Offset.

Returns:	float

Levels¶

class psd_tools.api.adjustments.Levels(*args)[source]¶

Levels adjustment.

Levels contain a list of LevelRecord.

data¶

List of level records. The first record is the master.

Returns:	`Levels`.

master¶: Master record.

Vibrance¶

class psd_tools.api.adjustments.Vibrance(*args)[source]¶

Vibrance adjustment.

saturation¶

Saturation.

Returns:	int

vibrance¶

Vibrance.

Returns:	int

HueSaturation¶

class psd_tools.api.adjustments.HueSaturation(*args)[source]¶

Hue/Saturation adjustment.

HueSaturation contains a list of data.

colorization¶

Colorization.

Returns:	tuple

data¶

List of Hue/Saturation records.

Returns:	list

enable_colorization¶

Enable colorization.

Returns:	int

master¶

Master record.

Returns:	tuple

ColorBalance¶

class psd_tools.api.adjustments.ColorBalance(*args)[source]¶

Color balance adjustment.

highlights¶

Highlights.

Returns:	tuple

luminosity¶

Luminosity.

Returns:	int

midtones¶

Mid-tones.

Returns:	tuple

shadows¶

Shadows.

Returns:	tuple

BlackAndWhite¶

class psd_tools.api.adjustments.BlackAndWhite(*args)[source]¶

Black and white adjustment.

blue¶

cyan¶

green¶

magenta¶

preset_file_name¶

preset_kind¶

red¶

tint_color¶

use_tint¶

yellow¶

PhotoFilter¶

class psd_tools.api.adjustments.PhotoFilter(*args)[source]¶

Photo filter adjustment.

color_components¶

color_space¶

density¶

luminosity¶

xyz¶

xyz.

Returns:	bool

ChannelMixer¶

class psd_tools.api.adjustments.ChannelMixer(*args)[source]¶

Channel mixer adjustment.

data¶

monochrome¶

ColorLookup¶

class psd_tools.api.adjustments.ColorLookup(*args)[source]¶: Color lookup adjustment.

Posterize¶

class psd_tools.api.adjustments.Posterize(*args)[source]¶

Posterize adjustment.

posterize¶

Posterize value.

Returns:	int

Threshold¶

class psd_tools.api.adjustments.Threshold(*args)[source]¶

Threshold adjustment.

threshold¶

Threshold value.

Returns:	int

SelectiveColor¶

class psd_tools.api.adjustments.SelectiveColor(*args)[source]¶

Selective color adjustment.

data¶

method¶

GradientMap¶

class psd_tools.api.adjustments.GradientMap(*args)[source]¶

Gradient map adjustment.

color_model¶

color_stops¶

dithered¶

expansion¶

gradient_name¶

interpolation¶: Interpolation between 0.0 and 1.0.

length¶

max_color¶

min_color¶

mode¶

random_seed¶

reversed¶

roughness¶

show_transparency¶

transparency_stops¶

use_vector_color¶