Home / Lua API Manual / darktable / darktable.films
< darktable.debug
darktable.gettext >

# darktable.films

A table containing all the film objects in the database.

# 🔗darktable.films.#

`types.dt_lua_film_t`

Each film has a numeric entry in the database. See types.dt_lua_film_t.

# 🔗darktable.films.new

    function(
      directory : string
    ) : types.dt_lua_film_t

Creates a new empty film

see darktable.database.import to import a directory with all its images and to add images to a film

- directory - string - The directory that the new film will represent. The directory must exist
- return - types.dt_lua_film_t - The newly created film, or the existing film if the directory is already imported

# 🔗darktable.films.delete

see types.dt_lua_film_t.delete

< darktable.debug
darktable.gettext >