Como adicionar uma moldura a uma imagem

Quando usar uma moldura configurável

Uma moldura acrescenta uma margem visual à imagem e pode ajudar a separá-la do fundo numa composição. A ferramenta Image Border recebe os dados da imagem numa cadeia de texto em base64 e permite ajustar a largura e a cor do rebordo. O resultado bem-sucedido inclui a imagem processada, também em texto base64, além das dimensões original e resultante. Assim, pode preparar a entrada, definir o aspeto da margem e confirmar a alteração através dos dados devolvidos, sem confundir as opções escolhidas com a própria imagem final. Antes de começar, tenha disponível uma representação base64 que corresponda a uma imagem descodificável. A cadeia não deve ficar vazia, porque esse caso faz o processamento falhar. A ferramenta é adequada quando precisa de acrescentar uma margem configurável aos dados de uma imagem e pretende conservar informação sobre o tamanho antes e depois da operação. A largura e a cor são independentes, pelo que pode manter a largura predefinida e mudar apenas o tom, ou alterar os dois valores para obter uma moldura mais discreta ou mais evidente.

Passos para criar o rebordo

1. Prepare a entrada. Obtenha os dados da imagem como uma cadeia em base64. Verifique se existe conteúdo e se a cadeia representa uma imagem que possa ser descodificada; uma entrada vazia não produz um processamento bem-sucedido.

2. Introduza a imagem. Cole a cadeia no campo destinado aos dados da imagem. Evite substituir a entrada por um nome de ficheiro ou por texto que não contenha a representação base64 da imagem.

3. Defina a largura. Indique a largura pretendida para a moldura. Quando não fornecer outro valor, será usada a largura predefinida de 10, que é encaminhada para a operação de criação do rebordo tal como foi fornecida.

4. Escolha a cor. Pode indicar a cor com seis caracteres hexadecimais, com ou sem o símbolo #. Esses seis caracteres são interpretados pela ordem vermelho, verde e azul. Se não escolher outra cor, será aplicado #000000.

5. Inicie o processamento. Execute a operação depois de rever a entrada, a largura e a cor. Se decorrer com sucesso, consulte o texto base64 da imagem com moldura e as dimensões original e resultante.

6. Considere o formato. Quando o formato original estiver disponível, o resultado é guardado nesse formato. Se essa informação não estiver disponível, o resultado é guardado como PNG. Use essa indicação para tratar corretamente a imagem devolvida na etapa seguinte.

Leitura do resultado e dos limites

Comece por comparar as dimensões original e resultante apresentadas no retorno. Essa comparação ajuda a verificar o efeito da moldura, enquanto o texto base64 devolvido corresponde à imagem processada e não apenas às definições de cor e largura. Se precisar de reconstruir ou encaminhar a imagem, mantenha em consideração o formato indicado: a informação original é conservada quando está disponível e, na sua ausência, deve esperar um resultado em PNG. Uma operação sem sucesso não confirma que a imagem tenha sido alterada. Reveja primeiro se a entrada contém dados base64 de uma imagem descodificável, pois uma cadeia vazia, inválida ou ilegível pode impedir o processamento. Examine também a cor e a largura introduzidas. Uma cor fora da estrutura hexadecimal suportada, uma largura inadequada, dados que não representem uma imagem ou outra exceção podem produzir um resultado sem processamento concluído. O retorno deve ser lido como a combinação de três elementos: a imagem em base64, as dimensões e a indicação do formato aplicável. Se faltar a imagem codificada ou alguma dimensão, trate o resultado como incompleto e corrija os dados de entrada antes de repetir a operação.

Exemplo prático

Está a preparar uma fotografia para uma composição e quer acrescentar uma margem azul de 20 unidades sem usar a cor preta predefinida.

Para uma fotografia representada em base64, indique uma largura de 20 e uma cor azul formada por seis caracteres hexadecimais, execute o processamento e consulte os dados devolvidos antes de usar a imagem resultante. A moldura será definida pelas opções fornecidas, em vez da largura e cor predefinidas.

O retorno contém texto base64 correspondente à imagem com moldura, as dimensões original e resultante e o formato original quando disponível, ou PNG na sua ausência.

Limitações

• Dados vazios, inválidos ou ilegíveis, cores hexadecimais inadequadas, larguras inválidas e outras exceções podem impedir o processamento da imagem.

Erros comuns

• Uma entrada vazia ou uma cor que não contenha seis caracteres hexadecimais válidos pode impedir o processamento. Forneça dados base64 de uma imagem descodificável e reveja a cor antes de executar novamente.

Perguntas frequentes

Que entrada devo fornecer para a imagem?

A entrada deve conter dados de imagem numa cadeia base64 descodificável. Se o campo ficar vazio, o processamento falha, mesmo que a entrada esteja prevista como opcional na definição da ferramenta. Verifique o conteúdo antes de executar.

Qual é a largura predefinida da moldura?

Se não indicar outra largura, é aplicada a predefinição de 10. Também pode fornecer um valor diferente, que será encaminhado para a operação de criação do rebordo conforme foi introduzido. Confirme esse valor antes do processamento.

Como indicar a cor do rebordo?

Sem uma escolha diferente, a cor usada é #000000. Para mudar o resultado, forneça seis caracteres hexadecimais, com ou sem #; a leitura segue a ordem vermelho, verde e azul. Uma cor fora dessa estrutura pode causar falha.