Como ajustar o brilho de uma imagem com um fator numérico

Para que serve o ajuste de brilho

Esta ferramenta ajusta o brilho de dados de imagem fornecidos em texto codificado em base64. É útil quando já tem os dados de uma imagem e pretende pedir um ajuste numérico, sem indicar um fator se quiser usar o valor predefinido. O resultado bem-sucedido continua a ser texto codificado em base64, para poder ser tratado posteriormente como dados de imagem.

Como ajustar o brilho passo a passo

1. Prepare dados de imagem não vazios em texto base64. A codificação deve poder ser descodificada para bytes de uma imagem; texto vazio ou uma cadeia que não corresponda a uma imagem não constitui uma entrada válida.

2. Introduza esses dados no campo destinado à imagem. Não substitua o conteúdo por um nome de ficheiro ou por texto arbitrário: a entrada esperada é o próprio texto codificado.

3. Se necessário, indique um fator de brilho numérico entre 0,0 e 3,0, incluindo os limites. Quando não indicar o fator, é usado o valor predefinido de 1,5.

4. Inicie o processamento e aguarde o resultado. Se a operação for concluída, copie os dados de imagem devolvidos em base64 para o passo seguinte do seu fluxo. Se precisar de verificar o ficheiro produzido, descodifique o resultado como imagem e confirme as suas propriedades.

Como ler o resultado e reconhecer os limites

Um resultado bem-sucedido é novamente constituído por dados de imagem codificados em base64, e não por uma pré-visualização descrita em texto. A imagem mantém as dimensões da origem. Quanto ao formato, é guardado no formato da imagem de origem quando este está disponível; caso contrário, é usado PNG.

O fator é uma entrada numérica para o ajuste, com processamento limitado ao intervalo de 0,0 a 3,0. Esse intervalo não garante um determinado nível de luminosidade, qualidade visual ou compatibilidade com todas as codificações de imagem. Se não houver suporte para imagens, se os dados estiverem vazios ou se ocorrer um problema ao descodificar, abrir, ajustar ou guardar a imagem, o processamento pode falhar. Nessa situação, reveja primeiro os dados fornecidos e o fator utilizado.

Exemplo prático

Tem uma imagem PNG válida codificada em base64 e pretende processá-la com um fator de brilho de 2,0.

Introduza os dados base64 válidos dessa imagem e indique o fator numérico 2,0. Depois, descodifique o texto devolvido para confirmar as dimensões e o formato.

O resultado esperado, se o processamento for bem-sucedido, é texto base64 correspondente a uma imagem com as mesmas dimensões da origem; sendo a origem PNG, o formato PNG é mantido.

Limitações

• O intervalo de 0,0 a 3,0 é um limite de processamento do fator, não uma garantia sobre a luminosidade obtida ou a qualidade visual.
• O processamento pode falhar quando o suporte para imagens não está disponível ou quando há um problema ao descodificar, abrir, ajustar ou guardar os dados.

Erros comuns

• Uma causa frequente de falha é fornecer texto vazio ou uma cadeia que não descodifica para bytes de uma imagem. Corrija-o fornecendo dados base64 não vazios e verificando se representam uma imagem antes de iniciar o processamento.

Perguntas frequentes

Posso ajustar o brilho sem indicar um fator?

Quando o fator não é indicado, é usado o valor predefinido de 1,5. Se indicar um valor, mantenha-o entre 0,0 e 3,0.

O que recebo depois do ajuste?

Quando a operação é concluída com sucesso, recebe dados de imagem ajustados em base64. As dimensões da origem são preservadas e o formato de origem é mantido quando disponível; caso contrário, o resultado é guardado como PNG.

Porque pode falhar o processamento da imagem?

Quando os dados estão vazios, não descodificam para uma imagem ou ocorre um problema ao abrir, ajustar ou guardar, o processamento falha. Forneça dados base64 não vazios que representem uma imagem e confirme o fator indicado.