PANGO-VIEW(1)

📦
version 1.57.1 · 9 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, debian trixie, ubuntu questing

okay bestie, welcome to PANGO-VIEW(1) — the Pango text viewer from the Pango commands manual. This is your group-chat cheat sheet, and yes, every flag is invited to the party 💖

🎀 NAME 🎀

pango-view — Pango text viewer.

✨ SYNOPSIS ✨

Run it like this, bb:

pango-view [OPTIONS...] FILE

🌸 DESCRIPTION 🌸

So like, pango-view formats a text using Pango, and it has options that let you exercise most of Pango's layout features. It’s giving “layout lab, but make it cute” 🧪💅

💅 HELP OPTIONS 💅

Need the tea? These are the help exits:

  • -h, --help — Show help options.
  • --help-all — Show all help options.
  • --help-cairo — Show help for options understood by the cairo backend.
  • --version — Print the command's version and exit.

🦋 CAIRO BACKEND OPTIONS 🦋

Only the cairo backend wants the spotlight here:

  • --annotate=FLAGS — Annotate the output. FLAGS is a comma-separated list of gravity, progression, baselines, layout, line, run, cluster, char, glyph, caret, slope.

🌈 APPLICATION OPTIONS 🌈

Main character options, incoming — all the levers you can pull:

  • --no-auto-dir — No layout direction according to contents.
  • --backend=cairo/xft/ft2 — Pango backend to use for rendering (default: cairo).
  • --background=red/#rrggbb/#rrggbbaa/transparent — Set the background color.
  • -q, --no-display — Do not display (just write to file or whatever).
  • --dpi=number — Set the resolution.
  • --align=left/center/right — Set text alignment.
  • --ellipsize=start/middle/end — Set ellipsization mode.
  • --font=description — Set the font description.
  • --foreground=red/#rrggbb/#rrggbbaa — Set the text color.
  • --gravity=south/east/north/west/auto — Set base gravity: glyph rotation.
  • --gravity-hint=natural/strong/line — Set gravity hint.
  • --header — Display the options in the output.
  • --height=+points/-numlines — Set height in points (positive) or number of lines (negative) for ellipsizing.
  • --hinting=none/auto/slight/medium/full — Set hinting style.
  • --antialias=none/gray/subpixel — Set antialiasing.
  • --hint-metrics=on/off — Set hint metrics.
  • --subpixel-positions — Set subpixel positioning.
  • --subpixel-order=rgb/bgr/vrgb/vbgr — Set subpixel order.
  • --indent=points — Set paragraph indentation (in points).
  • --spacing=points — Set line spacing (in points).
  • --line-spacing=factor — Set spread factor for line height.
  • --justify — Stretch paragraph lines to be justified.
  • --justify-last-line — Justify the last line of the paragraph.
  • --language=en_US/etc — Set language to use for font selection.
  • --margin=CSS-style numbers in pixels — Set the margin on the output in pixels.
  • --markup — Interpret text as Pango markup.
  • -o, --output=file — Save rendered image to output file.
  • --pixels — Use pixel units instead of points (sets dpi to 72).
  • --pango-units — Use Pango units instead of points.
  • --rtl — Set base direction to right-to-left.
  • --rotate=degrees — Set angle at which to rotate results,
  • -n, --runs=integer — Run Pango layout engine this many times.
  • --single-par — Enable single-paragraph mode.
  • -t, --text=string — Text to display (instead of a file).
  • --waterfall — Create a waterfall display.
  • -w, --width=points — Width in points to which to wrap lines or ellipsize.
  • --wrap=word/char/word-char — Text wrapping mode (needs a width to be set).
  • --serialized=FILE — Create layout from a serialized file,
  • --serialize-to=FILE — Serialize result to a file.

Signed off with the Pango source/version line and the PANGO-VIEW(1) date from your local manpage build — mwah, slay, and happy rendering 💋✨

📦 where this page comes from