Convertisseur mégapixels

Les noms d’unité inconnus échouent avec une erreur invalid_input claire plutôt qu’avec des facteurs silencieux erronés. Photographes comparant les mégapixels du boîtier à des cadres réels de 4000 par 3000, équipes produit dimensionnant des pipelines d’image, enseignants présentant les facteurs SI mega et clients API normalisant des champs de résolution mixtes partagent le même chemin déterministe.

Quelles unités de résolution sont prises en charge et comment fonctionne la conversion

Lorsque la cible est dimensions, largeur et hauteur sont récupérées à partir du total et d’un rapport d’aspect : la largeur égale la racine carrée du total fois aspect_w sur aspect_h, et la hauteur égale le total divisé par la largeur, avec un cadre seize par neuf par défaut si vous omettez aspect_w et aspect_h. Des alias courants sont acceptés sans distinction de casse : mp, mpx et megapixel pour les mégapixels ; px, pixel count et total pixels pour les pixels ; kp et kpx pour les kilopixels ; gp et gpx pour les gigapixels ; et wxh, width x height et resolution pour dimensions. Si le nom n’est pas dans cette liste, le solveur rejette la requête avec invalid_input en nommant le mauvais champ et en listant les unités prises en charge, afin que les clients ne devinent jamais si une faute de frappe a produit un mauvais nombre. Les zéros et les valeurs négatives sont rejetés car les comptages de pixels et les notes en mégapixels ne sont pas des quantités signées ; la magnitude absolue doit rester dans la limite publiée d’un billion afin que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur.

Comment appeler l’API et lire la réponse

Branchez ceci dans des outils de comparaison d’appareils, des pipelines d’actifs média, des fiches pédagogiques ou des lots qui détiennent déjà une lecture de résolution et n’ont besoin que d’une seconde représentation pour l’affichage ou le stockage sans embarquer des tables de conversion dans chaque binaire d’application. Envoyez un corps JSON avec l’unité cible dans to (alias to_unit, unit_to et target) et soit une lecture scalaire, soit une paire largeur par hauteur. En mode scalaire, fournissez value (alias amount, quantity, n et mp) et optionnellement from (alias from_unit, unit_from et source) ; lorsque from est omis et que value est présent, la source par défaut est megapixels. En mode dimensions, fournissez width et height positifs (alias width_px, w, w_px et height_px, h, h_px) ; from peut être dimensions ou omis. Lorsque to est dimensions, aspect_w et aspect_h optionnels (défaut seize et neuf) contrôlent la forme du cadre récupéré. Value, width, height et les parties d’aspect doivent être des nombres finis positifs ou des chaînes numériques strictes dans la limite absolue d’un billion. En cas de succès, la réponse renvoie une value arrondie, des libellés canoniques from et to, result comme magnitude principale convertie, total_pixels, megapixels, kilopixels et gigapixels pour chaque requête, unit comme libellé cible, formula et message comme résumés en anglais de la logique, steps comme lignes de substitution ordonnées, et supported_units avec les cinq identifiants canoniques. Lorsque des dimensions sont en entrée ou en sortie, width, height, aspect_w et aspect_h apparaissent aussi. Une validation échouée—champs manquants, nombres non finis, valeurs non positives, valeurs hors limites absolues ou nom d’unité inconnu—renvoie invalid_input et n’est jamais facturée. Le tarif est un forfait de $0.002 par requête réussie avec l’unité item.

Conseils pratiques, limites et quand utiliser cette page

Préférez envoyer des nombres nus pour value, width et height lorsque vous contrôlez le client ; les chaînes numériques ne sont acceptées que si elles correspondent à un motif numérique fini strict sans symboles monétaires ni séparateurs de milliers. Normalisez les libellés d’affichage de votre côté si vous avez besoin d’orthographes locales : cette API renvoie toujours les jetons canoniques courts megapixels, pixels, kilopixels, gigapixels et dimensions afin que les tests automatisés restent stables. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires bon marché lorsque les clients testent volontairement des noms d’unité inconnus.