Pango(3)

okay so you've pulled up the Pango(3) page from the User Contributed Perl Documentation, and bestie, it's literally the manual for Pango — the library for laying out and rendering international text 💅✨. Think of it as your group chat for scripts, fonts, and Cairo, but make it typography.

🌸 NAME 🌸

Pango — layout and render international text. That's the whole vibe: text goes in, beautiful internationalized layout comes out 🫶.

✨ SYNOPSIS ✨

Here's the little starter snippet, verbatim, no cap:

my $surface = Cairo::ImageSurface->create ('argb32', 200, 100);
my $cr = Cairo::Context->create ($surface);

my $layout = Pango::Cairo::create_layout ($cr);
$layout->set_text ("\x{03A0}\x{03B1}\x{03BD}\x{8A9E}");

my $font = Pango::FontDescription->from_string ('Serif Bold 27');
$layout->set_font_description ($font);

Pango::Cairo::show_layout($cr, $layout);

$surface->write_to_png ('pango.png');

🦋 ABSTRACT 🦋

Pango is a library for laying out and rendering text, and it's super focused on internationalization. You can use Pango anywhere text layout is needed, but pairing Pango with Cairo and/or Gtk2 gives you a complete solution with high quality text handling and graphics rendering.

The dynamically loaded modules handle text layout for particular combinations of script and font backend. Pango ships a wide selection of modules — including modules for Hebrew, Arabic, Hangul, Thai, and a number of Indic scripts — and virtually all of the world's major scripts are supported.

Besides the low level layout rendering routines, Pango includes Pango::Layout, a high level driver for laying out entire blocks of text, plus routines that assist in editing internationalized text.

[Adapted from <http://www.pango.org/>.]

📚 DOCUMENTATION 📚

Pango tries to stick very close in spirit to the C API of the underlying pango library. So the manual at <http://library.gnome.org/devel/pango/stable/> also applies to this module. On top of that, API listings in POD form are generated during compilation for each of the sub-modules. You can find an index of those POD pages at Pango::index.

👀 SEE ALSO 👀

Shoutout to perl, Glib, Cairo, and Gtk2.

Pango::index lists the autogenerated API documentation pod files for Pango.

<http://www.pango.org/> is the homepage of the pango C library. Its API documentation lives at <http://library.gnome.org/devel/pango/stable/>.

💖 AUTHORS 💖

The legends behind this page:

• muppet <scott at asofyet dot org>
• Torsten Schoenfeld <kaffeetisch at gmx dot de>
• Marc Lehmann <pcg at goof dot com>

👑 COPYRIGHT AND LICENSE 👑

Copyright 2003-2011, 2014 by the gtk2-perl team.

The legal tea, word for word:

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the LICENSE file in the top-level directory of this distribution for the full license terms.

---

okay that's the page, bestie! This beauty is from perl v5.42.0, dated 2019-09-16, and it's the Pango(3) manual — slay, periodt 💅🌈✨.