Círculo de parafusos

A quantidade de furos deve ser um inteiro positivo; zero, fração ou valor negativo falha com invalid_input e não é cobrado.

O que é um círculo de parafusos e como as coordenadas se formam

Dado um centro (center_x, center_y), um diâmetro de circunferência, uma quantidade de furos n e um ângulo inicial em graus, o raio r é a metade do diâmetro e o passo angular são 360 graus divididos por n. O furo i, contado a partir de zero, fica no ângulo polar theta igual a start_angle mais i vezes 360 sobre n. As coordenadas cartesianas seguem a identidade x igual a center_x mais r vezes o cosseno de theta e y igual a center_y mais r vezes o seno de theta, com theta convertido em radianos só dentro da chamada trigonométrica. Essa é a convenção da maioria dos sistemas CAD e da conversão polar para cartesiana; se o seu desenho coloca o furo um às doze horas, envie start_angle como noventa. Um padrão de quatro furos em um diâmetro de cem com centro na origem e start_angle zero produz furos em (50, 0), (0, 50), (−50, 0) e (0, −50), a cruz clássica que o maquinista usa como verificação.

Contrato de entrada, forma da resposta e erros

Um diâmetro não positivo é rejeitado porque um círculo de parafusos com diâmetro nulo ou negativo não consegue colocar furos em um raio real. Uma cadeia de fórmula reescreve a identidade polar para que você possa auditar uma coordenada sem ler o código. Envie por POST um corpo JSON com cinco números. center_x e center_y situam o centro da circunferência no seu plano de desenho; podem ser zero, negativos ou grandes, e aceitam os aliases cx, centre_x e cy, centre_y. diameter é o diâmetro do círculo de passo que passa pelos centros dos furos, não o diâmetro dos furos em si, e deve ser um número finito estritamente positivo; os aliases incluem d, pcd, bcd, circle_diameter e pitch_diameter. hole_count é a quantidade de furos igualmente espaçados e deve ser um inteiro positivo de um a mil; os aliases incluem n, count, holes e num_holes. start_angle é o ângulo polar do furo um em graus, com aliases angle, theta, start e starting_angle. O campo opcional precision, com aliases decimals e dp, escolhe as casas decimais de cada campo numérico da resposta, com padrão oito e teto quinze para que os goldens JSON permaneçam estáveis. Campos ausentes, cadeias vazias, valores não finitos e magnitudes acima do teto suportado falham com invalid_input nomeando o campo. Um hole_count que não seja um inteiro positivo — zero, um número negativo, uma fração como quatro ponto cinco ou uma cadeia não numérica — falha com uma mensagem que nomeia hole_count e exige um inteiro positivo; essas falhas não são cobradas. No sucesso o corpo ecoa o centro analisado, o diâmetro, o raio, hole_count, start_angle e angle_step, e então lista os furos como objetos com índice a partir de um, ângulo envolvido em graus, x e y. Combine a resposta com o seu próprio gerador DXF ou G-code se precisar de um arquivo de desenho; este endpoint só devolve coordenadas e não emite gráficos, trajetórias nem listas de fixadores.

Onde uma calculadora de círculo de parafusos se paga

Programadores CNC emitem um círculo de parafusos como lista de alvos XY para um ciclo de furação, e uma API determinística ganha de uma planilha com unidades misturadas e uma célula oculta que ainda diz quatro furos e meio. Como a implementação é parse de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída, e a validação falha não consome saldo. Nesta página o trabalho roda inteiramente no seu navegador; pela API cada consulta bem-sucedida custa US$ 0,002, nada é armazenado depois que a resposta retorna, e o resultado matemático é idêntico.