ForHosting KIT · Vídeo

Calcular barras letterbox en píxeles para vídeo

Esta calculadora de barras letterbox convierte dos relaciones de aspecto y la altura del lienzo en medidas prácticas para sus composiciones de vídeo.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Introduzca la relación de la fuente, la del lienzo de destino y su altura. El resultado indica si las barras deben aparecer arriba y abajo o a izquierda y derecha, y ofrece el tamaño de cada barra igual. Si ambas relaciones coinciden, devuelve correctamente cero porque la imagen ya llena el lienzo sin recortes ni relleno.

Comience con las relaciones de la fuente y del lienzo

Una relación de aspecto expresa la anchura con respecto a la altura; por eso, 16:9 y 1.777777 describen la misma forma. Indique la relación de la imagen que desea conservar y la relación del lienzo final. La altura del lienzo fija la escala real en píxeles y la anchura se deduce de la relación de destino. La calculadora admite W:H, W/H o un decimal positivo, por lo que sirve para formatos habituales como 4:3, 16:9, 21:9 y 2.39:1. Cuando conozca la apertura real de visualización, utilícela en vez de dar por exacta una etiqueta comercial. Algunos formatos llamados 21:9, por ejemplo, presentan valores numéricos ligeramente distintos, capaces de producir barras visibles en resoluciones altas. Todas las dimensiones deben ser positivas y finitas, y la altura debe ser un número entero de píxeles. Si las relaciones coinciden, no hace falta relleno y todas las barras devuelven cero, no un error.

Distinga las barras horizontales de las laterales

La fuente se ajusta por completo dentro del lienzo sin estirarla ni eliminar contenido. Cuando es más ancha que el lienzo de destino, su anchura toca primero los bordes. La altura ajustada queda por debajo de la altura del lienzo y el espacio libre se reparte por igual arriba y abajo. El resultado denomina top_bottom a esta orientación e indica la altura de cada barra. Si la fuente es más estrecha, su altura llega primero a los límites y queda espacio horizontal. Este se divide entre los lados izquierdo y derecho, con orientación left_right y una anchura para cada barra lateral. Este segundo caso suele llamarse pillarbox, aunque ambos se resuelven con el mismo ajuste. El campo bar_size_pixels contiene siempre el tamaño de una sola barra, no el relleno total. Los campos específicos para cada borde permiten aplicar el resultado sin interpretar antes la orientación.

Aplique el resultado en edición y renderizado

Use las dimensiones calculadas al preparar superposiciones, fotogramas de vista previa, másteres codificados, proyecciones o composiciones con CSS y canvas. Si la geometría no divide el espacio en píxeles enteros, el resultado conserva fracciones y las redondea de forma determinista a seis decimales. Una herramienta que exija coordenadas enteras deberá decidir su propia política de redondeo, pues redondear ambas barras por separado puede alterar en un píxel la dimensión final. En un flujo ráster puede redondear un borde hacia abajo y asignar el píxel restante al borde opuesto; los diseños vectoriales o del navegador suelen admitir la fracción. El cálculo supone un ajuste contain centrado: conserva la fuente completa, no recorta y distribuye el relleno por igual. No contempla píxeles anamórficos, metadatos de rotación, overscan ni zonas seguras; conviértalos antes en una relación efectiva. La automatización mediante API cuesta $0.002 por solicitud.

Prepare vídeo cinematográfico para un marco estándar

Calcule un relleno superior e inferior idéntico antes de colocar una fuente panorámica en un lienzo de entrega 16:9.

Cree un máster de archivo con barras laterales

Obtenga la anchura de las barras izquierda y derecha para conservar material antiguo 4:3 en un marco panorámico moderno.

Sitúe gráficos fuera de la imagen activa

Reserve dimensiones conocidas para subtítulos, etiquetas o controles sin cubrir la fuente ajustada.

¿Qué ocurre si ambas relaciones de aspecto son iguales?

El resultado utiliza la orientación none y devuelve cero en todas las dimensiones porque no se necesitan barras.

¿bar_size_pixels representa una barra o la suma de ambas?

Representa una sola barra. Las barras opuestas son iguales y los campos de borde muestran cada una explícitamente.

¿Por qué puede aparecer una fracción de píxel?

La geometría de las relaciones no siempre produce píxeles enteros. Se conserva el valor preciso para que su renderizador aplique el redondeo adecuado.

¿El cálculo recorta o estira la fuente?

No. Aplica un ajuste contain centrado que conserva toda la fuente y sus proporciones originales.

¿Cuánto cuesta un cálculo mediante API?

Cada solicitud a la API cuesta $0.002. El cálculo es determinista y no carga ni examina ningún archivo de vídeo.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_aspect_ratio":"21:9","target_aspect_ratio":"16:9","canvas_height":1080}'
{
  "source_aspect_ratio": "21:9",
  "target_aspect_ratio": "16:9",
  "canvas_height": 1080
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video2.aspect_ratio_letterbox_bars_size",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb500
max_minutes60
max_megapixels3.9
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →