openmsx::KeyMatrixPosition Class Reference

A position (row, column) in a keyboard matrix. More...

#include <UnicodeKeymap.hh>

Public Member Functions
constexpr	KeyMatrixPosition ()=default
	Creates an invalid key matrix position, which can be used when a key does not exist on a particular keyboard.
constexpr	KeyMatrixPosition (uint8_t rowCol_)
	Creates a key matrix position from a uint8_t: the row is stored in the high nibble, the column is stored in the low nibble.
constexpr	KeyMatrixPosition (unsigned row, unsigned col)
	Creates a key matrix position with a given row and column.
constexpr bool	isValid () const
	Returns true iff this position is valid.
constexpr uint8_t	getRow () const
	Returns the matrix row.
constexpr uint8_t	getColumn () const
	Returns the matrix column.
constexpr uint8_t	getRowCol () const
	Returns the matrix row and column combined in a single uint8_t: the column is stored in the lower 3 bits, the row is stored in the higher bits.
constexpr uint8_t	getMask () const
	Returns a mask with the bit corresponding to this position's column set, all other bits clear.
constexpr bool	operator== (const KeyMatrixPosition &) const =default

Static Public Attributes
static constexpr unsigned	NUM_ROWS = 16
	Rows are in the range [0..NUM_ROWS).
static constexpr unsigned	NUM_COLS = 8
	Columns are in the range [0..NUM_COLS).
static constexpr unsigned	NUM_ROWCOL = 1 << 7
	Combined row and column values are in the range [0..NUM_ROWCOL).

Detailed Description

A position (row, column) in a keyboard matrix.

Definition at line 18 of file UnicodeKeymap.hh.

Constructor & Destructor Documentation

KeyMatrixPosition() [1/3]

constexpr openmsx::KeyMatrixPosition::KeyMatrixPosition ( )

constexprdefault

Creates an invalid key matrix position, which can be used when a key does not exist on a particular keyboard.

KeyMatrixPosition() [2/3]

constexpr openmsx::KeyMatrixPosition::KeyMatrixPosition ( uint8_t  rowCol_ )

inlineexplicitconstexpr

Creates a key matrix position from a uint8_t: the row is stored in the high nibble, the column is stored in the low nibble.

Definition at line 37 of file UnicodeKeymap.hh.

KeyMatrixPosition() [3/3]

constexpr openmsx::KeyMatrixPosition::KeyMatrixPosition ( unsigned  row, unsigned  col  )

inlineconstexpr

Creates a key matrix position with a given row and column.

Definition at line 44 of file UnicodeKeymap.hh.

References isValid(), NUM_COLS, and NUM_ROWS.

Member Function Documentation

getColumn()

constexpr uint8_t openmsx::KeyMatrixPosition::getColumn ( ) const

inlineconstexpr

Returns the matrix column.

Must only be called on valid positions.

Definition at line 69 of file UnicodeKeymap.hh.

References isValid().

Referenced by getMask().

getMask()

constexpr uint8_t openmsx::KeyMatrixPosition::getMask ( ) const

inlineconstexpr

Returns a mask with the bit corresponding to this position's column set, all other bits clear.

Must only be called on valid positions.

Definition at line 87 of file UnicodeKeymap.hh.

References getColumn(), and isValid().

getRow()

constexpr uint8_t openmsx::KeyMatrixPosition::getRow ( ) const

inlineconstexpr

Returns the matrix row.

Must only be called on valid positions.

Definition at line 61 of file UnicodeKeymap.hh.

References isValid().

getRowCol()

constexpr uint8_t openmsx::KeyMatrixPosition::getRowCol ( ) const

inlineconstexpr

Returns the matrix row and column combined in a single uint8_t: the column is stored in the lower 3 bits, the row is stored in the higher bits.

Must only be called on valid positions.

Definition at line 78 of file UnicodeKeymap.hh.

References isValid().

Referenced by openmsx::UnicodeKeymap::getRelevantMods().

isValid()

constexpr bool openmsx::KeyMatrixPosition::isValid ( ) const

inlineconstexpr

Returns true iff this position is valid.

Definition at line 54 of file UnicodeKeymap.hh.

Referenced by getColumn(), getMask(), getRow(), getRowCol(), openmsx::UnicodeKeymap::KeyInfo::isValid(), openmsx::UnicodeKeymap::KeyInfo::KeyInfo(), and KeyMatrixPosition().

operator==()

constexpr bool openmsx::KeyMatrixPosition::operator== ( const KeyMatrixPosition &  ) const

constexprdefault

Member Data Documentation

NUM_COLS

constexpr unsigned openmsx::KeyMatrixPosition::NUM_COLS = 8

staticconstexpr

Columns are in the range [0..NUM_COLS).

Definition at line 25 of file UnicodeKeymap.hh.

Referenced by KeyMatrixPosition().

NUM_ROWCOL

constexpr unsigned openmsx::KeyMatrixPosition::NUM_ROWCOL = 1 << 7

staticconstexpr

Combined row and column values are in the range [0..NUM_ROWCOL).

Definition at line 27 of file UnicodeKeymap.hh.

NUM_ROWS

constexpr unsigned openmsx::KeyMatrixPosition::NUM_ROWS = 16

staticconstexpr

Rows are in the range [0..NUM_ROWS).

Definition at line 23 of file UnicodeKeymap.hh.

Referenced by openmsx::Keyboard::getKeys(), KeyMatrixPosition(), and openmsx::Keyboard::transferHostKeyMatrix().

---

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

• UnicodeKeymap.hh