O que uma curva de Bezier realmente é
Uma curva de Bezier é uma curva suave entre um ponto inicial e um ponto final. Ela é moldada por um ou mais , posicionados fora da própria curva, não sobre ela.
- Bezier quadrático: 3 pontos no total, início, um ponto de controle, fim.
É isso que
quadraticTodesenha. - Bezier cúbico: 4 pontos no total, início, dois pontos de controle, fim.
É isso que
cubicTodesenha.
O ponto de controle extra em uma curva cúbica é toda a diferença: mais uma atração independente sobre a forma. As próximas seções mostram exatamente o que essa atração faz, e por que é fácil supor que um ponto de controle está sobre a curva quando ele nunca está.
A intuição
Path.quadraticTo(x1, y1, x2, y2) e cubicTo(x1, y1, x2, y2, x3, y3)
ambos recebem coordenadas que parecem pontos na curva. Elas não são.
- Um ponto de controle nunca é um ponto pelo qual a curva passa, é um ponto na direção do qual a curva se inclina. A curva toca apenas seu início e seu fim.
- Mover um ponto de controle mais perto da linha reta entre início e fim muda a curva muito pouco; movê-lo bem longe inclina a curva fortemente, mas a curva ainda nunca o alcança.
arcToparece ser um terceiro membro da mesma família, mesmo formato de métodoPath, mesma assinatura de chamada "passe algumas coordenadas". Não é: não há ponto de controle atraindo nada, é geometria circular (raio, ângulo inicial, ângulo de varredura), um tipo de matemática completamente diferente usando o mesmo formato de API.
- →Screen Coordinate Systems Aren't CartesianWhy arcTo's startAngleDegrees/sweepAngleDegrees sweep clockwise on screen instead of counterclockwise, the same y-down convention behind every cos/sin call in the arc section below.
- →Polar to Cartesian: What cos and sin Are Actually ComputingThe cos/sin circular geometry arcTo is built on, as opposed to the control-point interpolation quadraticTo and cubicTo use instead.
Quadrático: um ponto de controle curva uma linha
val path = Path()
path.moveTo(20f, 80f)
// ❌ ponto de controle quase sobre a linha reta → quase não há curva
path.quadraticTo(
x1 = 140f,
y1 = 70f,
x2 = 260f,
y2 = 80f,
)
// ✅ ponto de controle puxado bem longe da linha → curvatura forte, mesmos extremos
path.quadraticTo(
x1 = 140f,
y1 = 20f,
x2 = 260f,
y2 = 80f,
)Ambas as chamadas começam em (20, 80) e terminam em (260, 80), os
mesmos dois extremos sempre. A única coisa que mudou é onde o ponto de
controle está, e isso também é a única coisa que mudou a forma.
quadraticTo(x1, y1, x2, y2) desenha um Bezier quadrático percorrendo um
de 0 a 1: em cada passo ao longo dessa varredura, ele interpola
linearmente do ponto inicial em direção ao ponto de controle, e
separadamente do ponto de controle em direção ao ponto final, depois
interpola entre esses dois resultados novamente. Isso é uma passagem
aninhada de
-do-lerp.
O ponto de controle nunca aparece na curva final, ele apenas direciona
para qual lado a mistura se inclina.
Arraste o ponto de controle abaixo e observe as duas extremidades permanecerem fixas enquanto a curva se remodela ao redor de onde ele vai:
drag any point — Start at 20, 130, End at 260, 130, Control 1 at 140, 30
Encadeando curvas quadráticas: uma única onda
Uma onda de sobe-e-desce, um único ciclo tipo seno, não é uma primitiva
de Path, mas não precisa ser. É apenas duas chamadas de quadraticTo
em sequência, uma puxando para cima até um pico, outra puxando para baixo
até um vale, compartilhando o ponto médio entre elas como uma dobradiça
onde a curva retorna à linha média.
A armadilha é reutilizar a mesma suposição que a seção anterior alertou: tratar a altura do ponto de controle como a altura do pico.
// ❌ ponto de controle definido na altura de pico desejada (amplitude 40
// acima da linha média) → a curva só alcança a metade disso, amplitude 20
val path = Path()
path.moveTo(20f, 130f) // linha média
path.quadraticTo(
x1 = 80f,
y1 = 90f,
x2 = 140f,
y2 = 130f,
)// ✅ pontos de controle puxados a 2x a amplitude desejada → a curva
// realmente atinge o pico na amplitude 40, em ambas as metades da onda
val path = Path()
path.moveTo(20f, 130f) // linha média
path.quadraticTo(
x1 = 80f,
y1 = 50f,
x2 = 140f,
y2 = 130f,
)
path.quadraticTo(
x1 = 200f,
y1 = 210f, // 2x a amplitude, abaixo da linha média desta vez
x2 = 260f,
y2 = 130f,
)A razão é o mesmo lerp aninhado da seção de intuição, apenas avaliado em
um ponto específico: em t = 0.5, um Bezier quadrático está em
0.25 × início + 0.5 × controle + 0.25 × fim. Com início e fim ambos
fixados na linha média, isso se reduz a (linha média + controle) / 2,
o simples ponto médio entre a linha média e o ponto de controle.
Resolvendo isso para "o controle cai em duas vezes a amplitude", o 2x não
é uma constante mágica, ele surge diretamente dos pesos na interpolação.
Arraste qualquer um dos pontos de controle abaixo e observe o pico real (o pequeno ponto vermelho) se mover apenas a metade da distância da alça:
drag either control point — the peak only moves half as far as the handle — Control 1 pulled to 50, peak amplitude 40 up. Control 2 pulled to 210, peak amplitude 40 down.
A mesma ideia de dobradiça-e-repetição se estende além de um ciclo:
encadeie mais pares de quadraticTo, alternando para qual lado da linha
média cada ponto de controle puxa, e o mesmo padrão de duas chamadas se
multiplica em uma onda mais longa.
Cúbico: um segundo ponto de controle adiciona uma curva em S
val path = Path()
path.moveTo(20f, 80f)
// ❌ ambos os pontos de controle do mesmo lado → uma única curvatura, a
// mesma forma que uma curva quadrática já poderia fazer com um ponto
path.cubicTo(
x1 = 80f,
y1 = 20f,
x2 = 200f,
y2 = 20f,
x3 = 260f,
y3 = 80f,
)
// ✅ pontos de controle em lados opostos → uma curva em S que uma curva
// quadrática nunca pode produzir, não importa onde seu único ponto vá
path.cubicTo(
x1 = 80f,
y1 = 20f,
x2 = 200f,
y2 = 140f,
x3 = 260f,
y3 = 80f,
)cubicTo(x1, y1, x2, y2, x3, y3) executa a mesma ideia de interpolação
aninhada um nível mais profundo: três lerps em vez de um, misturando
através de dois pontos de controle em vez de um. Esse ponto de controle
extra é toda a diferença entre quadrático e cúbico, não é um segundo
botão para a mesma curvatura, é uma segunda direção independente para a
qual a curva pode se inclinar, o que é exatamente o que torna a curva em
S possível e torna impossível para qualquer curva quadrática de ponto de
controle único igualá-la.
Arraste qualquer um dos pontos de controle abaixo e observe as duas extremidades permanecerem fixas enquanto a curva se remodela ao redor de onde o ponto arrastado vai:
drag any point — Start at 20, 130, End at 260, 130, Control 1 at 80, 30, Control 2 at 200, 230
O fundamental
Ambos são curvas de Bezier: um ponto no parâmetro t é calculado
interpolando linearmente de forma recursiva entre pontos de controle,
uma técnica chamada algoritmo de De Casteljau. Uma curva quadrática
(3 pontos: início, um ponto de controle, fim) executa um nível de lerp
aninhado; uma curva cúbica (4 pontos) executa dois. O grau é sempre
"contagem de pontos menos um", e os pontos de controle são pesos nessa
interpolação, nunca paradas ao longo da própria curva.
Em outros lugares: o mesmo fundamento, frameworks diferentes
- Dados de caminho SVG: o comando
Q(Q x1,y1 x,y) é um Bezier quadrático,C(C x1,y1 x2,y2 x,y) é cúbico, matemática idêntica, apenas escrita como uma string em vez de chamadas de método. cubic-bezier()do CSS: toda curva detransition-timing-functioneanimation-timing-function(incluindo as nomeadasease,ease-in-out, etc.) é um Bezier cúbico sobre o tempo em vez do espaço, dois pontos de controle, mesmo mecanismo de interpolação aninhada, apenas animando um valor de progresso em vez de uma posição em pixels.- PostScript / PDF: o operador
curvetorecebe exatamente os mesmos seis números quecubicTo, dois pontos de controle e um ponto final. O comandoCdo SVG foi modelado diretamente a partir dele. - A ferramenta de pena, basicamente em todo editor vetorial: Illustrator, caminhos vetoriais do Photoshop, Figma, Penpot, Sketch, Affinity Designer, Inkscape. Arrastar uma alça de curva a partir de um ponto de ancoragem é posicionar um ponto de controle cúbico à mão, a direção e o comprimento da alça são a direção e a distância do ponto de ancoragem até o ponto de controle invisível que direciona a curva. Não é uma convenção específica da Adobe, cada uma dessas ferramentas está arrastando exatamente os mesmos dois pontos de controle que este post vem arrastando o tempo todo, apenas com um mouse em vez de um slider. Manter Alt/Option pressionado enquanto arrasta uma alça a solta de sua gêmea, movendo um ponto de controle independentemente, o mesmo movimento assimétrico que produz a curva em S deste post.
Do design ao código: não estime visualmente
A seção da ferramenta de pena acima já disse isso: arrastar uma alça no Figma ou Penpot é posicionar um ponto de controle cúbico à mão. Isso significa que um caminho desenhado por um designer não é uma referência para aproximar, é o dado real do ponto de controle, já calculado. Trate-o assim.
Não estime a curva visualmente. Olhar para um mockup de design e adivinhar onde os pontos de controle "provavelmente" estão produz uma curva que parece próxima isoladamente e se desvia no momento em que o designer move uma alça, porque seu palpite e os números exatos deles nunca foram a mesma curva desde o início. Extraia as coordenadas reais em vez de estimá-las:
- Figma: selecione o caminho, clique com o botão direito,
Copiar/Colar como → Copiar como SVG. O atributo
dsão seus pontos de controle, literalmente. - Penpot: selecione a forma, Exportar → SVG. Mesmo atributo
d.
De qualquer forma você obtém comandos de caminho SVG padrão, e eles se
mapeiam para os argumentos de cubicTo/quadraticTo um a um, na mesma
ordem:
SVG: C x1,y1 x2,y2 x,y
Kotlin: cubicTo(x1, y1, x2, y2, x, y)
SVG: Q x1,y1 x,y
Kotlin: quadraticTo(x1, y1, x, y)
Aqui está exatamente a curva em S da seção cúbica acima, como uma exportação de fato entregaria a você:
M20,80 C80,20 200,140 260,80
val path = Path()
path.moveTo(20f, 80f)
path.cubicTo(
x1 = 80f,
y1 = 20f,
x2 = 200f,
y2 = 140f,
x3 = 260f,
y3 = 80f,
)Isso não é uma conversão, é uma transcrição. Os mesmos seis números, a mesma ordem, nenhum julgamento de valor pelo meio.
Uma armadilha para verificar primeiro. SVG permite um c/q
minúsculo, o mesmo comando mas relativo ao ponto atual em vez de
absoluto. cubicTo/quadraticTo do Compose só aceitam coordenadas
absolutas, então um comando relativo precisa ter o ponto atual somado a
cada par antes de poder ser usado (x1Abs = currentX + x1Rel, e assim
por diante). Transcreva um comando relativo como está e o ponto de
controle cai perto da ancoragem errada completamente, sem nenhum erro
para dizer por que a curva parece estranha.
Casos extremos
arcTo não é uma curva de Bezier de forma alguma.
arcTo(rect, startAngleDegrees, sweepAngleDegrees, forceMoveTo) é
definido por uma caixa delimitadora e um ângulo inicial/de varredura,
geometria circular verdadeira, calculada com cos/sin, não
interpolação entre pontos. Não há ponto de controle para posicionar
errado, o que também é por que ele consegue fazer algo que nenhuma curva
de Bezier consegue: traçar um arco circular perfeito. Recorra a
arcTo especificamente quando você precisa de um círculo ou anel exato
(um indicador de progresso, um dial), e recorra a
quadraticTo/cubicTo quando você quer uma curva orgânica que não
precisa ser geometricamente perfeita.
val path = Path()
path.arcTo(
rect = Rect(center = Offset(140f, 130f), radius = 80f),
startAngleDegrees = 0f,
sweepAngleDegrees = 270f,
forceMoveTo = false,
)Arraste os sliders abaixo. Por mais que você empurre o raio, o início ou a varredura, o resultado é sempre um arco perfeito, porque não há ponto de controle puxando nada para fora de forma:
drag the sliders, the arc is always a perfect circle — radius 80, startAngleDegrees 0, sweepAngleDegrees 270
Você não pode desenhar um círculo perfeito com um único Bezier cúbico, nunca. Nenhum posicionamento de dois pontos de controle faz uma curva cúbica traçar um arco circular verdadeiro. Os dois tipos de matemática só coincidem exatamente nos quatro pontos cardeais.
Toda ferramenta vetorial que parece estar desenhando círculos a partir de curvas de Bezier (SVG, Illustrator, Figma, o próprio Skia) está fingindo da mesma forma:
- Costure quatro curvas cúbicas juntas, uma por quadrante.
- Posicione cada ponto de controle a
raio × 0.5523de sua ancoragem mais próxima, a constante que melhor combina a tangente e a curvatura de um cúbico com um círculo. - Renderize o suficiente disso em um raio pequeno o bastante e o erro desaparece visualmente. Ele ainda está lá, apenas abaixo do pixel.
Pontos de controle cúbicos cruzados produzem um laço autointersectante, não apenas uma curva em S empurrada mais além. Arraste os dois pontos de controle na demonstração acima para cantos opostos e longe o suficiente um do outro, e a curva se cruza, um caminho real, não um bug de renderização, porque nada na matemática de interpolação impede os dois lerps aninhados de darem a volta um sobre o outro.
Quando recorrer a uma curva de Bezier
Sempre que uma curva precisa se curvar em uma direção orgânica, ajustada
à mão, em vez de uma precisamente circular, quadraticTo/cubicTo é a
ferramenta. Alguns lugares onde esse padrão aparece na prática:
Desenho e formas personalizadas
- Suavizar uma polilinha irregular (amostras de toque, dados de gráfico
de ações, uma tela de assinatura) em um traço visualmente suave, sem
amostrar centenas de pontos. Esse é o truque por trás de construir um
anel de carregamento ondulado circular: amostre pontos ao redor do
círculo, depois conecte-os com
quadraticToem vez delineTo. - Botões em formato de blob, sublinhados ondulados, ou qualquer indicador de carregamento cuja borda precise oscilar em vez de permanecer circular.
- Formas de canto personalizadas que um
RoundedCornerShapesimples não pode expressar, já que ele só conhece cantos circulares.
Animação e movimento
- Curvas de aceleração/desaceleração (easing): a mesma matemática cúbica da seção Em outros lugares acima, apenas mapeando progresso para progresso em vez de pixel para pixel.
- Transformar um ícone ou forma em outro interpolando os pontos de controle de cada forma ao longo do tempo.
Ilustração e arte vetorial
- Qualquer coisa desenhada à mão em uma ferramenta de pena (Illustrator,
Figma) e exportada como dados de
Pathchega como uma sequência de chamadascubicTojá pronta. Reconhecer o padrão é reconhecer o que a ferramenta já gerou para você.
Modelo mental para realmente usar
Pontos de controle são pesos em uma interpolação, não pontos de
passagem em uma curva. Escolha um Bezier (quadraticTo/cubicTo)
quando você quer uma curvatura que só precisa parecer organicamente
suave; escolha arcTo quando a geometria realmente precisa ser um
círculo.



