kittyPlaceholderCell function

String kittyPlaceholderCell(
  1. int row,
  2. int col, {
  3. int imageIdMsb = 0,
})

Returns the Kitty Unicode placeholder grapheme for tile (row, col).

When imageIdMsb is greater than 0, a 4th combining diacritic encoding the most-significant 8 bits ((imageId >> 24) & 0xFF) is appended, supporting full 32-bit Kitty image IDs.

Implementation

String kittyPlaceholderCell(int row, int col, {int imageIdMsb = 0}) {
  final rIdx = row.clamp(0, kittyDiacritics.length - 1);
  final cIdx = col.clamp(0, kittyDiacritics.length - 1);
  if (imageIdMsb > 0) {
    final mIdx = imageIdMsb.clamp(0, kittyDiacritics.length - 1);
    return '$kittyPlaceholderChar${String.fromCharCode(kittyDiacritics[rIdx])}${String.fromCharCode(kittyDiacritics[cIdx])}${String.fromCharCode(kittyDiacritics[mIdx])}';
  }
  return '$kittyPlaceholderChar${String.fromCharCode(kittyDiacritics[rIdx])}${String.fromCharCode(kittyDiacritics[cIdx])}';
}