A fixed point number, implemented by a 32-bit signed integer. More...

#include <FixedPoint.hh>

Inheritance diagram for openmsx::FixedPoint< FRACTION_BITS_ >:

[legend]

Public Member Functions
constexpr	FixedPoint ()=default
	Creates a zero-initialized fixed point object. More...

constexpr	FixedPoint (int i)

constexpr	FixedPoint (unsigned i)

	FixedPoint (float f)

	FixedPoint (double d)

template<unsigned BITS2>
constexpr	FixedPoint (FixedPoint< BITS2 > other)

constexpr int	toInt () const
	Returns the integer part (rounded down) of this fixed point number. More...

constexpr float	toFloat () const
	Returns the float value that corresponds to this fixed point number. More...

constexpr double	toDouble () const
	Returns the double value that corresponds to this fixed point number. More...

constexpr float	fractionAsFloat () const
	Returns the fractional part of this fixed point number as a float. More...

constexpr double	fractionAsDouble () const
	Returns the fractional part of this fixed point number as a double. More...

constexpr int	divAsInt (FixedPoint other) const
	Returns the result of a division between this fixed point number and another, rounded towards zero. More...

constexpr FixedPoint	floor () const
	Returns this value rounded down. More...

constexpr FixedPoint	fract () const
	Returns the fractional part of this value. More...

constexpr unsigned	fractAsInt () const
	Returns the fractional part of this value as an integer. More...

void	operator+= (FixedPoint other)

void	operator-= (FixedPoint other)

void	addQuantum ()
	Increase this value with the smallest possible amount. More...

constexpr int	getRawValue () const

template<typename Archive >
void	serialize (Archive &ar, unsigned)

Static Public Member Functions
static constexpr FixedPoint	create (int value)
	Create new fixed point object from given representation. More...

static constexpr FixedPoint	roundRatioDown (unsigned n, unsigned d)

static constexpr int	shiftHelper (int x, int s)

Static Public Attributes
static constexpr unsigned	FRACTION_BITS = FRACTION_BITS_
	Number of fractional bits (export template parameter as a constant so that external code can use it more easily). More...

Friends
constexpr friend FixedPoint	operator+ (FixedPoint x, FixedPoint y)

constexpr friend FixedPoint	operator- (FixedPoint x, FixedPoint y)

constexpr friend FixedPoint	operator* (FixedPoint x, FixedPoint y)

constexpr friend FixedPoint	operator* (FixedPoint x, int y)

constexpr friend FixedPoint	operator* (int x, FixedPoint y)

constexpr friend FixedPoint	operator/ (FixedPoint x, FixedPoint y)
	Divides two fixed point numbers. More...

constexpr friend FixedPoint	operator/ (FixedPoint x, int y)

constexpr friend FixedPoint	operator<< (FixedPoint x, int y)

constexpr friend FixedPoint	operator>> (FixedPoint x, int y)

constexpr friend bool	operator== (FixedPoint x, FixedPoint y)

constexpr friend bool	operator!= (FixedPoint x, FixedPoint y)

constexpr friend bool	operator< (FixedPoint x, FixedPoint y)

constexpr friend bool	operator<= (FixedPoint x, FixedPoint y)

constexpr friend bool	operator> (FixedPoint x, FixedPoint y)

constexpr friend bool	operator>= (FixedPoint x, FixedPoint y)

Detailed Description

template<unsigned FRACTION_BITS_>
class openmsx::FixedPoint< FRACTION_BITS_ >

A fixed point number, implemented by a 32-bit signed integer.

The FRACTION_BITS template argument selects the position of the "binary point" (base 2 equivalent to decimal point).

Definition at line 15 of file FixedPoint.hh.

Constructor & Destructor Documentation

◆ FixedPoint() [1/6]

template<unsigned FRACTION_BITS_>

constexpr openmsx::FixedPoint< FRACTION_BITS_ >::FixedPoint ( )

default

Creates a zero-initialized fixed point object.

