Calculadora de rollos de papel

La herramienta devuelve el largo de tira tras el redondeo al motivo, cuántas tiras verticales necesita la pared, cuántas tiras enteras caben en un rollo, rolls_needed, áreas de pared y rollo, merma de motivo y pasos de sustitución ordenados que puede copiar a un presupuesto o a una prueba unitaria. Las dimensiones no positivas se rechazan con un error invalid_input claro en lugar de inventar un recuento a partir de longitudes nulas o negativas. La ruta es matemática determinista pura —sin red, sin semillas aleatorias, sin reloj— de modo que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON tras el redondeo decimal fijo cada vez que la invoca.

Cómo se cuenta la cantidad de papel con repetición de motivo

El papel se cuelga en tiras verticales, no se pinta como un área continua, así que un simple área de pared dividida por área de rollo subestima cuando el motivo obliga a cortar cada tira más larga que la altura del muro. El método estándar del decorador empieza por el largo de tira. Los cinco campos de longitud deben usar la misma unidad —metros con metros, pies con pies— porque la calculadora nunca convierte unidades; solo exige dimensiones de pared y rollo positivas y una repetición no negativa. Si la tira calculada es más larga que el rollo, la llamada falla: no se puede cortar una tira entera, e inventar un rollo fraccionario engañaría la compra. Cuando pattern_repeat es cero —papel liso, textura o coincidencia aleatoria— la tira iguala la altura del muro. Cuando pattern_repeat es positivo, cada tira se redondea al siguiente múltiplo entero de esa repetición para que las tiras vecinas coincidan a la misma altura de motivo; esa longitud extra es merma intencionada, no un error. Después, strips_needed es el ancho de pared dividido por el ancho de rollo, siempre al alza para que una tira parcial consuma un ancho completo. strips_per_roll es cuántas tiras enteras caben en el largo del rollo, con división entera a la baja para que un resto más corto que una tira no cuente. Por último rolls_needed es strips_needed dividido por strips_per_roll, al alza. La respuesta también informa rolls_by_area_only para ver cuánto subestimaría la pura aritmética de área una vez incluida la merma de motivo y la geometría de tiras.

Cómo llamar a la API y qué devuelve

Envíe un cuerpo JSON con cuatro números finitos positivos obligatorios —wall_width (alias width, wall_w, room_width), wall_height (alias height, wall_h, room_height), roll_length (alias roll_len, length, paper_length) y roll_width (alias paper_width, strip_width, roll_w)— más pattern_repeat opcional (alias repeat, pattern, match, rapport), que por defecto es cero si se omite. Los valores absolutos deben permanecer dentro del rango publicado para que los productos intermedios sigan finitos en precisión doble IEEE en el Worker y en el navegador. Si tiene éxito, la respuesta repite entradas redondeadas, fija drop_length y pattern_multiples según la regla de altura y repetición, strips_needed y strips_per_roll con los pasos ceil y floor, rolls_needed como recuento de compra, wall_area y roll_area como productos ancho por alto, covered_area como tiras por tira por ancho de rollo, pattern_waste_per_drop y total_pattern_waste_length por la longitud extra del emparejamiento, rolls_by_area_only como el techo optimista solo por área, message como un resumen breve y steps como un array ordenado de líneas de sustitución. La validación fallida —campos ausentes, números no finitos, dimensiones de pared o rollo no positivas, repetición negativa o tira más larga que el rollo— devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición correcta con unidad ítem y precio unitario marginal cero.

Consejos prácticos, límites y búsquedas relacionadas

Mida el ancho de pared como la suma de todas las superficies que colgará, o llame una vez por muro si puertas y ventanas cambian el plan de tiras; esta herramienta no resta aberturas, así que ventanas grandes deben reducirse en wall_width o con un plan de tiras aparte. Lea pattern_repeat en la etiqueta del producto —a menudo en centímetros o pulgadas junto a «repeat» o «match»— y conviértalo a la misma unidad que sus medidas de pared antes de llamar. Al enseñar o escribir pruebas, compare la misma pared con pattern_repeat cero y con una repetición positiva para que rolls_needed suba solo cuando crece el largo de tira. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando envía a propósito altura cero para verificar el manejo de errores.