Ansel 0.0
A darktable fork - bloat + design vision
Loading...
Searching...
No Matches
IOP API

Bind one statically-linked IOP module into its dt_iop_module_so_t. More...

Functions

int process (struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, const void *const i, void *const o)
 CPU implementation of the pixel filter for this module.

Variables

int(* dt_iop_module_so_t::process )(struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, const void *const i, void *const o)
 CPU implementation of the pixel filter for this module.
int(* dt_iop_module_so_t::process_cl )(struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, cl_mem dev_in, cl_mem dev_out)
 GPU implementation of the pixel filter for this module.
int(* dt_iop_module_t::process )(struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, const void *const i, void *const o)
 CPU implementation of the pixel filter for this module.
int(* dt_iop_module_t::process_cl )(struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, cl_mem dev_in, cl_mem dev_out)
 GPU implementation of the pixel filter for this module.

Detailed Description

Bind one statically-linked IOP module into its dt_iop_module_so_t.

Global IOP module API functions.

IOP modules are compiled into lib_ansel, not dlopen'd: the set of them is fixed at build time, and both develop/iop_order.c's order tables and develop/geometry's roster are written against that same fixed set, so a module discovered on disk could never be anything but a disagreement with them – which is exactly what dt_ioppr_check_so_iop_order() used to abort startup over. See doc/static-iop.md.

This replaces the g_module_symbol() sweep. Two halves, and they cannot be merged: entry->fill_so() runs in the MODULE's translation unit, where the plain API names resolve to that module's own asm-labelled symbols, and stores NULL for every entry point it does not define; the DEFAULT fallbacks are applied here instead, because default_<fn> is static to this file.

Parameters
moduleZeroed module descriptor to fill.
entryRegistry entry naming the module and its generated binder.
Returns
0 on success, 1 if the module must not be used.

Global IOP module API functions

Function Documentation

◆ process()

int process ( struct dt_iop_module_t * self,
const struct dt_dev_pixelpipe_t * pipe,
const struct dt_dev_pixelpipe_iop_t * piece,
const void *const i,
void *const o )

CPU implementation of the pixel filter for this module.

Parameters
selfreference to the base module object. WARNING: it lives in the GUI thread, not in the pipeline thread.
pipereference to the pipeline running the module
piecedescriptor of the processing contract (input/output sizes, module parameters and internal states), in the current pipeline thread.
iinput pixel buffer
ooutput pixel buffer
Returns
1 on error, 0 on completion

a tiling variant of process().

GPU implementation of the pixel filter for this module.

Parameters
selfreference to the base module object. WARNING: it lives in the GUI thread, not in the pipeline thread.
pipereference to the pipeline running the module
piecedescriptor of the processing contract (input/output sizes, module parameters and internal states), in the current pipeline thread.
dev_ininput pixel buffer
dev_outoutput pixel buffer
Returns
1 on error, 0 on completion

Definition at line 397 of file atrous.c.

References eaw_decompose(), eaw_synthesize(), i, o, piece, pipe, and process_wavelets().

Variable Documentation

◆ process [1/2]

int(* dt_iop_module_so_t::process) (struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, const void *const i, void *const o)

CPU implementation of the pixel filter for this module.

Parameters
selfreference to the base module object. WARNING: it lives in the GUI thread, not in the pipeline thread.
pipereference to the pipeline running the module
piecedescriptor of the processing contract (input/output sizes, module parameters and internal states), in the current pipeline thread.
iinput pixel buffer
ooutput pixel buffer
Returns
1 on error, 0 on completion

Definition at line 266 of file imageop.h.

◆ process [2/2]

int(* dt_iop_module_t::process) (struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, const void *const i, void *const o)

CPU implementation of the pixel filter for this module.

Parameters
selfreference to the base module object. WARNING: it lives in the GUI thread, not in the pipeline thread.
pipereference to the pipeline running the module
piecedescriptor of the processing contract (input/output sizes, module parameters and internal states), in the current pipeline thread.
iinput pixel buffer
ooutput pixel buffer
Returns
1 on error, 0 on completion

Definition at line 266 of file imageop.h.

Referenced by _default_process_tiling_ptp(), and _default_process_tiling_roi().

◆ process_cl [1/2]

int(* dt_iop_module_so_t::process_cl) (struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, cl_mem dev_in, cl_mem dev_out)

GPU implementation of the pixel filter for this module.

Parameters
selfreference to the base module object. WARNING: it lives in the GUI thread, not in the pipeline thread.
pipereference to the pipeline running the module
piecedescriptor of the processing contract (input/output sizes, module parameters and internal states), in the current pipeline thread.
dev_ininput pixel buffer
dev_outoutput pixel buffer
Returns
1 on error, 0 on completion

Definition at line 293 of file imageop.h.

◆ process_cl [2/2]

int(* dt_iop_module_t::process_cl) (struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, cl_mem dev_in, cl_mem dev_out)

GPU implementation of the pixel filter for this module.

Parameters
selfreference to the base module object. WARNING: it lives in the GUI thread, not in the pipeline thread.
pipereference to the pipeline running the module
piecedescriptor of the processing contract (input/output sizes, module parameters and internal states), in the current pipeline thread.
dev_ininput pixel buffer
dev_outoutput pixel buffer
Returns
1 on error, 0 on completion

Definition at line 293 of file imageop.h.

Referenced by _default_process_tiling_cl_ptp(), _default_process_tiling_cl_roi(), _gui_presets_popup_menu_show_internal(), and pixelpipe_process_on_GPU().