Referenced by openmsx::FixedPoint< EG_DP_BITS - EG_BITS >::create(), and openmsx::FixedPoint< EG_DP_BITS - EG_BITS >::serialize().

◆ FixedPoint() [2/6]

template<unsigned FRACTION_BITS_>

constexpr openmsx::FixedPoint< FRACTION_BITS_ >::FixedPoint ( int i )

inlineexplicit

Definition at line 54 of file FixedPoint.hh.

◆ FixedPoint() [3/6]

template<unsigned FRACTION_BITS_>

constexpr openmsx::FixedPoint< FRACTION_BITS_ >::FixedPoint ( unsigned i )

inlineexplicit

Definition at line 55 of file FixedPoint.hh.

◆ FixedPoint() [4/6]

template<unsigned FRACTION_BITS_>

openmsx::FixedPoint< FRACTION_BITS_ >::FixedPoint ( float f )

inlineexplicit

Definition at line 56 of file FixedPoint.hh.

◆ FixedPoint() [5/6]

template<unsigned FRACTION_BITS_>

openmsx::FixedPoint< FRACTION_BITS_ >::FixedPoint ( double d )

inlineexplicit

Definition at line 57 of file FixedPoint.hh.

◆ FixedPoint() [6/6]

template<unsigned FRACTION_BITS_>

template<unsigned BITS2>

constexpr openmsx::FixedPoint< FRACTION_BITS_ >::FixedPoint ( FixedPoint< BITS2 > other )

inlineexplicit

Definition at line 67 of file FixedPoint.hh.

Member Function Documentation

◆ addQuantum()

template<unsigned FRACTION_BITS_>

void openmsx::FixedPoint< FRACTION_BITS_ >::addQuantum ( )

inline

Increase this value with the smallest possible amount.

Typically used to implement counters at the resolution of this datatype.

Definition at line 217 of file FixedPoint.hh.

Referenced by openmsx::YMF262::setMixLevel(), and openmsx::YM2413Burczynski::YM2413::YM2413().

◆ create()

template<unsigned FRACTION_BITS_>

static constexpr FixedPoint openmsx::FixedPoint< FRACTION_BITS_ >::create ( int value )

inlinestatic

Create new fixed point object from given representation.

Used by the overloaded operators.

Parameters

value the internal representation.

Definition at line 44 of file FixedPoint.hh.

Referenced by openmsx::FixedPoint< EG_DP_BITS - EG_BITS >::floor(), openmsx::FixedPoint< EG_DP_BITS - EG_BITS >::fract(), and openmsx::FixedPoint< EG_DP_BITS - EG_BITS >::roundRatioDown().

◆ divAsInt()

template<unsigned FRACTION_BITS_>

constexpr int openmsx::FixedPoint< FRACTION_BITS_ >::divAsInt ( FixedPoint< FRACTION_BITS_ > other ) const

inline

Returns the result of a division between this fixed point number and another, rounded towards zero.

Definition at line 120 of file FixedPoint.hh.

◆ floor()

template<unsigned FRACTION_BITS_>

constexpr FixedPoint openmsx::FixedPoint< FRACTION_BITS_ >::floor ( ) const

inline

Returns this value rounded down.

The result is equal to FixedPoint(fp.toInt()).

Definition at line 128 of file FixedPoint.hh.

◆ fract()

template<unsigned FRACTION_BITS_>

constexpr FixedPoint openmsx::FixedPoint< FRACTION_BITS_ >::fract ( ) const

inline

Returns the fractional part of this value.

The result is equal to fp - floor(fp).

Definition at line 136 of file FixedPoint.hh.

◆ fractAsInt()

template<unsigned FRACTION_BITS_>

constexpr unsigned openmsx::FixedPoint< FRACTION_BITS_ >::fractAsInt ( ) const

inline

Returns the fractional part of this value as an integer.

The result is equal to (fract() * (1 << FRACTION_BITS)).toInt()

Definition at line 144 of file FixedPoint.hh.

Referenced by openmsx::BlipBuffer::addDelta().

