Perfis de exportação

Um perfil de exportação agrupa, sob um único nome, um formato de ficheiro, 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 pela aplicação, pela linha de comandos, pela API local, pelos Atalhos e pelas pastas monitorizadas. Assim, deixa de repetir as mesmas definições em cada script.

Criar um perfil

1. Abra Definições (⌘,) 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 na aplicação

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 as definições 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 predefinido

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

Este mecanismo serve sobretudo a ação «Comprimir imagens» do Spotlight invocada pela sua frase genérica, sem qualquer atalho construído à mão. Essa invocação direta não transporta nenhum parâmetro além dos ficheiros selecionados, pelo que depende inteiramente do perfil predefinido para o formato, a qualidade e a pasta de destino. Consulte o guia Atalhos e AppleScript para o percurso completo.

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

Onde são guardados os perfis

Os perfis são guardados num único ficheiro, partilhado pela aplicação, 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 mesmas definições.

1. Crie o perfil Web JPEG: formato JPEG, qualidade 70, destino ~/Sites/media.
2. Na aplicação, 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 as definições.

# 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