home *** CD-ROM | disk | FTP | other *** search
/ PC Pro 2002 April / pcpro0402.iso / essentials / graphics / Gimp / gimp-src-20001226.exe / src / gimp / app / paths_cmds.c < prev    next >
Encoding:
C/C++ Source or Header  |  2000-02-23  |  26.2 KB  |  1,133 lines
  1. /* The GIMP -- an image manipulation program
  2.  * Copyright (C) 1995-2000 Spencer Kimball and Peter Mattis
  3.  *
  4.  * This program is free software; you can redistribute it and/or modify
  5.  * it under the terms of the GNU General Public License as published by
  6.  * the Free Software Foundation; either version 2 of the License, or
  7.  * (at your option) any later version.
  8.  *
  9.  * This program is distributed in the hope that it will be useful,
  10.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12.  * GNU General Public License for more details.
  13.  *
  14.  * You should have received a copy of the GNU General Public License
  15.  * along with this program; if not, write to the Free Software
  16.  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  17.  */
  18.  
  19. /* NOTE: This file is autogenerated by pdbgen.pl. */
  20.  
  21. #include "procedural_db.h"
  22.  
  23. #include <string.h>
  24.  
  25. #include "gimage.h"
  26. #include "path.h"
  27. #include "pathP.h"
  28.  
  29. static ProcRecord path_list_proc;
  30. static ProcRecord path_get_points_proc;
  31. static ProcRecord path_get_current_proc;
  32. static ProcRecord path_set_current_proc;
  33. static ProcRecord path_set_points_proc;
  34. static ProcRecord path_stroke_current_proc;
  35. static ProcRecord path_get_point_at_dist_proc;
  36. static ProcRecord path_get_tattoo_proc;
  37. static ProcRecord get_path_by_tattoo_proc;
  38. static ProcRecord path_delete_proc;
  39. static ProcRecord path_get_locked_proc;
  40. static ProcRecord path_set_locked_proc;
  41. static ProcRecord path_set_tattoo_proc;
  42.  
  43. void
  44. register_paths_procs (void)
  45. {
  46.   procedural_db_register (&path_list_proc);
  47.   procedural_db_register (&path_get_points_proc);
  48.   procedural_db_register (&path_get_current_proc);
  49.   procedural_db_register (&path_set_current_proc);
  50.   procedural_db_register (&path_set_points_proc);
  51.   procedural_db_register (&path_stroke_current_proc);
  52.   procedural_db_register (&path_get_point_at_dist_proc);
  53.   procedural_db_register (&path_get_tattoo_proc);
  54.   procedural_db_register (&get_path_by_tattoo_proc);
  55.   procedural_db_register (&path_delete_proc);
  56.   procedural_db_register (&path_get_locked_proc);
  57.   procedural_db_register (&path_set_locked_proc);
  58.   procedural_db_register (&path_set_tattoo_proc);
  59. }
  60.  
  61. static Argument *
  62. path_list_invoker (Argument *args)
  63. {
  64.   gboolean success = TRUE;
  65.   Argument *return_args;
  66.   GimpImage *gimage;
  67.   gint32 num_paths = 0;
  68.   gchar **path_list = NULL;
  69.   PathList *plist;
  70.  
  71.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  72.   if (gimage == NULL)
  73.     success = FALSE;
  74.  
  75.   if (success)
  76.     {
  77.       plist = gimage->paths;
  78.     
  79.       if (plist && plist->bz_paths)
  80.     {
  81.       gint    count = 0;
  82.       GSList *pl    = plist->bz_paths;
  83.     
  84.       num_paths = g_slist_length (pl);
  85.     
  86.       path_list = g_new (gchar *, num_paths);
  87.       while (pl)
  88.         {
  89.           Path *pptr = pl->data;
  90.           path_list[count++] = g_strdup (pptr->name);
  91.           pl = pl->next;
  92.         }
  93.     }
  94.     }
  95.  
  96.   return_args = procedural_db_return_args (&path_list_proc, success);
  97.  
  98.   if (success)
  99.     {
  100.       return_args[1].value.pdb_int = num_paths;
  101.       return_args[2].value.pdb_pointer = path_list;
  102.     }
  103.  
  104.   return return_args;
  105. }
  106.  
  107. static ProcArg path_list_inargs[] =
  108. {
  109.   {
  110.     PDB_IMAGE,
  111.     "image",
  112.     "The ID of the image to list the paths from"
  113.   }
  114. };
  115.  
  116. static ProcArg path_list_outargs[] =
  117. {
  118.   {
  119.     PDB_INT32,
  120.     "num_paths",
  121.     "The number of paths returned"
  122.   },
  123.   {
  124.     PDB_STRINGARRAY,
  125.     "path_list",
  126.     "List of the paths belonging to this image"
  127.   }
  128. };
  129.  
  130. static ProcRecord path_list_proc =
  131. {
  132.   "gimp_path_list",
  133.   "List the paths associated with the passed image.",
  134.   "List the paths associated with the passed image.",
  135.   "Andy Thomas",
  136.   "Andy Thomas",
  137.   "1999",
  138.   PDB_INTERNAL,
  139.   1,
  140.   path_list_inargs,
  141.   2,
  142.   path_list_outargs,
  143.   { { path_list_invoker } }
  144. };
  145.  
  146. static Argument *
  147. path_get_points_invoker (Argument *args)
  148. {
  149.   gboolean success = TRUE;
  150.   Argument *return_args;
  151.   GimpImage *gimage;
  152.   gchar *pname;
  153.   gint32 num_pdetails = 0;
  154.   gdouble *pnts = NULL;
  155.   PathList *plist;
  156.   Path *pptr = NULL;
  157.  
  158.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  159.   if (gimage == NULL)
  160.     success = FALSE;
  161.  
  162.   pname = (gchar *) args[1].value.pdb_pointer;
  163.   if (pname == NULL)
  164.     success = FALSE;
  165.  
  166.   if (success)
  167.     {
  168.       /* Get the path with the given name */
  169.       plist = gimage->paths;
  170.       
  171.       if (plist && plist->bz_paths)
  172.     {
  173.       GSList *pl = plist->bz_paths;
  174.     
  175.       while (pl)
  176.         {
  177.           pptr = pl->data;
  178.     
  179.           if (!strcmp (pname, pptr->name))
  180.         break; /* Found the path */
  181.     
  182.           pl = pl->next;
  183.           pptr = NULL;
  184.         }
  185.     
  186.       if (pl && pptr)
  187.         {
  188.           GSList  *points_list;
  189.           gint     pcount = 0;
  190.     
  191.           points_list = pptr->path_details;
  192.           if (points_list)
  193.         {
  194.           num_pdetails = g_slist_length (points_list) * 3;
  195.     
  196.           pnts = g_new (gdouble, num_pdetails);
  197.     
  198.           /* fill points and types in */
  199.           while (points_list)
  200.             {
  201.               PathPoint *ppoint = points_list->data;
  202.               pnts[pcount] = ppoint->x;
  203.               pnts[pcount + 1] = ppoint->y;
  204.               pnts[pcount + 2] = (gfloat) ppoint->type; /* Bit of fiddle but should be understandable why it was done */
  205.               pcount += 3;
  206.               points_list = points_list->next;
  207.             }
  208.         }        
  209.           else
  210.         success = FALSE;
  211.         }
  212.       else
  213.         success = FALSE;
  214.     }
  215.     }
  216.  
  217.   return_args = procedural_db_return_args (&path_get_points_proc, success);
  218.  
  219.   if (success)
  220.     {
  221.       return_args[1].value.pdb_int = pptr->pathtype;
  222.       return_args[2].value.pdb_int = pptr->closed;
  223.       return_args[3].value.pdb_int = num_pdetails;
  224.       return_args[4].value.pdb_pointer = pnts;
  225.     }
  226.  
  227.   return return_args;
  228. }
  229.  
  230. static ProcArg path_get_points_inargs[] =
  231. {
  232.   {
  233.     PDB_IMAGE,
  234.     "image",
  235.     "The ID of the image to list the paths from"
  236.   },
  237.   {
  238.     PDB_STRING,
  239.     "pathname",
  240.     "the name of the path whose points should be listed"
  241.   }
  242. };
  243.  
  244. static ProcArg path_get_points_outargs[] =
  245. {
  246.   {
  247.     PDB_INT32,
  248.     "path_type",
  249.     "The type of the path. Currently only one type (1 = Bezier) is supported"
  250.   },
  251.   {
  252.     PDB_INT32,
  253.     "path_closed",
  254.     "Return if the path is closed. {0=path open, 1= path closed}"
  255.   },
  256.   {
  257.     PDB_INT32,
  258.     "num_path_point_details",
  259.     "The number of points returned. Each point is made up of (x,y,pnt_type) of floats"
  260.   },
  261.   {
  262.     PDB_FLOATARRAY,
  263.     "points_pairs",
  264.     "The points in the path represented as 3 floats. The first is the x pos, next is the y pos, last is the type of the pnt. The type field is dependant on the path type. For beziers (type 1 paths) the type can either be {1.0= BEZIER_ANCHOR, 2.0= BEZIER_CONTROL}. Note all points are returned in pixel resolution"
  265.   }
  266. };
  267.  
  268. static ProcRecord path_get_points_proc =
  269. {
  270.   "gimp_path_get_points",
  271.   "List the points associated with the named path.",
  272.   "List the points associated with the named path.",
  273.   "Andy Thomas",
  274.   "Andy Thomas",
  275.   "1999",
  276.   PDB_INTERNAL,
  277.   2,
  278.   path_get_points_inargs,
  279.   4,
  280.   path_get_points_outargs,
  281.   { { path_get_points_invoker } }
  282. };
  283.  
  284. static Argument *
  285. path_get_current_invoker (Argument *args)
  286. {
  287.   gboolean success = TRUE;
  288.   Argument *return_args;
  289.   GimpImage *gimage;
  290.   PathList *plist;
  291.   Path *pptr = NULL;
  292.  
  293.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  294.   if (gimage == NULL)
  295.     success = FALSE;
  296.  
  297.   if (success)
  298.     {
  299.       /* Get the path with the given name */
  300.       plist = gimage->paths;
  301.     
  302.       if (plist && plist->bz_paths && plist->last_selected_row >= 0)
  303.     pptr = (Path*) g_slist_nth_data (plist->bz_paths, plist->last_selected_row);
  304.       else
  305.     success = FALSE;
  306.     }
  307.  
  308.   return_args = procedural_db_return_args (&path_get_current_proc, success);
  309.  
  310.   if (success)
  311.     return_args[1].value.pdb_pointer = g_strdup (pptr->name);
  312.  
  313.   return return_args;
  314. }
  315.  
  316. static ProcArg path_get_current_inargs[] =
  317. {
  318.   {
  319.     PDB_IMAGE,
  320.     "image",
  321.     "The ID of the image to get the current paths from"
  322.   }
  323. };
  324.  
  325. static ProcArg path_get_current_outargs[] =
  326. {
  327.   {
  328.     PDB_STRING,
  329.     "current_path_name",
  330.     "The name of the current path"
  331.   }
  332. };
  333.  
  334. static ProcRecord path_get_current_proc =
  335. {
  336.   "gimp_path_get_current",
  337.   "The name of the current path. Error if no paths.",
  338.   "The name of the current path. Error if no paths.",
  339.   "Andy Thomas",
  340.   "Andy Thomas",
  341.   "1999",
  342.   PDB_INTERNAL,
  343.   1,
  344.   path_get_current_inargs,
  345.   1,
  346.   path_get_current_outargs,
  347.   { { path_get_current_invoker } }
  348. };
  349.  
  350. static Argument *
  351. path_set_current_invoker (Argument *args)
  352. {
  353.   gboolean success = TRUE;
  354.   GimpImage *gimage;
  355.   gchar *pname;
  356.  
  357.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  358.   if (gimage == NULL)
  359.     success = FALSE;
  360.  
  361.   pname = (gchar *) args[1].value.pdb_pointer;
  362.   if (pname == NULL)
  363.     success = FALSE;
  364.  
  365.   if (success)
  366.     success = path_set_path (gimage, pname);
  367.  
  368.   return procedural_db_return_args (&path_set_current_proc, success);
  369. }
  370.  
  371. static ProcArg path_set_current_inargs[] =
  372. {
  373.   {
  374.     PDB_IMAGE,
  375.     "image",
  376.     "The ID of the image to list set the paths in"
  377.   },
  378.   {
  379.     PDB_STRING,
  380.     "set_current_path_name",
  381.     "The name of the path to set the current path to"
  382.   }
  383. };
  384.  
  385. static ProcRecord path_set_current_proc =
  386. {
  387.   "gimp_path_set_current",
  388.   "List the paths associated with the passed image.",
  389.   "List the paths associated with the passed image.",
  390.   "Andy Thomas",
  391.   "Andy Thomas",
  392.   "1999",
  393.   PDB_INTERNAL,
  394.   2,
  395.   path_set_current_inargs,
  396.   0,
  397.   NULL,
  398.   { { path_set_current_invoker } }
  399. };
  400.  
  401. static Argument *
  402. path_set_points_invoker (Argument *args)
  403. {
  404.   gboolean success = TRUE;
  405.   GimpImage *gimage;
  406.   gchar *pname = NULL;
  407.   gint32 ptype;
  408.   gint32 numpoints = 0;
  409.   gdouble *pnts;
  410.   gboolean pclosed = FALSE;
  411.  
  412.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  413.   if (gimage == NULL)
  414.     success = FALSE;
  415.  
  416.   pname = (gchar *) args[1].value.pdb_pointer;
  417.   if (pname == NULL)
  418.     success = FALSE;
  419.  
  420.   ptype = args[2].value.pdb_int;
  421.  
  422.   numpoints = args[3].value.pdb_int;
  423.   if (numpoints <= 0)
  424.     success = FALSE;
  425.  
  426.   pnts = (gdouble *) args[4].value.pdb_pointer;
  427.  
  428.   if (success)
  429.     {
  430.       if ((numpoints / 3) % 3 == 0)
  431.     pclosed = TRUE;
  432.       else if ((numpoints / 3) % 3 != 2)
  433.     success = FALSE;
  434.     
  435.       if (success && !path_set_path_points (gimage, pname, ptype, pclosed,
  436.                         numpoints, pnts))
  437.     success = FALSE;
  438.     }
  439.  
  440.   return procedural_db_return_args (&path_set_points_proc, success);
  441. }
  442.  
  443. static ProcArg path_set_points_inargs[] =
  444. {
  445.   {
  446.     PDB_IMAGE,
  447.     "image",
  448.     "The ID of the image to set the paths in"
  449.   },
  450.   {
  451.     PDB_STRING,
  452.     "pathname",
  453.     "The name of the path to create (if it exists then a unique name will be created - query the list of paths if you want to make sure that the name of the path you create is unique. This will be set as the current path."
  454.   },
  455.   {
  456.     PDB_INT32,
  457.     "ptype",
  458.     "The type of the path. Currently only one type (1 = Bezier) is supported"
  459.   },
  460.   {
  461.     PDB_INT32,
  462.     "num_path_points",
  463.     "The number of points in the path. Each point is made up of (x,y,type) of floats. Currently only the creation of bezier curves is allowed. The type parameter must be set to (1) to indicate a BEZIER type curve. For BEZIERS. Note the that points must be given in the following order... ACCACCAC ... If the path is not closed the last control point is missed off. Points consist of three control points (control/anchor/control) so for a curve that is not closed there must be at least two points passed (2 x,y pairs). If num_path_pnts % 3 = 0 then the path is assumed to be closed and the points are ACCACCACCACC."
  464.   },
  465.   {
  466.     PDB_FLOATARRAY,
  467.     "points_pairs",
  468.     "The points in the path represented as 3 floats. The first is the x pos, next is the y pos, last is the type of the pnt. The type field is dependant on the path type. For beziers (type 1 paths) the type can either be {1.0= BEZIER_ANCHOR, 2.0= BEZIER_CONTROL}. Note all points are returned in pixel resolution"
  469.   }
  470. };
  471.  
  472. static ProcRecord path_set_points_proc =
  473. {
  474.   "gimp_path_set_points",
  475.   "Set the points associated with the named path.",
  476.   "Set the points associated with the named path.",
  477.   "Andy Thomas",
  478.   "Andy Thomas",
  479.   "1999",
  480.   PDB_INTERNAL,
  481.   5,
  482.   path_set_points_inargs,
  483.   0,
  484.   NULL,
  485.   { { path_set_points_invoker } }
  486. };
  487.  
  488. static Argument *
  489. path_stroke_current_invoker (Argument *args)
  490. {
  491.   gboolean success = TRUE;
  492.   GimpImage *gimage;
  493.   PathList *plist;
  494.   Path *pptr = NULL;
  495.  
  496.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  497.   if (gimage == NULL)
  498.     success = FALSE;
  499.  
  500.   if (success)
  501.     {
  502.       /* Get the path with the given name */
  503.       plist = gimage->paths;
  504.     
  505.       if (plist && plist->bz_paths && plist->last_selected_row >= 0)
  506.     {
  507.       if ((pptr = (Path*) g_slist_nth_data (plist->bz_paths,
  508.                         plist->last_selected_row)))
  509.           
  510.         path_stroke (gimage, plist, pptr); /* Found the path to stroke.. */
  511.       else
  512.         success = FALSE;
  513.     }
  514.       else
  515.     success = FALSE;
  516.     }
  517.  
  518.   return procedural_db_return_args (&path_stroke_current_proc, success);
  519. }
  520.  
  521. static ProcArg path_stroke_current_inargs[] =
  522. {
  523.   {
  524.     PDB_IMAGE,
  525.     "image",
  526.     "The ID of the image which contains the path to stroke"
  527.   }
  528. };
  529.  
  530. static ProcRecord path_stroke_current_proc =
  531. {
  532.   "gimp_path_stroke_current",
  533.   "Stroke the current path in the passed image.",
  534.   "Stroke the current path in the passed image.",
  535.   "Andy Thomas",
  536.   "Andy Thomas",
  537.   "1999",
  538.   PDB_INTERNAL,
  539.   1,
  540.   path_stroke_current_inargs,
  541.   0,
  542.   NULL,
  543.   { { path_stroke_current_invoker } }
  544. };
  545.  
  546. static Argument *
  547. path_get_point_at_dist_invoker (Argument *args)
  548. {
  549.   gboolean success = TRUE;
  550.   Argument *return_args;
  551.   GimpImage *gimage;
  552.   gdouble distance;
  553.   gint32 x_point = 0;
  554.   gint32 y_point = 0;
  555.   gdouble gradient = 0;
  556.   PathList *plist;
  557.   Path *pptr = NULL;
  558.  
  559.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  560.   if (gimage == NULL)
  561.     success = FALSE;
  562.  
  563.   distance = args[1].value.pdb_float;
  564.  
  565.   if (success)
  566.     {
  567.       /* Get the path with the given name */
  568.       plist = gimage->paths;
  569.     
  570.       if (plist && plist->bz_paths && plist->last_selected_row >= 0)
  571.     {
  572.       pptr = (Path*) g_slist_nth_data (plist->bz_paths,
  573.                        plist->last_selected_row);
  574.       success = path_distance (pptr, distance, &x_point, &y_point,
  575.                    &gradient);
  576.     }
  577.       else
  578.     success = FALSE;
  579.     }
  580.  
  581.   return_args = procedural_db_return_args (&path_get_point_at_dist_proc, success);
  582.  
  583.   if (success)
  584.     {
  585.       return_args[1].value.pdb_int = x_point;
  586.       return_args[2].value.pdb_int = y_point;
  587.       return_args[3].value.pdb_float = gradient;
  588.     }
  589.  
  590.   return return_args;
  591. }
  592.  
  593. static ProcArg path_get_point_at_dist_inargs[] =
  594. {
  595.   {
  596.     PDB_IMAGE,
  597.     "image",
  598.     "The ID of the image the paths belongs to"
  599.   },
  600.   {
  601.     PDB_FLOAT,
  602.     "distance",
  603.     "The distance along the path"
  604.   }
  605. };
  606.  
  607. static ProcArg path_get_point_at_dist_outargs[] =
  608. {
  609.   {
  610.     PDB_INT32,
  611.     "x_point",
  612.     "The x position of the point"
  613.   },
  614.   {
  615.     PDB_INT32,
  616.     "y_point",
  617.     "The y position of the point"
  618.   },
  619.   {
  620.     PDB_FLOAT,
  621.     "gradient",
  622.     "The gradient at the specified point"
  623.   }
  624. };
  625.  
  626. static ProcRecord path_get_point_at_dist_proc =
  627. {
  628.   "gimp_path_get_point_at_dist",
  629.   "Get point on a path at a specified distance along the path.",
  630.   "This will return the x,y position of a point at a given distance along the bezier curve. The distance will the obtained by first digitizing the curve internally an then walking along the curve. For a closed curve the start of the path is the first point on the path that was created. This might not be obvious. Note the current path is used.",
  631.   "Andy Thomas",
  632.   "Andy Thomas",
  633.   "1999",
  634.   PDB_INTERNAL,
  635.   2,
  636.   path_get_point_at_dist_inargs,
  637.   3,
  638.   path_get_point_at_dist_outargs,
  639.   { { path_get_point_at_dist_invoker } }
  640. };
  641.  
  642. static Argument *
  643. path_get_tattoo_invoker (Argument *args)
  644. {
  645.   gboolean success = TRUE;
  646.   Argument *return_args;
  647.   GimpImage *gimage;
  648.   gchar *pname;
  649.   gint32 tattoo = 0;
  650.   PathList *plist;
  651.   Path *pptr = NULL;
  652.  
  653.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  654.   if (gimage == NULL)
  655.     success = FALSE;
  656.  
  657.   pname = (gchar *) args[1].value.pdb_pointer;
  658.   if (pname == NULL)
  659.     success = FALSE;
  660.  
  661.   if (success)
  662.     {
  663.       /* Get the path with the given name */
  664.       plist = gimage->paths;
  665.       
  666.       if (plist && plist->bz_paths)
  667.     {
  668.       GSList *pl = plist->bz_paths;
  669.     
  670.       while (pl)
  671.         {
  672.           pptr = pl->data;
  673.     
  674.           if (!strcmp (pname, pptr->name))
  675.         break; /* Found the path */
  676.     
  677.           pl = pl->next;
  678.           pptr = NULL;
  679.         }
  680.     
  681.       if (pl && pptr)
  682.         tattoo = path_get_tattoo (pptr);
  683.       else
  684.         success = FALSE;
  685.     }
  686.       else
  687.     success = FALSE;
  688.     }
  689.  
  690.   return_args = procedural_db_return_args (&path_get_tattoo_proc, success);
  691.  
  692.   if (success)
  693.     return_args[1].value.pdb_int = tattoo;
  694.  
  695.   return return_args;
  696. }
  697.  
  698. static ProcArg path_get_tattoo_inargs[] =
  699. {
  700.   {
  701.     PDB_IMAGE,
  702.     "image",
  703.     "The image"
  704.   },
  705.   {
  706.     PDB_STRING,
  707.     "pathname",
  708.     "the name of the path whose tattoo should be obtained"
  709.   }
  710. };
  711.  
  712. static ProcArg path_get_tattoo_outargs[] =
  713. {
  714.   {
  715.     PDB_INT32,
  716.     "tattoo",
  717.     "The tattoo associated with the name path"
  718.   }
  719. };
  720.  
  721. static ProcRecord path_get_tattoo_proc =
  722. {
  723.   "gimp_path_get_tattoo",
  724.   "Returns the tattoo associated with the name path.",
  725.   "This procedure returns the tattoo associated with the specified path. A tattoo is a unique and permanent identifier attached to a path that can be used to uniquely identify a path within an image even between sessions.",
  726.   "Andy Thomas",
  727.   "Andy Thomas",
  728.   "1999",
  729.   PDB_INTERNAL,
  730.   2,
  731.   path_get_tattoo_inargs,
  732.   1,
  733.   path_get_tattoo_outargs,
  734.   { { path_get_tattoo_invoker } }
  735. };
  736.  
  737. static Argument *
  738. get_path_by_tattoo_invoker (Argument *args)
  739. {
  740.   gboolean success = TRUE;
  741.   Argument *return_args;
  742.   GimpImage *gimage;
  743.   gint32 tattoo;
  744.   PathList *plist;
  745.   Path *pptr = NULL;
  746.  
  747.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  748.   if (gimage == NULL)
  749.     success = FALSE;
  750.  
  751.   tattoo = args[1].value.pdb_int;
  752.  
  753.   if (success)
  754.     {
  755.       /* Get the path with the given name */
  756.       plist = gimage->paths;
  757.     
  758.       if (plist && plist->bz_paths)
  759.     {        
  760.       if ((pptr = path_get_path_by_tattoo (gimage, tattoo)) == NULL)
  761.         success = FALSE;
  762.     }
  763.       else
  764.     success = FALSE;
  765.     }
  766.  
  767.   return_args = procedural_db_return_args (&get_path_by_tattoo_proc, success);
  768.  
  769.   if (success)
  770.     return_args[1].value.pdb_pointer = g_strdup (pptr->name);
  771.  
  772.   return return_args;
  773. }
  774.  
  775. static ProcArg get_path_by_tattoo_inargs[] =
  776. {
  777.   {
  778.     PDB_IMAGE,
  779.     "image",
  780.     "The image"
  781.   },
  782.   {
  783.     PDB_INT32,
  784.     "tattoo",
  785.     "The tattoo of the required path"
  786.   }
  787. };
  788.  
  789. static ProcArg get_path_by_tattoo_outargs[] =
  790. {
  791.   {
  792.     PDB_STRING,
  793.     "path_name",
  794.     "The name of the path with the specified tattoo"
  795.   }
  796. };
  797.  
  798. static ProcRecord get_path_by_tattoo_proc =
  799. {
  800.   "gimp_get_path_by_tattoo",
  801.   "Return the name of the path with the given tattoo.",
  802.   "The procedure returns the name of the path in the specified image which has the passed tattoo. The tattoos are unique within the image and will be preserved across sessions and through renaming of the path. An error is returned if no path woth the specified tattoo can be found.",
  803.   "Andy Thomas",
  804.   "Andy Thomas",
  805.   "1999",
  806.   PDB_INTERNAL,
  807.   2,
  808.   get_path_by_tattoo_inargs,
  809.   1,
  810.   get_path_by_tattoo_outargs,
  811.   { { get_path_by_tattoo_invoker } }
  812. };
  813.  
  814. static Argument *
  815. path_delete_invoker (Argument *args)
  816. {
  817.   gboolean success = TRUE;
  818.   GimpImage *gimage;
  819.   gchar *pname;
  820.  
  821.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  822.   if (gimage == NULL)
  823.     success = FALSE;
  824.  
  825.   pname = (gchar *) args[1].value.pdb_pointer;
  826.   if (pname == NULL)
  827.     success = FALSE;
  828.  
  829.   if (success)
  830.     success = path_delete_path (gimage, pname);
  831.  
  832.   return procedural_db_return_args (&path_delete_proc, success);
  833. }
  834.  
  835. static ProcArg path_delete_inargs[] =
  836. {
  837.   {
  838.     PDB_IMAGE,
  839.     "image",
  840.     "The ID of the image to list delete the paths from"
  841.   },
  842.   {
  843.     PDB_STRING,
  844.     "path_name_to_del",
  845.     "The name of the path to delete"
  846.   }
  847. };
  848.  
  849. static ProcRecord path_delete_proc =
  850. {
  851.   "gimp_path_delete",
  852.   "Delete the named paths associated with the passed image.",
  853.   "Delete the named path.",
  854.   "Andy Thomas",
  855.   "Andy Thomas",
  856.   "1999",
  857.   PDB_INTERNAL,
  858.   2,
  859.   path_delete_inargs,
  860.   0,
  861.   NULL,
  862.   { { path_delete_invoker } }
  863. };
  864.  
  865. static Argument *
  866. path_get_locked_invoker (Argument *args)
  867. {
  868.   gboolean success = TRUE;
  869.   Argument *return_args;
  870.   GimpImage *gimage;
  871.   gchar *pname;
  872.   gint32 lockstatus = 0;
  873.   PathList *plist;
  874.   Path *pptr = NULL;
  875.  
  876.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  877.   if (gimage == NULL)
  878.     success = FALSE;
  879.  
  880.   pname = (gchar *) args[1].value.pdb_pointer;
  881.   if (pname == NULL)
  882.     success = FALSE;
  883.  
  884.   if (success)
  885.     {
  886.       /* Get the path with the given name */
  887.       plist = gimage->paths;
  888.       
  889.       if (plist && plist->bz_paths)
  890.     {
  891.       GSList *pl = plist->bz_paths;
  892.     
  893.       while (pl)
  894.         {
  895.           pptr = pl->data;
  896.     
  897.           if (!strcmp (pname, pptr->name))
  898.         break; /* Found the path */
  899.     
  900.           pl = pl->next;
  901.           pptr = NULL;
  902.         }
  903.     
  904.       if (pl && pptr)
  905.         lockstatus = pptr->locked;
  906.       else
  907.         success = FALSE;
  908.     }
  909.       else
  910.     success = FALSE;
  911.     }
  912.  
  913.   return_args = procedural_db_return_args (&path_get_locked_proc, success);
  914.  
  915.   if (success)
  916.     return_args[1].value.pdb_int = lockstatus;
  917.  
  918.   return return_args;
  919. }
  920.  
  921. static ProcArg path_get_locked_inargs[] =
  922. {
  923.   {
  924.     PDB_IMAGE,
  925.     "image",
  926.     "The image"
  927.   },
  928.   {
  929.     PDB_STRING,
  930.     "pathname",
  931.     "the name of the path whose locked status should be obtained"
  932.   }
  933. };
  934.  
  935. static ProcArg path_get_locked_outargs[] =
  936. {
  937.   {
  938.     PDB_INT32,
  939.     "lockstatus",
  940.     "The lock status associated with the name path. 0 returned if the path is not locked. 1 is returned if the path is locked"
  941.   }
  942. };
  943.  
  944. static ProcRecord path_get_locked_proc =
  945. {
  946.   "gimp_path_get_locked",
  947.   "Returns the locked status associated with the name path.",
  948.   "This procedure returns the lock status associated with the specified path. A path can be \"locked\" which means that the transformation tool operations will also apply to the path.",
  949.   "Andy Thomas",
  950.   "Andy Thomas",
  951.   "1999",
  952.   PDB_INTERNAL,
  953.   2,
  954.   path_get_locked_inargs,
  955.   1,
  956.   path_get_locked_outargs,
  957.   { { path_get_locked_invoker } }
  958. };
  959.  
  960. static Argument *
  961. path_set_locked_invoker (Argument *args)
  962. {
  963.   gboolean success = TRUE;
  964.   GimpImage *gimage;
  965.   gchar *pname;
  966.   gint32 lockstatus = 0;
  967.   PathList *plist;
  968.   Path *pptr = NULL;
  969.  
  970.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  971.   if (gimage == NULL)
  972.     success = FALSE;
  973.  
  974.   pname = (gchar *) args[1].value.pdb_pointer;
  975.   if (pname == NULL)
  976.     success = FALSE;
  977.  
  978.   lockstatus = args[2].value.pdb_int;
  979.  
  980.   if (success)
  981.     {
  982.       /* Get the path with the given name */
  983.       plist = gimage->paths;
  984.       
  985.       if (plist && plist->bz_paths)
  986.     {
  987.       GSList *pl = plist->bz_paths;
  988.     
  989.       while (pl)
  990.         {
  991.           pptr = pl->data;
  992.     
  993.           if (!strcmp (pname, pptr->name))
  994.         break; /* Found the path */
  995.     
  996.           pl = pl->next;
  997.           pptr = NULL;
  998.         }
  999.     
  1000.       if (pl && pptr && lockstatus >=0 && lockstatus <= 1)
  1001.         pptr->locked = lockstatus;
  1002.       else
  1003.         success = FALSE;
  1004.     }
  1005.       else
  1006.     success = FALSE;
  1007.     }
  1008.  
  1009.   return procedural_db_return_args (&path_set_locked_proc, success);
  1010. }
  1011.  
  1012. static ProcArg path_set_locked_inargs[] =
  1013. {
  1014.   {
  1015.     PDB_IMAGE,
  1016.     "image",
  1017.     "The image"
  1018.   },
  1019.   {
  1020.     PDB_STRING,
  1021.     "pathname",
  1022.     "the name of the path whose locked status should be set"
  1023.   },
  1024.   {
  1025.     PDB_INT32,
  1026.     "lockstatus",
  1027.     "The lock status associated with the name path. 0 if the path is not locked. 1 if the path is to be locked"
  1028.   }
  1029. };
  1030.  
  1031. static ProcRecord path_set_locked_proc =
  1032. {
  1033.   "gimp_path_set_locked",
  1034.   "Set the locked status associated with the name path.",
  1035.   "This procedure sets the lock status associated with the specified path. A path can be \"locked\" which means that the transformation tool operations will also apply to the path.",
  1036.   "Andy Thomas",
  1037.   "Andy Thomas",
  1038.   "1999",
  1039.   PDB_INTERNAL,
  1040.   3,
  1041.   path_set_locked_inargs,
  1042.   0,
  1043.   NULL,
  1044.   { { path_set_locked_invoker } }
  1045. };
  1046.  
  1047. static Argument *
  1048. path_set_tattoo_invoker (Argument *args)
  1049. {
  1050.   gboolean success = TRUE;
  1051.   GimpImage *gimage;
  1052.   gchar *pname;
  1053.   gint32 tattovalue = 0;
  1054.   PathList *plist;
  1055.   Path *pptr = NULL;
  1056.  
  1057.   gimage = pdb_id_to_image (args[0].value.pdb_int);
  1058.   if (gimage == NULL)
  1059.     success = FALSE;
  1060.  
  1061.   pname = (gchar *) args[1].value.pdb_pointer;
  1062.   if (pname == NULL)
  1063.     success = FALSE;
  1064.  
  1065.   tattovalue = args[2].value.pdb_int;
  1066.  
  1067.   if (success)
  1068.     {
  1069.       /* Get the path with the given name */
  1070.       plist = gimage->paths;
  1071.       
  1072.       if (plist && plist->bz_paths)
  1073.     {
  1074.       GSList *pl = plist->bz_paths;
  1075.     
  1076.       while (pl)
  1077.         {
  1078.           pptr = pl->data;
  1079.     
  1080.           if (!strcmp (pname, pptr->name))
  1081.         break; /* Found the path */
  1082.     
  1083.           pl = pl->next;
  1084.           pptr = NULL;
  1085.         }
  1086.     
  1087.       if (pl && pptr)
  1088.         pptr->tattoo = tattovalue ;
  1089.       else
  1090.         success = FALSE;
  1091.     }
  1092.       else
  1093.     success = FALSE;
  1094.     }
  1095.  
  1096.   return procedural_db_return_args (&path_set_tattoo_proc, success);
  1097. }
  1098.  
  1099. static ProcArg path_set_tattoo_inargs[] =
  1100. {
  1101.   {
  1102.     PDB_IMAGE,
  1103.     "image",
  1104.     "The image"
  1105.   },
  1106.   {
  1107.     PDB_STRING,
  1108.     "pathname",
  1109.     "the name of the path whose tattoo should be set"
  1110.   },
  1111.   {
  1112.     PDB_INT32,
  1113.     "tattovalue",
  1114.     "The tattoo associated with the name path. Only values returned from 'path_get_tattoo' should be used here"
  1115.   }
  1116. };
  1117.  
  1118. static ProcRecord path_set_tattoo_proc =
  1119. {
  1120.   "gimp_path_set_tattoo",
  1121.   "Sets the tattoo associated with the name path.",
  1122.   "This procedure sets the tattoo associated with the specified path. A tattoo is a unique and permenant identifier attached to a path that can be used to uniquely identify a path within an image even between sessions. Note that the value passed to this function must have been obtained from a previous call to path_get_tattoo.",
  1123.   "Andy Thomas",
  1124.   "Andy Thomas",
  1125.   "1999",
  1126.   PDB_INTERNAL,
  1127.   3,
  1128.   path_set_tattoo_inargs,
  1129.   0,
  1130.   NULL,
  1131.   { { path_set_tattoo_invoker } }
  1132. };
  1133.