diff options
| author | Brian Paul <brian.paul@tungstengraphics.com> | 2006-04-05 03:29:46 +0000 |
|---|---|---|
| committer | Brian Paul <brian.paul@tungstengraphics.com> | 2006-04-05 03:29:46 +0000 |
| commit | c87809c9ed3579cdbd145479a3e55e4058489bf7 (patch) | |
| tree | 6048bd406d764881977f23e0002167d4ebdbf665 /src/mesa/math | |
| parent | 1979b6b2def208143a1357e0eef9baece5ea9d3b (diff) | |
just some comments/docs
Diffstat (limited to 'src/mesa/math')
| -rw-r--r-- | src/mesa/math/m_translate.h | 22 |
1 files changed, 19 insertions, 3 deletions
diff --git a/src/mesa/math/m_translate.h b/src/mesa/math/m_translate.h index 527c7063d6..d76eac6939 100644 --- a/src/mesa/math/m_translate.h +++ b/src/mesa/math/m_translate.h @@ -1,9 +1,8 @@ - /* * Mesa 3-D graphics library - * Version: 3.5 + * Version: 6.5.1 * - * Copyright (C) 1999-2001 Brian Paul All Rights Reserved. + * Copyright (C) 1999-2006 Brian Paul All Rights Reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), @@ -31,6 +30,21 @@ #include "mtypes.h" /* hack for GLchan */ +/** + * Array translation. + * For example, convert array of GLushort[3] to GLfloat[4]. + * The function name specifies the destination format/size. + * \param to the destination address + * \param ptr the source address + * \param stride the source stride (in bytes) between elements + * \param type the source datatype (GL_SHORT, GL_UNSIGNED_INT, etc) + * \param size number of values per element in source array (1,2,3 or 4) + * \param start first element in source array to convert + * \param n number of elements to convert + * + * Note: "element" means a tuple like GLfloat[3] or GLubyte[4]. + */ + extern void _math_trans_1f(GLfloat *to, CONST void *ptr, @@ -77,6 +91,7 @@ extern void _math_trans_4us(GLushort (*to)[4], GLuint start, GLuint n ); +/** Convert to floats w/out normalization (i.e. just cast) */ extern void _math_trans_4f(GLfloat (*to)[4], CONST void *ptr, GLuint stride, @@ -85,6 +100,7 @@ extern void _math_trans_4f(GLfloat (*to)[4], GLuint start, GLuint n ); +/** Convert to normalized floats in [0,1] or [-1, 1] */ extern void _math_trans_4fc(GLfloat (*to)[4], CONST void *ptr, GLuint stride, |