Como rodar páginas de um PDF por ângulo

Quando usar o rotador de PDF

Este rotador permite ajustar a orientação de um PDF sem alterar a inclusão das restantes páginas no ficheiro de saída. Pode rodar o documento inteiro ou indicar páginas individuais, definir o ângulo pretendido e obter um novo PDF codificado em base64. O ângulo predefinido é 90 graus, mas também pode fornecer outros valores, que são normalizados antes da rotação.

Como rodar páginas de um PDF

1. Prepare o ficheiro PDF e forneça-o como dados codificados em base64. Sem um ficheiro, a operação falha.

2. Indique o ângulo de rotação. Se não definir este valor, será usado 90 graus. O valor fornecido é reduzido por módulo 360; por exemplo, 450 graus equivale a 90 graus.

3. Escolha as páginas. Se não indicar uma seleção, todas as páginas são rodadas. Para rodar apenas algumas, escreva números de página individuais, separados por vírgulas, como 2,5,8. A numeração começa em 1.

4. Confirme a operação. Numa seleção específica, números dentro do intervalo são considerados, números fora do intervalo são ignorados e uma página repetida conta apenas uma vez. As páginas não selecionadas continuam incluídas no PDF resultante, mas mantêm a orientação original.

5. Recolha o resultado devolvido. Quando a operação termina com sucesso, recebe um PDF em base64, o ângulo normalizado e a contagem total de páginas e de páginas rodadas. Um token que não seja um número inteiro, como parte de uma seleção, pode fazer a operação falhar; use apenas números de página individuais separados por vírgulas.

Como interpretar o resultado

Comece por verificar o ângulo normalizado e as duas contagens devolvidas. A contagem total representa as páginas presentes no PDF de saída; a contagem de páginas rodadas mostra quantas foram efetivamente selecionadas para rotação. Assim, uma seleção parcial não elimina as restantes páginas: apenas deixa de lhes aplicar a rotação.

Se o resultado não for devolvido, confirme primeiro se foi fornecido um ficheiro PDF válido e se a codificação base64 pode ser lida. A operação também pode falhar durante a leitura, a seleção, a rotação ou a escrita do PDF. Uma falha pode ainda ocorrer se a dependência necessária para processar PDF não estiver disponível. O ambiente declara não ter acesso à rede, mas essa informação não determina onde o ficheiro é processado nem estabelece regras de armazenamento ou privacidade.

Exemplo prático

Precisa de corrigir a orientação das páginas 2 e 5 de um PDF com 6 páginas sem retirar as outras páginas.

Forneça um PDF com 6 páginas, indique o ângulo 450 e use a seleção 2,2,5. A página repetida conta uma vez; as páginas 2 e 5 são rodadas e as restantes permanecem no ficheiro.

O resultado deve conter um PDF em base64, ângulo normalizado de 90 graus, total de 6 páginas e 2 páginas rodadas.

Limitações

• A seleção documentada não inclui intervalos nem tokens não inteiros; a operação pode falhar sem ficheiro, durante o processamento do PDF ou quando a dependência necessária não está disponível. O acesso à rede é declarado como falso, sem implicar condições de armazenamento ou privacidade.

Erros comuns

• Um erro frequente é escrever um intervalo ou incluir um token não inteiro, como 2-5 ou página 3, quando a seleção aceita números de página individuais separados por vírgulas. Corrija a entrada para um formato como 2,3,4,5; números fora do intervalo podem ser ignorados, mas um token não inteiro pode fazer a operação falhar.

Perguntas frequentes

Posso rodar todas as páginas ou apenas algumas?

Sim, se não fornecer uma seleção de páginas, todas as páginas são rodadas. Se indicar números separados por vírgulas, apenas as páginas válidas e selecionadas recebem a rotação, enquanto as restantes continuam no PDF.

Que ângulos posso indicar?

O valor predefinido é 90 graus. Outros valores também podem ser fornecidos, porque o ângulo é reduzido por módulo 360 antes da rotação; por exemplo, 450 torna-se 90.

As páginas que não selecionei desaparecem do resultado?

Não. A saída inclui um PDF em base64, o ângulo normalizado e contagens do total de páginas e das páginas rodadas. As páginas não selecionadas continuam incluídas no PDF.