Changeset 1586 for trunk/examples/objects/api/c/plot

Timestamp:

Oct 23, 2009 7:56:25 AM (11 years ago)

Author:

dkearney

Message:

updating potential apis for c cpp and python. adding random() and diff()
functions to the rappture objects. objects should be able to generate a random
value for itself based on how it was configured. objects should be able to
compare itself with another object and tell us what the differences are.

File:

• trunk/examples/objects/api/c/plot (modified) (2 diffs)

trunk/examples/objects/api/c/plot

@@ -42 +42 @@
     void Rp_PlotVValue(Rp_Plot *p, void *storage, size_t numHints,
                        va_list arg) const;
+    void Rp_PlotRandom();
+    Rp_Chain *Rp_PlotDiff(Rp_Plot *o);
 
     void Rp_PlotConfigure(Rp_Plot *p, size_t as, ClientData c);
@@ -264 +266 @@
     Code Example:
 
+void Rp_PlotRandom();
+    Purpose: populate the object with a random value
+    Input Arguments: 0
+    Return Value: None
+    Notes: the current value of this object will be populated
+           with a random value that fits within the min and
+           max if they were specified.
+    Code Example:
+
+Rp_Chain *Rp_PlotDiff(const Rp_Object *o);
+    Purpose: return a linked list showing the differences between
+             this object and Rp_Object *o
+    Input Arguments: 1
+        1. const Rp_Object *o - object to diff against
+    Return Value: list of differences between objects
+    Notes: None
+    Code Example:
+
 void Rp_PlotConfigure(Rp_Plot *p, size_t as, ClientData c);
     Purpose: configure the object based on the data in "c".