Home / Lua API Manual / darktable / darktable.gui / darktable.gui.selection
< darktable.gui.panel_visible
darktable.gui.views >

# darktable.gui.selection

    function(
      [selection : table of types.dt_lua_image_t]
    ) : table of types.dt_lua_image_t

Get or change the set of selected images.

Attributes: implicit_yield

- [selection] - table of types.dt_lua_image_t - A table of images which will define the selected images. If this parameter is not given the selection will be untouched. If an empty table is given the selection will be emptied.
- return - table of types.dt_lua_image_t - A table containing the selection as it was before the function was called.

< darktable.gui.panel_visible
darktable.gui.views >