Home / Lua API Manual / darktable / darktable.gui / darktable.gui.create_job
< darktable.gui.action_images
darktable.gui.current_view >

# darktable.gui.create_job

    function(
      text : string,
      [percentage : boolean],
      [cancel_callback : function]
    ) : types.dt_lua_backgroundjob_t

Create a new progress_bar displayed in darktable.gui.libs.backgroundjobs

- text - string - The text to display in the job entry

- [percentage] - boolean - Should a progress bar be displayed

- [cancel_callback] - function - A function called when the cancel button for that job is pressed. Note: the job won’t be destroyed automatically. You need to set types.dt_lua_backgroundjob_t.valid to false for that.

- return - types.dt_lua_backgroundjob_t - The newly created job object

## 🔗cancel_callback

    function(
      job : types.dt_lua_backgroundjob_t
    )

- job - types.dt_lua_backgroundjob_t - The job that is being cancelled

< darktable.gui.action_images
darktable.gui.current_view >