Scripting no Adobe Illustrator

Orientação especializada para automatizar o Adobe Illustrator através do ExtendScript (JavaScript/JSX). Esta habilidade abrange o modelo de objetos de scripting do Illustrator, todos os principais objetos da API, padrões de código e melhores práticas para escrever scripts de qualidade .jsx para produção.

Recursos Incluídos

• references/object-model-quick-reference.md: Use este como uma consulta rápida para o modelo de objetos de scripting do Illustrator, tipos comuns de documentos e itens de página, e conceitos relacionados do DOM ao escrever ou depurar scripts.
• scripts/: Contém scripts de automação de exemplo do Illustrator que você pode usar como pontos de partida ou padrões de implementação para tarefas comuns, como manipulação de documentos, exportações, processamento em lote e uso do DOM. Revise e adapte esses exemplos quando precisar de padrões JSX funcionais ou quiser comparar o comportamento durante a depuração.

Quando Usar Esta Habilidade

• Escrever novos scripts de automação do Illustrator (arquivos .jsx ou .js)
• Depurar ou corrigir código ExtendScript existente do Illustrator
• Manipular documentos, camadas, itens de página, caminhos, texto ou cores programaticamente
• Processar em lote arquivos do Illustrator ou gerar arte a partir de dados
• Exportar documentos para vários formatos (PDF, SVG, PNG, EPS, etc.)
• Trabalhar com o DOM do Illustrator (Application, Document, Layer, PathItem, TextFrame, etc.)
• Criar gráficos orientados por dados usando variáveis e conjuntos de dados
• Automatizar fluxos de trabalho de impressão com opções de impressão scriptadas

Pré-requisitos

• Adobe Illustrator CC ou posterior instalado
• Conhecimento básico de JavaScript (ExtendScript é baseado em ES3 com extensões da Adobe)
• Scripts são executados via Arquivo > Scripts > Outros Scripts, o menu Scripts, ou colocados na pasta Scripts de Inicialização
• O ExtendScript Toolkit (ESTK) ou qualquer editor de texto pode ser usado para escrever arquivos .jsx

Ambiente de Scripting

Linguagem e Extensões de Arquivo

Esta habilidade foca em ExtendScript/JavaScript como a opção multiplataforma mais amplamente utilizada.

Executando Scripts

• Menu Scripts: Arquivo > Scripts lista scripts da pasta de scripts da aplicação
• Outros Scripts: Arquivo > Scripts > Outros Scripts para navegar e executar qualquer arquivo .jsx
• Scripts de Inicialização: Coloque scripts na pasta Scripts de Inicialização para executar automaticamente ao iniciar
• Diretiva Target: Comece scripts com #target illustrator ao executar a partir do ESTK ou ferramentas externas
• Diretiva #targetengine: Use #targetengine "session" para persistir variáveis entre execuções de script
• Invocação externa: Scripts são frequentemente iniciados de fora do Illustrator — por scripts de shell, gerenciadores de tarefas, trabalhos de CI, ExtendScript Toolkit (ExtendScript Toolkit.exe -run script.jsx), ou mensagens BridgeTalk de outros aplicativos da Adobe. Veja Invocação Externa e Passagem de Argumentos.

Convenções de Nomenclatura (JavaScript)

• Objetos e propriedades usam camelCase: activeDocument, pathItems, textFrames
• O global app referencia o objeto Application
• Índices de coleção são baseados em zero: documents[0] é o documento mais à frente
• Use a propriedade typename para identificar tipos de objetos em tempo de execução

Visão Geral do Modelo de Objetos

O DOM do Illustrator segue uma hierarquia de contenção estrita:

Application (app)
├── activeDocument / documents[]
│   ├── layers[]
│   │   ├── pageItems[] (all artwork)
│   │   ├── pathItems[]
│   │   ├── compoundPathItems[]
│   │   ├── textFrames[]
│   │   ├── placedItems[]
│   │   ├── rasterItems[]
│   │   ├── meshItems[]
│   │   ├── pluginItems[]
│   │   ├── graphItems[]
│   │   ├── symbolItems[]
│   │   ├── nonNativeItems[]
│   │   ├── legacyTextItems[]
│   │   └── groupItems[]
│   ├── artboards[]
│   ├── views[]
│   ├── selection (array of selected items)
│   ├── swatches[], spots[], gradients[], patterns[]
│   ├── graphicStyles[], brushes[], symbols[]
│   ├── textFonts[] (via app.textFonts)
│   ├── stories[], characterStyles[], paragraphStyles[]
│   ├── variables[], datasets[]
│   └── inkList[], printOptions
├── preferences
├── printerList[]
└── textFonts[]

Objetos de Nível Superior

• Application (app): O objeto raiz. Fornece acesso a documentos, preferências, fontes e impressoras. Propriedades chave: activeDocument, documents, textFonts, printerList, userInteractionLevel, version.

…