fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2026-05-06 05:08:08 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

nak: Improve documentation for RegRef

Browse source 
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34919>
This commit is contained in:
Faith Ekstrand 2025-05-11 23:14:27 -04:00 • committed by Marge Bot
parent 22056d5b08
commit 3459004104
1 changed files with 11 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
src/nouveau/compiler/nak/ir.rs
View file

@ -369,6 +369,8 @@ impl<T> IndexMut<RegFile> for PerRegFile<T> {
}
}
/// A reference to a contiguous range of registers in a particular register
/// file.
#[derive(Clone, Copy, Eq, Hash, PartialEq)]
pub struct RegRef {
packed: u32,
@ -377,6 +379,11 @@ pub struct RegRef {
impl RegRef {
pub const MAX_IDX: u32 = (1 << 26) - 1;
/// Creates a new register reference.
///
/// # Panics
///
/// This method panics if `base_idx > RegRef::MAX_IDX` or if `comps > 8`.
pub fn new(file: RegFile, base_idx: u32, comps: u8) -> RegRef {
assert!(base_idx <= Self::MAX_IDX);
let mut packed = base_idx;
@ -387,20 +394,24 @@ impl RegRef {
RegRef { packed: packed }
}
/// Returns the index of the first register referenced.
pub fn base_idx(&self) -> u32 {
self.packed & 0x03ffffff
}
/// Returns the range of register indices referenced.
pub fn idx_range(&self) -> Range<u32> {
let start = self.base_idx();
let end = start + u32::from(self.comps());
start..end
}
/// Returns the number of registers referenced.
pub fn comps(&self) -> u8 {
(((self.packed >> 26) & 0x7) + 1).try_into().unwrap()
}
/// Returns a reference to the single register at `base_idx() + c`.
pub fn comp(&self, c: u8) -> RegRef {
assert!(c < self.comps());
RegRef::new(self.file(), self.base_idx() + u32::from(c), 1)