[CHG] Documentation improvement

This commit is contained in:
Crayon2000 2009-02-25 19:37:42 +00:00
parent 46c91a7703
commit 82532896e5
2 changed files with 29 additions and 30 deletions

View file

@ -87,7 +87,7 @@ inline void GRRLIB_Rectangle(f32 x, f32 y, f32 width, f32 height, u32 color, u8
}
/**
*
* Draw a polygon.
* @param v
* @param color
* @param n
@ -97,7 +97,7 @@ void GRRLIB_NGone(Vector v[], u32 color, long n) {
}
/**
*
* Draw a filled polygon.
* @param v
* @param color
* @param n
@ -107,7 +107,7 @@ void GRRLIB_NGoneFilled(Vector v[], u32 color, long n) {
}
/**
*
* Initialize a tile set.
* @param tex
* @param tilew
* @param tileh
@ -245,8 +245,7 @@ GRRLIB_texImg GRRLIB_LoadTextureJPG(const unsigned char my_jpg[]) {
* Print formatted output.
* @param xpos
* @param ypos
* @param tex
* @param color
* @param bmf
* @param zoom
* @param text
* @param ... Optional arguments.
@ -520,12 +519,12 @@ inline void GRRLIB_DrawTile(f32 xpos, f32 ypos, GRRLIB_texImg tex, float degrees
/**
* Print formatted output.
* @param xpos
* @param ypos
* @param tex
* @param color
* @param zoom
* @param text
* @param xpos specifies the x-coordinate of the upper-left corner of the text.
* @param ypos specifies the y-coordinate of the upper-left corner of the text.
* @param tex texture containing the character set.
* @param color text color in RGBA format. The alpha channel is used to change the opacity of the text.
* @param zoom this is a factor by which the text size will be increase or decrease.
* @param text text to draw.
* @param ... Optional arguments.
*/
void GRRLIB_Printf(f32 xpos, f32 ypos, GRRLIB_texImg tex, u32 color, f32 zoom, const char *text, ...) {
@ -559,14 +558,14 @@ bool GRRLIB_PtInRect(int hotx, int hoty, int hotw, int hoth, int wpadx, int wpad
/**
* Determines whether a specified rectangle lies within another rectangle.
* @param rect1x
* @param rect1y
* @param rect1w
* @param rect1h
* @param rect2x
* @param rect2y
* @param rect2w
* @param rect2h
* @param rect1x specifies the x-coordinate of the upper-left corner of the rectangle.
* @param rect1y specifies the y-coordinate of the upper-left corner of the rectangle.
* @param rect1w specifies the width of the rectangle.
* @param rect1h specifies the height of the rectangle.
* @param rect2x specifies the x-coordinate of the upper-left corner of the rectangle.
* @param rect2y specifies the y-coordinate of the upper-left corner of the rectangle.
* @param rect2w specifies the width of the rectangle.
* @param rect2h specifies the height of the rectangle.
* @return If the specified rectangle lies within the other rectangle, the return value is true otherwise it's false.
*/
bool GRRLIB_RectInRect(int rect1x, int rect1y, int rect1w, int rect1h, int rect2x, int rect2y, int rect2w, int rect2h) {
@ -576,14 +575,14 @@ bool GRRLIB_RectInRect(int rect1x, int rect1y, int rect1w, int rect1h, int rect2
/**
* Determines whether a part of a specified rectangle lies on another rectangle.
* @param rect1x
* @param rect1y
* @param rect1w
* @param rect1h
* @param rect2x
* @param rect2y
* @param rect2w
* @param rect2h
* @param rect1x specifies the x-coordinate of the upper-left corner of the first rectangle.
* @param rect1y specifies the y-coordinate of the upper-left corner of the first rectangle.
* @param rect1w specifies the width of the first rectangle.
* @param rect1h specifies the height of the first rectangle.
* @param rect2x specifies the x-coordinate of the upper-left corner of the second rectangle.
* @param rect2y specifies the y-coordinate of the upper-left corner of the second rectangle.
* @param rect2w specifies the width of the second rectangle.
* @param rect2h specifies the height of the second rectangle.
* @return If the specified rectangle lies on the other rectangle, the return value is true otherwise it's false.
*/
bool GRRLIB_RectOnRect(int rect1x, int rect1y, int rect1w, int rect1h, int rect2x, int rect2y, int rect2w, int rect2h) {

View file

@ -40,8 +40,8 @@ typedef struct GRRLIB_bytemapChar{
u8 character; /**< Which character. */
u8 width; /**< Character width. */
u8 height; /**< Character height. */
s8 relx; /**< Horizontal offset according to cursor (-128..127). */
s8 rely; /**< Vertical offset according to cursor (-128..127). */
s8 relx; /**< Horizontal offset according to cursor (-128 to 127). */
s8 rely; /**< Vertical offset according to cursor (-128 to 127). */
u8 shift; /**< Horizontal cursor shift after drawing the character. */
u8 *data; /**< Character data itself (uncompressed, 8 bits per pixel). */
} GRRLIB_bytemapChar;
@ -51,7 +51,7 @@ typedef struct GRRLIB_bytemapChar{
*/
typedef struct GRRLIB_bytemapFont{
u8 version; /**< Version. */
s8 addSpace; /**< Add-space after each char (-128..127). */
s8 addSpace; /**< Add-space after each char (-128 to 127). */
u32 *palette; /**< Font palette. */
char *name; /**< Font name. */
u16 nbChar; /**< Number of characters in font. */