Cropping text
Cropping text
There are some rare cases in which it is useful to crop a given text line and loose part of its information.
Sometimes there is not enough room to show the complete (line of) text. In such a situation we can strip of some characters by using
\doboundtext {text} {width} {sentinel}
When the text is wider than the given width, it's split and the third argument (sentinel) is appended. As much text as possible is printed.
An example:
\framed{\doboundtext{My entire inheritance goes to my cat Pussy!}{62mm}{...}}
A bit more beautiful alternative for the previous command is \limitatetext.
This command takes care of word boundaries, so that only complete words will
appear in the final (cropped) text.
\limitatetext {text} {width} {sentinel} \limitatetext {text} {-width} {prelude}
When no width is given, the whole text becomes available. A negative value crops the beginning and the text starts with the prelude. Sentinel and prelude are optional.
Example:
\framed{\limitatetext {Pussy is the name of the cat!}{50mm}{...}} \framed{\limitatetext {Pussy is the name of the cat!}{-50mm}{...}}
Both commands have their range of application.
\limitatetext is more robust, \doboundtext works
better on text that cannot be hyphenated.
TODO: \limitatefirstline