Method

GimpProcedureset_sensitivity_mask

since: 3.0

Declaration [src]

void
gimp_procedure_set_sensitivity_mask (
  GimpProcedure* procedure,
  gint sensitivity_mask
)

Description [src]

Sets the cases when procedure is supposed to be sensitive or not.

Note that it will be used by the core to determine whether to show a procedure as sensitive (hence forbid running it otherwise), yet it will not forbid thid-party plug-ins for instance to run manually your registered procedure. Therefore you should still handle non-supported cases appropriately by returning with GIMP_PDB_EXECUTION_ERROR and a suitable error message.

Similarly third-party plug-ins should verify they are allowed to call a procedure with gimp_procedure_get_sensitivity_mask() when running with dynamic contents.

Note that by default, a procedure works on an image with one or more drawables selected. Hence not setting the mask, setting it with 0 or setting it with GIMP_PROCEDURE_SENSITIVE_DRAWABLE | GIMP_PROCEDURE_SENSITIVE_DRAWABLES are equivalent.

Available since: 3.0

Parameters

sensitivity_mask

Type: gint

A binary mask of GimpProcedureSensitivityMask.