macos_code_gen.dart 5.43 KB
Newer Older
1 2 3 4 5 6 7
// Copyright 2014 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import 'package:path/path.dart' as path;

import 'base_code_gen.dart';
8 9 10
import 'constants.dart';
import 'logical_key_data.dart';
import 'physical_key_data.dart';
11 12
import 'utils.dart';

13 14 15 16 17 18 19 20 21 22
const List<String> kModifiersOfInterest = <String>[
  'ShiftLeft',
  'ShiftRight',
  'ControlLeft',
  'ControlRight',
  'AltLeft',
  'AltRight',
  'MetaLeft',
  'MetaRight',
];
23

24 25 26 27 28
// The name of keys that require special attention.
const List<String> kSpecialPhysicalKeys = <String>['CapsLock'];
const List<String> kSpecialLogicalKeys = <String>['CapsLock'];

/// Generates the key mapping for macOS, based on the information in the key
29
/// data structure given to it.
30
class MacOSCodeGenerator extends PlatformCodeGenerator {
31
  MacOSCodeGenerator(super.keyData, super.logicalData, this._layoutGoals);
32 33

  /// This generates the map of macOS key codes to physical keys.
34
  String get _scanCodeMap {
35
    final OutputLines<int> lines = OutputLines<int>('macOS scancode map');
36
    for (final PhysicalKeyEntry entry in keyData.entries) {
37
      if (entry.macOSScanCode != null) {
38
        lines.add(entry.macOSScanCode!, '  @${toHex(entry.macOSScanCode)} : @${toHex(entry.usbHidCode)},  // ${entry.constantName}');
39 40
      }
    }
41
    return lines.sortedJoin().trimRight();
42 43
  }

44
  String get _keyCodeToLogicalMap {
45
    final OutputLines<int> lines = OutputLines<int>('macOS keycode map');
46
    for (final LogicalKeyEntry entry in logicalData.entries) {
47
      zipStrict(entry.macOSKeyCodeValues, entry.macOSKeyCodeNames, (int macOSValue, String macOSName) {
48 49
        lines.add(macOSValue,
            '  @${toHex(macOSValue)} : @${toHex(entry.value, digits: 11)},  // $macOSName -> ${entry.constantName}');
50
      });
51
    }
52
    return lines.sortedJoin().trimRight();
53 54
  }

55 56 57
  /// This generates the mask values for the part of a key code that defines its plane.
  String get _maskConstants {
    final StringBuffer buffer = StringBuffer();
58 59 60 61 62
    const List<MaskConstant> maskConstants = <MaskConstant>[
      kValueMask,
      kUnicodePlane,
      kMacosPlane,
    ];
63
    for (final MaskConstant constant in maskConstants) {
64
      buffer.writeln('const uint64_t k${constant.upperCamelName} = ${toHex(constant.value, digits: 11)};');
65 66 67 68 69 70 71 72
    }
    return buffer.toString().trimRight();
  }

  /// This generates a map from the key code to a modifier flag.
  String get _keyToModifierFlagMap {
    final StringBuffer modifierKeyMap = StringBuffer();
    for (final String name in kModifiersOfInterest) {
73
      modifierKeyMap.writeln('  @${toHex(logicalData.entryByName(name).macOSKeyCodeValues[0])} : @(kModifierFlag${lowerCamelToUpperCamel(name)}),');
74 75 76 77 78 79 80 81
    }
    return modifierKeyMap.toString().trimRight();
  }

  /// This generates a map from the modifier flag to the key code.
  String get _modifierFlagToKeyMap {
    final StringBuffer modifierKeyMap = StringBuffer();
    for (final String name in kModifiersOfInterest) {
82
      modifierKeyMap.writeln('  @(kModifierFlag${lowerCamelToUpperCamel(name)}) : @${toHex(logicalData.entryByName(name).macOSKeyCodeValues[0])},');
83 84 85 86 87 88 89 90 91 92 93 94
    }
    return modifierKeyMap.toString().trimRight();
  }

  /// This generates some keys that needs special attention.
  String get _specialKeyConstants {
    final StringBuffer specialKeyConstants = StringBuffer();
    for (final String keyName in kSpecialPhysicalKeys) {
      specialKeyConstants.writeln('const uint64_t k${keyName}PhysicalKey = ${toHex(keyData.entryByName(keyName).usbHidCode)};');
    }
    for (final String keyName in kSpecialLogicalKeys) {
      specialKeyConstants.writeln('const uint64_t k${lowerCamelToUpperCamel(keyName)}LogicalKey = ${toHex(logicalData.entryByName(keyName).value)};');
95
    }
96
    return specialKeyConstants.toString().trimRight();
97 98
  }

99 100
  final Map<String, bool> _layoutGoals;
  String get _layoutGoalsString {
101
    final OutputLines<int> lines = OutputLines<int>('macOS layout goals');
102 103 104 105 106 107 108 109 110
    _layoutGoals.forEach((String name, bool mandatory) {
      final PhysicalKeyEntry physicalEntry = keyData.entryByName(name);
      final LogicalKeyEntry logicalEntry = logicalData.entryByName(name);
      final String line = 'LayoutGoal{'
          '${toHex(physicalEntry.macOSScanCode, digits: 2)}, '
          '${toHex(logicalEntry.value, digits: 2)}, '
          '${mandatory ? 'true' : 'false'}'
          '},';
      lines.add(logicalEntry.value,
111
          '    ${line.padRight(32)}'
112 113
          '// ${logicalEntry.name}');
    });
114 115 116
    return lines.sortedJoin().trimRight();
  }

117
  @override
118
  String get templatePath => path.join(dataRoot, 'macos_key_code_map_cc.tmpl');
119 120

  @override
121
  String outputPath(String platform) => path.join(PlatformCodeGenerator.engineRoot,
122
      'shell', 'platform', 'darwin', 'macos', 'framework', 'Source', 'KeyCodeMap.g.mm');
123 124 125 126 127 128 129

  @override
  Map<String, String> mappings() {
    // There is no macOS keycode map since macOS uses keycode to represent a physical key.
    // The LogicalKeyboardKey is generated by raw_keyboard_macos.dart from the unmodified characters
    // from NSEvent.
    return <String, String>{
130 131 132 133 134 135
      'MACOS_SCAN_CODE_MAP': _scanCodeMap,
      'MACOS_KEYCODE_LOGICAL_MAP': _keyCodeToLogicalMap,
      'MASK_CONSTANTS': _maskConstants,
      'KEYCODE_TO_MODIFIER_FLAG_MAP': _keyToModifierFlagMap,
      'MODIFIER_FLAG_TO_KEYCODE_MAP': _modifierFlagToKeyMap,
      'SPECIAL_KEY_CONSTANTS': _specialKeyConstants,
136
      'LAYOUT_GOALS': _layoutGoalsString,
137 138 139
    };
  }
}