Difference between revisions of "snaptogrid"

From ConTeXt wiki
(new page)
 
 
Line 3: Line 3:
 
|attributes=
 
|attributes=
 
}}
 
}}
 +
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>snaptogrid</syntax>
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==

Latest revision as of 17:26, 10 November 2019

\snaptogrid

Syntax (autogenerated)

\snaptogrid[...]\command{...}
[...]normal standard yes strict tolerant top bottom both broad fit first last high one low none line strut box min max middle math math:line math:halfline math:-line math:-halfline name
\commandCSNAME
{...}CONTENT


\snaptogrid[...,...]\command{...}
[...,...]inherits from \definegridsnapping
\commandCSNAME
{...}CONTENT


Syntax

\snaptogrid[...,...,...]\{h,v}box
[...,...,...] top both bottom -top -both -bottom text high middle low page none standard broad fit depth line dimension


Description

Adjust the placement of a box on the grid. The mandatory argument is an explicit TeX box; box registers defined by \newbox will not work. That leaves \hbox:

\snaptogrid \hbox \bgroup
  content that should be grid aligned
\egroup

and \vbox:

\snaptogrid \vbox {\externalfigure [cow]}

The optional first argument determines the snap method which can be one of the following:

Argument Description
normal height: rounded up; depth: rounded up; enlarge by line height and depth
standard synonym for normal
yes synonym for normal
strict height: rounded up to 0.8 times the line height; depth: rounded up to 0.8times the line height; enlarge by line height and depth
tolerant height: rounded up to 1.2 times the line height; depth: rounded up to 1.2 times the line height; enlarge by line height and depth
top height: rounded down; depth: rounded up; enlarge by line height and depth
bottom height: rounded up; depth: rounded down; enlarge by line height and depth
both height: rounded down; depth: rounded down; enlarge by line height and depth
broad height: rounded up; depth: rounded up; enlarge by line height and depth; snap height and depth reduced by 0.8
fit height: rounded up; depth: rounded up; enlarge by line height and depth; snap height and depth reduced by 1.2
first align to top line
last align to bottom line
high height: rounded down; depth: rounded up; don’t enlarge
one height: rounded down; depth: rounded down
low height: rounded up; depth: rounded down; don’t enlarge
none don’t enlarge
line enlarge both height and depth by one line depth
strut enlarge by height and depth (default)
max synonym for normal
min synonym for both
middle height: rounded up; depth: rounded up

Where snap height and snap depth are the dimensions \globalbodyfontstrutheight and \globalbodyfontstrutdepth, respectively.

Example

\useMPlibrary [dum]
\setuppapersize [A6]
\showgrid
\setuplayout [grid=yes] %% set the global snap method

\def \makedummy {
  %% create a dummy figure with a vsize that is not a multiple of the
  %% leading
  \externalfigure [dummy] [height=\dimexpr4.25\lineheight]%
}

\starttext
  \input ward \par

  method: default
  \snaptogrid\vbox{\makedummy} \par
  \input ward \par

  method: top
  \snaptogrid [top] \vbox{\makedummy} \par
  \input ward \par

  method: line
  \snaptogrid [line] \vbox{\makedummy} \par
  \input ward \par
\stoptext

... yields ...

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: