Aspose.PSD FOSS
Python
Developer Guide
Sections

Sections

Sections

Un PsdImage cargado expone objetos de resumen de solo lectura para las secciones estructurales de un documento PSD/PSB — la cabecera, la sección de datos de color, la sección de datos de imagen y la sección de recursos de imagen — todo a través de propiedades tipadas, sin requerir ningún análisis manual a nivel de bytes.

Inspeccionando la sección de cabecera

PsdImage.header devuelve un PsdHeader con los campos estructurales sin procesar del documento. PsdHeader.version es la versión cruda del contenedor PSD (1 para PSD, 2 para PSB) — esta es una propiedad diferente de la no relacionada PsdImage.version, que es un número de versión API fijo, no un valor de formato de archivo.

from aspose_psd_foss.psdimage import PsdImage

image = PsdImage.load(input_path)
header = image.header

print(f"Size: {header.width}x{header.height}, channels: {header.channels}")
print(f"Bit depth: {header.bit_depth}, raw container version: {header.version}")
print(f"Is PSB: {header.is_large_document}")

Inspeccionando la sección de datos de color

PsdImage.color_data_info devuelve un resumen PsdColorDataInfo; kind es un valor PsdColorDataKind (NONE, INDEXED_PALETTE, RGB_PAYLOAD, CMYK_PAYLOAD o RAW_PRESERVED).

if image.has_color_mode_data:
    color_info = image.color_data_info
    print(f"Color data kind: {color_info.kind}, raw bytes: {color_info.raw_data_length}")

Inspeccionando la sección de datos de imagen

PsdImage.image_data_info devuelve un resumen PsdImageDataInfo que describe cómo se codifican los datos de píxeles combinados; image.compression informa de la misma codificación mediante un enum CompressionMethod separado.

data_info = image.image_data_info
print(f"Compression: {image.compression}, data kind: {data_info.kind}")
print(f"Uses prediction: {data_info.uses_prediction}")

Inspección de la sección de recursos de imagen

PsdImage.resources, resource_count, y has_image_resources superficie los contenidos de la sección de recursos de imagen. Ver Resources para los recursos completos API.

print(f"Resource count: {image.resource_count}")

Consejos y mejores prácticas

  • PsdHeader y sus resúmenes de sección relacionados (PsdColorDataInfo, ColorData, PsdImageDataInfo) son de solo lectura en esta compilación FOSS — no hay setters públicos en ninguna de sus propiedades.
  • No confunda PsdHeader.version (la verdadera versión del contenedor PSD/PSB) con PsdImage.version (un número de versión API fijo y no relacionado que siempre es 6).
  • Verifique image.has_color_mode_data antes de leer color_data_info — un documento sin datos de modo de color aún devuelve un objeto de resumen, pero sus campos pueden no ser significativos.

Problemas comunes

ProblemaCausaSolución
header.color_mode no coincide con image.color_modePsdHeader.color_mode es el campo entero crudo del archivo; PsdImage.color_mode es el enum ColorModes fuertemente tipado construido a partir de élUtilice image.color_mode para un valor tipado; utilice header.color_mode solo si necesita el entero sin procesar
color_data_info.indexed_palette es NoneEl tipo de datos de color del documento no es INDEXED_PALETTESolo los documentos con color indexado llevan una paleta — verifique color_data_info.kind primero

FAQ

¿Puedo modificar directamente las secciones de encabezado, datos de color o datos de imagen?

No — PsdHeader, PsdColorDataInfo, ColorData y PsdImageDataInfo son todos objetos de resumen de solo lectura en esta compilación FOSS.

¿Cuál es la diferencia entre image.compression y image.image_data_info.kind?

Describen la misma codificación subyacente mediante dos enums separados: image.compression devuelve un valor CompressionMethod, mientras que image.image_data_info.kind devuelve un valor ImageDataKind.

API Reference Resumen

Clase/MétodoDescripción
PsdImage.headerResumen del encabezado del documento (PsdHeader)
PsdImage.color_data_info / parsed_color_dataResumen de la sección de datos de color (PsdColorDataInfo / ColorData)
PsdImage.image_data_info / image_data_kind / compressionResumen de la sección de datos de imagen
PsdImage.resources / resource_count / has_image_resourcesResumen de la sección de recursos de imagen

Ver también

 Español