Skip to main content

SetDrawLayer

SetDrawLayer [/W=winName /K] layerName​

The SetDrawLayer operation makes all future drawing operations use the named layer.

Parameters​

Valid layerNames for graphs:

ProgBackUserBackProgAxesUserAxesProgFront

ProgTop UserTop Overlay

Valid layerNames for page layouts:

ProgBackUserBackProgFrontUserFrontOverlay
Valid layerNames for control panels:
ProgBackUserBackProgFrontUserFrontOverlay

There are really only three layers for control panels. ProgFront is treated as an alias for ProgBack and UserFront is treated as an alias for UserBack.

Flags​

/Kkills (erases) the given layer.
/W = winNamespecifies the named window for drawing. This must be the first flag specified when used in a Proc or Macro or on the command line.

Details​

The Overlay layer is drawn above all else. It is not included when printing or exporting graphics and is provided for programmers who wish to add user-interface drawing elements without disturbing graphics elements. Overlay was added in Igor Pro 7.00.

Layer icon in the drawing tool palette: . A checkmark indicates the current layer. Non-drawing layers are indicated with gray text.

Output Variables​

SetDrawLayer sets S_Name to the name of the previously-selected drawing layer. You can use this to restore the active drawing layer after programmatic drawing.

See Also​

Drawing, Drawing Layers, DrawAction