5.4.3.1 Destination types for pdftex and dvipdfm

xyz

“Current position”. The option zoom specifies magnification to use (zero or empty means leave magnification unchanged, which is the default). This is the default type.

For dvipdfm: the options left and top specify position coordinates to use (empty options mean current position coordinate, which is the default).

Example: \hldest{xyz}{zoom=2000}{dest123}

fit

Fit the page to the window.

Example: \hldest{fit}{}{dest123}

fith

Fit the width of the page to the window.

For dvipdfm: the top option specifies vertical position (default is empty, meaning current position).

Example: \hldest{fith}{}{dest123}

fitv

Fit the height of the page to the window.

For dvipdfm: The option left specifies horizontal position (default is empty, meaning current position).

Example: \hldest{fitv}{}{dest123}

fitb

Fit the page's bounding box to the window.

Example: \hldest{fitb}{}{dest123}

fitbh

Fit the width of the page's bounding box to the window.

For dvipdfm: the option top specifies vertical position (default is empty, meaning current position).

Example: \hldest{fitbh}{}{dest123}

fitbv

Fit the height of the page's bounding box to the window.

For dvipdfm: the option left specifies horizontal position (default is empty, meaning current position).

Example: \hldest{fitbv}{}{dest123}

fitr

For pdftex: fit the rectangle specified by the options width, height and depth (as a TeX rule specification) in the window. For dimensions set to empty, the corresponding value of the parent box is used (these are the defaults).

For dvipdfm: fit the rectangle specified by the options left, bottom, right and top (in PostScript points, 72 points per inch) in the window. For dimensions set to empty, current position coordinate is substituted (these are the defaults).

Example for pdftex:

          \hldest{fitr}{width=\hsize,
                        height=.5\vsize,depth=0pt}{dest123}
     

Example for dvipdfm:

          \hldest{fitr}{left=72,bottom=72,
                        right=720,top=360}{dest123}
     

raw

The destination specification (in the form of a pdfTeX command or a dvipdfm \special) is taken from the command sequence \cs, where cs is the value of the cmd option. In the definition of \cs, use \@hllabel to refer to the hyperlink label. This option is intended to be used with destgroups (see Setting hyperlink types and options), as it does not make sense in a direct call to \hldest—you can just call the raw command.

Example for pdftex:

          \makeatletter
          \def\mydest{\pdfdest name{\@hllabel} xyz}
          \resetatcatcode
          \hldesttype{raw}
          \hldestopts{cmd=mydest}
     

Example for dvipdfm:

          \makeatletter
          \def\mydest{\special{pdf: dest (\@hllabel)
                                    [@thispage /XYZ @xpos @ypos 0]}}
          \resetatcatcode
          \hldesttype{raw}
          \hldestopts{cmd=mydest}