Calculadora de rolos de papel

A ferramenta devolve o comprimento da faixa após o arredondamento ao padrão, quantas faixas verticais a parede precisa, quantas faixas inteiras cabem em um rolo, rolls_needed, áreas de parede e rolo, perda de padrão e passos de substituição ordenados que você pode copiar para um orçamento ou teste unitário. Dimensões não positivas são rejeitadas com um erro invalid_input claro em vez de inventar contagem a partir de comprimentos nulos ou negativos. O caminho é matemática determinística pura —sem rede, sem sementes aleatórias, sem relógio— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo cada vez que você chama.

Como a quantidade de papel é contada com repetição de padrão

O papel se cola em faixas verticais, não se pinta como área contínua, então área da parede dividida pela área do rolo subestima quando o padrão força cada faixa a ser cortada mais longa que a altura do muro. O método padrão do decorador começa pelo comprimento da faixa. Os cinco campos de comprimento devem usar a mesma unidade —metros com metros, pés com pés— porque a calculadora nunca converte unidades; só exige dimensões de parede e rolo positivas e repetição não negativa. Se a faixa calculada for mais longa que o rolo, a chamada falha: não se corta uma faixa inteira, e inventar um rolo fracionário enganaria a compra. Quando pattern_repeat é zero —papel liso, textura ou encaixe aleatório— a faixa iguala a altura da parede. Quando pattern_repeat é positivo, cada faixa é arredondada para o próximo múltiplo inteiro dessa repetição para que faixas vizinhas combinem na mesma altura de motivo; esse comprimento extra é perda intencional, não um bug. Em seguida, strips_needed é a largura da parede dividida pela largura do rolo, sempre para cima para que uma faixa parcial consuma uma largura completa. strips_per_roll é quantas faixas inteiras cabem no comprimento do rolo, com divisão inteira para baixo para que um resto menor que uma faixa não conte. Por fim rolls_needed é strips_needed dividido por strips_per_roll, para cima. A resposta também informa rolls_by_area_only para ver quanto a pura aritmética de área subestimaria o serviço com perda de padrão e geometria de faixas.

Como chamar a API e o que volta

Envie um corpo JSON com quatro números finitos positivos obrigatórios —wall_width (aliases width, wall_w, room_width), wall_height (aliases height, wall_h, room_height), roll_length (aliases roll_len, length, paper_length) e roll_width (aliases paper_width, strip_width, roll_w)— mais pattern_repeat opcional (aliases repeat, pattern, match, rapport), que vale zero se omitido. Os valores absolutos devem ficar no intervalo publicado para que produtos intermediários permaneçam finitos em precisão dupla IEEE no Worker e no navegador. Em sucesso, a resposta ecoa entradas arredondadas, define drop_length e pattern_multiples pela regra de altura e repetição, strips_needed e strips_per_roll com os passos ceil e floor, rolls_needed como contagem de compra, wall_area e roll_area como produtos largura por altura, covered_area como faixas por faixa por largura do rolo, pattern_waste_per_drop e total_pattern_waste_length pelo comprimento extra do encaixe, rolls_by_area_only como o teto otimista só por área, message como resumo breve e steps como array ordenado de linhas de substituição. Validação falha —campos ausentes, números não finitos, dimensões de parede ou rolo não positivas, repetição negativa ou faixa mais longa que o rolo— retorna invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por pedido bem-sucedido com unidade item e preço unitário marginal zero.

Dicas práticas, limites e buscas relacionadas

Meça a largura da parede como a soma de todas as superfícies que você vai colar, ou chame uma vez por parede se portas e janelas mudam o plano de faixas; esta ferramenta não subtrai aberturas, então janelas grandes devem reduzir wall_width ou ter plano separado. Leia pattern_repeat no rótulo do produto —muitas vezes em centímetros ou polegadas ao lado de «repeat» ou «match»— e converta para a mesma unidade das medidas da parede antes de chamar. Ao ensinar ou escrever testes, compare a mesma parede com pattern_repeat zero e com repetição positiva para que rolls_needed suba só quando o comprimento da faixa cresce. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que deixa scripts exploratórios baratos quando você envia de propósito altura zero para verificar o tratamento de erro.