More function docs

This commit is contained in:
Michael Jumper
2010-09-16 21:17:22 -07:00
parent 6dca902d56
commit 521f0c44b5

View File

@@ -160,10 +160,52 @@ struct guac_client {
};
typedef void guac_client_init_handler(guac_client* client, const char* hostname, int port);
/**
* Initialize and return a new guac_client using the specified client init handler (guac_client_init_handler).
* This will normally be the guac_client_init function as provided by any of the pluggable proxy clients.
*
* @param client_fd The file descriptor associated with the socket associated with the connection to the
* web-client tunnel.
* @param client_init Function pointer to the client init handler which will initialize the new guac_client
* when called. The given hostname and port will be passed to this handler.
* @param hostname The hostname of the host that the proxy client should connect to.
* @param port The port of the host that the proxy client should connect to.
* @return A pointer to the newly initialized client.
*/
guac_client* guac_get_client(int client_fd, guac_client_init_handler* client_init, const char* hostname, int port);
/**
* Enter the main network message handling loop for the given client.
*
* @param client The proxy client to start handling messages of/for.
*/
void guac_start_client(guac_client* client);
/**
* Free all resources associated with the given client.
*
* @param client The proxy client to free all reasources of.
*/
void guac_free_client(guac_client* client);
/**
* Allocate a libpng-compatible buffer to hold raw image data.
*
* @param w The width of the buffer to allocate, in pixels.
* @param h The height of the buffer to allocate, in pixels.
* @param bpp The number of bytes per pixel (3 for RGB images, 4 for RGBA).
* @return A pointer to the newly allocated buffer.
*/
png_byte** guac_alloc_png_buffer(int w, int h, int bpp);
/**
* Free all memory associated with the given libpng-compatible buffer
* as allocated by guac_alloc_png_buffer.
*
* @param png_buffer The buffer to free.
* @param h The height of the buffer to free.
*/
void guac_free_png_buffer(png_byte** png_buffer, int h);
#endif