Recadrer des pages PDF et calculer leurs dimensions

Il vérifie aussi que chaque rectangle reste dans les limites de sa page source, afin de détecter une géométrie incorrecte avant son envoi à une bibliothèque PDF, un flux d’impression ou une chaîne documentaire. Le calcul est déterministe et accepte plusieurs formats de page dans une même requête.

Décrivez chaque page et chaque zone en points PDF

Une page PDF se mesure en points, à raison de 72 points par pouce. Pour chaque page, renseignez sa largeur et sa hauteur d’origine, puis définissez le rectangle avec crop_x, crop_y, crop_width et crop_height. La coordonnée x part du bord gauche et la coordonnée y du bord inférieur, conformément au repère habituel des PDF. La largeur et la hauteur de la zone représentent la partie qui restera visible, et non des marges à soustraire. Par exemple, une page Lettre américaine mesure généralement 612 sur 792 points. Une zone commençant à 36, 54 et mesurant 540 sur 684 tient dans cette page et donne un résultat de 540 sur 684 points. Placez les pages dans l’ordre du document. La réponse les numérote selon cet ordre, ce qui permet de rattacher facilement la géométrie calculée à un rapport d’analyse ou à une opération ultérieure. Une requête peut mêler orientations portrait, paysage et formats personnalisés.

Comprenez les contrôles des limites

Toutes les dimensions d’origine et toutes les composantes de la zone doivent être des nombres finis. La largeur et la hauteur de la page comme celles du recadrage doivent être strictement positives. Les coordonnées d’origine peuvent être nulles, mais jamais négatives. Le calculateur contrôle le bord droit en additionnant crop_x et crop_width, puis en comparant le résultat à la largeur d’origine. Il contrôle le bord supérieur de la même manière avec crop_y, crop_height et la hauteur d’origine. Si l’un de ces bords dépasse la page source, la requête échoue avec une erreur d’entrée incorrecte qui précise la page concernée. En revanche, une zone peut toucher exactement un bord extérieur : terminer à la largeur ou à la hauteur de la page reste valide. Ce contrôle est essentiel, car un rectangle aux dimensions plausibles peut tout de même être décalé hors de la page par son origine. Toutes les pages sont vérifiées et une seule page incorrecte empêche la production d’un résultat partiel ambigu.

Intégrez les dimensions à votre traitement PDF

Le résultat indique, pour chaque page, le format d’origine, l’origine du recadrage ainsi que la nouvelle largeur et la nouvelle hauteur. Il ne réécrit ni ne téléverse le PDF : il calcule et valide la géométrie qu’un éditeur ou une bibliothèque PDF pourra ensuite appliquer. Cette séparation facilite la prévisualisation, le contrôle de réglages saisis par des utilisateurs, l’estimation d’une mise en page ou la normalisation des instructions avant une opération documentaire coûteuse. Pour obtenir des pouces, divisez les valeurs par 72 ; conserver les points pendant le traitement évite toutefois les arrondis. Si plusieurs pages partagent un format et une règle, répétez leurs valeurs afin que la sortie reste explicitement alignée sur l’ordre du document. Avant l’application, vérifiez si votre bibliothèque attend x, y, largeur et hauteur, ou gauche, bas, droite et haut. Dans ce dernier cas, la droite vaut crop_x plus new_width et le haut crop_y plus new_height. L’API coûte $0.002 par requête.