Changes

There are some rare cases in which it is useful to crop truncate a givenline of text line and loose part discard some of its informationit.

\doboundtext{My entire inheritance goes to my beloved cat Pussy!}{70mm60mm}{...}

\ss\x\doboundtext{My entire inheritance goes to my beloved cat Pussy!}{70mm60mm}{...}

the <tt>prelude</tt>. Sentinel and prelude are both optional.Just look at the example, to see what happens, if you call the macro withtwo positive dimensions...

\limitatetext {Pussy is the name of the cat!}{50mm38mm}{...}\par\limitatetext {Pussy is the name of the cat!}{-50mm38mm}{...}\par\limitatetext {Pussy is the name of the cat!}{12mm, 12mm}{...}

\limitatetext {\ss\x Pussy is the name of the cat!}{50mm38mm}{...}\par\limitatetext {\ss\x Pussy is the name of the cat!}{-50mm38mm}{...}\par\limitatetext {\ss\x Pussy is the name of the cat!}{10mm, 10mm}{...}

called <tt>\limitatefirstline</tt>, which acts nearly like <tt>\doboundtext</tt>,but at a more robust level. This macro first tries to break the given textat character level. It uses nearly the same breaking mechanism as <tt>\limitatetext</tt>,so it shares the problem with nonbreakable text.But in contrast to <tt>\limitatetext</tt> it has a second mechanism, that is only used,if the prior one fails or if the result of breaking is wasting too much space.This fail safe mechanism "simply" clips (no breaking at all) the text to the desiredmeasures. This is done without any consideration to character boundaries.So you must live with the fact, that the last character can be cut off at any possibleplace.

\limitatefirstline {\underbar{The garden's version of \CONTEXT is too oldMr.~Drofnats was happiest when he was at work% typesetting beautiful documents.}{65mm109mm}{\unknown}

{\hbox\bgroup\strut\dontcomplain \setbox\scratchbox\hbox{\begstrut#1\endstrut}%

\global\setbox\plusone\hbox{\strut\unhbox\plusone}% \hbox % to #2 {\ifx\clip\undefined \box\plusone\removeunwantedspaces#3% \else\ifdim\wd\plusone>\hsize \lower\strutdepth\hbox{\clip[\c!width=\hsize,\c!height=\lineheight]{\hbox{\raise\strutdepth\box\plusone}}}% \else\ifdim\wd\plusone<\dimexpr\hsize-6ex\relax% tolerance for "successful" breaking \lower\strutdepth\hbox{\clip[\c!width=\hsize,\c!height=\lineheight]{\hbox{\raise\strutdepth\hbox{\begstrut#31\endstrut}}}}% \else \box\plusone \fi\fi\fi \removeunwantedspaces#3}}% \firemoveunwantedspaces\fihss#3}}%

 \limitatefirstline {\ss\x\underbar{The Mr.~Drofnats was happiest when he was at work typesetting beautiful documents.}}{107mm}{\unknown}</context>  In this example breaking is successful (right after the word typesetting),but the gap between the breaking point and the given width is too big.So clipping is used here. === A direct comparison === {| border="0" cellpadding="5" cellspacing="0"||It's all in the garden.|0123456789|\underbar{In a bar, under the sea}|-|<tt>'''\doboundtext'''</tt>|<context>\ss\x\doboundtext{It's version of all in the garden.}{30mm}{...}</context>|<context>\ss\CONTEXT is too oldx\doboundtext{0123456789}{15mm}{...}</context>|align=center|not possible|-|<tt>'''\limitatetext'''</tt>|<context>\ss\x\limitatetext{It's all in the garden.}{30mm}{...}</context>|<context>\ss\x\limitatetext{0123456789}{15mm}{...}</context>|<context>\ss\x\limitatetext{\underbar{In a bar, under the sea}}{31mm}{...}</context>|-|<tt>'''\limitatefirstline'''</tt>|<context>\ss\x\limitatefirstline{It's all in the garden.}{30mm}{\red...}</context>|<context>\ss\x\limitatefirstline{0123456789}{15mm}{...}</context>|<context>\ss\x\limitatefirstline{\underbar{In a bar, under the sea}}{31mm}{...}</context>|} == Fitting text ==You can fit text into a box by: <texcode>\def\HowStrange#1{#1\ifx#1\blankspace\else\allowbreak\fi} \framed [width=2cm,align={normal,verytolerant,stretch}] {\handletokens There are some rather long titles that needs to be typeset.\with\HowStrange}</texcode> <context>\def\HowStrange#1{#1\ifx#1\blankspace\else\allowbreak\fi} \framed [width=2cm,align={65mmnormal,verytolerant,stretch}] {\unknownhandletokens There are some rather long titles that needs to be typeset.\with\HowStrange}