overlay_img_pro

Description

Overlays an external image onto the input video with explicit control over image position and dimensions.
overlay_img_pro allows precise placement, scaling, and compositing of static images (PNG, JPG, etc.) on top of a video layer.

Purpose

overlay_img_pro is intended for creators who want to:

add logos, watermarks, stickers, UI elements, or graphic marks,
precisely place images using pixel coordinates,
scale images to specific dimensions for uniform branding,
composite image layers as part of a stylized or functional pipeline,
automate graphic overlays without using a traditional editor.

How It Works

Image Loading
The external image defined by --overlay_img is loaded into the FFmpeg filtergraph.
Scaling
The image is resized to the dimensions specified by:
- img_width
- img_height
Positioning
The overlay image is placed at:
- x_pos (horizontal placement)
- y_pos (vertical placement)
Compositing
The resized and positioned image is blended over the source video.
Encoding
Final output is encoded using global Videobeaux codec, pixel-format, and CRF settings.

Program Template

videobeaux -P overlay_img_pro \
  -i input.mp4 \
  -o output.mp4 \
  --overlay_img VALUE \
  --x_pos VALUE \
  --y_pos VALUE \
  --img_height VALUE \
  --img_width VALUE

Arguments

overlay_img — Path to the image to overlay (PNG, JPG, etc.).
x_pos — Horizontal position of the top-left corner of the overlay (in pixels).
y_pos — Vertical position of the top-left corner of the overlay (in pixels).
img_height — Height of the overlay image after scaling.
img_width — Width of the overlay image after scaling.

Real World Example

videobeaux -P overlay_img_pro \
  -i myvideo.mp4 \
  -o overlay_img_pro_styled.mp4 \
  --overlay_img EXAMPLE \
  --x_pos EXAMPLE \
  --y_pos EXAMPLE \
  --img_height EXAMPLE \
  --img_width EXAMPLE

Program Output

Technical Notes

PNG images with alpha channels will respect transparency automatically.
Extremely large overlays may impact performance or produce scaling artifacts.
For best results, use high-resolution images when scaling down rather than up.
The overlay is applied top-left–anchored; centering must be done manually using math for x_pos / y_pos.
Works on any resolution or aspect ratio, including portrait, square, and ultrawide.

Recommended Usage

Watermarks, logos, and branding elements.
Titles or lower-third graphics generated externally.
UI overlays for mockups or stylized edits.
Layer-based collage compositions when combined with other Videobeaux programs.
Automated batch rendering where graphics must appear in consistent positions.

Quality Tips

Pre-scale the external image to your target size to avoid unnecessary interpolation.
Use PNG for overlays requiring clean edges or transparency.
Combine with convert_dims beforehand to ensure predictable placement on varying aspect ratios.
For multi-image overlays, use lagkage instead for complex composite pipelines.
Lower CRF values keep overlay edges crisp after encoding.

3.5 KiB Raw Permalink Blame History Unescape Escape