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