Release 4.18 drivers/gpu/drm/amd/display/include/fixed31_32.h

/*
 * Copyright 2012-15 Advanced Micro Devices, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 *
 * Authors: AMD
 *
 */

#ifndef __DAL_FIXED31_32_H__

#define __DAL_FIXED31_32_H__


#define FIXED31_32_BITS_PER_FRACTIONAL_PART 32
#ifndef LLONG_MIN

#define LLONG_MIN (1LL<<63)
#endif
#ifndef LLONG_MAX

#define LLONG_MAX (-1LL>>1)
#endif

/*
 * @brief
 * Arithmetic operations on real numbers
 * represented as fixed-point numbers.
 * There are: 1 bit for sign,
 * 31 bit for integer part,
 * 32 bits for fractional part.
 *
 * @note
 * Currently, overflows and underflows are asserted;
 * no special result returned.
 */


struct fixed31_32 {
	
long long value;
};


/*
 * @brief
 * Useful constants
 */


static const struct fixed31_32 dc_fixpt_zero = { 0 };

static const struct fixed31_32 dc_fixpt_epsilon = { 1LL };

static const struct fixed31_32 dc_fixpt_half = { 0x80000000LL };

static const struct fixed31_32 dc_fixpt_one = { 0x100000000LL };


static const struct fixed31_32 dc_fixpt_pi = { 13493037705LL };

static const struct fixed31_32 dc_fixpt_two_pi = { 26986075409LL };

static const struct fixed31_32 dc_fixpt_e = { 11674931555LL };

static const struct fixed31_32 dc_fixpt_ln2 = { 2977044471LL };

static const struct fixed31_32 dc_fixpt_ln2_div_2 = { 1488522236LL };

/*
 * @brief
 * Initialization routines
 */

/*
 * @brief
 * result = numerator / denominator
 */
struct fixed31_32 dc_fixpt_from_fraction(long long numerator, long long denominator);

/*
 * @brief
 * result = arg
 */


