From 839d0ab4354c5568ecae35f48b1ec9d072ee43f6 Mon Sep 17 00:00:00 2001
From: Nicola Fontana <ntd@entidi.it>
Date: Sat, 4 Jul 2009 01:00:20 +0200
Subject: [PATCH] [CpmlArc] Placeholder for cpml_arc_near_pos()

Empty function: should be implemented.
---
 cpml/cpml-arc.c | 25 +++++++++++++++++++++++++
 cpml/cpml-arc.h |  2 ++
 2 files changed, 27 insertions(+)

diff --git a/cpml/cpml-arc.c b/cpml/cpml-arc.c
index 2c06a30f..398489fd 100644
--- a/cpml/cpml-arc.c
+++ b/cpml/cpml-arc.c
@@ -242,6 +242,31 @@ cpml_arc_vector_at(const CpmlPrimitive *arc, CpmlVector *vector, double pos)
 }
 
 /**
+ * cpml_arc_near_pos:
+ * @arc: the #CpmlPrimitive arc data
+ * @pair: the coordinates of the subject point
+ *
+ * Returns the pos value of the point on @arc nearest to @pair.
+ * The returned value is always between 0 and 1.
+ *
+ * <important>
+ * <title>TODO</title>
+ * <itemizedlist>
+ * <listitem>To be implemented...</listitem>
+ * </itemizedlist>
+ * </important>
+ *
+ * Return value: the pos value, always between 0 and 1
+ **/
+double
+cpml_arc_near_pos(const CpmlPrimitive *arc, const CpmlPair *pair)
+{
+    /* TODO */
+
+    return 0;
+}
+
+/**
  * cpml_arc_intersection:
  * @arc:  the first arc
  * @arc2: the second arc
diff --git a/cpml/cpml-arc.h b/cpml/cpml-arc.h
index 304cad89..696d0488 100644
--- a/cpml/cpml-arc.h
+++ b/cpml/cpml-arc.h
@@ -47,6 +47,8 @@ void    cpml_arc_pair_at                (const CpmlPrimitive    *arc,
 void    cpml_arc_vector_at              (const CpmlPrimitive    *arc,
                                          CpmlVector             *vector,
                                          double                  pos);
+double  cpml_arc_near_pos               (const CpmlPrimitive    *arc,
+                                         const CpmlPair         *pair);
 int     cpml_arc_intersection           (const CpmlPrimitive    *arc,
                                          const CpmlPrimitive    *arc2,
                                          CpmlPair               *dest,
-- 
2.11.4.GIT