summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/adjustbox/README
blob: fd435f477394ce3c44e83a3a974979ae348d95ec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
LaTeX bundle adjustbox
=========================
Copyright (c) 2011-2012 by Martin Scharrer <martin@scharrer-online.de>  
WWW: <https://bitbucket.org/martin_scharrer/adjustbox> (incl. bug tracker)

This bundle contains the the adjustbox package and its auxiliary packages trimclip and adjcalc.
The initial purpose of adjustbox was to supplement the standard graphics/x package, 
which defines the macros \resizebox, \scalebox and \rotatebox, with the macros \trimbox and \clipbox.
An additional \marginbox macro is also provided.
These macros are now placed in the dedicated package trimclip which is loaded by adjustbox.
The package comes with clipping driver files are provided for pdftex (incl. LuaLaTeX), dvips and xetex. A
fall-back driver which uses the pgf package is still included. 
The driver files got written by Joseph Wright (LaTeX3 project) and the package author.

The main feature of adjustbox is the general \adjustbox macro which extends the key=value
interface of \includegraphics from the graphicx package, and applies it to general text
content. It also provides further text/box modifications keys, macros and envionments.

Both adjustbox and trimclip use the adjcalc package to allow for algebraic expressions for all length
arguments. The adjcalc package can use either e-TeX, the calc package or the pgfmath package.

All macros use the authors other package collectbox to read the content as box and not as
macro argument. This allows for all forms of content including special material like verbatim content.
A special feature of collectbox is used to provide matching environments with the identical names as the
macros.