ReadPSD node

pluginIcon

This documentation is for version 2.7 of ReadPSD.

Description

Read Photoshop/GIMP/Cinepaint (RGB/CMYK/GRAY) image formats with ICC color management.

Powered by Little CMS v2 http://www.littlecms.com/ and ImageMagick 6.9.7-5 Q32 x86_64 2017-01-26 http://www.imagemagick.org

ImageMagick (R) is Copyright 1999-2015 ImageMagick Studio LLC, a non-profit organization dedicated to making software imaging solutions freely available.

ImageMagick is distributed under the Apache 2.0 license.

Little CMS is Copyright 2010-2015 Marti Maria Saguer. All rights reserved.

Little CMS is distributed under the MIT license agreement.

OpenColorIO is Copyright 2003-2010 Sony Pictures Imageworks Inc., et al. All Rights Reserved.

OpenColorIO is distributed under a BSD license.

Inputs

Input Description Optional
Sync Sync Yes

Controls

Parameter / script name Type Default Function
File / filename N/A   The input image sequence/video stream file(s).
First Frame / firstFrame Integer 0 The first frame this sequence/video should start at. This cannot be less than the first frame of the sequence and cannot be greater than the last frame of the sequence.
Before / before Choice Hold
What to do before the first frame of the sequence.
Hold: While before the sequence, load the first frame.
Loop: Repeat the sequence before the first frame
Bounce: Repeat the sequence in reverse before the first frame
Black: Render a black image
Error: Report an error
Last Frame / lastFrame Integer 0 The frame this sequence/video should end at. This cannot be lesser than the first frame of the sequence and cannot be greater than the last frame of the sequence.
After / after Choice Hold
What to do after the last frame of the sequence.
Hold: While before the sequence, load the first frame.
Loop: Repeat the sequence before the first frame
Bounce: Repeat the sequence in reverse before the first frame
Black: Render a black image
Error: Report an error
On Missing Frame / onMissingFrame Choice Error
What to do when a frame is missing from the sequence/stream.
Hold previous: Try to load the previous frame in the sequence/stream, if any.
Load next: Try to load the next frame in the sequence/stream, if any.
Load nearest: Try to load the nearest frame in the sequence/stream, if any.
Error: Report an error
Black: Render a black image
Frame Mode / frameMode Choice Starting Time  
Starting Time / startingTime Integer 0 At what time (on the timeline) should this sequence/video start.
Time Offset / timeOffset Integer 0 Offset applied to the sequence in time units (i.e. frames).
Proxy File / proxy N/A   Filename of the proxy images. They will be used instead of the images read from the File parameter when the proxy mode (downscaling of the images) is activated.
Proxy threshold / proxyThreshold Double x: 1 y: 1 The original scale of the proxy image.
Custom Proxy Scale / customProxyScale Boolean Off Check to enable the Proxy scale edition.
File Premult / filePremult Choice PreMultiplied
The image file being read is considered to have this premultiplication state.
To get UnPremultiplied (or “unassociated alpha”) images, set the “Output Premult” parameter to Unpremultiplied.
By default the value should be correctly be guessed by the image file, but this parameter can be edited if the metadatas inside the file are wrong.
- Opaque means that the alpha channel is considered to be 1 (one), and it is not taken into account in colorspace conversion.
- Premultiplied, red, green and blue channels are divided by the alpha channel before applying the colorspace conversion, and re-multiplied by alpha after colorspace conversion.
- UnPremultiplied, means that red, green and blue channels are not modified before applying the colorspace conversion, and are multiplied by alpha after colorspace conversion.
This is set automatically from the image file and the plugin, but can be adjusted if this information is wrong in the file metadata.
RGB images can only be Opaque, and Alpha images can only be Premultiplied (the value of this parameter doesn’t matter).
Opaque: The image is opaque and so has no premultiplication state, as if the alpha component in all pixels were set to the white point.
PreMultiplied: The image is premultiplied by its alpha (also called “associated alpha”).
UnPreMultiplied: The image is unpremultiplied (also called “unassociated alpha”).
Output Premult / outputPremult Choice PreMultiplied
The alpha premultiplication in output of this node will have this state.
Opaque: The image is opaque and so has no premultiplication state, as if the alpha component in all pixels were set to the white point.
PreMultiplied: The image is premultiplied by its alpha (also called “associated alpha”).
UnPreMultiplied: The image is unpremultiplied (also called “unassociated alpha”).
Output Components / outputComponents Choice RGBA What type of components this effect should output when the main color plane is requested. For the Read node it will map (in number of components) the Output Layer choice to these.
Frame rate / frameRate Double 24 By default this value is guessed from the file. You can override it by checking the Custom fps parameter. The value of this parameter is what will be visible by the effects down-stream.
Custom FPS / customFps Boolean Off If checked, you can freely force the value of the frame rate parameter. The frame-rate is just the meta-data that will be passed downstream to the graph, no retime will actually take place.
Image layer / layer Choice Default
Select image layer

