Calcule barras letterbox em pixels para vídeo

Informe a proporção da fonte, a proporção da tela de destino e a altura. O resultado mostra se as barras ficam acima e abaixo da imagem ou nos lados esquerdo e direito, além de indicar o tamanho de cada barra igual. Quando as proporções coincidem, o valor retornado é zero, pois a fonte já ocupa a tela sem corte nem preenchimento.

Comece pelas proporções da fonte e da tela

Uma proporção descreve a largura em relação à altura; portanto, 16:9 e 1.777777 representam o mesmo formato. Informe a proporção da imagem que você deseja preservar e a da tela final. A altura da tela define a escala real em pixels, enquanto a largura é derivada da proporção de destino. A calculadora aceita W:H, W/H ou um decimal positivo e atende formatos comuns como 4:3, 16:9, 21:9 e 2.39:1. Se você conhecer a abertura real de exibição, prefira esse valor a uma denominação comercial aproximada. Alguns formatos chamados de 21:9, por exemplo, têm valores numéricos um pouco diferentes, e pequenas diferenças podem gerar barras visíveis em alta resolução. Todas as dimensões precisam ser positivas e finitas, e a altura deve ser um número inteiro de pixels. Se as proporções forem iguais, não há preenchimento: todas as dimensões das barras retornam zero, sem erro.

Entenda as barras horizontais e laterais

A fonte é encaixada inteira na tela, sem deformação e sem remoção de conteúdo. Quando ela é mais larga que a tela de destino, sua largura encosta primeiro nas bordas. A altura ajustada fica menor que a altura da tela, e o espaço restante é dividido igualmente acima e abaixo da imagem. O resultado chama essa orientação de top_bottom e informa a altura de cada barra. Se a fonte for mais estreita, a altura encosta primeiro e sobra espaço horizontal. Esse espaço é repartido entre os lados esquerdo e direito, gerando a orientação left_right e uma largura para cada barra lateral. Esse caso costuma ser chamado de pillarbox, embora os dois usem o mesmo cálculo de encaixe. O campo bar_size_pixels sempre contém o tamanho de uma única barra, e não a soma do preenchimento. Os campos de cada borda deixam a saída inequívoca para o código de layout.

Use o resultado na edição e na renderização

Aplique as dimensões retornadas ao preparar sobreposições, quadros de prévia, masters codificados, projeções ou composições em CSS e canvas. Quando a geometria não resulta em pixels inteiros, a calculadora mantém a fração e faz um arredondamento determinístico para seis casas decimais. Uma ferramenta que exija coordenadas inteiras deve adotar sua própria regra, pois arredondar as duas barras separadamente pode alterar a dimensão final em um pixel. Em um fluxo raster, você pode arredondar uma borda para baixo e atribuir o pixel restante à borda oposta; layouts vetoriais ou de navegador geralmente aceitam a fração. O cálculo presume um encaixe contain centralizado: preserva toda a fonte, não corta e distribui o preenchimento igualmente. Ele não considera pixels anamórficos, metadados de rotação, overscan ou áreas seguras; converta esses fatores em uma proporção efetiva antes. A automação pela API custa US$ 0,002 por solicitação.