# HG changeset patch # User diego # Date 1217886890 0 # Node ID db7f6a006d4f778c46b2a87310d24eea9d5c4b04 # Parent 945d88d23efe422baa57a369b29da566b63339a2 misc spelling/wording fixes diff -r 945d88d23efe -r db7f6a006d4f random.c --- a/random.c Thu Jul 31 02:38:40 2008 +0000 +++ b/random.c Mon Aug 04 21:54:50 2008 +0000 @@ -41,7 +41,7 @@ int index; /* - This differs from the wikipedia article. Source is from the Makoto + This differs from the wikipedia article. Source is from the Makoto Matsumoto and Takuji Nishimura code, with the following comment: */ /* See Knuth TAOCP Vol2. 3rd Ed. P.106 for multiplier. */ diff -r 945d88d23efe -r db7f6a006d4f random.h --- a/random.h Thu Jul 31 02:38:40 2008 +0000 +++ b/random.h Mon Aug 04 21:54:50 2008 +0000 @@ -28,17 +28,17 @@ typedef struct { unsigned int mt[AV_RANDOM_N]; ///< the array for the state vector - int index; ///< current untempered value we use as the base. + int index; ///< Current untempered value we use as the base. } AVRandomState; -void av_init_random(unsigned int seed, AVRandomState *state); ///< to be inlined, the struct must be visible, so it doesn't make sense to try and keep it opaque with malloc/free like calls -void av_random_generate_untempered_numbers(AVRandomState *state); ///< Regenerate the untempered numbers (must be done every 624 iterations, or it will loop) +void av_init_random(unsigned int seed, AVRandomState *state); ///< To be inlined, the struct must be visible. So it does not make sense to try and keep it opaque with malloc/free-like calls. +void av_random_generate_untempered_numbers(AVRandomState *state); ///< Regenerate the untempered numbers (must be done every 624 iterations, or it will loop). /** - * generates a random number on [0,0xffffffff]-interval + * Generates a random number from the interval [0,0xffffffff]. * - * Please do NOT use the mersenne twister, it is slow, use the random generator + * Please do NOT use the Mersenne Twister, it is slow. Use the random generator * from lfg.c/h or a simple LCG like state= state*1664525+1013904223. * If you still choose to use MT, expect that you will have to provide * some evidence that it makes a difference for the case where you use it. @@ -47,14 +47,14 @@ { unsigned int y; - // regenerate the untempered numbers if we should... + // Regenerate the untempered numbers if we should... if (state->index >= AV_RANDOM_N) av_random_generate_untempered_numbers(state); - // grab one... + // Grab one... y = state->mt[state->index++]; - /* Now temper (Mersenne Twister coefficients) The coefficients for MT19937 are.. */ + /* Now temper (Mersenne Twister coefficients). The coefficients for MT19937 are.. */ y ^= (y >> 11); y ^= (y << 7) & 0x9d2c5680; y ^= (y << 15) & 0xefc60000; @@ -63,7 +63,7 @@ return y; } -/** return random in range [0-1] as double */ +/** Return random in range [0-1] as double. */ static inline double av_random_real1(AVRandomState *state) { /* divided by 2^32-1 */