diff --git a/app/pdb/drawable-transform-cmds.c b/app/pdb/drawable-transform-cmds.c index be8648aeb6..c7dfa45355 100644 --- a/app/pdb/drawable-transform-cmds.c +++ b/app/pdb/drawable-transform-cmds.c @@ -1330,12 +1330,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-flip-simple"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-flip-simple", - "Flip the specified drawable either vertically or horizontally.", - "This procedure flips the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then flipped. If auto_center is set to TRUE, the flip is around the selection's center. Otherwise, the coordinate of the axis needs to be specified. The return value is the ID of the flipped drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and flipped drawable.", + "Deprecated: Use 'gimp-item-transform-flip-simple' instead.", + "Deprecated: Use 'gimp-item-transform-flip-simple' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-flip-simple"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1386,12 +1386,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-flip"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-flip", - "Flip the specified drawable around a given line.", - "This procedure flips the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then flipped. The axis to flip around is specified by specifying two points from that line. The return value is the ID of the flipped drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and flipped drawable. The clip results parameter specifies wheter current selection will affect the transform.", + "Deprecated: Use 'gimp-item-transform-flip' instead.", + "Deprecated: Use 'gimp-item-transform-flip' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-flip"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1471,12 +1471,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-flip-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-flip-default", - "Flip the specified drawable around a given line.", - "This procedure is a variant of 'gimp-drawable-transform-flip' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-flip' instead.", + "Deprecated: Use 'gimp-item-transform-flip' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-flip"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1536,12 +1536,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-perspective"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-perspective", - "Perform a possibly non-affine transformation on the specified drawable, with extra parameters.", - "This procedure performs a possibly non-affine transformation on the specified drawable by allowing the corners of the original bounding box to be arbitrarily remapped to any values. The specified drawable is remapped if no selection exists. However, if a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then remapped as specified. The return value is the ID of the remapped drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and remapped drawable. The 4 coordinates specify the new locations of each corner of the original bounding box. By specifying these values, any affine transformation (rotation, scaling, translation) can be affected. Additionally, these values can be specified such that the resulting transformed drawable will appear to have been projected via a perspective transform.", + "Deprecated: Use 'gimp-item-transform-perspective' instead.", + "Deprecated: Use 'gimp-item-transform-perspective' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-perspective"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1646,12 +1646,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-perspective-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-perspective-default", - "Perform a possibly non-affine transformation on the specified drawable, with extra parameters.", - "This procedure is a variant of 'gimp-drawable-transform-perspective' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-perspective' instead.", + "Deprecated: Use 'gimp-item-transform-perspective' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-perspective"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1736,12 +1736,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-rotate-simple"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-rotate-simple", - "Rotate the specified drawable about given coordinates through the specified angle.", - "This function rotates the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then rotated by the specified amount. The return value is the ID of the rotated drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and rotated drawable.", + "Deprecated: Use 'gimp-item-transform-rotate-simple' instead.", + "Deprecated: Use 'gimp-item-transform-rotate-simple' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-rotate-simple"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1796,12 +1796,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-rotate"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-rotate", - "Rotate the specified drawable about given coordinates through the specified angle.", - "This function rotates the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then rotated by the specified amount. The return value is the ID of the rotated drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and rotated drawable.", + "Deprecated: Use 'gimp-item-transform-rotate' instead.", + "Deprecated: Use 'gimp-item-transform-rotate' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-rotate"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1882,12 +1882,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-rotate-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-rotate-default", - "Rotate the specified drawable about given coordinates through the specified angle.", - "This procedure is a variant of 'gimp-drawable-transform-rotate' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-rotate' instead.", + "Deprecated: Use 'gimp-item-transform-rotate' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-rotate"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -1948,12 +1948,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-scale"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-scale", - "Scale the specified drawable with extra parameters", - "This procedure scales the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then scaled by the specified amount. The return value is the ID of the scaled drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and scaled drawable.", + "Deprecated: Use 'gimp-item-transform-scale' instead.", + "Deprecated: Use 'gimp-item-transform-scale' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-scale"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2034,12 +2034,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-scale-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-scale-default", - "Scale the specified drawable with extra parameters", - "This procedure is a variant of 'gimp-drawable-transform-scale' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-scale' instead.", + "Deprecated: Use 'gimp-item-transform-scale' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-scale"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2100,12 +2100,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-shear"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-shear", - "Shear the specified drawable about its center by the specified magnitude, with extra parameters.", - "This procedure shears the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then sheard by the specified amount. The return value is the ID of the sheard drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and sheard drawable. The shear type parameter indicates whether the shear will be applied horizontally or vertically. The magnitude can be either positive or negative and indicates the extent (in pixels) to shear by.", + "Deprecated: Use 'gimp-item-transform-shear' instead.", + "Deprecated: Use 'gimp-item-transform-shear' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-shear"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2177,12 +2177,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-shear-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-shear-default", - "Shear the specified drawable about its center by the specified magnitude, with extra parameters.", - "This procedure is a variant of 'gimp-drawable-transform-shear' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-shear' instead.", + "Deprecated: Use 'gimp-item-transform-shear' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-shear"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2234,12 +2234,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-2d"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-2d", - "Transform the specified drawable in 2d, with extra parameters.", - "This procedure transforms the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then transformed. The transformation is done by scaling the image by the x and y scale factors about the point (source_x, source_y), then rotating around the same point, then translating that point to the new position (dest_x, dest_y). The return value is the ID of the rotated drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and transformed drawable.", + "Deprecated: Use 'gimp-item-transform-2d' instead.", + "Deprecated: Use 'gimp-item-transform-2d' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-2d"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2338,12 +2338,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-2d-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-2d-default", - "Transform the specified drawable in 2d, with extra parameters.", - "This procedure is a variant of 'gimp-drawable-transform-2d' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-2d' instead.", + "Deprecated: Use 'gimp-item-transform-2d' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-2d"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2422,12 +2422,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-matrix"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-matrix", - "Transform the specified drawable in 2d, with extra parameters.", - "This procedure transforms the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then transformed. The transformation is done by assembling a 3x3 matrix from the coefficients passed. The return value is the ID of the rotated drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and transformed drawable.", + "Deprecated: Use 'gimp-item-transform-matrix' instead.", + "Deprecated: Use 'gimp-item-transform-matrix' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-matrix"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", @@ -2538,12 +2538,12 @@ register_drawable_transform_procs (GimpPDB *pdb) "gimp-drawable-transform-matrix-default"); gimp_procedure_set_static_strings (procedure, "gimp-drawable-transform-matrix-default", - "Transform the specified drawable in 2d, with extra parameters.", - "This procedure is a variant of 'gimp-drawable-transform-matrix' which uses no interpolation/supersampling at all, or default values (depending on the 'interpolate' parameter).", + "Deprecated: Use 'gimp-item-transform-matrix' instead.", + "Deprecated: Use 'gimp-item-transform-matrix' instead.", "Jo\xc3\xa3o S. O. Bueno", "Jo\xc3\xa3o S. O. Bueno", "2004", - NULL); + "gimp-item-transform-matrix"); gimp_procedure_add_argument (procedure, gimp_param_spec_drawable_id ("drawable", "drawable", diff --git a/libgimp/gimpdrawabletransform_pdb.c b/libgimp/gimpdrawabletransform_pdb.c index 037e81b024..b7ed98bae1 100644 --- a/libgimp/gimpdrawabletransform_pdb.c +++ b/libgimp/gimpdrawabletransform_pdb.c @@ -23,6 +23,9 @@ #include "config.h" #include "gimp.h" +#undef GIMP_DISABLE_DEPRECATED +#undef __GIMP_DRAWABLE_TRANSFORM_PDB_H__ +#include "gimpdrawabletransform_pdb.h" /** @@ -42,17 +45,7 @@ * @axis: coord. of flip axis. * @clip_result: Whether to clip results. * - * Flip the specified drawable either vertically or horizontally. - * - * This procedure flips the specified drawable if no selection exists. - * If a selection exists, the portion of the drawable which lies under - * the selection is cut from the drawable and made into a floating - * selection which is then flipped. If auto_center is set to TRUE, the - * flip is around the selection's center. Otherwise, the coordinate of - * the axis needs to be specified. The return value is the ID of the - * flipped drawable. If there was no selection, this will be equal to - * the drawable ID supplied as input. Otherwise, this will be the newly - * created and flipped drawable. + * Deprecated: Use gimp_item_transform_flip_simple() instead. * * Returns: The flipped drawable. * @@ -99,18 +92,7 @@ gimp_drawable_transform_flip_simple (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: Whether to clip results. * - * Flip the specified drawable around a given line. - * - * This procedure flips the specified drawable if no selection exists. - * If a selection exists, the portion of the drawable which lies under - * the selection is cut from the drawable and made into a floating - * selection which is then flipped. The axis to flip around is - * specified by specifying two points from that line. The return value - * is the ID of the flipped drawable. If there was no selection, this - * will be equal to the drawable ID supplied as input. Otherwise, this - * will be the newly created and flipped drawable. The clip results - * parameter specifies wheter current selection will affect the - * transform. + * Deprecated: Use gimp_item_transform_flip() instead. * * Returns: The flipped drawable. * @@ -164,11 +146,7 @@ gimp_drawable_transform_flip (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: Whether to clip results. * - * Flip the specified drawable around a given line. - * - * This procedure is a variant of gimp_drawable_transform_flip() which - * uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_flip() instead. * * Returns: The flipped drawable. * @@ -223,24 +201,7 @@ gimp_drawable_transform_flip_default (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: How to clip results. * - * Perform a possibly non-affine transformation on the specified - * drawable, with extra parameters. - * - * This procedure performs a possibly non-affine transformation on the - * specified drawable by allowing the corners of the original bounding - * box to be arbitrarily remapped to any values. The specified drawable - * is remapped if no selection exists. However, if a selection exists, - * the portion of the drawable which lies under the selection is cut - * from the drawable and made into a floating selection which is then - * remapped as specified. The return value is the ID of the remapped - * drawable. If there was no selection, this will be equal to the - * drawable ID supplied as input. Otherwise, this will be the newly - * created and remapped drawable. The 4 coordinates specify the new - * locations of each corner of the original bounding box. By specifying - * these values, any affine transformation (rotation, scaling, - * translation) can be affected. Additionally, these values can be - * specified such that the resulting transformed drawable will appear - * to have been projected via a perspective transform. + * Deprecated: Use gimp_item_transform_perspective() instead. * * Returns: The newly mapped drawable. * @@ -306,12 +267,7 @@ gimp_drawable_transform_perspective (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: How to clip results. * - * Perform a possibly non-affine transformation on the specified - * drawable, with extra parameters. - * - * This procedure is a variant of gimp_drawable_transform_perspective() - * which uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_perspective() instead. * * Returns: The newly mapped drawable. * @@ -366,16 +322,7 @@ gimp_drawable_transform_perspective_default (gint32 drawable_ID, * @center_y: The vert. coordinate of the center of rotation. * @clip_result: Whether to clip results. * - * Rotate the specified drawable about given coordinates through the - * specified angle. - * - * This function rotates the specified drawable if no selection exists. - * If a selection exists, the portion of the drawable which lies under - * the selection is cut from the drawable and made into a floating - * selection which is then rotated by the specified amount. The return - * value is the ID of the rotated drawable. If there was no selection, - * this will be equal to the drawable ID supplied as input. Otherwise, - * this will be the newly created and rotated drawable. + * Deprecated: Use gimp_item_transform_rotate_simple() instead. * * Returns: The rotated drawable. * @@ -424,16 +371,7 @@ gimp_drawable_transform_rotate_simple (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: How to clip results. * - * Rotate the specified drawable about given coordinates through the - * specified angle. - * - * This function rotates the specified drawable if no selection exists. - * If a selection exists, the portion of the drawable which lies under - * the selection is cut from the drawable and made into a floating - * selection which is then rotated by the specified amount. The return - * value is the ID of the rotated drawable. If there was no selection, - * this will be equal to the drawable ID supplied as input. Otherwise, - * this will be the newly created and rotated drawable. + * Deprecated: Use gimp_item_transform_rotate() instead. * * Returns: The rotated drawable. * @@ -487,12 +425,7 @@ gimp_drawable_transform_rotate (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: How to clip results. * - * Rotate the specified drawable about given coordinates through the - * specified angle. - * - * This procedure is a variant of gimp_drawable_transform_rotate() - * which uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_rotate() instead. * * Returns: The rotated drawable. * @@ -543,15 +476,7 @@ gimp_drawable_transform_rotate_default (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: How to clip results. * - * Scale the specified drawable with extra parameters - * - * This procedure scales the specified drawable if no selection exists. - * If a selection exists, the portion of the drawable which lies under - * the selection is cut from the drawable and made into a floating - * selection which is then scaled by the specified amount. The return - * value is the ID of the scaled drawable. If there was no selection, - * this will be equal to the drawable ID supplied as input. Otherwise, - * this will be the newly created and scaled drawable. + * Deprecated: Use gimp_item_transform_scale() instead. * * Returns: The scaled drawable. * @@ -605,11 +530,7 @@ gimp_drawable_transform_scale (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: How to clip results. * - * Scale the specified drawable with extra parameters - * - * This procedure is a variant of gimp_drawable_transform_scale() which - * uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_scale() instead. * * Returns: The scaled drawable. * @@ -658,19 +579,7 @@ gimp_drawable_transform_scale_default (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: How to clip results. * - * Shear the specified drawable about its center by the specified - * magnitude, with extra parameters. - * - * This procedure shears the specified drawable if no selection exists. - * If a selection exists, the portion of the drawable which lies under - * the selection is cut from the drawable and made into a floating - * selection which is then sheard by the specified amount. The return - * value is the ID of the sheard drawable. If there was no selection, - * this will be equal to the drawable ID supplied as input. Otherwise, - * this will be the newly created and sheard drawable. The shear type - * parameter indicates whether the shear will be applied horizontally - * or vertically. The magnitude can be either positive or negative and - * indicates the extent (in pixels) to shear by. + * Deprecated: Use gimp_item_transform_shear() instead. * * Returns: The sheared drawable. * @@ -718,12 +627,7 @@ gimp_drawable_transform_shear (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: How to clip results. * - * Shear the specified drawable about its center by the specified - * magnitude, with extra parameters. - * - * This procedure is a variant of gimp_drawable_transform_shear() which - * uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_shear() instead. * * Returns: The sheared drawable. * @@ -773,18 +677,7 @@ gimp_drawable_transform_shear_default (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: How to clip results. * - * Transform the specified drawable in 2d, with extra parameters. - * - * This procedure transforms the specified drawable if no selection - * exists. If a selection exists, the portion of the drawable which - * lies under the selection is cut from the drawable and made into a - * floating selection which is then transformed. The transformation is - * done by scaling the image by the x and y scale factors about the - * point (source_x, source_y), then rotating around the same point, - * then translating that point to the new position (dest_x, dest_y). - * The return value is the ID of the rotated drawable. If there was no - * selection, this will be equal to the drawable ID supplied as input. - * Otherwise, this will be the newly created and transformed drawable. + * Deprecated: Use gimp_item_transform_2d() instead. * * Returns: The transformed drawable. * @@ -847,11 +740,7 @@ gimp_drawable_transform_2d (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: How to clip results. * - * Transform the specified drawable in 2d, with extra parameters. - * - * This procedure is a variant of gimp_drawable_transform_2d() which - * uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_2d() instead. * * Returns: The transformed drawable. * @@ -913,16 +802,7 @@ gimp_drawable_transform_2d_default (gint32 drawable_ID, * @recursion_level: Maximum recursion level used for supersampling (3 is a nice value). * @clip_result: How to clip results. * - * Transform the specified drawable in 2d, with extra parameters. - * - * This procedure transforms the specified drawable if no selection - * exists. If a selection exists, the portion of the drawable which - * lies under the selection is cut from the drawable and made into a - * floating selection which is then transformed. The transformation is - * done by assembling a 3x3 matrix from the coefficients passed. The - * return value is the ID of the rotated drawable. If there was no - * selection, this will be equal to the drawable ID supplied as input. - * Otherwise, this will be the newly created and transformed drawable. + * Deprecated: Use gimp_item_transform_matrix() instead. * * Returns: The transformed drawable. * @@ -991,11 +871,7 @@ gimp_drawable_transform_matrix (gint32 drawable_ID, * @interpolate: Whether to use interpolation and supersampling. * @clip_result: How to clip results. * - * Transform the specified drawable in 2d, with extra parameters. - * - * This procedure is a variant of gimp_drawable_transform_matrix() - * which uses no interpolation/supersampling at all, or default values - * (depending on the 'interpolate' parameter). + * Deprecated: Use gimp_item_transform_matrix() instead. * * Returns: The transformed drawable. * diff --git a/libgimp/gimpdrawabletransform_pdb.h b/libgimp/gimpdrawabletransform_pdb.h index 715bf6e59a..5d296b7ce4 100644 --- a/libgimp/gimpdrawabletransform_pdb.h +++ b/libgimp/gimpdrawabletransform_pdb.h @@ -28,6 +28,7 @@ G_BEGIN_DECLS /* For information look into the C source or the html documentation */ +#ifndef GIMP_DISABLE_DEPRECATED gint32 gimp_drawable_transform_flip_simple (gint32 drawable_ID, GimpOrientationType flip_type, gboolean auto_center, @@ -178,6 +179,7 @@ gint32 gimp_drawable_transform_matrix_default (gint32 drawa gdouble coeff_2_2, gboolean interpolate, GimpTransformResize clip_result); +#endif /* GIMP_DISABLE_DEPRECATED */ G_END_DECLS diff --git a/tools/pdbgen/pdb/drawable_transform.pdb b/tools/pdbgen/pdb/drawable_transform.pdb index 2b62348115..addd6ff329 100644 --- a/tools/pdbgen/pdb/drawable_transform.pdb +++ b/tools/pdbgen/pdb/drawable_transform.pdb @@ -126,23 +126,7 @@ CODE # The defs sub drawable_transform_flip_simple { - $blurb = <<'BLURB'; -Flip the specified drawable either vertically or horizontally. -BLURB - - $help = <<'HELP'; -This procedure flips the specified drawable if no selection exists. If -a selection exists, the portion of the drawable which lies under the -selection is cut from the drawable and made into a floating selection -which is then flipped. If auto_center is set to TRUE, the flip is -around the selection's center. Otherwise, the coordinate of the axis -needs to be specified. - -The return value is the ID of the flipped drawable. If there was no -selection, this will be equal to the drawable ID supplied as input. -Otherwise, this will be the newly created and flipped drawable. -HELP - + &std_pdb_deprecated('gimp-item-transform-flip-simple'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -192,23 +176,7 @@ CODE sub drawable_transform_flip { - $blurb = <<'BLURB'; -Flip the specified drawable around a given line. -BLURB - - $help = <<'HELP'; -This procedure flips the specified drawable if no selection exists. If -a selection exists, the portion of the drawable which lies under the -selection is cut from the drawable and made into a floating selection -which is then flipped. The axis to flip around is specified by -specifying two points from that line. - -The return value is the ID of the flipped drawable. If there was no -selection, this will be equal to the drawable ID supplied as input. -Otherwise, this will be the newly created and flipped drawable. The clip -results parameter specifies wheter current selection will affect the transform. -HELP - + &std_pdb_deprecated('gimp-item-transform-flip'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -248,16 +216,7 @@ CODE sub drawable_transform_flip_default { - $blurb = <<'BLURB'; -Flip the specified drawable around a given line. -BLURB - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_flip() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-flip'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -291,28 +250,7 @@ CODE sub drawable_transform_perspective { - $blurb = <<'BLURB'; -Perform a possibly non-affine transformation on the specified drawable, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure performs a possibly non-affine transformation on the -specified drawable by allowing the corners of the original bounding -box to be arbitrarily remapped to any values. The specified drawable -is remapped if no selection exists. However, if a selection exists, -the portion of the drawable which lies under the selection is cut from -the drawable and made into a floating selection which is then remapped -as specified. The return value is the ID of the remapped drawable. If -there was no selection, this will be equal to the drawable ID supplied -as input. Otherwise, this will be the newly created and remapped -drawable. The 4 coordinates specify the new locations of each corner -of the original bounding box. By specifying these values, any affine -transformation (rotation, scaling, translation) can be -affected. Additionally, these values can be specified such that the -resulting transformed drawable will appear to have been projected via -a perspective transform. -HELP - + &std_pdb_deprecated('gimp-item-transform-perspective'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -370,16 +308,7 @@ CODE sub drawable_transform_perspective_default { - $blurb = <<'BLURB'; -Perform a possibly non-affine transformation on the specified drawable, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_perspective() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-perspective'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -431,20 +360,7 @@ CODE sub drawable_transform_rotate_simple { - $blurb = <<'BLURB'; -Rotate the specified drawable about given coordinates through the specified angle. -BLURB - - $help = <<'HELP'; -This function rotates the specified drawable if no selection -exists. If a selection exists, the portion of the drawable which lies -under the selection is cut from the drawable and made into a floating -selection which is then rotated by the specified amount. The return -value is the ID of the rotated drawable. If there was no selection, -this will be equal to the drawable ID supplied as input. Otherwise, -this will be the newly created and rotated drawable. -HELP - + &std_pdb_deprecated('gimp-item-transform-rotate-simple'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -497,21 +413,7 @@ CODE } sub drawable_transform_rotate { - $blurb = <<'BLURB'; -Rotate the specified drawable about given coordinates through the -specified angle. -BLURB - - $help = <<'HELP'; -This function rotates the specified drawable if no selection -exists. If a selection exists, the portion of the drawable which lies -under the selection is cut from the drawable and made into a floating -selection which is then rotated by the specified amount. The return -value is the ID of the rotated drawable. If there was no selection, -this will be equal to the drawable ID supplied as input. Otherwise, -this will be the newly created and rotated drawable. -HELP - + &std_pdb_deprecated('gimp-item-transform-rotate'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -555,16 +457,7 @@ CODE sub drawable_transform_rotate_default { - $blurb = <<'BLURB'; -Rotate the specified drawable about given coordinates through the specified angle. -BLURB - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_rotate() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-rotate'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -602,18 +495,7 @@ CODE sub drawable_transform_scale { - $blurb = 'Scale the specified drawable with extra parameters'; - - $help = <<'HELP'; -This procedure scales the specified drawable if no selection -exists. If a selection exists, the portion of the drawable which lies -under the selection is cut from the drawable and made into a floating -selection which is then scaled by the specified amount. The return -value is the ID of the scaled drawable. If there was no selection, -this will be equal to the drawable ID supplied as input. Otherwise, -this will be the newly created and scaled drawable. -HELP - + &std_pdb_deprecated('gimp-item-transform-scale'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -658,14 +540,7 @@ CODE sub drawable_transform_scale_default { - $blurb = 'Scale the specified drawable with extra parameters'; - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_scale() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-scale'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -704,23 +579,7 @@ CODE sub drawable_transform_shear { - $blurb = <<'BLURB'; -Shear the specified drawable about its center by the specified magnitude, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure shears the specified drawable if no selection -exists. If a selection exists, the portion of the drawable which lies -under the selection is cut from the drawable and made into a floating -selection which is then sheard by the specified amount. The return -value is the ID of the sheard drawable. If there was no selection, -this will be equal to the drawable ID supplied as input. Otherwise, -this will be the newly created and sheard drawable. The shear type -parameter indicates whether the shear will be applied horizontally or -vertically. The magnitude can be either positive or negative and -indicates the extent (in pixels) to shear by. -HELP - + &std_pdb_deprecated('gimp-item-transform-shear'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -758,16 +617,7 @@ CODE sub drawable_transform_shear_default { - $blurb = <<'BLURB'; -Shear the specified drawable about its center by the specified magnitude, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_shear() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-shear'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -799,24 +649,7 @@ CODE sub drawable_transform_2d { - $blurb = <<'BLURB'; -Transform the specified drawable in 2d, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure transforms the specified drawable if no selection -exists. If a selection exists, the portion of the drawable which lies -under the selection is cut from the drawable and made into a floating -selection which is then transformed. The transformation is done by -scaling the image by the x and y scale factors about the point -(source_x, source_y), then rotating around the same point, then -translating that point to the new position (dest_x, dest_y). The -return value is the ID of the rotated drawable. If there was no -selection, this will be equal to the drawable ID supplied as -input. Otherwise, this will be the newly created and transformed -drawable. -HELP - + &std_pdb_deprecated('gimp-item-transform-2d'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -864,16 +697,7 @@ CODE sub drawable_transform_2d_default { - $blurb = <<'BLURB'; -Transform the specified drawable in 2d, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_2d() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-2d'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -915,21 +739,7 @@ CODE sub drawable_transform_matrix { - $blurb = <<'BLURB'; -Transform the specified drawable in 2d, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure transforms the specified drawable if no selection -exists. If a selection exists, the portion of the drawable which lies -under the selection is cut from the drawable and made into a floating -selection which is then transformed. The transformation is done by -assembling a 3x3 matrix from the coefficients passed. The return -value is the ID of the rotated drawable. If there was no selection, -this will be equal to the drawable ID supplied as input. Otherwise, -this will be the newly created and transformed drawable. -HELP - + &std_pdb_deprecated('gimp-item-transform-matrix'); &joao_pdb_misc('2004', '2.2'); @inargs = ( @@ -985,16 +795,7 @@ CODE sub drawable_transform_matrix_default { - $blurb = <<'BLURB'; -Transform the specified drawable in 2d, with extra parameters. -BLURB - - $help = <<'HELP'; -This procedure is a variant of gimp_drawable_transform_matrix() which -uses no interpolation/supersampling at all, or default values -(depending on the 'interpolate' parameter). -HELP - + &std_pdb_deprecated('gimp-item-transform-matrix'); &joao_pdb_misc('2004', '2.2'); @inargs = (