Como aplicar filtros artísticos a uma imagem

Forneça os dados da imagem em base64 e escolha um filtro artístico reconhecido. Se não indicar um filtro, será aplicado emboss; em caso de sucesso, receberá a imagem filtrada em base64, o nome do filtro e as dimensões.

O que pode fazer com os filtros de imagem

O Image Filters aplica um filtro artístico aos dados de uma imagem fornecida e devolve os dados da imagem processada quando a operação é concluída com sucesso. É útil para preparar uma imagem com um efeito visual como desfoque, contorno, relevo ou nitidez, sem alterar o objetivo principal do ficheiro original.

A imagem deve ser enviada como dados codificados em base64. O nome do filtro é opcional: quando não indicar um, é usado emboss. Para escolher um efeito diferente, forneça um dos nomes reconhecidos pelo serviço. A operação começa por descodificar os dados e abrir a imagem; por isso, uma cadeia que não corresponda a uma imagem válida pode não ser processada.

Como aplicar um filtro a uma imagem

1. Prepare os dados da imagem em base64. Confirme que não estão vazios e que representam uma imagem que possa ser descodificada e aberta.

2. No controlo destinado aos dados da imagem, forneça a cadeia em base64. Sem dados de imagem, o processamento falha.

3. Escolha um filtro, se não quiser utilizar o predefinido. Os nomes reconhecidos são blur, contour, detail, edge_enhance, edge_enhance_more, emboss, find_edges, sharpen, smooth e smooth_more. Respeite a grafia destes nomes. Se deixar o filtro em branco, a escolha será emboss.

4. Inicie o processamento e aguarde pelo resultado. Quando a operação é bem-sucedida, recebe os dados da imagem filtrada codificados em base64, o nome do filtro selecionado e as dimensões da imagem.

5. Utilize os dados devolvidos para guardar ou apresentar a imagem. O formato usado é o formato de imagem disponível depois do processamento; quando esse formato não está disponível, é utilizado PNG. No caso de emboss aplicado a uma imagem que não esteja em RGB, a conversão para RGB pode remover os metadados do formato original e levar ao uso de PNG.

Como interpretar o resultado

Um resultado bem-sucedido deve incluir três elementos: os novos dados da imagem em base64, o nome do filtro escolhido e as dimensões da imagem. Os dados devolvidos representam a versão processada, mas o serviço não estabelece um resultado visual específico nem uma garantia sobre a qualidade do efeito.

Se a operação não for bem-sucedida, verifique primeiro se os dados foram fornecidos e se não estão vazios. Depois, confirme o nome do filtro e a validade da imagem codificada. Também pode ocorrer uma falha durante a descodificação, a abertura, a aplicação do filtro ou a gravação. A ausência do suporte necessário para processar imagens produz igualmente um resultado malsucedido.

O resultado pode usar um formato diferente do original, sobretudo quando emboss é aplicado a uma imagem que não esteja em RGB. Consulte o formato efetivamente produzido antes de decidir como o vai guardar ou apresentar.

Exemplo prático

Uma pessoa quer realçar a nitidez de uma fotografia antes de a apresentar.

Para uma fotografia convertida em base64, forneça os dados, selecione sharpen e inicie o processamento; depois, verifique os três elementos devolvidos antes de guardar a imagem.

O resultado bem-sucedido apresenta dados da imagem filtrada em base64, o nome do filtro escolhido e as dimensões da imagem.

Limitações

• O processamento falha sem dados de imagem, com um filtro não reconhecido ou quando ocorre um problema ao descodificar, abrir, filtrar ou guardar a imagem.
• O formato de saída depende do formato disponível após o processamento; em determinadas aplicações de emboss, pode ser usado PNG.

Erros comuns

• Um erro frequente é enviar dados vazios, uma imagem inválida ou um nome de filtro fora da lista reconhecida. Corrija-o fornecendo dados de imagem em base64 que possam ser abertos e selecionando um dos nomes suportados, ou deixe o filtro em branco para usar emboss.

Perguntas frequentes

Posso aplicar um filtro a qualquer imagem?

Sim, desde que os dados da imagem não estejam vazios, sejam descodificados corretamente e possam ser abertos e processados. Uma cadeia inválida ou uma falha durante o processamento produz um resultado malsucedido.

Que filtro é aplicado quando não escolho nenhum?

Se não indicar um filtro, é usado emboss. Para escolher outro efeito, utilize um dos nomes reconhecidos, como blur, sharpen ou smooth_more.

O que recebo depois de aplicar o filtro?

O resultado bem-sucedido inclui a imagem filtrada em base64, o nome do filtro selecionado e as dimensões da imagem. O formato pode ser o disponível após o processamento ou PNG quando não houver outro formato disponível.