Guia de referência do parser de Photoshop PSD.rb

[!NOTE] Biblioteca Arquivada: O PSD.rb é um parser Ruby independente para arquivos .psd do Photoshop.

O PSD.rb converte arquivos PSD em objetos Ruby estruturados sem exigir o Adobe Photoshop.

Abertura e Parsing

require 'psd'

psd = PSD.new('design.psd', parse_layer_images: true)
psd.parse!

---

Navegação na Árvore de Camadas

# Nó raiz do documento
node = psd.tree

# Helpers de travessia
node.root
node.descendants
node.ancestors
node.siblings
node.subtree

# Filtrar por tipo de camada
groups = node.descendant_groups
layers = node.descendant_layers

---

Propriedades da Camada

layer = node.children.first

layer.name         # => "Header Background"
layer.top          # => 0 (Y coordinate)
layer.left         # => 0 (X coordinate)
layer.width        # => 1440
layer.height       # => 800

layer.visible?     # => true
layer.hidden?      # => false
layer.layer?       # => true
layer.group?       # => false

layer.blending_mode # => "normal", "multiply", etc.
layer.opacity       # => 0..255 (divide by 255 for CSS opacity)

---

Extração de Texto e Tipografia

if layer.text
  puts layer.text[:value]             # Conteúdo de texto
  puts layer.text[:font][:name]       # Nome da família da fonte (ex: 'Helvetica')
  puts layer.text[:font][:sizes]      # Tamanhos de fonte utilizados
  puts layer.text[:font][:colors]     # Arrays de cores RGBA
  puts layer.text[:font][:css]        # Definição de fonte CSS pré-calculada
end

---

Exportando Imagens de Camadas

# Salvar imagem da camada como PNG
layer.image.save_as_png("layer_#{layer.name}.png")

---

Referências

• layervault/psd.rb no GitHub