◆ fractionAsDouble()

template<unsigned FRACTION_BITS_>

constexpr double openmsx::FixedPoint< FRACTION_BITS_ >::fractionAsDouble ( ) const

inline

Returns the fractional part of this fixed point number as a double.

The fractional part is never negative, even for negative fixed point numbers. x.toInt() + x.fractionAsDouble() is approximately equal to x.toDouble()

Definition at line 110 of file FixedPoint.hh.

◆ fractionAsFloat()

template<unsigned FRACTION_BITS_>

constexpr float openmsx::FixedPoint< FRACTION_BITS_ >::fractionAsFloat ( ) const

inline

Returns the fractional part of this fixed point number as a float.

The fractional part is never negative, even for negative fixed point numbers. x.toInt() + x.fractionAsFloat() is approximately equal to x.toFloat()

Definition at line 100 of file FixedPoint.hh.

◆ getRawValue()

template<unsigned FRACTION_BITS_>

constexpr int openmsx::FixedPoint< FRACTION_BITS_ >::getRawValue ( ) const

inline

Definition at line 223 of file FixedPoint.hh.

◆ operator+=()

template<unsigned FRACTION_BITS_>

void openmsx::FixedPoint< FRACTION_BITS_ >::operator+= ( FixedPoint< FRACTION_BITS_ > other )

inline

Definition at line 207 of file FixedPoint.hh.

◆ operator-=()

template<unsigned FRACTION_BITS_>

void openmsx::FixedPoint< FRACTION_BITS_ >::operator-= ( FixedPoint< FRACTION_BITS_ > other )

inline

Definition at line 210 of file FixedPoint.hh.

◆ roundRatioDown()

template<unsigned FRACTION_BITS_>

static constexpr FixedPoint openmsx::FixedPoint< FRACTION_BITS_ >::roundRatioDown	(	unsigned	n,
		unsigned	d
	)

inlinestatic

Definition at line 59 of file FixedPoint.hh.

◆ serialize()

template<unsigned FRACTION_BITS_>

template<typename Archive >

void openmsx::FixedPoint< FRACTION_BITS_ >::serialize	(	Archive &	ar,
		unsigned
	)

inline

Definition at line 228 of file FixedPoint.hh.

◆ shiftHelper()

template<unsigned FRACTION_BITS_>

static constexpr int openmsx::FixedPoint< FRACTION_BITS_ >::shiftHelper	(	int	x,
		int	s
	)

inlinestatic

Definition at line 63 of file FixedPoint.hh.

◆ toDouble()

template<unsigned FRACTION_BITS_>

constexpr double openmsx::FixedPoint< FRACTION_BITS_ >::toDouble ( ) const

inline

Returns the double value that corresponds to this fixed point number.

Definition at line 90 of file FixedPoint.hh.

◆ toFloat()

template<unsigned FRACTION_BITS_>

constexpr float openmsx::FixedPoint< FRACTION_BITS_ >::toFloat ( ) const

inline

Returns the float value that corresponds to this fixed point number.

Definition at line 83 of file FixedPoint.hh.

◆ toInt()

template<unsigned FRACTION_BITS_>

constexpr int openmsx::FixedPoint< FRACTION_BITS_ >::toInt ( ) const

inline

Returns the integer part (rounded down) of this fixed point number.

Note that for negative numbers, rounding occurs away from zero.

Definition at line 76 of file FixedPoint.hh.

Referenced by openmsx::BlipBuffer::addDelta(), openmsx::YM2413Burczynski::Slot::calc_phase(), openmsx::YMF262::setMixLevel(), and openmsx::YM2413Burczynski::YM2413::YM2413().

Friends And Related Function Documentation

◆ operator!=

template<unsigned FRACTION_BITS_>

constexpr friend bool operator!=	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 189 of file FixedPoint.hh.

◆ operator* [1/3]

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator*	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 156 of file FixedPoint.hh.

