Commit 853f04d5 authored by Michael Natterer's avatar Michael Natterer 😴 Committed by Michael Natterer

Changed naming scheme for PDB procedure names from

2005-08-03  Michael Natterer  <mitch@gimp.org>

	Changed naming scheme for PDB procedure names from
	random_crap_that_traditionally_has_underscores to
	enforced-canonical-identifiers. I'm pretty sure some things are
	broken after this commit. More changes to come...

	* libgimpbase/gimpbase.def
	* libgimpbase/gimputils.[ch]: added gimp_canonicalize_identifier().

	* app/pdb/procedural_db.[ch] (struct ProcRecord): added
	"gchar *original_name" to keep a procedure's original name as
	reigstered by plug-ins (compat cruft).

	(procedural_db_init_procs): canonicalized list of deprecated
	procedures.

	* app/plug-in/plug-in-proc-def.c (plug_in_proc_def_free): free
	original_name.

	* app/plug-in/plug-in-message.c: canonicalize procedure names
	which are received over the wire.

	* app/plug-in/plug-in-rc.c: serialize the original_name and create
	the canonicalized name on-the-fly when deserializing.

	* app/plug-in/plug-in-run.c: pass the original_name to plug-ins
	when running them because they strcmp() the passed procedure name.

	* app/plug-in/plug-ins.c (plug_ins_add_to_db): pass
	canonical procedure names to procedural_db_execute().

	(plug_ins_file_proc_compare): special-case "gimp-xcf", not "gimp_xcf".

	* app/xcf/xcf.c: changed static XCF procedures accordingly.

	* tools/pdbgen/app.pl
	* tools/pdbgen/lib.pl: do some trivial substitutions to generate
	canonicalized names in app/, and C identifiers with underscores in
	libgimp/.

	* tools/pdbgen/pdb/brushes.pdb
	* tools/pdbgen/pdb/fileops.pdb
	* tools/pdbgen/pdb/gradients.pdb
	* tools/pdbgen/pdb/image.pdb
	* tools/pdbgen/pdb/palettes.pdb
	* tools/pdbgen/pdb/patterns.pdb
	* tools/pdbgen/pdb/plug_in.pdb
	* tools/pdbgen/pdb/procedural_db.pdb
	* tools/pdbgen/pdb/text_tool.pdb
	* tools/pdbgen/pdb/transform_tools.pdb: canonicaloized procedure
	names in calls to std_pdb_deprecated() and in procedure names in
	generated C code.

	* app/pdb/*_cmds.c
	* libgimp/*_pdb.c: regenerated.
parent 990ee207
2005-08-03 Michael Natterer <mitch@gimp.org>
Changed naming scheme for PDB procedure names from
random_crap_that_traditionally_has_underscores to
enforced-canonical-identifiers. I'm pretty sure some things are
broken after this commit. More changes to come...
* libgimpbase/gimpbase.def
* libgimpbase/gimputils.[ch]: added gimp_canonicalize_identifier().
* app/pdb/procedural_db.[ch] (struct ProcRecord): added
"gchar *original_name" to keep a procedure's original name as
reigstered by plug-ins (compat cruft).
(procedural_db_init_procs): canonicalized list of deprecated
procedures.
* app/plug-in/plug-in-proc-def.c (plug_in_proc_def_free): free
original_name.
* app/plug-in/plug-in-message.c: canonicalize procedure names
which are received over the wire.
* app/plug-in/plug-in-rc.c: serialize the original_name and create
the canonicalized name on-the-fly when deserializing.
* app/plug-in/plug-in-run.c: pass the original_name to plug-ins
when running them because they strcmp() the passed procedure name.
* app/plug-in/plug-ins.c (plug_ins_add_to_db): pass
canonical procedure names to procedural_db_execute().
(plug_ins_file_proc_compare): special-case "gimp-xcf", not "gimp_xcf".
* app/xcf/xcf.c: changed static XCF procedures accordingly.
* tools/pdbgen/app.pl
* tools/pdbgen/lib.pl: do some trivial substitutions to generate
canonicalized names in app/, and C identifiers with underscores in
libgimp/.
* tools/pdbgen/pdb/brushes.pdb
* tools/pdbgen/pdb/fileops.pdb
* tools/pdbgen/pdb/gradients.pdb
* tools/pdbgen/pdb/image.pdb
* tools/pdbgen/pdb/palettes.pdb
* tools/pdbgen/pdb/patterns.pdb
* tools/pdbgen/pdb/plug_in.pdb
* tools/pdbgen/pdb/procedural_db.pdb
* tools/pdbgen/pdb/text_tool.pdb
* tools/pdbgen/pdb/transform_tools.pdb: canonicaloized procedure
names in calls to std_pdb_deprecated() and in procedure names in
generated C code.
* app/pdb/*_cmds.c
* libgimp/*_pdb.c: regenerated.
2005-08-03 Sven Neumann <sven@gimp.org>
* libgimp/gimpbrushmenu.c
......
......@@ -136,7 +136,8 @@ static ProcArg brush_new_outargs[] =
static ProcRecord brush_new_proc =
{
"gimp_brush_new",
"gimp-brush-new",
"gimp-brush-new",
"Creates a new brush",
"This procedure creates a new, uninitialized brush",
"Michael Natterer <mitch@gimp.org>",
......@@ -212,7 +213,8 @@ static ProcArg brush_duplicate_outargs[] =
static ProcRecord brush_duplicate_proc =
{
"gimp_brush_duplicate",
"gimp-brush-duplicate",
"gimp-brush-duplicate",
"Duplicates a brush",
"This procedure creates an identical brush by a different name",
"Michael Natterer <mitch@gimp.org>",
......@@ -281,7 +283,8 @@ static ProcArg brush_is_generated_outargs[] =
static ProcRecord brush_is_generated_proc =
{
"gimp_brush_is_generated",
"gimp-brush-is-generated",
"gimp-brush-is-generated",
"Tests if generated",
"Returns True if this brush is parametric, False for other types",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -360,7 +363,8 @@ static ProcArg brush_rename_outargs[] =
static ProcRecord brush_rename_proc =
{
"gimp_brush_rename",
"gimp-brush-rename",
"gimp-brush-rename",
"Rename a brush",
"This procedure renames a brush",
"Michael Natterer <mitch@gimp.org>",
......@@ -426,7 +430,8 @@ static ProcArg brush_delete_inargs[] =
static ProcRecord brush_delete_proc =
{
"gimp_brush_delete",
"gimp-brush-delete",
"gimp-brush-delete",
"Deletes a brush",
"This procedure deletes a brush",
"Michael Natterer <mitch@gimp.org>",
......@@ -495,7 +500,8 @@ static ProcArg brush_is_editable_outargs[] =
static ProcRecord brush_is_editable_proc =
{
"gimp_brush_is_editable",
"gimp-brush-is-editable",
"gimp-brush-is-editable",
"Tests if brush can be edited",
"Returns True if you have permission to change the brush",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -581,7 +587,8 @@ static ProcArg brush_get_info_outargs[] =
static ProcRecord brush_get_info_proc =
{
"gimp_brush_get_info",
"gimp-brush-get-info",
"gimp-brush-get-info",
"Retrieve information about the specified brush.",
"This procedure retrieves information about the specified brush. This includes the brush name, and the brush extents (width and height).",
"Michael Natterer <mitch@gimp.org>",
......@@ -712,7 +719,8 @@ static ProcArg brush_get_pixels_outargs[] =
static ProcRecord brush_get_pixels_proc =
{
"gimp_brush_get_pixels",
"gimp-brush-get-pixels",
"gimp-brush-get-pixels",
"Retrieve information about the specified brush.",
"This procedure retrieves information about the specified brush. This includes the brush extents (width and height) and its pixels data.",
"Michael Natterer <mitch@gimp.org>",
......@@ -778,7 +786,8 @@ static ProcArg brush_get_spacing_outargs[] =
static ProcRecord brush_get_spacing_proc =
{
"gimp_brush_get_spacing",
"gimp-brush-get-spacing",
"gimp-brush-get-spacing",
"Get the brush spacing.",
"This procedure returns the spacing setting for the specified brush. The return value is an integer between 0 and 1000 which represents percentage of the maximum of the width and height of the mask.",
"Michael Natterer <mitch@gimp.org>",
......@@ -842,7 +851,8 @@ static ProcArg brush_set_spacing_inargs[] =
static ProcRecord brush_set_spacing_proc =
{
"gimp_brush_set_spacing",
"gimp-brush-set-spacing",
"gimp-brush-set-spacing",
"Set the brush spacing.",
"This procedure modifies the spacing setting for the specified brush. The value should be a integer between 0 and 1000.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -908,7 +918,8 @@ static ProcArg brush_get_shape_outargs[] =
static ProcRecord brush_get_shape_proc =
{
"gimp_brush_get_shape",
"gimp-brush-get-shape",
"gimp-brush-get-shape",
"Get the shape of a generated brush.",
"This procedure gets the shape value for a generated brush. If called for any other type of brush, it does not succeed. The current possibilities are Circle (GIMP_BRUSH_GENERATED_CIRCLE), Square (GIMP_BRUSH_GENERATED_SQUARE), and Diamond (GIMP_BRUSH_GENERATED_DIAMOND). Other shapes are likely to be added in the future.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -974,7 +985,8 @@ static ProcArg brush_get_radius_outargs[] =
static ProcRecord brush_get_radius_proc =
{
"gimp_brush_get_radius",
"gimp-brush-get-radius",
"gimp-brush-get-radius",
"Get the radius of a generated brush.",
"This procedure gets the radius value for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1040,7 +1052,8 @@ static ProcArg brush_get_spikes_outargs[] =
static ProcRecord brush_get_spikes_proc =
{
"gimp_brush_get_spikes",
"gimp-brush-get-spikes",
"gimp-brush-get-spikes",
"Get the number of spikes for a generated brush.",
"This procedure gets the number of spikes for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1106,7 +1119,8 @@ static ProcArg brush_get_hardness_outargs[] =
static ProcRecord brush_get_hardness_proc =
{
"gimp_brush_get_hardness",
"gimp-brush-get-hardness",
"gimp-brush-get-hardness",
"Get the hardness of a generated brush.",
"This procedure gets the hardness of a generated brush. The hardness of a brush is the amount its intensity fades at the outside edge. If called for any other type of brush, the function does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1172,7 +1186,8 @@ static ProcArg brush_get_aspect_ratio_outargs[] =
static ProcRecord brush_get_aspect_ratio_proc =
{
"gimp_brush_get_aspect_ratio",
"gimp-brush-get-aspect-ratio",
"gimp-brush-get-aspect-ratio",
"Get the aspect ratio of a generated brush.",
"This procedure gets the aspect ratio of a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1238,7 +1253,8 @@ static ProcArg brush_get_angle_outargs[] =
static ProcRecord brush_get_angle_proc =
{
"gimp_brush_get_angle",
"gimp-brush-get-angle",
"gimp-brush-get-angle",
"Get the rotation angle of a generated brush.",
"This procedure gets the angle of rotation for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1315,7 +1331,8 @@ static ProcArg brush_set_shape_outargs[] =
static ProcRecord brush_set_shape_proc =
{
"gimp_brush_set_shape",
"gimp-brush-set-shape",
"gimp-brush-set-shape",
"Set the shape of a generated brush.",
"This procedure sets the shape value for a generated brush. If called for any other type of brush, it does not succeed. The current possibilities are Circle (GIMP_BRUSH_GENERATED_CIRCLE), Square (GIMP_BRUSH_GENERATED_SQUARE), and Diamond (GIMP_BRUSH_GENERATED_DIAMOND). Other shapes are likely to be added in the future.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1392,7 +1409,8 @@ static ProcArg brush_set_radius_outargs[] =
static ProcRecord brush_set_radius_proc =
{
"gimp_brush_set_radius",
"gimp-brush-set-radius",
"gimp-brush-set-radius",
"Set the radius of a generated brush.",
"This procedure sets the radius for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1469,7 +1487,8 @@ static ProcArg brush_set_spikes_outargs[] =
static ProcRecord brush_set_spikes_proc =
{
"gimp_brush_set_spikes",
"gimp-brush-set-spikes",
"gimp-brush-set-spikes",
"Set the number of spikes for a generated brush.",
"This procedure sets the number of spikes for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1546,7 +1565,8 @@ static ProcArg brush_set_hardness_outargs[] =
static ProcRecord brush_set_hardness_proc =
{
"gimp_brush_set_hardness",
"gimp-brush-set-hardness",
"gimp-brush-set-hardness",
"Set the hardness of a generated brush.",
"This procedure sets the hardness for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1623,7 +1643,8 @@ static ProcArg brush_set_aspect_ratio_outargs[] =
static ProcRecord brush_set_aspect_ratio_proc =
{
"gimp_brush_set_aspect_ratio",
"gimp-brush-set-aspect-ratio",
"gimp-brush-set-aspect-ratio",
"Set the aspect ratio of a generated brush.",
"This procedure sets the aspect ratio for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......@@ -1700,7 +1721,8 @@ static ProcArg brush_set_angle_outargs[] =
static ProcRecord brush_set_angle_proc =
{
"gimp_brush_set_angle",
"gimp-brush-set-angle",
"gimp-brush-set-angle",
"Set the rotation angle of a generated brush.",
"This procedure sets the rotation angle for a generated brush. If called for any other type of brush, it does not succeed.",
"Bill Skaggs <weskaggs@primate.ucdavis.edu",
......
......@@ -131,7 +131,8 @@ static ProcArg brushes_popup_inargs[] =
static ProcRecord brushes_popup_proc =
{
"gimp_brushes_popup",
"gimp-brushes-popup",
"gimp-brushes-popup",
"Invokes the Gimp brush selection.",
"This procedure popups the brush selection dialog.",
"Andy Thomas",
......@@ -182,7 +183,8 @@ static ProcArg brushes_close_popup_inargs[] =
static ProcRecord brushes_close_popup_proc =
{
"gimp_brushes_close_popup",
"gimp-brushes-close-popup",
"gimp-brushes-close-popup",
"Popdown the Gimp brush selection.",
"This procedure closes an opened brush selection dialog.",
"Andy Thomas",
......@@ -277,7 +279,8 @@ static ProcArg brushes_set_popup_inargs[] =
static ProcRecord brushes_set_popup_proc =
{
"gimp_brushes_set_popup",
"gimp-brushes-set-popup",
"gimp-brushes-set-popup",
"Sets the current brush selection in a popup.",
"Sets the current brush selection in a popup.",
"Andy Thomas",
......
......@@ -65,7 +65,8 @@ brushes_refresh_invoker (Gimp *gimp,
static ProcRecord brushes_refresh_proc =
{
"gimp_brushes_refresh",
"gimp-brushes-refresh",
"gimp-brushes-refresh",
"Refresh current brushes. This function always succeeds.",
"This procedure retrieves all brushes currently in the user's brush path and updates the brush dialogs accordingly.",
"Seth Burgess",
......@@ -135,9 +136,10 @@ static ProcArg brushes_get_list_outargs[] =
static ProcRecord brushes_get_list_proc =
{
"gimp_brushes_get_list",
"gimp-brushes-get-list",
"gimp-brushes-get-list",
"Retrieve a complete listing of the available brushes.",
"This procedure returns a complete listing of available GIMP brushes. Each name returned can be used as input to the 'gimp_context_set_brush' procedure.",
"This procedure returns a complete listing of available GIMP brushes. Each name returned can be used as input to the 'gimp-context-set-brush' procedure.",
"Spencer Kimball & Peter Mattis",
"Spencer Kimball & Peter Mattis",
"1995-1996",
......@@ -201,13 +203,14 @@ static ProcArg brushes_get_brush_outargs[] =
static ProcRecord brushes_get_brush_proc =
{
"gimp_brushes_get_brush",
"This procedure is deprecated! Use 'gimp_context_get_brush' instead.",
"This procedure is deprecated! Use 'gimp_context_get_brush' instead.",
"gimp-brushes-get-brush",
"gimp-brushes-get-brush",
"This procedure is deprecated! Use 'gimp-context-get-brush' instead.",
"This procedure is deprecated! Use 'gimp-context-get-brush' instead.",
"",
"",
"",
"gimp_context_get_brush",
"gimp-context-get-brush",
GIMP_INTERNAL,
0,
NULL,
......@@ -241,13 +244,14 @@ static ProcArg brushes_get_spacing_outargs[] =
static ProcRecord brushes_get_spacing_proc =
{
"gimp_brushes_get_spacing",
"This procedure is deprecated! Use 'gimp_brush_get_spacing' instead.",
"This procedure is deprecated! Use 'gimp_brush_get_spacing' instead.",
"gimp-brushes-get-spacing",
"gimp-brushes-get-spacing",
"This procedure is deprecated! Use 'gimp-brush-get-spacing' instead.",
"This procedure is deprecated! Use 'gimp-brush-get-spacing' instead.",
"",
"",
"",
"gimp_brush_get_spacing",
"gimp-brush-get-spacing",
GIMP_INTERNAL,
0,
NULL,
......@@ -286,13 +290,14 @@ static ProcArg brushes_set_spacing_inargs[] =
static ProcRecord brushes_set_spacing_proc =
{
"gimp_brushes_set_spacing",
"This procedure is deprecated! Use 'gimp_brush_set_spacing' instead.",
"This procedure is deprecated! Use 'gimp_brush_set_spacing' instead.",
"gimp-brushes-set-spacing",
"gimp-brushes-set-spacing",
"This procedure is deprecated! Use 'gimp-brush-set-spacing' instead.",
"This procedure is deprecated! Use 'gimp-brush-set-spacing' instead.",
"",
"",
"",
"gimp_brush_set_spacing",
"gimp-brush-set-spacing",
GIMP_INTERNAL,
1,
brushes_set_spacing_inargs,
......@@ -411,13 +416,14 @@ static ProcArg brushes_get_brush_data_outargs[] =
static ProcRecord brushes_get_brush_data_proc =
{
"gimp_brushes_get_brush_data",
"This procedure is deprecated! Use 'gimp_brush_get_pixels' instead.",
"This procedure is deprecated! Use 'gimp_brush_get_pixels' instead.",
"gimp-brushes-get-brush-data",
"gimp-brushes-get-brush-data",
"This procedure is deprecated! Use 'gimp-brush-get-pixels' instead.",
"This procedure is deprecated! Use 'gimp-brush-get-pixels' instead.",
"",
"",
"",
"gimp_brush_get_pixels",
"gimp-brush-get-pixels",
GIMP_INTERNAL,
1,
brushes_get_brush_data_inargs,
......
......@@ -158,7 +158,8 @@ static ProcArg channel_new_outargs[] =
static ProcRecord channel_new_proc =
{
"gimp_channel_new",
"gimp-channel-new",
"gimp-channel-new",
"Create a new channel.",
"This procedure creates a new channel with the specified width and height. Name, opacity, and color are also supplied parameters. The new channel still needs to be added to the image, as this is not automatic. Add the new channel with the 'gimp_image_add_channel' command. Other attributes such as channel show masked, should be set with explicit procedure calls. The channel's contents are undefined initially.",
"Spencer Kimball & Peter Mattis",
......@@ -248,7 +249,8 @@ static ProcArg channel_new_from_component_outargs[] =
static ProcRecord channel_new_from_component_proc =
{
"gimp_channel_new_from_component",
"gimp-channel-new-from-component",
"gimp-channel-new-from-component",
"Create a new channel from a color component",
"This procedure creates a new channel from a color component.",
"Shlomi Fish <shlomif@iglu.org.il>",
......@@ -313,7 +315,8 @@ static ProcArg channel_copy_outargs[] =
static ProcRecord channel_copy_proc =
{
"gimp_channel_copy",
"gimp-channel-copy",
"gimp-channel-copy",
"Copy a channel.",
"This procedure copies the specified channel and returns the copy.",
"Spencer Kimball & Peter Mattis",
......@@ -396,7 +399,8 @@ static ProcArg channel_combine_masks_inargs[] =
static ProcRecord channel_combine_masks_proc =
{
"gimp_channel_combine_masks",
"gimp-channel-combine-masks",
"gimp-channel-combine-masks",
"Combine two channel masks.",
"This procedure combines two channel masks. The result is stored in the first channel.",
"Spencer Kimball & Peter Mattis",
......@@ -453,7 +457,8 @@ static ProcArg channel_get_show_masked_outargs[] =
static ProcRecord channel_get_show_masked_proc =
{
"gimp_channel_get_show_masked",
"gimp-channel-get-show-masked",
"gimp-channel-get-show-masked",
"Get the composite method of the specified channel.",
"This procedure returns the specified channel's composite method. If it is non-zero, then the channel is composited with the image so that masked regions are shown. Otherwise, selected regions are shown.",
"Spencer Kimball & Peter Mattis",
......@@ -506,7 +511,8 @@ static ProcArg channel_set_show_masked_inargs[] =
static ProcRecord channel_set_show_masked_proc =
{
"gimp_channel_set_show_masked",
"gimp-channel-set-show-masked",
"gimp-channel-set-show-masked",
"Set the composite method of the specified channel.",
"This procedure sets the specified channel's composite method. If it is non-zero, then the channel is composited with the image so that masked regions are shown. Otherwise, selected regions are shown.",
"Spencer Kimball & Peter Mattis",
......@@ -563,7 +569,8 @@ static ProcArg channel_get_opacity_outargs[] =
static ProcRecord channel_get_opacity_proc =
{
"gimp_channel_get_opacity",
"gimp-channel-get-opacity",
"gimp-channel-get-opacity",
"Get the opacity of the specified channel.",
"This procedure returns the specified channel's opacity.",
"Spencer Kimball & Peter Mattis",
......@@ -618,7 +625,8 @@ static ProcArg channel_set_opacity_inargs[] =
static ProcRecord channel_set_opacity_proc =
{
"gimp_channel_set_opacity",
"gimp-channel-set-opacity",
"gimp-channel-set-opacity",
"Set the opacity of the specified channel.",
"This procedure sets the specified channel's opacity.",
"Spencer Kimball & Peter Mattis",
......@@ -679,7 +687,8 @@ static ProcArg channel_get_color_outargs[] =
static ProcRecord channel_get_color_proc =
{
"gimp_channel_get_color",
"gimp-channel-get-color",
"gimp-channel-get-color",
"Get the compositing color of the specified channel.",
"This procedure returns the specified channel's compositing color.",
"Spencer Kimball & Peter Mattis",
......@@ -737,7 +746,8 @@ static ProcArg channel_set_color_inargs[] =
static ProcRecord channel_set_color_proc =
{
"gimp_channel_set_color",
"gimp-channel-set-color",
"gimp-channel-set-color",
"Set the compositing color of the specified channel.",
"This procedure sets the specified channel's compositing color.",
"Spencer Kimball & Peter Mattis",
......
......@@ -169,7 +169,8 @@ static ProcArg brightness_contrast_inargs[] =
static ProcRecord brightness_contrast_proc =
{
"gimp_brightness_contrast",
"gimp-brightness-contrast",
"gimp-brightness-contrast",
"Modify brightness/contrast in the specified drawable.",
"This procedures allows the brightness and contrast of the specified drawable to be modified. Both 'brightness' and 'contrast' parameters are defined between -127 and 127.",
"Spencer Kimball & Peter Mattis",
......@@ -291,7 +292,8 @@ static ProcArg levels_inargs[] =
static ProcRecord levels_proc =
{
"gimp_levels",
"gimp-levels",
"gimp-levels",
"Modifies intensity levels in the specified drawable.",
"This tool allows intensity levels in the specified drawable to be remapped according to a set of parameters. The low/high input levels specify an initial mapping from the source intensities. The gamma value determines how intensities between the low and high input intensities are interpolated. A gamma value of 1.0 results in a linear interpolation. Higher gamma values result in more high-level intensities. Lower gamma values result in more low-level intensities. The low/high output levels constrain the final intensity mapping--that is, no final intensity will be lower than the low output level and no final intensity will be higher than the high output level. This tool is only valid on RGB color and grayscale images. It will not operate on indexed drawables.",
"Spencer Kimball & Peter Mattis",
......@@ -343,7 +345,8 @@ static ProcArg levels_auto_inargs[] =
static ProcRecord levels_auto_proc =
{
"gimp_levels_auto",
"gimp-levels-auto",
"gimp-levels-auto",
"This procedure is deprecated! Use 'gimp_levels_stretch' instead.",
"This procedure is deprecated! Use 'gimp_levels_stretch' instead.",
"",
......@@ -395,7 +398,8 @@ static ProcArg levels_stretch_inargs[] =
static ProcRecord levels_stretch_proc =
{
"gimp_levels_stretch",
"gimp-levels-stretch",
"gimp-levels-stretch",
"Automatically modifies intensity levels in the specified drawable.",
"This procedure allows intensity levels in the specified drawable to be remapped according to a set of guessed parameters. It is equivalent to clicking the \"Auto\" button in the Levels tool. This procedure is only valid on RGB color and grayscale images. It will not operate on indexed drawables.",
"Joao S.O. Bueno, Shawn Willden",
......@@ -482,7 +486,8 @@ static ProcArg posterize_inargs[] =
static ProcRecord posterize_proc =
{
"gimp_posterize",
"gimp-posterize",
"gimp-posterize",
"Posterize the specified drawable.",
"This procedures reduces the number of shades allows in each intensity channel to the specified 'levels' parameter.",
"Spencer Kimball & Peter Mattis",
......@@ -534,7 +539,8 @@ static ProcArg desaturate_inargs[] =
static ProcRecord desaturate_proc =
{
"gimp_desaturate",
"gimp-desaturate",
"gimp-desaturate",
"Desaturate the contents of the specified drawable.",
"This procedure desaturates the contents of the specified drawable. This procedure only works on drawables of type RGB color.",
"Spencer Kimball & Peter Mattis",
......@@ -596,7 +602,8 @@ static ProcArg desaturate_full_inargs[] =
static ProcRecord desaturate_full_proc =
{
"gimp_desaturate_full",
"gimp-desaturate-full",
"gimp-desaturate-full",
"Desaturate the contents of the specified drawable, with the specified formula.",
"This procedure desaturates the contents of the specified drawable, with the specified formula. This procedure only works on drawables of type RGB color.",
"Karine Delvare",
......@@ -656,7 +663,8 @@ static ProcArg equalize_inargs[] =
static ProcRecord equalize_proc =
{
"gimp_equalize",
"gimp-equalize",
"gimp-equalize",
"Equalize the contents of the specified drawable.",
"This procedure equalizes the contents of the specified drawable. Each intensity channel is equalizeed independently. The equalized intensity is given as inten' = (255 - inten). Indexed color drawables are not valid for this operation. The 'mask_only' option specifies whether to adjust only the area of the image within the selection bounds, or the entire image based on the histogram of the selected area. If there is no selection, the entire image is adjusted based on the histogram for the entire image.",
"Spencer Kimball & Peter Mattis",
......@@ -708,7 +716,8 @@ static ProcArg invert_inargs[] =
static ProcRecord invert_proc =
{
"gimp_invert",
"gimp-invert",
"gimp-invert",
"Invert the contents of the specified drawable.",
"This procedure inverts the contents of the specified drawable. Each intensity channel is inverted independently. The inverted intensity is given as inten' = (255 - inten). Indexed color drawables are not valid for this operation.",
"Spencer Kimball & Peter Mattis",
......@@ -843,7 +852,8 @@ static ProcArg curves_spline_inargs[] =
static ProcRecord curves_spline_proc =
{
"gimp_curves_spline",
"gimp-curves-spline",
"gimp-curves-spline",
"Modifies the intensity curve(s) for specified drawable.",
"Modifies the intensity mapping for one channel in the specified drawable. The drawable must be either grayscale or RGB, and the channel can be either an intensity component, or the value. The 'control_pts' parameter is an array of integers which define a set of control points which describe a Catmull Rom spline which yields the final intensity curve. Use the 'gimp_curves_explicit' function to explicitly modify intensity levels.",
"Spencer Kimball & Peter Mattis",
......@@ -969,7 +979,8 @@ static ProcArg curves_explicit_inargs[] =
static ProcRecord curves_explicit_proc =
{
"gimp_curves_explicit",
"gimp-curves-explicit",
"gimp-curves-explicit",
"Modifies the intensity curve(s) for specified drawable.",
"Modifies the intensity mapping for one channel in the specified drawable. The drawable must be either grayscale or RGB, and the channel can be either an intensity component, or the value. The 'curve' parameter is an array of bytes which explicitly defines how each pixel value in the drawable will be modified. Use the 'gimp_curves_spline' function to modify intensity levels with Catmull Rom splines.",
"Spencer Kimball & Peter Mattis",
......@@ -1099,7 +1110,8 @@ static ProcArg color_balance_inargs[] =
static ProcRecord color_balance_proc =
{
"gimp_color_balance",
"gimp-color-balance",
"gimp-color-balance",
"Modify the color balance of the specified drawable.",
"Modify the color balance of the specified drawable. There are three axis which can be modified: cyan-red, magenta-green, and yellow-blue. Negative values increase the amount of the former, positive values increase the amount of the latter. Color balance can be controlled with the 'transfer_mode' setting, which allows shadows, midtones, and highlights in an image to be affected differently. The 'preserve_lum' parameter, if non-zero, ensures that the luminosity of each pixel remains fixed.",
"Spencer Kimball & Peter Mattis",
......@@ -1209,7 +1221,8 @@ static ProcArg colorize_inargs[] =
static ProcRecord colorize_proc =
{
"gimp_colorize",
"gimp-colorize",
"gimp-colorize",
"Render the drawable as a grayscale image seen through a colored glass.",
"Desatures the drawable, then tints it with the specified color. This tool is only valid on RGB color images. It will not operate on grayscale or indexed drawables.",
"Spencer Kimball & Peter Mattis",
......@@ -1365,7 +1378,8 @@ static ProcArg histogram_outargs[] =
static ProcRecord histogram_proc =
{
"gimp_histogram",
"gimp-histogram",
"gimp-histogram",
"Returns information on the intensity histogram for the specified drawable.",
"This tool makes it possible to gather information about the intensity histogram of a drawable. A channel to examine is first specified. This can be either value, red, green, or blue, depending on whether the drawable is of type color or grayscale. The drawable may not be indexed. Second, a range of intensities are specified. The gimp_histogram function returns statistics based on the pixels in the drawable that fall under this range of values. Mean, standard deviation, median, number of pixels, and percentile are all returned. Additionally, the total count of pixels in the image is returned. Counts of pixels are weighted by any associated alpha values and by the current selection mask. That is, pixels that lie outside an active selection mask will not be counted. Similarly, pixels with transparent alpha values will not be counted.",
"Spencer Kimball & Peter Mattis",
......@@ -1486,7 +1500,8 @@ static ProcArg hue_saturation_inargs[] =
static ProcRecord hue_saturation_proc =
{
"gimp_hue_saturation",
"gimp-hue-saturation",
"gimp-hue-saturation",
"Modify hue, lightness, and saturation in the specified drawable.",
"This procedures allows the hue, lightness, and saturation in the specified drawable to be modified. The 'hue_range' parameter provides the capability to limit range of affected hues.",
"Spencer Kimball & Peter Mattis",
......@@ -1583,7 +1598,8 @@ static ProcArg threshold_inargs[] =
static ProcRecord threshold_proc =
{
"gimp_threshold",
"gimp-threshold",
"gimp-threshold",
"Threshold the specified drawable.",
"This procedures generates a threshold map of the specified drawable. All pixels between the values of 'low_threshold' and 'high_threshold' are replaced with white, and all other pixels with black.",
"Spencer Kimball & Peter Mattis",
......
......@@ -105,7 +105,8 @@ context_push_invoker (Gimp *gimp,
static ProcRecord context_push_proc =
{
"gimp_context_push",
"gimp-context-push",
"gimp-context-push",
"Pushes a context to the top of the plug-in's context stack.",
"This procedure creates a new context by copying the current context. This copy becomes the new current context for the calling plug-in until it is popped again.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -140,7 +141,8 @@ context_pop_invoker (Gimp *gimp,
static ProcRecord context_pop_proc =
{
"gimp_context_pop",
"gimp-context-pop",
"gimp-context-pop",
"Pops the topmost context from the plug-in's context stack.",
"This procedure creates a new context and makes it the current context for the calling plug-in.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -183,7 +185,8 @@ static ProcArg context_get_foreground_outargs[] =
static ProcRecord context_get_foreground_proc =
{
"gimp_context_get_foreground",
"gimp-context-get-foreground",
"gimp-context-get-foreground",
"Get the current GIMP foreground color.",
"This procedure returns the current GIMP foreground color. The foreground color is used in a variety of tools such as paint tools, blending, and bucket fill.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -225,7 +228,8 @@ static ProcArg context_set_foreground_inargs[] =
static ProcRecord context_set_foreground_proc =
{
"gimp_context_set_foreground",
"gimp-context-set-foreground",
"gimp-context-set-foreground",
"Set the current GIMP foreground color.",
"This procedure sets the current GIMP foreground color. After this is set, operations which use foreground such as paint tools, blending, and bucket fill will use the new value.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -268,7 +272,8 @@ static ProcArg context_get_background_outargs[] =
static ProcRecord context_get_background_proc =
{
"gimp_context_get_background",
"gimp-context-get-background",
"gimp-context-get-background",
"Get the current GIMP background color.",
"This procedure returns the current GIMP background color. The background color is used in a variety of tools such as blending, erasing (with non-alpha images), and image filling.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -310,7 +315,8 @@ static ProcArg context_set_background_inargs[] =
static ProcRecord context_set_background_proc =
{
"gimp_context_set_background",
"gimp-context-set-background",
"gimp-context-set-background",
"Set the current GIMP background color.",
"This procedure sets the current GIMP background color. After this is set, operations which use background such as blending, filling images, clearing, and erasing (in non-alpha images) will use the new value.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -337,7 +343,8 @@ context_set_default_colors_invoker (Gimp *gimp,
static ProcRecord context_set_default_colors_proc =
{
"gimp_context_set_default_colors",
"gimp-context-set-default-colors",
"gimp-context-set-default-colors",
"Set the current GIMP foreground and background colors to black and white.",
"This procedure sets the current GIMP foreground and background colors to their initial default values, black and white.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -364,7 +371,8 @@ context_swap_colors_invoker (Gimp *gimp,
static ProcRecord context_swap_colors_proc =
{
"gimp_context_swap_colors",
"gimp-context-swap-colors",
"gimp-context-swap-colors",
"Swap the current GIMP foreground and background colors.",
"This procedure swaps the current GIMP foreground and background colors, so that the new foreground color becomes the old background color and vice versa.",
"Michael Natterer <mitch@gimp.org> & Sven Neumann <sven@gimp.org>",
......@@ -404,7 +412,8 @@ static ProcArg context_get_opacity_outargs[] =
static ProcRecord context_get_opacity_proc =
{