doxygen updates

ugfx_release_2.6
inmarket 2014-09-29 16:09:08 +10:00
parent 4cf198aad2
commit b7a89b2ada
10 changed files with 27 additions and 15 deletions

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gdisp/image_bmp.c * @file src/gdisp/gdisp_image_bmp.c
* @brief GDISP native image code. * @brief GDISP native image code.
* *
* @defgroup Image Image * @defgroup Image Image

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gdisp/image_gif.c * @file src/gdisp/gdisp_image_gif.c
* @brief GDISP native image code. * @brief GDISP native image code.
* *
* @defgroup Image Image * @defgroup Image Image

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gdisp/image_jpg.c * @file src/gdisp/gdisp_image_jpg.c
* @brief GDISP native image code. * @brief GDISP native image code.
*/ */
#include "gfx.h" #include "gfx.h"

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gdisp/image_native.c * @file src/gdisp/gdisp_image_native.c
* @brief GDISP native image code. * @brief GDISP native image code.
*/ */
#include "gfx.h" #include "gfx.h"

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gdisp/image_png.c * @file src/gdisp/gdisp_image_png.c
* @brief GDISP native image code. * @brief GDISP native image code.
*/ */
#include "gfx.h" #include "gfx.h"

View File

@ -250,6 +250,8 @@ unsigned gdispGetDisplayCount(void);
* *
* @param[in] g The display to use * @param[in] g The display to use
* *
* @return The width of the display
*
* @api * @api
*/ */
coord_t gdispGGetWidth(GDisplay *g); coord_t gdispGGetWidth(GDisplay *g);
@ -260,6 +262,8 @@ coord_t gdispGGetWidth(GDisplay *g);
* *
* @param[in] g The display to use * @param[in] g The display to use
* *
* @return The height of the display
*
* @api * @api
*/ */
coord_t gdispGGetHeight(GDisplay *g); coord_t gdispGGetHeight(GDisplay *g);
@ -270,6 +274,8 @@ coord_t gdispGGetHeight(GDisplay *g);
* *
* @param[in] g The display to use * @param[in] g The display to use
* *
* @return The current power mode
*
* @api * @api
*/ */
powermode_t gdispGGetPowerMode(GDisplay *g); powermode_t gdispGGetPowerMode(GDisplay *g);
@ -280,6 +286,8 @@ powermode_t gdispGGetPowerMode(GDisplay *g);
* *
* @param[in] g The display to use * @param[in] g The display to use
* *
* @return The current orientation
*
* @api * @api
*/ */
orientation_t gdispGGetOrientation(GDisplay *g); orientation_t gdispGGetOrientation(GDisplay *g);
@ -290,6 +298,8 @@ orientation_t gdispGGetOrientation(GDisplay *g);
* *
* @param[in] g The display to use * @param[in] g The display to use
* *
* @return The current backlight value
*
* @api * @api
*/ */
uint8_t gdispGGetBacklight(GDisplay *g); uint8_t gdispGGetBacklight(GDisplay *g);
@ -300,6 +310,8 @@ uint8_t gdispGGetBacklight(GDisplay *g);
* *
* @param[in] g The display to use * @param[in] g The display to use
* *
* @return The current contrast value
*
* @api * @api
*/ */
uint8_t gdispGGetContrast(GDisplay *g); uint8_t gdispGGetContrast(GDisplay *g);

View File

@ -103,21 +103,21 @@ extern "C" {
* @return Valid GFILE on success, 0 otherwise * @return Valid GFILE on success, 0 otherwise
* *
* @note The modes follow the c library fopen() standard. * @note The modes follow the c library fopen() standard.
* The valid modes are:<br/> * The valid modes are:
* <ul><li>r - Open for read, the file must exist</li> * <ul><li>r - Open for read, the file must exist</li>
* <li>w - Open for write, the file is truncated if it exists</li> * <li>w - Open for write, the file is truncated if it exists</li>
* <li>wx - Open for write, the file must not exist</li> * <li>wx - Open for write, the file must not exist</li>
* <li>a - Open for append, the file is truncated if it exists</li> * <li>a - Open for append, the file is truncated if it exists</li>
* <li>ax - Open for append, the file must not exists</li> * <li>ax - Open for append, the file must not exists</li>
* </ul><br/> * </ul>
* THe following flags can also be added to the above modes:<br/> * The following flags can also be added to the above modes:<br/>
* <ul><li>+ - Open for both read and write</li> * <ul><li>+ - Open for both read and write</li>
* <li>b - Open as a binary file rather than a text file</li> * <li>b - Open as a binary file rather than a text file</li>
* <ul> * </ul>
* @note Not all file-systems support all modes. For example, write * @note Not all file-systems support all modes. For example, write
* is not available with the ROM file-system. Similarly few platforms * is not available with the ROM file-system. Similarly few platforms
* distinguish between binary and text files. * distinguish between binary and text files.
* @note Even though binary vs text is relevant only for a small number of platforms * @note Even though binary vs. text is relevant only for a small number of platforms
* the "b" flag should always be specified for binary files such as images. * the "b" flag should always be specified for binary files such as images.
* This ensures portability to other platforms. The extra flag will be ignored * This ensures portability to other platforms. The extra flag will be ignored
* on platforms where it is not relevant. * on platforms where it is not relevant.
@ -346,8 +346,8 @@ extern "C" {
/** /**
* @brief Open file from a null terminated C string * @brief Open file from a null terminated C string
* *
* @param[in] memptr The pointer to the string or string buffer * @param[in] str The pointer to the string or string buffer
* @param[in] mode The mode. * @param[in] mode The mode
* *
* @return Valid GFILE on success, 0 otherwise * @return Valid GFILE on success, 0 otherwise
* *

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gos/freertos.h * @file src/gos/gfx_freertos.h
* @brief GOS - Operating System Support header file for FreeRTOS. * @brief GOS - Operating System Support header file for FreeRTOS.
*/ */

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gos/win32.c * @file src/gos/gfx_win32.c
* @brief GOS Win32 Operating System support. * @brief GOS Win32 Operating System support.
*/ */
#include "gfx.h" #include "gfx.h"

View File

@ -6,7 +6,7 @@
*/ */
/** /**
* @file src/gos/win32.h * @file src/gos/gfx_win32.h
* @brief GOS - Operating System Support header file for WIN32. * @brief GOS - Operating System Support header file for WIN32.
*/ */