Calculateur de rouleaux de papier peint

L’outil renvoie la longueur de lés après arrondi au motif, combien de lés verticaux le mur exige, combien de lés entiers tiennent dans un rouleau, rolls_needed, surfaces de mur et de rouleau, perte de motif et étapes de substitution ordonnées que vous pouvez copier dans un devis ou un test unitaire. Les dimensions non positives sont rejetées avec une erreur invalid_input claire au lieu d’inventer un compte à partir de longueurs nulles ou négatives. Le chemin est purement déterministe —pas de réseau, pas de graine aléatoire, pas d’horloge— de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après arrondi décimal fixe à chaque appel.

Comment la quantité de papier se compte avec le raccord de motif

Le papier se pose en lés verticaux, pas comme une surface peinte continue, donc une simple surface de mur divisée par la surface du rouleau sous-estime lorsque le motif force chaque lés à être coupé plus long que la hauteur du mur. La méthode standard du décorateur commence par la longueur de lés. Les cinq champs de longueur doivent utiliser la même unité —mètres avec mètres, pieds avec pieds— car le calculateur ne convertit jamais les unités ; il n’exige que des dimensions de mur et de rouleau positives et un raccord non négatif. Si le lés calculé est plus long que le rouleau, l’appel échoue : aucun lés entier ne peut être coupé, et inventer un rouleau fractionnaire tromperait l’achat. Lorsque pattern_repeat vaut zéro —papier uni, texture ou raccord aléatoire— le lés égale la hauteur du mur. Lorsque pattern_repeat est positif, chaque lés est arrondi au prochain multiple entier de ce raccord pour que les lés voisins s’alignent à la même hauteur de motif ; cette longueur en plus est une perte volontaire, pas un défaut. Ensuite, strips_needed est la largeur du mur divisée par la largeur du rouleau, toujours vers le haut pour qu’un lés partiel consomme une largeur pleine. strips_per_roll est le nombre de lés entiers qui tiennent dans la longueur du rouleau, avec division entière vers le bas pour qu’un reste plus court qu’un lés ne compte pas. Enfin rolls_needed est strips_needed divisé par strips_per_roll, vers le haut. La réponse indique aussi rolls_by_area_only pour voir combien la pure arithmétique de surface sous-estimerait le chantier une fois la perte de motif et la géométrie des lés incluses.

Comment appeler l’API et ce qui revient

Envoyez un corps JSON avec quatre nombres finis positifs obligatoires —wall_width (alias width, wall_w, room_width), wall_height (alias height, wall_h, room_height), roll_length (alias roll_len, length, paper_length) et roll_width (alias paper_width, strip_width, roll_w)— plus pattern_repeat optionnel (alias repeat, pattern, match, rapport), qui vaut zéro s’il est omis. Les valeurs absolues doivent rester dans la plage publiée pour que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. En cas de succès, la réponse renvoie les entrées arrondies, fixe drop_length et pattern_multiples selon la règle hauteur-et-raccord, strips_needed et strips_per_roll via les étapes ceil et floor, rolls_needed comme quantité d’achat, wall_area et roll_area comme produits largeur par hauteur, covered_area comme lés par lés par largeur de rouleau, pattern_waste_per_drop et total_pattern_waste_length pour la longueur forcée par le raccord, rolls_by_area_only comme le plafond optimiste surface seule, message comme un court résumé et steps comme un tableau ordonné de lignes de substitution. Une validation échouée —champs manquants, nombres non finis, dimensions de mur ou de rouleau non positives, raccord négatif ou lés plus long que le rouleau— renvoie invalid_input et n’est jamais facturée. Le tarif est un forfait de $0.002 par requête réussie avec unité item et prix unitaire marginal nul.

Conseils pratiques, limites et recherches liées

Mesurez la largeur de mur comme la somme de toutes les surfaces que vous poserez, ou appelez une fois par mur si portes et fenêtres changent le plan de lés ; cet outil ne soustrait pas les ouvertures, donc de grandes fenêtres doivent réduire wall_width ou un plan de lés séparé. Lisez pattern_repeat sur l’étiquette produit —souvent en centimètres ou pouces près de « repeat » ou « match »— et convertissez-le dans la même unité que vos mesures de mur avant l’appel. Pour l’enseignement ou les tests, comparez le même mur avec pattern_repeat zéro et avec un raccord positif afin que rolls_needed n’augmente que lorsque la longueur de lés croît. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui rend les scripts d’exploration peu coûteux lorsque vous envoyez volontairement une hauteur nulle pour vérifier la gestion d’erreur.