PSD Layer Extractor:
The XIS_PSDLayerExtractor is a specialized node designed to extract individual layers from a PSD (Photoshop Document) file, providing both the images and their associated metadata. This node is particularly beneficial for AI artists who work with complex PSD files and need to manipulate or analyze specific layers independently. By converting each layer into an RGBA image tensor, the node ensures that the extracted images maintain their transparency and color integrity. The node also captures essential metadata such as layer dimensions, offsets, and potential transformations like rotation and scaling, which can be crucial for precise image manipulation and alignment in creative projects. Overall, the XIS_PSDLayerExtractor streamlines the process of working with layered PSD files, making it easier to access and utilize individual components for further artistic or analytical purposes.
PSD Layer Extractor Input Parameters:
PSD File
The PSD File parameter is the primary input for the XIS_PSDLayerExtractor node. It accepts a Photoshop Document (PSD) file from which the layers will be extracted. This parameter is crucial as it determines the source of the layers and metadata that the node will process. The PSD file should be a valid and accessible file path, ensuring that the node can read and interpret the file's contents accurately. There are no specific minimum or maximum values for this parameter, but the file must be in the PSD format.
PSD Layer Extractor Output Parameters:
Extracted Layers
The Extracted Layers output parameter provides a list of image tensors representing each layer extracted from the PSD file. Each tensor is in RGBA format, ensuring that the color and transparency information is preserved. This output is essential for users who need to work with individual layers separately, allowing for detailed manipulation and analysis. The output also includes metadata for each layer, such as dimensions, offsets, and any transformations applied, which can be used to understand the layer's position and orientation within the original PSD file.
Metadata
The Metadata output parameter contains detailed information about each extracted layer, including its name, width, height, offset, and any transformations like rotation and scaling. This metadata is crucial for understanding the context and properties of each layer, enabling users to make informed decisions when manipulating or analyzing the layers. The metadata helps maintain the integrity of the original design by providing insights into how each layer fits within the overall composition.
PSD Layer Extractor Usage Tips:
- Ensure that the PSD file is not corrupted and is accessible from the node's environment to avoid processing errors.
- Use the metadata output to align and position layers accurately when reconstructing or manipulating the extracted images in other applications.
PSD Layer Extractor Common Errors and Solutions:
Invalid image tensor shape for layer <layer_name>
- Explanation: This error occurs when the extracted image tensor does not have the expected shape, typically due to an issue with the layer's data or format.
- Solution: Verify that the PSD file is not corrupted and that the layers are in a compatible format. If the issue persists, try re-saving the PSD file in Photoshop to ensure compatibility.
No valid layers found in PSD file
- Explanation: This error indicates that the node could not find any layers to extract from the PSD file, possibly due to an empty file or unsupported layer types.
- Solution: Check the PSD file to ensure it contains layers and that they are not hidden or locked. Re-save the file if necessary to ensure it is in a compatible format.