The recommended way to access layers is through a merge/shuffle node (multi-plane).
Offset layers / offset Boolean On Enable/Disable layer offset
Color management / icc Boolean Off
Enable/Disable ICC color management

Requires installed ICC v2/v4 color profiles.
Default RGB profile / iccRGB Choice None
Default RGB profile

Used when a RGB image is missing an embedded color profile.
Default CMYK profile / iccCMYK Choice None
Default CMYK profile

Used when a CMYK image is missing an embedded color profile.
Default GRAY profile / iccGRAY Choice None
Default GRAY profile

Used when a GRAY image is missing an embedded color profile.
Rendering intent / renderingIntent Choice Perceptual Rendering intent specifies the style of reproduction to be used.
Black point / blackPoint Boolean Off Enable/Disable black point compensation
Input color profile / iccIn Choice None
ICC input profile

If profile colorspace differs from image colorspace then a colorspace convert will happen.
Output color profile / iccOut Choice None
ICC RGB output profile

If image is CMYK/GRAY a colorspace convert will happen.
OCIO Config File / ocioConfigFile N/A   OpenColorIO configuration file
File Colorspace / ocioInputSpace String scene_linear Input data is taken to be in this colorspace.
File Colorspace / ocioInputSpaceIndex Choice Linear
Input data is taken to be in this colorspace.
Linear: Rec. 709 (Full Range), Blender native linear space (reference, scene_linear)
Raw: (color_picking, texture_paint)
adx10: Film Scan, using the 10-bit Academy Density Encoding
Linear ACES: ACES linear space
display/nuke_rec709: Rec. 709 (Full Range) Display Space
display/dci_xyz: OpenDCP output LUT with DCI reference white and Gamma 2.6
display/lg10: conversion from film log (color_timing)
lgf: lgf : conversion from film log (compositing_log)
display/srgb8: RGB display space for the sRGB standard.
sRGB: Standard RGB Display Space
VD16: The simple video conversion from a gamma 2.2 sRGB space
Cineon: Cineon (Log Film Scan)
Panalog: Sony/Panavision Genesis Log Space
REDLog: RED Log Space
ViperLog: Viper Log Space
AlexaV3LogC: Alexa Log C
PLogLin: Josh Pines style pivoted log/lin conversion. 445->0.18
SLog: Sony SLog
SLog1: Sony SLog1
SLog2: Sony SLog2
SLog3: Sony SLog3
CLog: Canon CLog
Protune: GoPro Protune
Non-Color: Color space used for images which contains non-color data (i,e, normal maps)
display/p3dci8: p3dci8 :rgb display space for gamma 2.6 P3 projection.
Output Colorspace / ocioOutputSpace String scene_linear Output data is taken to be in this colorspace.
Output Colorspace / ocioOutputSpaceIndex Choice Linear
Output data is taken to be in this colorspace.
Linear: Rec. 709 (Full Range), Blender native linear space (reference, scene_linear)
Raw: (color_picking, texture_paint)
adx10: Film Scan, using the 10-bit Academy Density Encoding
Linear ACES: ACES linear space
display/nuke_rec709: Rec. 709 (Full Range) Display Space
display/dci_xyz: OpenDCP output LUT with DCI reference white and Gamma 2.6
display/lg10: conversion from film log (color_timing)
lgf: lgf : conversion from film log (compositing_log)
display/srgb8: RGB display space for the sRGB standard.
sRGB: Standard RGB Display Space
VD16: The simple video conversion from a gamma 2.2 sRGB space
Cineon: Cineon (Log Film Scan)
Panalog: Sony/Panavision Genesis Log Space
REDLog: RED Log Space
ViperLog: Viper Log Space
AlexaV3LogC: Alexa Log C
PLogLin: Josh Pines style pivoted log/lin conversion. 445->0.18
SLog: Sony SLog
SLog1: Sony SLog1
SLog2: Sony SLog2
SLog3: Sony SLog3
CLog: Canon CLog
Protune: GoPro Protune
Non-Color: Color space used for images which contains non-color data (i,e, normal maps)
display/p3dci8: p3dci8 :rgb display space for gamma 2.6 P3 projection.
key1 / key1 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value1 / value1 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
key2 / key2 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value2 / value2 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
key3 / key3 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value3 / value3 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
key4 / key4 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value4 / value4 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
OCIO config help... / ocioHelp Button   Help about the OpenColorIO configuration.