nanogui: Timer Event Patch for Nano-X
Subject:
Re: Timer Event Patch for Nano-X
From:
Gary James ####@####.####
Date:
9 May 2001 01:17:33 -0000
Message-Id: <20010508211639.C777@pc.twcny.rr.com>
On Tue, 08 May 2001 15:20:31 Gary James wrote:
> > On Tue, 8 May 2001, Gary James wrote:
> > > I'm including the timer ID (GR_TIMER_ID) in the event structure for
> > > this purpose.
> >
> > I see. Don't forget to write the gtkdoc API reference headers for the
> new
> > functions in client.c.
>
> I did forget that, will add them tonight.
>
Heres a patch to add the gtkdoc API reference headers to the timer event
functions.
Gary James
diff -urN microwin/src/nanox/client.c microwin-new/src/nanox/client.c
--- microwin/src/nanox/client.c Tue May 8 01:01:12 2001
+++ microwin-new/src/nanox/client.c Tue May 8 21:11:00 2001
@@ -3045,6 +3045,15 @@
#endif
+/**
+ * GrCreateTimer:
+ * @wid: the ID of the window to use as a destination for GR_TIMER_EVENT
events
+ * that result from this timer.
+ * @period: The timer period in milliseconds
+ * @Returns: the ID of the newly created timer, or 0 if failure.
+ *
+ * Creates a nano-X timer with the specified period.
+ */
GR_TIMER_ID
GrCreateTimer (GR_WINDOW_ID wid, GR_TIMEOUT period)
{
@@ -3061,6 +3070,15 @@
return timerid;
}
+/**
+ * GrDestroyTimer:
+ * @tid: the ID of the timer to destroy
+ *
+ * Destroys a timer previously created with GrCreateTimer(). NOTE: There
is a
+ * potential for more GR_TIMER_EVENTs to be queued in the connection
between
+ * the nano-X server and client. The client should be able to handle late
+ * arriving GR_TIMER_EVENTs.
+ */
void
GrDestroyTimer (GR_TIMER_ID tid)
{