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

« back to all changes in this revision

Viewing changes to prim/help/insertimag.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:
 
1
% @(#)insertimag.hlq    19.1 (ESO-IPG) 02/25/03 14:03:26 
 
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
3
%.COPYRIGHT  (c)  1990 European Southern Observatory
 
4
%.IDENT      insertimag.hlq
 
5
%.AUTHOR     KB, IPG/ESO
 
6
%.KEYWORDS   MIDAS, help files, INSERT/IMAGE
 
7
%.PURPOSE    On-line help file for the command: INSERT/IMAGE
 
8
%.VERSION    1.0  07-MAR-1985 : Creation, KB
 
9
%.VERSION    1.2  14-MAY-1991 : Update, KB
 
10
%----------------------------------------------------------------
 
11
\se
 
12
SECTION./IMAG
 
13
\es\co
 
14
INSERT/IMAGE                                    14-MAY-1991  KB
 
15
\oc\su
 
16
INSERT/IMAGE subframe modframe [startx,y,z]
 
17
        insert a subframe into another frame
 
18
\us\pu
 
19
Purpose: 
 
20
          Insert a subframe into another frame.
 
21
\up\sy
 
22
Syntax:
 
23
          INSERT/IMAGE subframe modframe [startx,y,z]
 
24
\ys\pa
 
25
          subframe = name of image frame which will be inserted in the other
 
26
\ap\pa
 
27
          modframe = name of image frame into which 'subframe' will be inserted;
 
28
\\
 
29
                parts or all of modframe will be overwritten with the pixels
 
30
                of subframe, depending upon the start values
 
31
\ap\pa
 
32
          startx,y,z = optional start coordinates for subframe within modframe;
 
33
\\
 
34
                if omitted the start coords. will be taken from the descriptor
 
35
                START of the subframe
 
36
\ap\sa
 
37
See also:
 
38
          EXTRACT/IMAGE
 
39
\as\no
 
40
Note:  
 
41
          startx,starty,startz can be in any of the following formats:
 
42
\\
 
43
            -  any number, to indicate real world coordinates;
 
44
\\
 
45
            -  an integer number preceded by @, to indicate a pixel number;
 
46
\\
 
47
            -  the symbols "<" and ">", to indicate start or end pixel
 
48
\\
 
49
          the startvalues may also be negative, i.e. "before" the start of
 
50
          the modframe, so that only the overlapping part of the subframe is
 
51
          put into the modframe
 
52
\\
 
53
          since @1 indicates first pixel, @0 means 1 pixel outside and @-1
 
54
          actually puts the begin of the insertion 2 pixels outside modframe!
 
55
\on\exs
 
56
Examples:
 
57
\ex
 
58
          INSERT/IMA sun galaxy
 
59
          insert frame sun.bdf into galaxy.bdf, the position of sun within 
 
60
          galaxy will be determined by descriptor START of sun.bdf
 
61
\xe\ex
 
62
          INSERT/IMA sun galaxy @22,@100
 
63
          insertion of the data of sun.bdf will begin at the 22th x-pixel
 
64
          and the 100th y-pixel of frame galaxy.bdf (assuming, that both frames
 
65
          are 2-dimensional frames)
 
66
\xe\ex
 
67
          INSERT/IMA sun galaxy @-1,@-1
 
68
          insert sun.bdf into galaxy.bdf, sun will begin two pixels and two
 
69
          lines outside of modframe, therefore only from pixel 3 and line 3 on
 
70
          are data overlapping and thus inserted into galaxy.bdf
 
71
\xe \sxe