Perfis de exportação

Um perfil de exportação agrupa, sob um único nome, um formato de arquivo, um nível de qualidade e uma pasta de destino.

É a base comum de todas as automatizações do JPGBoost. Configura um perfil uma única vez e depois pode reutilizá-lo em qualquer lugar onde seja necessária uma exportação.

Para que serve um perfil

Um perfil de exportação tem um nome e guarda três informações:

• um formato de saída (PNG, JPEG, HEIC, AVIF, WebP ou JPEG XL);
• uma qualidade de 1 a 100;
• uma pasta de destino, opcional.

Uma vez criado, este perfil é reconhecido pelo aplicativo, pela linha de comandos, pela API local, pelos Atalhos e pelas pastas monitorizadas. Assim, deixa de repetir as mesmos ajustes em cada script.

Criar um perfil

1. Abra Ajustes (⌘,) e depois o separador Perfis.
2. Crie um novo perfil e dê-lhe um nome claro, por exemplo Web JPEG ou Entrega ao cliente.
3. Escolha o formato de saída e a qualidade.
4. Se quiser, selecione uma pasta de destino com o seletor nativo.
5. Guarde. O perfil fica imediatamente disponível em todo o lado.

Aplicar um perfil no aplicativo

A barra de ferramentas da janela principal oferece um menu de perfis. Aplica o formato e a qualidade do perfil ao lote atual, e mostra sempre o nome do perfil aplicado.

Reutilizar um perfil noutro local

O mesmo perfil pode ser invocado pelo nome a partir de cada ponto de entrada:

Regra de prioridade

Um perfil de exportação completa apenas os ajustes em falta. Qualquer valor definido explicitamente tem prioridade sobre o do perfil. Esta regra aplica-se em todo o JPGBoost.

# O perfil fornece o formato, a qualidade e a pasta
jpgboost-cli --profile "Web JPEG" *.png

# Aqui, --output prevalece sobre a pasta do perfil
# (o formato e a qualidade do perfil continuam a aplicar-se)
jpgboost-cli --profile "Web JPEG" --output ./outra-pasta *.png

Para as pastas monitorizadas, a regra é ligeiramente diferente: a pasta de destino configurada na pasta monitorizada prevalece sempre sobre a do perfil.

Perfil padrão

Apenas um perfil de cada vez pode ser marcado como padrão, a partir de Ajustes → Perfis. É o que o JPGBoost aplica quando nenhum perfil é indicado, uma situação diferente da regra de prioridade acima, que pressupõe que um perfil já foi indicado explicitamente.

Esse mecanismo serve sobretudo a ação «Comprimir imagens» do Spotlight invocada pela sua frase genérica, sem nenhum atalho construído manualmente. Essa invocação direta não carrega nenhum parâmetro além dos arquivos selecionados, e por isso depende inteiramente do perfil padrão para o formato, a qualidade e a pasta de destino. Consulte o guia Atalhos e AppleScript para o passo a passo completo.

O mesmo mecanismo beneficia a linha de comandos sem --profile, o AppleScript sem um parâmetro profile, e uma pasta monitorada sem perfil próprio.

Onde são guardados os perfis

Os perfis são guardados num único arquivo, partilhado pelo aplicativo, pela CLI e pela API:

~/Library/Application Support/JPGBoost/exportProfiles.json

É esta partilha que permite que um perfil criado na interface fique imediatamente disponível num script, e vice-versa.

Exemplo completo

Objetivo: entregar todas as semanas imagens otimizadas para a web, sempre na mesma pasta e com as mesmos ajustes.

1. Crie o perfil Web JPEG: formato JPEG, qualidade 70, destino ~/Sites/media.
2. No aplicativo, aplique-o a um lote a partir da barra de ferramentas para verificar visualmente o resultado.
3. Uma vez satisfeito, invoque-o a partir de um script sem precisar de repetir os ajustes.

# Linha de comandos: nada a repetir, tudo vem do perfil
jpgboost-cli --profile "Web JPEG" ~/Imagens/semana-12/*.png

# API local: aplicar o perfil e depois exportar para a sua pasta
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile": "Web JPEG"}' \
  http://127.0.0.1:51823/v1/export