◆ operator* [2/3]

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator*	(	FixedPoint< FRACTION_BITS_ >	x,
		int	y
	)

friend

Definition at line 160 of file FixedPoint.hh.

◆ operator* [3/3]

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator*	(	int	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 163 of file FixedPoint.hh.

◆ operator+

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator+	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 150 of file FixedPoint.hh.

◆ operator-

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator-	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 153 of file FixedPoint.hh.

◆ operator/ [1/2]

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator/	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Divides two fixed point numbers.

The fractional part is rounded down.

Definition at line 170 of file FixedPoint.hh.

◆ operator/ [2/2]

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator/	(	FixedPoint< FRACTION_BITS_ >	x,
		int	y
	)

friend

Definition at line 174 of file FixedPoint.hh.

◆ operator<

template<unsigned FRACTION_BITS_>

constexpr friend bool operator<	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 192 of file FixedPoint.hh.

◆ operator<<

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator<<	(	FixedPoint< FRACTION_BITS_ >	x,
		int	y
	)

friend

Definition at line 177 of file FixedPoint.hh.

◆ operator<=

template<unsigned FRACTION_BITS_>

constexpr friend bool operator<=	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 195 of file FixedPoint.hh.

◆ operator==

template<unsigned FRACTION_BITS_>

constexpr friend bool operator==	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 186 of file FixedPoint.hh.

◆ operator>

template<unsigned FRACTION_BITS_>

constexpr friend bool operator>	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 198 of file FixedPoint.hh.

◆ operator>=

template<unsigned FRACTION_BITS_>

constexpr friend bool operator>=	(	FixedPoint< FRACTION_BITS_ >	x,
		FixedPoint< FRACTION_BITS_ >	y
	)

friend

Definition at line 201 of file FixedPoint.hh.

◆ operator>>

template<unsigned FRACTION_BITS_>

constexpr friend FixedPoint operator>>	(	FixedPoint< FRACTION_BITS_ >	x,
		int	y
	)

friend

Definition at line 180 of file FixedPoint.hh.

Member Data Documentation

◆ FRACTION_BITS

template<unsigned FRACTION_BITS_>

constexpr unsigned openmsx::FixedPoint< FRACTION_BITS_ >::FRACTION_BITS = FRACTION_BITS_

static

Number of fractional bits (export template parameter as a constant so that external code can use it more easily).

Definition at line 19 of file FixedPoint.hh.

Referenced by openmsx::FixedPoint< EG_DP_BITS - EG_BITS >::toInt().

The documentation for this class was generated from the following file:

FixedPoint.hh

Public Member Functions

Static Public Member Functions

Static Public Attributes

Friends

Detailed Description

template<unsigned FRACTION_BITS_> class openmsx::FixedPoint< FRACTION_BITS_ >

Constructor & Destructor Documentation

◆ FixedPoint() [1/6]

◆ FixedPoint() [2/6]

◆ FixedPoint() [3/6]

◆ FixedPoint() [4/6]

◆ FixedPoint() [5/6]

◆ FixedPoint() [6/6]

Member Function Documentation

◆ addQuantum()

◆ create()

◆ divAsInt()

◆ floor()

◆ fract()

◆ fractAsInt()

◆ fractionAsDouble()

◆ fractionAsFloat()

◆ getRawValue()

◆ operator+=()

◆ operator-=()

◆ roundRatioDown()

◆ serialize()

◆ shiftHelper()

◆ toDouble()

◆ toFloat()

◆ toInt()

Friends And Related Function Documentation

◆ operator!=

◆ operator* [1/3]

◆ operator* [2/3]

◆ operator* [3/3]

◆ operator+

◆ operator-

◆ operator/ [1/2]

◆ operator/ [2/2]

◆ operator<

◆ operator<<

◆ operator<=

◆ operator==

◆ operator>

◆ operator>=

◆ operator>>

Member Data Documentation

◆ FRACTION_BITS

template<unsigned FRACTION_BITS_>
class openmsx::FixedPoint< FRACTION_BITS_ >