OOF2: The Manual

Name

OOF.Graphics_n.Layer.Lower.By — Lower the selected graphics layer under a given number of other layers.

Synopsis

OOF.Graphics_n.Layer.Lower.By(n, howfar)

Details

  • Parent Menu: OOF.Graphics_n.Layer.Lower
  • Callback: function GfxWindow.lowerBy in module ooflib.common.IO.ghostgfxwindow
  • Parameters:

    n
    Layer index. Type: Integer.
    howfar
    How far to lower the layer. Type: Integer.

Description

Graphics Layers are conceptually organized in a stack, with Layers on the bottom drawn first, and layers on the top drawn last. Higher Layers therefore obscure the lower ones. Lowering a Layer in the stack makes it less visible. This command lowers the given layer by howfar levels in the stack, raising all the intervening layers by one level.

In GUI mode, this command operates on the currently selected Layer. In text mode and in scripts, the Layer is specified by its position n in the window's layer list. The unlisted layers and invisible (empty) layers must be counted when computing n and howfar. This command isn't very friendly in scripts, because it can be hard to determine n and howfar.

If howfar is 1, then this command is identical to OOF.Graphics_n.Layer.Lower.One_Level.

See Also