AppendLayoutObject

AppendLayoutObject [flags] objectType objectName

The AppendLayoutObject operation appends a single object to the top layout or to the layout specified via the /W flag. It targets the active page or the page specified by the /PAGE flag.

Unlike the AppendToLayout operation, AppendLayoutObject can be used in user-defined functions. Therefore, AppendLayoutObject should be used in new programming instead of AppendToLayout.

Parameters

objectType identifies the type of object to be appended. It is one of the following keywords: graph, table, picture, gizmo.

objectName is the name of the graph, table, picture or Gizmo window to be appended.

Use a space between objectType and objectName. A comma is not allowed.

Flags

/D=fidelity

fidelity is 0 to make the object low fidelity or 1 (default) to make it high fidelity. This affects drawing on the screen only, not exporting or printing. Low fidelity is somewhat faster but less accurate. It should be used only for graphs that take a very long time to draw.

/F=frame

frame =0:	No frame.
frame =1:	Single frame (default).
frame =2:	Double frame.
frame =3:	Triple frame.
frame =4:	Shadow frame.

/T=trans

trans =0:	Opaque (default).
trans =1:	Transparent.

For this to be effective, the object itself must also be transparent. Annotations have their own transparent/opaque settings. Graphs are transparent only if their backgrounds are white. PICTs may have been created transparent or opaque, and Igor cannot make an opaque PICT transparent.

/PAGE=page

Appends the object to the specified page.

Page numbers start from 1. To target to the active page, omit /PAGE or use page=0.

The /PAGE flag was added in Igor Pro 7.00.

/R=(l, t, r, b )

Sets the size and position of the object. If omitted, the object is placed with a default size and position. l, t, r, and b are the left, top, right, and bottom coordinates of the object respectively. Coordinates are expressed in units of points, relative to the top/left corner of the paper.

/W=winName

winName is the name of the page layout window to which the object is to be appended. If /W is omitted or if winName is $"", the top page layout is used.