Directory macros/latex/contrib/tkz/pgfornament
pgfornament – Drawing of Vectorian ornaments with PGF/TikZ
Release 1.4 2026/10/17
Description
This package allows the drawing of Vectorian ornaments (196) with pgf/tikz. Version 1.4 adds a family of 16 Celtic knots (object=celtic, public domain, from publicdomainvectors.org) and a script tools/svg2pgf.py to convert svg, eps or pdf drawings into new ornaments. The documentation presents the syntax and parameters of the macro "pgfornament". About tikzrput package: This package contains the rput macro that can be used to place objects. This macro does similar actions of the rput macro from pstricks. Here this macro needs tikz to work. With this new version comes a new family of ornaments. Chennan Zhang drew the motifs using a CAD application, re-drew them in TikZ, and granted permission for these to be turned into a library pgfornament-han suitable for use with the pgfornament package by LianTze Lim. It is now possible to use directly the library for Chinese traditional motifs and patterns.
About tikzrput package
This package contains the \rput macro that can be used to place objects. This macro does similar actions of the \rput macro from pstricks. Here this macro needs tikz to work.
Licence
The packages may be modified and distributed under the terms and conditions of the LaTeX Project Public License, version 1.3c or greater. See the files LICENSE and lppl-1-3c.txt.
Installation
The package pgfornament and tikzrput are present in TeXLive and MiKTeX, use the package manager to install.
You can experiment with the pgfornament and tikzrput packages by placing all of the distribution files in the directory containing your current tex file.
For manual instalation all files must be moved into the different directories in your installation TDS tree or in your TEXMFHOME:
doc/*.* -> TDS:doc/latex/pgfornament/*.* latex/*.* -> TDS:tex/latex/pgfornament/*.* generic/*/*.* -> TDS:tex/generic/pgfornament/*/*.* tools/svg2pgf.py -> TDS:doc/latex/pgfornament/tools/ (optional)
File names
Since version 1.4 all the runtime files begin with pgfornament (TeX Live rule): pgfornament.sty, the libraries pgfornament-lib-<family>.code.tex and the ornaments pgfornament-<family><n>.pgf. The package tikzrput.sty is a separate package of the bundle. The documentation is pgfornament-doc.pdf.
How to use it
To use the package pgfornament, place the following lines in the preamble of your LaTeX document.
\usepackage{pgfornament}
Documentation
Documentations for pgfornament and tikzrput are available on CTAN and in your TeX distribution.
Download the contents of this package in one zip archive (3.1M).
PGFornament – Draw vector ornaments with PGF/TikZ
This package allows the drawing of vector ornaments with PGF/TikZ. The macro \pgfornament places an ornament anywhere in a document, alone or inside a TikZ picture, with options to set its size, colour, opacity, symmetry and anchor. Further macros draw lines of ornaments, ornaments between two nodes or along a path, and frames around pages or texts.
Several families of ornaments are available:
- vectorian: 196 ornaments (symbols, corners, lines, animals, hands…), inspired by psvectorian;
- pgfhan: 78 Chinese traditional motifs and patterns by LianTze Lim and Chennan Zhang;
- celtic: 16 Celtic knots, released in the public domain;
- am: a small example family showing how to create new ornaments.
The bundle also contains the package tikzrput, which provides the \rput macro similar to the one of PSTricks, and a Python script, svg2pgf.py, which converts svg, eps or pdf drawings into new families of ornaments.
| Package | PGFornament |
| Home page | |
| Version | 1.4 |
| Licenses | The LaTeX Project Public License 1.3 |
| Copyright | 2012–2026 Alain Matthes |
| Maintainer | Alain Matthes |
| Contained in | TeX Live as pgfornament MiKTeX as pgfornament |
| Topics | Decoration Tagged PDF – partially compatible Graphics plot |
| See also | PGF |
