← Back to branch summary

~ubuntu-branches/debian/jessie/eso-midas/jessie

« back to all changes in this revision

Viewing changes to prim/help/copy_disp.hlq

  • Committer: Package Import Robot
  • Author(s): Ole Streicher
  • Date: 2014-04-22 14:44:58 UTC
  • Revision ID: package-import@ubuntu.com-20140422144458-okiwi1assxkkiz39
Tags: upstream-13.09pl1.2+dfsg
Import upstream version 13.09pl1.2+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
prim/help/copy_disp.hlq
 
1
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
2
%.COPYRIGHT  (c)  1990-2006 European Southern Observatory
 
3
%.IDENT      copy_disp.hlq
 
4
%.AUTHOR     KB, IPG/ESO
 
5
%.KEYWORDS   MIDAS, help files, COPY/DISPLAY
 
6
%.PURPOSE    On-line help file for the command: COPY/DISPLAY
 
7
%.VERSION    1.0  24-JUL-1990 : Creation, KB
 
8
%.VERSION    1.1  07-OCT-1992 : Update, KB
 
9
% 060413        last modif
 
10
%----------------------------------------------------------------
 
11
\se
 
12
SECTION./DISP
 
13
\es\co
 
14
COPY/DISPLAY                                    13-APR-2006  KB
 
15
\oc\su
 
16
COPY/DISPLAY [out_dev] [stop_flg] [ITTdef] [LUTnam] [prflag] [prmode]
 
17
        make a hardcopy of the display on output_device
 
18
\us\pu
 
19
Purpose: 
 
20
          Make a hardcopy of the ImageDisplay on output_device.
 
21
\up\sy
 
22
Syntax: 
 
23
          COPY/DISPLAY [out_dev] [stop_flg] [ITTdef] [LUTnam] [prflag] [prmode]
 
24
\ys\pa
 
25
          out_dev = generic MIDAS name or host system name of output device,
 
26
             if the printer is a colour printer, `printer_name.c' has
 
27
             to be entered
 
28
             defaulted to LASER, the generic MIDAS name for a default
 
29
             black+white Postscript printer
 
30
\ap\pa
 
31
          stop_flg = if set to STOP, only read the contents of ImageDisplay
 
32
              and save them in image frame `screen.ima', but do not create a 
 
33
              PostScript file;
 
34
              defaulted to NOSTOP
 
35
\ap\pa
 
36
          ITTdef = N or P for negative or positive conversion of intensity
 
37
              or I,ITT_name to indicate special ITT to be applied to the data;
 
38
              defaulted to N for grayscale printers, so black -> white and 
 
39
              white -> black;
 
40
              defaulted to P for colour printers, so the colours on the output
 
41
              will be the same as on the image display.
 
42
              Note, however, that any ITT already in effect on the display is
 
43
              always applied to the image data. So if you want an exact copy
 
44
              of the screen, do not enter any ITT (just use N or P if you want
 
45
              to exchange black + white in the hardcopy or not).
 
46
              If you want a different ITT applied to the hardcopy then disable
 
47
              first the ITT on the display, before using COPY/DISPLAY with that
 
48
              specific ITT.
 
49
\ap\pa
 
50
          LUTnam = name of a LUT to be applied to the data;
 
51
              if the loaded image has a real descriptor MIDAS_LUT, this data
 
52
              is taken, if LUT_name is omitted. Else we default to current LUT.
 
53
\ap\pa
 
54
          prflag = print_spec,file_spec
 
55
              if print_spec = NOPRINT, the PostScript file which is created by
 
56
              COPY/DISPLAY is not sent to `out_dev';
 
57
              if print_spec = PRINT, the PostScript file is sent to `out_dev';
 
58
              if file_spec = SAMEFILE, the PostScript file is named 
 
59
              `screenXY.ps' where XY is the Midas unit; 
 
60
              if file_spec = NEWFILE, the PostScript file is named 
 
61
              `screenXY:hr:min:sec.ps' where hr:min:sec is the current time;
 
62
              defaulted to PRINT,SAMEFILE
 
63
\ap\pa
 
64
          prmode = 5-char. flag:
 
