Notice: MediaWiki has been updated. Report any rough edges to marcan@marcan.st
C Sync Wrapper: Difference between revisions
No edit summary |
(→About) |
||
Line 2: | Line 2: | ||
The freenect driver provides an "asynchronous" interface where you provide callbacks and it calls them when sensor data is available. There is another way of thinking about the data by having a "synchronous" interface where you call a function to get an image "freenect_get_depth" or "freenect_get_rgb" and it blocks and gives you back the data. | The freenect driver provides an "asynchronous" interface where you provide callbacks and it calls them when sensor data is available. There is another way of thinking about the data by having a "synchronous" interface where you call a function to get an image "freenect_get_depth" or "freenect_get_rgb" and it blocks and gives you back the data. | ||
This is implemented by using a thread to handle the callbacks and a buffer to provide an interface for the client. You are guaranteed to get the buffers in order by timestamp (e.g., you won't get something older than your last). You may not get all frames with this interface (e.g., there may be gaps). | This is implemented by using a thread to handle the callbacks and a buffer to provide an interface for the client. You are guaranteed to get the buffers in order by timestamp (e.g., you won't get something older than your last). You may not get all frames with this interface (e.g., there may be gaps); however, a 'best effort' is made. | ||
== Who is involved == | == Who is involved == |
Revision as of 18:22, 24 November 2010
About
The freenect driver provides an "asynchronous" interface where you provide callbacks and it calls them when sensor data is available. There is another way of thinking about the data by having a "synchronous" interface where you call a function to get an image "freenect_get_depth" or "freenect_get_rgb" and it blocks and gives you back the data.
This is implemented by using a thread to handle the callbacks and a buffer to provide an interface for the client. You are guaranteed to get the buffers in order by timestamp (e.g., you won't get something older than your last). You may not get all frames with this interface (e.g., there may be gaps); however, a 'best effort' is made.
Who is involved
Search for Synchronous in People
However (Brandyn) and (amiller) are trying to organize things for the Synchronous interface.
Interface
#define RGB_BYTES 921600 // 480 * 640 * 3
int freenect_get_rgb(char **rgb, uint32_t *timestamp);
Synchronous rgb function, starts the runloop if it isn't running Args: rgb: Populated with a pointer to a RGB buffer (of size RGB_BYTES) that you need to free timestamp: Populated with a pointer to the associated timestamp Returns: Nonzero on error.
#define DEPTH_BYTES 614400 // 480 * 640 * 2
int freenect_get_depth(char **depth, uint32_t *timestamp);
Synchronous depth function, starts the runloop if it isn't running Args: depth: Populated with a pointer to a depth buffer (of size DEPTH_BYTES) that you need to free timestamp: Populated with a pointer to the associated timestamp Returns: Nonzero on error.
Performance
TODO