summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/isorot/rotman.tex
blob: 6d2fe22d1a726b4bcaed3e545460bd08eeb495a9 (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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
% rotman.tex   User Manual for isorot package
\documentclass[11pt]{article}
\usepackage{isorot}

%\makeatletter
\ifx\pdfoutput\undefined\else
  \pdfoutput=1
\fi
%\makeatother

\setlength{\textheight}{8.0in}
\setlength{\textwidth}{6.0in}
\setlength{\oddsidemargin}{0.25in}
\setlength{\evensidemargin}{0.25in}
\setlength{\marginparwidth}{0.6in}
\setcounter{secnumdepth}{4}
\setcounter{tocdepth}{4}

%
%    remainder of preamble is some special macro definitions
\makeatletter
%   the \meta{} command
%
\begingroup
\obeyspaces%
\catcode`\^^M\active%
\gdef\meta{\begingroup\obeyspaces\catcode`\^^M\active%
\let^^M\do@space\let \do@space%
\def\-{\egroup\discretionary{-}{}{}\hbox\bgroup\it}%
\m@ta}%
\endgroup
\def\m@ta#1{\leavevmode\hbox\bgroup\texttt{<}\textit{#1}\/\texttt{>}\egroup
    \endgroup}
\def\do@space{\egroup\space
    \hbox\bgroup\it\futurelet\next\sp@ce}
\def\sp@ce{\ifx\next\do@space\expandafter\sp@@ce\fi}
\def\sp@@ce#1{\futurelet\next\sp@ce}
%
\makeatother

