context_set_sample_merged

Set the sample merged setting.

Modifies the sample merged setting. If an operation depends on the colors of the pixels present in a drawable, like when doing a seed fill, this setting controls whether the pixel data from the given drawable is used ('sample-merged' is FALSE), or the pixel data from the composite image ('sample-merged' is TRUE. This is equivalent to sampling for colors after merging all visible layers).

This setting affects the following procedures: select_color, select_contiguous_color, edit_bucket_fill.

Parameters:

sample_merged

The sample merged setting.

Returns:

TRUE on success.