summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBrian Paul <brian.paul@tungstengraphics.com>2006-04-05 03:29:46 +0000
committerBrian Paul <brian.paul@tungstengraphics.com>2006-04-05 03:29:46 +0000
commitc87809c9ed3579cdbd145479a3e55e4058489bf7 (patch)
tree6048bd406d764881977f23e0002167d4ebdbf665
parent1979b6b2def208143a1357e0eef9baece5ea9d3b (diff)
just some comments/docs
-rw-r--r--src/mesa/math/m_translate.h22
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,