%
\makeatletter
%
% the \latex command
\newcommand{\latex}{\LaTeX}
\newcommand{\tex}{\TeX}
%
%   the \file{} command
%
\newcommand{\file}[1]{\textsf{#1}}
%
% example and note environments
\newenvironment{example}{\begin{quotation}\small\textbf{Example: }}{\par\end{quotation}}
\newenvironment{note}{\begin{quotation}\small\textbf{Note: }}{\par\end{quotation}}

% internal refs
\newcommand{\tref}[1]{Table~\ref{#1}}
\newcommand{\fref}[1]{Figure~\ref{#1}}

%   index a command
\newcommand{\bs}{\symbol{'134}}
\newcommand{\ixcom}[1]{\index{#1/ @{\tt \protect\bs #1}}}
%   index an environment
\newcommand{\ixenv}[1]{\index{#1 @{\tt #1} (environment)}}
%   index a starred environment
\newcommand{\ixenvs}[1]{\index{#1s @{\tt #1*} (environment)}}
%   index an option
\newcommand{\ixopt}[1]{\index{#1 @{\tt #1} (option)}}
%   index a package
\newcommand{\ixpack}[1]{\index{#1 @\file{#1} (package)}}
%   index a class
\newcommand{\ixclass}[1]{\index{#1 @\file{#1} (class)}}
%   index in typewriter font
\newcommand{\ixtt}[1]{\index{#1@{\tt #1}}}
%   index LaTeX
\newcommand{\ixltx}{\index{latex@\latex}}
%   index LaTeX 2e
\newcommand{\ixltxe}{\index{latex2e@\latex 2e}}
%   index LaTeX v2.09
\newcommand{\ixltxv}{\index{latex209@\latex{} v2.09}}
\makeatother
%
%   end of preamble
%

\title{The \file{isorot} Package User Manual}
\author{Peter Wilson\\ \texttt{peter.r.wilson@boeing.com}}
\date{15 February 2000}

\begin{document}
\pagenumbering{roman}
\maketitle

\begin{abstract}
The facilities in the \file{isorot} package are described. The package
was initially designed for use with the \file{iso} class but can be used
with the `normal' classes as well. The package enables the rotation of 
document elements, like text or tables of figures.
\end{abstract}
\tableofcontents
\listoffigures
\listoftables
\clearpage
\pagestyle{headings}
\pagenumbering{arabic}


\section{Introduction}

   The \file{isorot} package enables the rotation of document elements on
a page. It uses the \latex{} \verb|\special| command to perform its
effects, and thus can only be used
with a limited number of \TeX{} to print routes. The facilities
available are summarized in \tref{tab4}.

    \file{isorot} is a modification of the \file{rotation.sty} file
created by Rahtz and Barroca~\cite{rahtz}. Further examples of the usage
of their style are given in Goosens \emph{et al}~\cite{goosens}. The
package also uses David Carlisle's \file{graphicx} and \file{lscape}
packages.

\begin{note}Several examples of the effects of the commands described herein
are shown. In many cases the results are not pretty. This should act as
a warning that using rotational elements requires more care than
most other document elements.\end{note} %end note

\begin{sidewaystable}
\ixcom{rotdriver} \ixcom{clockwise} \ixcom{counterclockwise}
\ixcom{figuresright} \ixcom{figuresleft} \ixcom{rotcaption}
\ixcom{controtcaption}
\ixenv{sideways} \ixenv{turn} \ixenv{rotate} \ixenv{sidewaystable}
\ixenv{sidewaysfigure} \ixenv{landscape}
\centering
\caption{The rotation facilities} \label{tab4}
\begin{tabular}{|l|l|} \hline
\textbf{Facility} & \textbf{Effect} \\ \hline
\multicolumn{2}{|c|}{\textbf{Commands}} \\ \hline
\verb|\rotdriver{<driver>}| & 
declare the name of the dvi to Postscript translator (default {\tt dvips}) \\
\verb|\clockwise| & 
sets rotation direction clockwise for positive angles (the default) \\
\verb|\counterclockwise| &
sets rotation direction counterclockwise for positive angles \\
\verb|\figuresright| &
sets rotation direction for sideways floats counterclockwise (the default) \\
\verb|\figuresleft| &
sets rotation direction for sideways floats clockwise \\
\verb|\rotcaption| &
like the \verb|caption| command, but rotates the caption through 90 degrees \\
\verb|\controtcaption| &
like the \verb|contcaption| command, but rotates the caption through 90 degrees \\ \hline
\multicolumn{2}{|c|}{\textbf{Environments}} \\ \hline
\verb|sideways| &
rotates the contents through 90 degrees counterclockwise \\
\verb|turn| &
rotates the contents through the given angle \\
\verb|rotate| &
rotates the contents through the given angle, but no space allowed for the result\\
\verb|sidewaystable| &
like the \verb|table| environment, but rotated 90 degrees \\
\verb|sidewaystable*| &
twocolumn version of \verb|sidewaystable| \\
\verb|sidewaysfigure| &
like the \verb|figure| environment, but rotated 90 degrees \\
\verb|sidewaysfigure*| &
twocolumn version of \verb|sidewaysfigure| \\
\verb|landscape| &
prints all enclosed pages in landscape mode \\ \hline
\end{tabular}
\end{sidewaystable}

\section{Options}

    The \file{isorot} facility has one option, 
namely \verb|debugshow|\ixopt{debugshow}. Calling this option produces
messages on the screen and in the \file{log} file regarding the actions 
being taken.

\begin{note} This option is principally of interest to the maintainer
of the facility. \end{note}

    The font used for the captions of rotated figures or tables is controlled
by the \verb|rotcapfont| command. Under normal circumstances this is a null
command but when used with the \file{iso} class it is defined as: \\
\verb|\newcommand{\rotcapfont}{\captionsisize\bf}| \\
 where \verb|\captionsize| is defined in the class. You can renew 
\verb|\rotcapfont| to change the caption font to your liking. 

\section{DVI drivers}

    The \file{isorot} facility supports only a limited number of
dvi to postscript translators. The default translator is \emph{dvips}.
 The following command must be put in
the preamble of the document if \emph{dvips} is not being used: 
\verb|\rotdriver{<drivername>}|,\ixcom{rotdriver} where
\verb|<drivername>| is one of the following:\footnote{I have been able to 
try the {\tt dvips} driver
but not the others. If anyone has experience with the other drivers, or has
extended the range of drivers, I would like to be given the results.} %end footnote

\begin{enumerate}
\item \verb|dvipdf| for the \emph{dvipdf} 
      translator;\ixtt{dvipdf}
\item \verb|dvips| for Tom Rockicki's \emph{dvips} 
      translator;\ixtt{dvips}
\item \verb|dvipsone| for Y\&Y's \emph{dvipsone} 
      translator;\ixtt{dvipsone}
\item \verb|dvitops| for James Clark's \emph{dvitops} 
      translator;\ixtt{dvitops}
\item \verb|dviwindo| for Y\&Y's \emph{dviwindo} 
      translator;\ixtt{dviwindo}
\item \verb|pctex32| for Personal TeX's PC TeX for 32 bit Windows 
      (\emph{pctex32})
      translator;\ixtt{pctex32}
\item \verb|pctexps| for Personal TeX's PC PTI Laser/PS (\emph{pctexps})
      translator;\ixtt{pctexps}
\item \verb|pubps| for the Arbortext's \emph{pubps} 
      translator.\ixtt{pubps}
\item \verb|textures| for Blue Sky's \emph{Textures} 
      translator;\ixtt{textures}

\end{enumerate}

    The \file{isorot} package can also be used in documents processed
by pdfLaTeX.

\section{Rotational directions}

    \file{isorot} enables the textual and other elements of a document
to be rotated from their normal horizontal layout. In some cases elements
can be rotated through arbitrary angles, whereas in others only 90 degree
rotation is possible. 

    By default, a rotation through a positive number of
degrees corresponds to a clockwise rotation. The command 
\verb|\counterclockwise|\ixcom{counterclockwise}
sets the following rotations to be counterclockwise for positive angles.
The command \verb|\clockwise|\ixcom{clockwise}
sets the following rotations to be clockwise for positive angles.
These commands can be used to toggle the rotational behavior.
    

    Rotated floating environments are normally rotated so that they are
printed with a counterclockwise rotation (i.e. the original bottom of the float
is placed at the right hand side of the paper), 
which is what is normally required.
This behavior can be altered by the command
\verb|\figuresleft|,\ixcom{figuresleft}
which will give the reverse effect. The command
\verb|\figuresright|\ixcom{figuresright}
will set the behavior to the default.
These commands can be used to toggle the rotational behavior of
floats.


\section{Rotation of text}

    The \verb|sideways|\ixenv{sideways}
environment rotates the contents of the environment
by 90 degrees counterclockwise, and leaves space for the result.

    The \verb|\begin{turn}{|\meta{angle}\verb|}|\ixenv{turn}
environment rotates the contents by the given number
of degrees in the direction specified by the most recent of the
\verb|\clockwise|\ixcom{clockwise} or
\verb|\counterclockwise|\ixcom{counterclockwise}
commands, leaving space for the result.

    The \verb|\begin{rotate}{|\meta{angle}\verb|}|\ixenv{rotate}
environment rotates the contents by the given number
of degrees in the direction specified by the most recent of the
\verb|\clockwise|\ixcom{clockwise} or
\verb|\counterclockwise|\ixcom{counterclockwise}
commands, but no arrangements are made for leaving space for the result.


\begin{example}Some simple rotations: \label{ex:1}

This code
\begin{verbatim}
Default rotation direction: \\
A 
\begin{sideways}%
B C
\end{sideways}
D E F G H I J K L M
\begin{turn}{-90}%
Minus 90 turn
\end{turn}
N O P
\begin{rotate}{90}%
Plus 90 rotate
\end{rotate}
Q \\
and continue on with another line after rotations.
\end{verbatim}
produces the following (note how space is allowed for the \verb|turn|ed 
text, whereas the \verb|rotate|d text runs into the text below).

Default rotation direction: \\
A 
\begin{sideways}%
B C
\end{sideways}
D E F G H I J K L M
\begin{turn}{-90}%
Minus 90 turn
\end{turn}
N O P
\begin{rotate}{90}%
Plus 90 rotate
\end{rotate}
Q \\
and continue on with another line after rotations.
\end{example} % end example
\begin{example}This example shows the effect of using the 
\verb|\counterclockwise|\ixcom{counterclockwise}
command.

This code
\begin{verbatim}
Flip rotation direction: \\
\counterclockwise
A 
\begin{sideways}%
B C
\end{sideways}
D E F G H I J K L M
\begin{turn}{-90}%
Minus 90 turn
\end{turn}
N O P
\begin{rotate}{90}%
Plus 90 rotate
\end{rotate}
Q \\
Set rotation direction back to default value.
\clockwise
\end{verbatim}

produces the following, which should be compared with example~\ref{ex:1}.

Flip rotation direction: \\
\counterclockwise
A 
\begin{sideways}%
B C
\end{sideways}
D E F G H I J K L M
\begin{turn}{-90}%
Minus 90 turn
\end{turn}
N O P
\begin{rotate}{90}%
Plus 90 rotate
\end{rotate}
Q \\
Set rotation direction back to default value.
\clockwise
\end{example} % end example


    Although the examples so far have only shown the rotation of text, boxes
can also be rotated.

\begin{example}Rotating a box.

This code
\begin{verbatim}
\newsavebox{\foo}
\newlength{\fool}
\settowidth{\fool}{Hurrah for ISO.}
\savebox{\foo}{\parbox{\fool}{Hurrah for ISO. Hurrah for ISO.
                              Hurrah for ISO. Hurrah for ISO.}}
Start
\usebox{\foo}
\&
\begin{turn}{-45}\usebox{\foo}\end{turn}
\&
\begin{turn}{45}\usebox{\foo}\end{turn}
End
\end{verbatim}
produces:

\newsavebox{\foo}
\newlength{\fool}
\settowidth{\fool}{Hurrah for ISO.}
\savebox{\foo}{\parbox{\fool}{Hurrah for ISO. Hurrah for ISO.
                              Hurrah for ISO. Hurrah for ISO.}}
Start
\usebox{\foo}
\&
\begin{turn}{-45}\usebox{\foo}\end{turn}
\&
\begin{turn}{45}\usebox{\foo}\end{turn}
End

\end{example} %end example

    Elements can be rotated through arbitrary angles, and also rotated
elements can be nested inside other rotated elements.


\begin{example}Repeated rotation:

    The following example code shows that text can be rotated through any angle.
The result is shown in \fref{fig:wheel}.
\begin{verbatim}
\newcount\prwc
\newsavebox{\prwtext}
\newdimen\prwspace
\def\wheel#1#2{%
  \savebox{\prwtext}{#1\begin{sideways}#2\end{sideways}}%
  \prwspace\wd\prwtext%
  \advance\prwspace by 1cm%
  \centerline{%
  \rule{0pt}{\prwspace}%
  \rule[-\prwspace]{0pt}{\prwspace}%
  \prwc=-180\loop\ifnum\prwc<180
  \rlap{\begin{rotate}{\the\prwc}%
  \rule{1cm}{0pt}\usebox{\prwtext}\end{rotate}}%
  \advance\prwc by 20\repeat}}
\begin{figure}
\wheel{Express yourself ---}{Hooray for STEP!}
\caption{Example rotation through multiple angles}
\label{fig:wheel}
\end{figure}
\end{verbatim}

\newcount\prwc
\newsavebox{\prwtext}
\newdimen\prwspace
\def\wheel#1#2{%
  \savebox{\prwtext}{#1\begin{sideways}#2\end{sideways}}%
  \prwspace\wd\prwtext%
  \advance\prwspace by 1cm%
  \centerline{%
  \rule{0pt}{\prwspace}%
  \rule[-\prwspace]{0pt}{\prwspace}%
  \prwc=-180\loop\ifnum\prwc<180
  \rlap{\begin{rotate}{\the\prwc}%
  \rule{1cm}{0pt}\usebox{\prwtext}\end{rotate}}%
  \advance\prwc by 20\repeat}}
\begin{figure}
\vspace*{1cm}
\wheel{Express yourself ---}{Hooray for STEP!}
\vspace*{1cm}
\caption{Example rotation through multiple angles}
\label{fig:wheel}
\end{figure}
\end{example} %end example

    Later in the manual, Figures~\ref{fig:angles1} and~\ref{fig:angles2} 
also show rotations through a
range of angles, both positive and negative.

\begin{example}Nested rotations. \label{ex:sidetabular}

This code
\begin{verbatim}
    Here is some text before a \verb|sideways| environment. 
And some more, and more and more garble gobble cluck
click clack clock cluck and so on and on and on.
\begin{center}
\begin{sideways}
\rule{1in}{0pt}
\begin{tabular}{|lr|}
\begin{rotate}{-45}\emph{Word}\end{rotate} & \begin{rotate}{-90}%
Occurrences\end{rotate}
\\
\hline
hello & 33 \\
goodbye & 34 \\
\hline
\end{tabular}
\end{sideways}
\end{center}
    Here is some text after a \verb|sideways| environment.
 And some more, and more and more garble gobble cluck
click clack clock cluck and so on and on and on.
\end{verbatim}
produces:

    Here is some text before a \verb|sideways| environment. 
And some more, and more and more garble gobble cluck
click clack clock cluck and so on and on and on.
\begin{center}
\begin{sideways}
%\rule{1in}{0pt}
\begin{tabular}{|lr|}
\begin{rotate}{-45}\emph{Word}\end{rotate} & \begin{rotate}{-90}%
Occurrences\end{rotate} \\ \hline
hello & 33 \\
goodbye & 34 \\ \hline
\end{tabular}
\end{sideways}
\end{center}
    Here is some text after a \verb|sideways| environment.
 And some more, and more and more garble gobble cluck
click clack clock cluck and so on and on and on.
\end{example} %end example



\section{Rotations of tables and figures}

    The previous examples have demonstrated the rotation of textual elements.
For instance, the last one showed that tabular material can be rotated using
the \verb|sideways|\ixenv{sideways}
environment. (Actually, any of the previously
mentioned environments could have been used instead.)
Two further environments are provided which rotate a \latex{} float through
90 degrees. These are:
\begin{itemize}
\item \verb|sidewaystable|\ixenv{sidewaystable}, which
  corresponds to the standard \latex{} \verb|table|\ixenv{table}
  environment; and
\item \verb|sidewaysfigure|\ixenv{sidewaysfigure}, which
  corresponds to the standard \latex{} \verb|figure|\ixenv{figure}
  environment.
\end{itemize}
There are also starred versions of these, namely 
\verb|sidewaystable*|\ixenvs{sidewaystable} and
\verb|sidewaysfigure*|\ixenvs{sidewaysfigure}, for use in twocolumn mode.
However, the correspondence with the standard environments is not strictly
complete as a sideways float is alway placed on a page by itself.

    The direction of rotation may be controlled by the 
\verb|\figuresright|\ixcom{figuresright} and
\verb|\figuresleft|\ixcom{figuresleft} commands.

\begin{example}Table~\ref{tab4} was produced by the code below: \label{ex:4}

\begin{verbatim}
\begin{sidewaystable}
\centering
\caption{The rotation facilities} \label{tab4}
\begin{tabular}{|l|l|} \hline
\textbf{Facility} & \textbf{Effect} \\ \hline
\multicolumn{2}{|c|}{\textbf{Commands}} \\ \hline
\verb|\rotdriver{<driver>}| & 
declare the name of the dvi to Postscript translator (default {\tt dvips}) \\
......
\verb|sidewaysfigure| &
like the \verb|figure| environment, but rotated 90 degrees \\ \hline
\end{tabular}
\end{sidewaystable}
\end{verbatim}
\end{example} % end example



\section{Rotation of float captions and bodies}

    Sometimes it may be useful to rotate a caption independently of the
rotation of a figure or table. The command 
\verb|\rotcaption|\ixcom{rotcaption} is analogous
to the normal \verb|\caption|\ixcom{caption} command, 
and inserts the caption rotated
by 90~degrees. There is also the companion command 
\verb|\controtcaption|\ixcom{controtcaption}, analagous to the
\verb|\contcaption|\ixcom{contcaption} command,
for continuation captions.

%\newsavebox{\picbox}

\begin{figure}
\centering
\caption{Example figure with a standard caption.} \label{fig:nocrot}
\setlength{\unitlength}{0.2in}
\footnotesize
\begin{picture}(17,2)
\thicklines
\put(0,0){\begin{picture}(4,1)
  \put(1.5,0.5){\oval(3,1)}
  \put(1.5,0.5){\makebox(0,0){2,5 (1)}}
  \put(3,0.5){\line(1,0){1.0}}
  \put(4.25,0.5){\circle{0.5}}
  \end{picture}}

\put(4.5,0){\begin{picture}(8,1)
  \put(0,0){\dashbox{0.25}(4,1){date}}
  \put(4,0.5){\line(1,0){3.5}}
  \put(7.75,0.5){\circle{0.5}}
  \put(6,1){\makebox(0,0){A[1:3]}}
  \end{picture}}

\put(12.5,0){\begin{picture}(4,1)
  \put(0,0){\framebox(4,1){INTEGER}}
  \put(3.75,0){\line(0,1){1}}
  \end{picture}}
\end{picture}
\normalsize
\setlength{\unitlength}{1pt}
\end{figure}


\begin{example}Float with a regular caption.

Figure~\ref{fig:nocrot} is produced by the code below:
\begin{verbatim}
\begin{figure}
\centering
\caption{Example figure with a standard caption.} \label{fig:nocrot}
\setlength{\unitlength}{0.2in}
\footnotesize
\begin{picture}(17,2)
\thicklines
\put(0,0){\begin{picture}(4,1)
  \put(1.5,0.5){\oval(3,1)}
  \put(1.5,0.5){\makebox(0,0){2,5 (1)}}
  \put(3,0.5){\line(1,0){1.0}}
  \put(4.25,0.5){\circle{0.5}}
  \end{picture}}
\put(4.5,0){\begin{picture}(8,1)
  \put(0,0){\dashbox{0.25}(4,1){date}}
  \put(4,0.5){\line(1,0){3.5}}
  \put(7.75,0.5){\circle{0.5}}
  \put(6,1){\makebox(0,0){A[1:3]}}
  \end{picture}}
\put(12.5,0){\begin{picture}(4,1)
  \put(0,0){\framebox(4,1){INTEGER}}
  \put(3.75,0){\line(0,1){1}}
  \end{picture}}
\end{picture}
\normalsize
\setlength{\unitlength}{1pt}
\end{figure}
\end{verbatim}
\end{example} % end example

\begin{example}Float with a rotated caption.

Figure~\ref{fig:crot} is produced by the code below:
\begin{verbatim}
\begin{figure}
\centering
\rotcaption{Figure~\protect\ref{fig:nocrot} with a rotated caption.}
 \label{fig:crot}
\setlength{\unitlength}{0.2in}
\footnotesize
\begin{picture}(17,2)
...
\end{picture}
\normalsize
\setlength{\unitlength}{1pt}
\end{figure}
\end{verbatim}
\end{example} % end example


\begin{figure}
\centering
\rotcaption{Figure~\protect\ref{fig:nocrot} with a rotated caption.}
 \label{fig:crot}
\setlength{\unitlength}{0.2in}
\footnotesize
\begin{picture}(17,2)
\thicklines
\put(0,0){\begin{picture}(4,1)
  \put(1.5,0.5){\oval(3,1)}
  \put(1.5,0.5){\makebox(0,0){2,5 (1)}}
  \put(3,0.5){\line(1,0){1.0}}
  \put(4.25,0.5){\circle{0.5}}
  \end{picture}}
\put(4.5,0){\begin{picture}(8,1)
  \put(0,0){\dashbox{0.25}(4,1){date}}
  \put(4,0.5){\line(1,0){3.5}}
  \put(7.75,0.5){\circle{0.5}}
  \put(6,1){\makebox(0,0){A[1:3]}}
  \end{picture}}
\put(12.5,0){\begin{picture}(4,1)
  \put(0,0){\framebox(4,1){INTEGER}}
  \put(3.75,0){\line(0,1){1}}
  \end{picture}}
\end{picture}
\normalsize
\setlength{\unitlength}{1pt}
\end{figure}

    As can be seen from \fref{fig:crot} the advisability of rotating a caption
depends on the size of the body of the float. It may be better in certain
cases to leave the caption in its regular position and rotate the body of
the float instead.

\def\prwrot#1{%
\settowidth{\fool}{ISOROT}
\savebox{\foo}{\parbox{\fool}{ISOROT ISOROT ISOROT ISOROT}}%
\framebox{---\begin{turn}{#1}\framebox{\usebox{\foo}}\end{turn}---}}%
\def\degrees{{\small$^{o}$}}

\begin{figure}
\centering
\begin{tabular}{|c|c|c|} \hline
\prwrot{0} &\prwrot{-40}&\prwrot{-80}\\
0\degrees & -40\degrees & -80\degrees \\ \hline
\prwrot{-120}&\prwrot{-160}&\prwrot{-200}\\
-120\degrees & -160\degrees & -200\degrees \\ \hline
\prwrot{-240}&\prwrot{-280}&\prwrot{-320}\\
-240\degrees & -280\degrees & -320\degrees \\ \hline
\end{tabular}
\caption{Rotation of paragraphs between 0 and -320 degrees} \label{fig:angles1}
\end{figure}


\begin{example}Regular caption and float.

Figure~\ref{fig:angles1} is a regular figure and caption. It is produced by
the following code:
\begin{verbatim}
\def\prwrot#1{%
\settowidth{\fool}{ISOROT}
\savebox{\foo}{\parbox{\fool}{ISOROT ISOROT ISOROT ISOROT}}%
\framebox{---\begin{turn}{#1}\framebox{\usebox{\foo}}\end{turn}---}}%
\def\degrees{{\small$^{o}$}}
\end{verbatim}

\begin{verbatim}
\begin{figure}
\centering
\begin{tabular}{|c|c|c|} \hline
\prwrot{0} &\prwrot{-40}&\prwrot{-80}\\
0\degrees & -40\degrees & -80\degrees \\ \hline
\prwrot{-120}&\prwrot{-160}&\prwrot{-200}\\
-120\degrees & -160\degrees & -200\degrees \\ \hline
\prwrot{-240}&\prwrot{-280}&\prwrot{-320}\\
-240\degrees & -280\degrees & -320\degrees \\ \hline
\end{tabular}
\caption{Rotation of paragraphs between 0 and -320 degrees} \label{fig:angles1}
\end{figure}
\end{verbatim}
\end{example} % end example


\begin{figure}
\centering
\begin{sideways}
\begin{tabular}{|c|c|c|} \hline
\prwrot{0} &\prwrot{40}&\prwrot{80}\\
0\degrees & 40\degrees & 80\degrees \\ \hline
\prwrot{120}&\prwrot{160}&\prwrot{200}\\
120\degrees & 160\degrees & 200\degrees \\ \hline
\prwrot{240}&\prwrot{280}&\prwrot{320}\\
240\degrees & 280\degrees & 320\degrees \\ \hline
\end{tabular}
\end{sideways}
\caption[Rotation of paragraphs between 0 and 320 degrees]%
        {Rotation of paragraphs between 0 and 320 degrees (with figure
         body turned sideways)}\label{fig:angles2}
\end{figure}

\begin{example}Regular caption and rotated float body.

Figure~\ref{fig:angles2} is a regular figure and caption where the figure
contents have been rotated. It was produced by the following code.
\begin{verbatim}
\begin{figure}
\centering
\begin{sideways}
\begin{tabular}{|c|c|c|} \hline
\prwrot{0} &\prwrot{40}&\prwrot{80}\\
0\degrees & 40\degrees & 80\degrees \\ \hline
\prwrot{120}&\prwrot{160}&\prwrot{200}\\
120\degrees & 160\degrees & 200\degrees \\ \hline
\prwrot{240}&\prwrot{280}&\prwrot{320}\\
240\degrees & 280\degrees & 320\degrees \\ \hline
\end{tabular}
\end{sideways}
\caption[Rotation of paragraphs between 0 and 320 degrees]%
        {Rotation of paragraphs between 0 and 320 degrees (with figure
         body turned sideways)}\label{fig:angles2}
\end{figure}
\end{verbatim}
\end{example} % end example

\begin{landscape}
\section{Landscaping}

    \latex{} normally prints in portrait mode. 
The \verb|landscape|\ixenv{landscape} environment
prints all the enclosed stuff in landscape mode, except for headers
and footers which are not rotated.

\begin{example} Landscaping

The source for this part of the document is:
\begin{verbatim}
\begin{landscape}
\section{Landscaping}

    \latex{} normally prints in portrait mode. The ...
...
... long, wide tables.
\end{landscape}
\end{verbatim}
\end{example}

    The environment starts by clearing the current page and then switches
to portrait mode. At the end of the environment the current page is cleared
and the next page is back to normal portrait mode. 

    All the other rotation commands and environments produce boxes and
\latex{} will not break a box across a page. The \verb|landscape| environemt
does not produce a box and so many pages can be printed in landscape mode
with \latex{} taking care of the page breaking for you. 

    Landscape mode is not particularly useful for normal text as the
lines are far too long for comfortable reading. Where it can be useful
is where you have a table that is too wide to fit on a portrait page, so
needs to be rotated, yet is also too long to fit on the page when it is
rotated. The \file{supertabular}\ixpack{supertabular},
the \file{longtable}\ixpack{longtable},
and the \file{xtab}\ixpack{xtab}
packages provide facilities for automatically breaking long tables across 
pages. Any of these can be used in conjunction with landscaping to both 
rotate and automatically page break long, wide tables.
\end{landscape}


%%%%%%%%%%%%%%
%\end{document}
%%%%%%%%%%%%%

\bibliographystyle{alpha}
\begin{thebibliography}{GMS94}

\bibitem[GMS94]{goosens}
Michel Goossens, Frank Mittelbach and Alexander Samarin.
\newblock \textit{The LaTeX Companion}.
\newblock Addison-Wesley Publishing Co. 1994.

\bibitem[RB92]{rahtz}
Sebastian Rahtz and Leonor Barroca.
\newblock \textit{A style option for rotated objects in LaTeX}.
\newblock TUGBoat, volume 13, number 2, pp 156--180, July 1992.

\end{thebibliography}

\end{document}

\begin{references}
\reference{LAMPORT, L.,}{LaTeX --- A Document Preparation System,}
            {Addison-Wesley Publishing Co., 2nd edition, 1994.} \label{lamport}
\reference{WILSON, P.R.,}{LaTeX files for typesetting ISO standards:
           Source code,}
           {NISTIR,  National Institute of Standards and Technology,
           Gaithersburg, MD 20899. June 1996.} \label{isoe}
\reference{WILSON, P.R.,}{LaTeX package files for ISO~10303: User manual,}
           {NISTIR,  National Institute of Standards and Technology,
           Gaithersburg, MD 20899. June 1996.} \label{stepsty}
\reference{RAHTZ, S., and BARROCA, L.,}{A style option for rotated
           objects in \latex,}{ TUGBoat, volume 13, number 2, pp 156--180, 
           July 1992.} \label{rahtz}
\reference{GOOSSENS, M., MITTELBACH, F. and SAMARIN, A.,}{%
           The LaTeX Companion,}
           {Addison-Wesley Publishing Co., 1994.} \label{goosens}
\reference{GOOSSENS, M., and RAHTZ, S.,}{%
           The LaTeX Web Companion --- Integrating TeX, HTML and XML,}
           {Addison-Wesley Publishing Co., 1999.} \label{lwebcom}
\reference{CHEN, P. and HARRISON, M.A.,}{Index preparation and
           processing,}{Software--Practice and Experience, 19(9):897--915,
           September 1988.} \label{chen}
\reference{KOPKA, H. and DALY, P.W.,}{A Guide to LaTeX,}
           {Addison-Wesley Publishing Co., 1993.} \label{kopka}
\reference{WALSH, N.,}{Making TeX Work,}{O'Reilly \& Associates, Inc.,
           103 Morris Street, Suite A, Sebastopol, CA 95472. 1994. } \label{walsh}
\reference{ISO 8879:1986,}{Information processing --- 
                                Text and office systems ---
           Standard Generalized Markup Language (SGML).}{} \label{sgml}
\reference{GOLDFARB, C.F.,}{The SGML Handbook,}
           {Oxford University Press, 1990.} \label{goldfarb}
\reference{BRYAN, M.,}{SGML --- An Author's Guide to the Standard Generalized
           Markup Language,}{Addison-Wesley Publishing Co., 1988. } \label{bryan}
\reference{PHILLIPS, L. and LUBELL, J.,}{An SGML Environment for STEP,}%
          {NISTIR 5515, National Institute of Standards and Technology,
           Gaithersburg, MD 20899. November 1994.} \label{pandl}
\reference{WILSON, P. R.,}{LTX2X: A LaTeX to X Auto-tagger,}%
          {NISTIR, National Institute of Standards and Technology,
           Gaithersburg, MD 20899. June 1996.} \label{ltx2x}
\reference{RESSLER, S.,}{The National PDES Testbed Mail Server User's Guide,}
           {NSTIR 4508, National Institute of Standards and Technology,
           Gaithersburg, MD 20899. January 1991.} \label{ressler}
\reference{RINAUDOT, G.R.,}{STEP On Line Information Service (SOLIS),}
          {NISTIR 5511, National Institute of Standards and Technology,
          Gaithersburg, MD 20899. October 1994. } \label{rinaudot}
\reference{KROL, E.,}{The Whole Internet --- User's Guide \& Catalog,}
           {O'Reilly \& Associates, Inc.,
           103 Morris Street, Suite A, Sebastopol, CA 95472. 1993. } \label{krol}
\reference{WILSON, P.R.,}{The hyphenat package,}%
          {1999. (Available from CTAN)} \label{bib:hyphenat}
\reference{WILSON, P.R.,}{The xtab package,}%
          {1998. (Available from CTAN)} \label{bib:xtab}
\end{references}



\end{document}