static inline struct fixed31_32 dc_fixpt_from_int(int arg)
{
	struct fixed31_32 res;

	res.value = (long long) arg << FIXED31_32_BITS_PER_FRACTIONAL_PART;

	return res;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
24
80.00%
1
33.33%
Dmytro Laktyushkin
6
20.00%
2
66.67%
Total
30
100.00%
3
100.00%

/*
 * @brief
 * Unary operators
 */

/*
 * @brief
 * result = -arg
 */


static inline struct fixed31_32 dc_fixpt_neg(struct fixed31_32 arg)
{
	struct fixed31_32 res;

	res.value = -arg.value;

	return res;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
20
71.43%
1
33.33%
Harry Wentland
7
25.00%
1
33.33%
Dmytro Laktyushkin
1
3.57%
1
33.33%
Total
28
100.00%
3
100.00%

/*
 * @brief
 * result = abs(arg) := (arg >= 0) ? arg : -arg
 */


static inline struct fixed31_32 dc_fixpt_abs(struct fixed31_32 arg)
{
	if (arg.value < 0)
		return dc_fixpt_neg(arg);
	else
		return arg;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
21
70.00%
1
33.33%
Harry Wentland
7
23.33%
1
33.33%
Dmytro Laktyushkin
2
6.67%
1
33.33%
Total
30
100.00%
3
100.00%

/*
 * @brief
 * Binary relational operators
 */

/*
 * @brief
 * result = arg1 < arg2
 */


static inline bool dc_fixpt_lt(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	return arg1.value < arg2.value;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
13
54.17%
1
33.33%
Harry Wentland
10
41.67%
1
33.33%
Dmytro Laktyushkin
1
4.17%
1
33.33%
Total
24
100.00%
3
100.00%

/*
 * @brief
 * result = arg1 <= arg2
 */


static inline bool dc_fixpt_le(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	return arg1.value <= arg2.value;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
13
54.17%
1
33.33%
Harry Wentland
10
41.67%
1
33.33%
Dmytro Laktyushkin
1
4.17%
1
33.33%
Total
24
100.00%
3
100.00%

/*
 * @brief
 * result = arg1 == arg2
 */


static inline bool dc_fixpt_eq(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	return arg1.value == arg2.value;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
13
54.17%
1
33.33%
Harry Wentland
10
41.67%
1
33.33%
Dmytro Laktyushkin
1
4.17%
1
33.33%
Total
24
100.00%
3
100.00%

/*
 * @brief
 * result = min(arg1, arg2) := (arg1 <= arg2) ? arg1 : arg2
 */


static inline struct fixed31_32 dc_fixpt_min(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	if (arg1.value <= arg2.value)
		return arg1;
	else
		return arg2;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
21
63.64%
1
33.33%
Harry Wentland
11
33.33%
1
33.33%
Dmytro Laktyushkin
1
3.03%
1
33.33%
Total
33
100.00%
3
100.00%

/*
 * @brief
 * result = max(arg1, arg2) := (arg1 <= arg2) ? arg2 : arg1
 */


static inline struct fixed31_32 dc_fixpt_max(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	if (arg1.value <= arg2.value)
		return arg2;
	else
		return arg1;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
21
63.64%
1
33.33%
Harry Wentland
11
33.33%
1
33.33%
Dmytro Laktyushkin
1
3.03%
1
33.33%
Total
33
100.00%
3
100.00%

/*
 * @brief
 *          | min_value, when arg <= min_value
 * result = | arg, when min_value < arg < max_value
 *          | max_value, when arg >= max_value
 */


static inline struct fixed31_32 dc_fixpt_clamp(
	struct fixed31_32 arg,
	struct fixed31_32 min_value,
	struct fixed31_32 max_value)
{
	if (dc_fixpt_le(arg, min_value))
		return min_value;
	else if (dc_fixpt_le(max_value, arg))
		return max_value;
	else
		return arg;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
31
63.27%
1
33.33%
Harry Wentland
15
30.61%
1
33.33%
Dmytro Laktyushkin
3
6.12%
1
33.33%
Total
49
100.00%
3
100.00%

/*
 * @brief
 * Binary shift operators
 */

/*
 * @brief
 * result = arg << shift
 */


static inline struct fixed31_32 dc_fixpt_shl(struct fixed31_32 arg, unsigned char shift)
{
	ASSERT(((arg.value >= 0) && (arg.value <= LLONG_MAX >> shift)) ||
		((arg.value < 0) && (arg.value >= ~(LLONG_MAX >> shift))));

	arg.value = arg.value << shift;

	return arg;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
61
81.33%
3
50.00%
Harry Wentland
9
12.00%
1
16.67%
David Francis
3
4.00%
1
16.67%
Anthony Koo
2
2.67%
1
16.67%
Total
75
100.00%
6
100.00%

/*
 * @brief
 * result = arg >> shift
 */


static inline struct fixed31_32 dc_fixpt_shr(struct fixed31_32 arg, unsigned char shift)
{
	bool negative = arg.value < 0;

	if (negative)
		arg.value = -arg.value;
	arg.value = arg.value >> shift;
	if (negative)
		arg.value = -arg.value;
	return arg;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
37
57.81%
2
40.00%
Dave Airlie
16
25.00%
1
20.00%
Harry Wentland
9
14.06%
1
20.00%
Anthony Koo
2
3.12%
1
20.00%
Total
64
100.00%
5
100.00%

/*
 * @brief
 * Binary additive operators
 */

/*
 * @brief
 * result = arg1 + arg2
 */


static inline struct fixed31_32 dc_fixpt_add(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	struct fixed31_32 res;

	ASSERT(((arg1.value >= 0) && (LLONG_MAX - arg1.value >= arg2.value)) ||
		((arg1.value < 0) && (LLONG_MIN - arg1.value <= arg2.value)));

	res.value = arg1.value + arg2.value;

	return res;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
71
86.59%
2
66.67%
Harry Wentland
11
13.41%
1
33.33%
Total
82
100.00%
3
100.00%

/*
 * @brief
 * result = arg1 + arg2
 */


static inline struct fixed31_32 dc_fixpt_add_int(struct fixed31_32 arg1, int arg2)
{
	return dc_fixpt_add(arg1, dc_fixpt_from_int(arg2));
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
13
50.00%
1
25.00%
Amy Zhang
9
34.62%
1
25.00%
Dmytro Laktyushkin
3
11.54%
1
25.00%
Anthony Koo
1
3.85%
1
25.00%
Total
26
100.00%
4
100.00%

/*
 * @brief
 * result = arg1 - arg2
 */


static inline struct fixed31_32 dc_fixpt_sub(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	struct fixed31_32 res;

	ASSERT(((arg2.value >= 0) && (LLONG_MIN + arg2.value <= arg1.value)) ||
		((arg2.value < 0) && (LLONG_MAX + arg2.value >= arg1.value)));

	res.value = arg1.value - arg2.value;

	return res;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
71
86.59%
2
50.00%
Harry Wentland
9
10.98%
1
25.00%
Dave Airlie
2
2.44%
1
25.00%
Total
82
100.00%
4
100.00%

/*
 * @brief
 * result = arg1 - arg2
 */


static inline struct fixed31_32 dc_fixpt_sub_int(struct fixed31_32 arg1, int arg2)
{
	return dc_fixpt_sub(arg1, dc_fixpt_from_int(arg2));
}


Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
13
50.00%
1
25.00%
Harry Wentland
9
34.62%
1
25.00%
Dmytro Laktyushkin
3
11.54%
1
25.00%
Anthony Koo
1
3.85%
1
25.00%
Total
26
100.00%
4
100.00%

/*
 * @brief
 * Binary multiplicative operators
 */

/*
 * @brief
 * result = arg1 * arg2
 */
struct fixed31_32 dc_fixpt_mul(struct fixed31_32 arg1, struct fixed31_32 arg2);


/*
 * @brief
 * result = arg1 * arg2
 */


static inline struct fixed31_32 dc_fixpt_mul_int(struct fixed31_32 arg1, int arg2)
{
	return dc_fixpt_mul(arg1, dc_fixpt_from_int(arg2));
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
13
50.00%
1
25.00%
Harry Wentland
9
34.62%
1
25.00%
Dmytro Laktyushkin
3
11.54%
1
25.00%
Anthony Koo
1
3.85%
1
25.00%
Total
26
100.00%
4
100.00%

/*
 * @brief
 * result = square(arg) := arg * arg
 */
struct fixed31_32 dc_fixpt_sqr(struct fixed31_32 arg);

/*
 * @brief
 * result = arg1 / arg2
 */


static inline struct fixed31_32 dc_fixpt_div_int(struct fixed31_32 arg1, long long arg2)
{
	return dc_fixpt_from_fraction(arg1.value, dc_fixpt_from_int(arg2).value);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
17
54.84%
1
25.00%
Harry Wentland
9
29.03%
1
25.00%
Dmytro Laktyushkin
3
9.68%
1
25.00%
Anthony Koo
2
6.45%
1
25.00%
Total
31
100.00%
4
100.00%

/*
 * @brief
 * result = arg1 / arg2
 */


static inline struct fixed31_32 dc_fixpt_div(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	return dc_fixpt_from_fraction(arg1.value, arg2.value);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dave Airlie
15
53.57%
1
33.33%
Harry Wentland
11
39.29%
1
33.33%
Dmytro Laktyushkin
2
7.14%
1
33.33%
Total
28
100.00%
3
100.00%

/*
 * @brief
 * Reciprocal function
 */

/*
 * @brief
 * result = reciprocal(arg) := 1 / arg
 *
 * @note
 * No special actions taken in case argument is zero.
 */
struct fixed31_32 dc_fixpt_recip(struct fixed31_32 arg);

/*
 * @brief
 * Trigonometric functions
 */

/*
 * @brief
 * result = sinc(arg) := sin(arg) / arg
 *
 * @note
 * Argument specified in radians,
 * internally it's normalized to [-2pi...2pi] range.
 */
struct fixed31_32 dc_fixpt_sinc(struct fixed31_32 arg);

/*
 * @brief
 * result = sin(arg)
 *
 * @note
 * Argument specified in radians,
 * internally it's normalized to [-2pi...2pi] range.
 */
struct fixed31_32 dc_fixpt_sin(struct fixed31_32 arg);

/*
 * @brief
 * result = cos(arg)
 *
 * @note
 * Argument specified in radians
 * and should be in [-2pi...2pi] range -
 * passing arguments outside that range
 * will cause incorrect result!
 */
struct fixed31_32 dc_fixpt_cos(struct fixed31_32 arg);

/*
 * @brief
 * Transcendent functions
 */

/*
 * @brief
 * result = exp(arg)
 *
 * @note
 * Currently, function is verified for abs(arg) <= 1.
 */
struct fixed31_32 dc_fixpt_exp(struct fixed31_32 arg);

/*
 * @brief
 * result = log(arg)
 *
 * @note
 * Currently, abs(arg) should be less than 1.
 * No normalization is done.
 * Currently, no special actions taken
 * in case of invalid argument(s). Take care!
 */
struct fixed31_32 dc_fixpt_log(struct fixed31_32 arg);

/*
 * @brief
 * Power function
 */

/*
 * @brief
 * result = pow(arg1, arg2)
 *
 * @note
 * Currently, abs(arg1) should be less than 1. Take care!
 */


static inline struct fixed31_32 dc_fixpt_pow(struct fixed31_32 arg1, struct fixed31_32 arg2)
{
	return dc_fixpt_exp(
		dc_fixpt_mul(
			dc_fixpt_log(arg1),
			arg2));
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
19
63.33%
2
66.67%
Harry Wentland
11
36.67%
1
33.33%
Total
30
100.00%
3
100.00%

/*
 * @brief
 * Rounding functions
 */

/*
 * @brief
 * result = floor(arg) := greatest integer lower than or equal to arg
 */


static inline int dc_fixpt_floor(struct fixed31_32 arg)
{
	unsigned long long arg_value = arg.value > 0 ? arg.value : -arg.value;

	if (arg.value >= 0)
		return (int)(arg_value >> FIXED31_32_BITS_PER_FRACTIONAL_PART);
	else
		return -(int)(arg_value >> FIXED31_32_BITS_PER_FRACTIONAL_PART);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
55
90.16%
2
50.00%
Harry Wentland
5
8.20%
1
25.00%
Anthony Koo
1
1.64%
1
25.00%
Total
61
100.00%
4
100.00%

/*
 * @brief
 * result = round(arg) := integer nearest to arg
 */


static inline int dc_fixpt_round(struct fixed31_32 arg)
{
	unsigned long long arg_value = arg.value > 0 ? arg.value : -arg.value;

	const long long summand = dc_fixpt_half.value;

	ASSERT(LLONG_MAX - (long long)arg_value >= summand);

	arg_value += summand;

	if (arg.value >= 0)
		return (int)(arg_value >> FIXED31_32_BITS_PER_FRACTIONAL_PART);
	else
		return -(int)(arg_value >> FIXED31_32_BITS_PER_FRACTIONAL_PART);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
81
93.10%
2
50.00%
Harry Wentland
5
5.75%
1
25.00%
Anthony Koo
1
1.15%
1
25.00%
Total
87
100.00%
4
100.00%

/*
 * @brief
 * result = ceil(arg) := lowest integer greater than or equal to arg
 */


static inline int dc_fixpt_ceil(struct fixed31_32 arg)
{
	unsigned long long arg_value = arg.value > 0 ? arg.value : -arg.value;

	const long long summand = dc_fixpt_one.value -
		dc_fixpt_epsilon.value;

	ASSERT(LLONG_MAX - (long long)arg_value >= summand);

	arg_value += summand;

	if (arg.value >= 0)
		return (int)(arg_value >> FIXED31_32_BITS_PER_FRACTIONAL_PART);
	else
		return -(int)(arg_value >> FIXED31_32_BITS_PER_FRACTIONAL_PART);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
85
93.41%
2
50.00%
Harry Wentland
5
5.49%
1
25.00%
Anthony Koo
1
1.10%
1
25.00%
Total
91
100.00%
4
100.00%

/* the following two function are used in scaler hw programming to convert fixed
 * point value to format 2 bits from integer part and 19 bits from fractional
 * part. The same applies for u0d19, 0 bits from integer part and 19 bits from
 * fractional
 */

unsigned int dc_fixpt_u3d19(struct fixed31_32 arg);

unsigned int dc_fixpt_u2d19(struct fixed31_32 arg);

unsigned int dc_fixpt_u0d19(struct fixed31_32 arg);

unsigned int dc_fixpt_clamp_u0d14(struct fixed31_32 arg);

unsigned int dc_fixpt_clamp_u0d10(struct fixed31_32 arg);

int dc_fixpt_s4d19(struct fixed31_32 arg);



static inline struct fixed31_32 dc_fixpt_truncate(struct fixed31_32 arg, unsigned int frac_bits)
{
	bool negative = arg.value < 0;

	if (frac_bits >= FIXED31_32_BITS_PER_FRACTIONAL_PART) {
		ASSERT(frac_bits == FIXED31_32_BITS_PER_FRACTIONAL_PART);
		return arg;
	}

	if (negative)
		arg.value = -arg.value;
	arg.value &= (~0LL) << (FIXED31_32_BITS_PER_FRACTIONAL_PART - frac_bits);
	if (negative)
		arg.value = -arg.value;
	return arg;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
87
100.00%
1
100.00%
Total
87
100.00%
1
100.00%

#endif
Overall Contributors
Person
Tokens
Prop
Commits
CommitProp
Dmytro Laktyushkin
648
46.69%
5
35.71%
Harry Wentland
410
29.54%
1
7.14%
Dave Airlie
272
19.60%
3
21.43%
Anthony Koo
27
1.95%
1
7.14%
Vitaly Prosyak
12
0.86%
1
7.14%
Amy Zhang
10
0.72%
1
7.14%
Ken Chalmers
6
0.43%
1
7.14%
David Francis
3
0.22%
1
7.14%
Total
1388
100.00%
14
100.00%
Directory: drivers/gpu/drm/amd/display/include

Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.