videobeaux/docs/programs/effects/resize.md

resize

Description

Resizes the dimensions of a video to a specified width and height.
This module performs a direct scale transformation, producing clean, predictable results for platform formatting, layout prep, or visual uniformity.

Purpose

resize is designed for creators who want to:

• convert videos into specific resolution targets,
• prepare assets for social platforms (square, vertical, widescreen),
• normalize input dimensions before compositing in Lagkage,
• upscale or downscale footage with direct pixel precision,
• create clean formatting pipelines without aspect-ratio tricks.

How It Works

1. Dimension Override
   The user specifies:
   • new_width
   • new_height
2. Scaling Filter
   FFmpeg’s scaler processes each frame to the requested resolution.
3. Output Encoding
   The final resized image is encoded using global Videobeaux settings (CRF, codec, pixel format, preset).

Program Template

videobeaux -P resize -i input.mp4 -o output.mp4 --new_height VALUE --new_width VALUE

Arguments

• new_height — Target output height in pixels.
• new_width — Target output width in pixels.

Real World Example

videobeaux -P resize \
  -i myvideo.mp4 \
  -o resize_styled.mp4 \
  --new_height EXAMPLE \
  --new_width EXAMPLE

Program Output

Program output video not yet linked.

Technical Notes

• This module does not enforce aspect-ratio preservation.
• If the provided width and height do not match the original aspect ratio, the result will be stretched or squished — which may be desirable for stylized distortion.
• For clean upscaling, combine with high-quality pixel formats (e.g., yuv444p or 10-bit formats) if your pipeline supports them.
• Works well as a preprocessing step for LUTs, Lagkage, overlays, or dimension-specific delivery outputs.

Recommended Usage

• Creating platform-targeted versions:
  • 1080×1920 (reels/stories/shorts)
  • 1080×1080 (square grid formats)
  • 1920×1080 (landscape)
• Normalizing assets before multi-layer compositing.
• Preparing clips for generative art pipelines where exact sizes matter.
• Upscaling stylized effects (e.g., painterly, glitch, smear) for high-res exports.

Quality Tips

• For crisp results, resize before applying heavy effects and grading.
• For a degraded or lo-fi look, resize after, which amplifies artifacts.
• Use exact values that match your layout or platform’s requirements.
• Pair with convert_dims when you want aspect-ratio intelligence; use resize when you want exact pixel control.
• For upscaling beyond 2×, consider preprocessing with gamma_fix or tonemap_hdr_sdr to stabilize tonal fidelity before scaling.