65
              (1) = P(ortrait)/L(andscape), (2) C(olor)/B(lack+white),
 
66
              (3) = 4/8 bits per pixel on hardcopy,
 
67
              (4) = N(o background)/B(ackground in blue);
 
68
              (5) = T(ext)/Z(noText) on output 
 
69
              default is PC8NT for COLOUR, PC8B for SLIDE,
 
70
              for all other devices the default is PB8NT
 
71
\ap\sa
 
72
See also:
 
73
          COPY/PSCR, COPY/ZOOM, COPY/GRAPHICS, ASSIGN/DISPLAY
 
74
          HELP [Printers], @a gammacorr
 
75
\as\no
 
76
Note:
 
77
          The parameters may also be referenced via:
 
78
          OUT_DEV= STOP_FLG= ITTDEF= LUTNAM= PRFLAG= PRMODE=
 
79
          The pixel resolution for the PostScript Laser printers can be 
 
80
          controlled by modifying the keyword POSTSCRIPT(1). Default value is
 
81
          21.0 (i.e. 21.0*constant pixels per cm). Use HELP/KEYW POSTSCRIPT
 
82
          to get an explanation of the different elements of POSTSCRIPT.
 
83
          An image frame containing the retrieved info is always created,
 
84
          regardless of the stop_flag, its name is the same as the PostScript
 
85
          file with a file type `.ima' instead of `.ps' .
 
86
          If you work on X11 devices make sure, that the display window is
 
87
          completely inside the screen - otherwise you get an error from the
 
88
          X11 server (at least until release 11.4). Also, make sure that no
 
89
          other window overlaps the display window, else you will find that 
 
90
          back on your hardcopy...
 
91
          Normally, you have an interest in printing an image as closely as
 
92
          possible like it appears on your screen. If your printed output
 
93
          seems bleached out or too dark you should probably apply some 
 
94
          gamma correction which controls the overall brightness of an image.
 
95
          With the help of the Midas application procedure `gammacorr.prg' you
 
96
          get a first guess about the gamma value of your display which you
 
97
          can then refine further.
 
98
 
 
99
          In case you want to include the graphics of the output Postscript 
 
100
          file within Latex (via \includegraphics), you have to change the 
 
101
          bounding boxes of the Postscript file:
 
102
          Replace the "%%BoundingBox: (atend)" in the beginning of the
 
103
          Postscript code by the "%%BoundingBox ..." at the very end of the
 
104
          file which has the real coordinates (using any editor, e.g. vi). 
 
105
 
 
106
\on\exs
 
107
Examples:
 
108
\ex
 
109
          COPY/DISPLAY ps4ipg0 ittdef=p
 
110
            Make hardcopy on grayscale Postscript printer `ps4ipg0'.
 
111
            Keep the same gray levels as in the display window, 
 
112
            i.e. no negative conversion of gray levels is done.
 
113
\ex
 
114
          COPY/DISPLAY pacol4.c ittdef=p
 
115
            As above but use Postscript colour printer for the output.
 
116
\xe\ex
 
117
          COPY/DISPLAY stop_flag=stop 
 
118
            Get a copy of display window in Midas image `screen00.ima' but do
 
119
            not produce a Postscript file of it (so, also nothing sent to
 
120
            the printer).
 
121
\xe\ex
 
122
          WRITE/KEYW postscript/r/3/3 24,0.1,0.1
 
123
          COPY/DISPLAY prmode=pb8nz
 
124
            Increase the size of the hardcopy a lot and omit the text output
 
125
            at the bottom of the copy.  
 
126
            It depends on the specs of the printer used for the output
 
127
            if and how that works...
 
128
\xe\ex
 
129
          COPY/DISPLAY ? ? I,lasritt
 
130
            Make hardcopy on default device and use the ITT `lasritt.itt'.
 
131
\xe\ex
 
132
          COPY/DISPLAY PRFLAG=NO,new
 
133
            Store "hardcopy" of image display in image `screen01:11:14:35.ima',
 
134
            convert it to PostScript file `screen01:11:14:35.ps', but do not
 
135
            print it (assuming that your Midas unit is 01 and the current time
 
136
            is 11:14:35).
 
137
\xe \sxe