AgentSkillsCN

led-mapping-guide

APC Mini MK2 LED与按钮映射的可视化指南。当用户需要了解“哪个按钮”、“垫子的位置”、“LED的方位”、“音符对应的坐标”、“坐标对应的音符”,或希望深入了解控制器的物理布局时,此技能便能助您一臂之力。

SKILL.md
--- frontmatter
name: led-mapping-guide
description: Visual guide for APC Mini MK2 LED and button mapping. Use when user needs to know "which button", "pad location", "LED position", "coordinate to note", "note to coordinate", or wants to understand the physical layout of the controller.

APC Mini MK2 LED Mapping Guide

Visual reference for button positions. For complete details, see reference.md.

Physical Layout

code
┌─────────────────────────────────────────────┐
│  [SHIFT]                        [SCENE 1-8] │
│                                   112-119   │
│  ┌───┬───┬───┬───┬───┬───┬───┬───┐  ┌───┐  │
│  │56 │57 │58 │59 │60 │61 │62 │63 │  │112│  │
│  ├───┼───┼───┼───┼───┼───┼───┼───┤  ├───┤  │
│  │...│   │   │   │   │   │   │...│  │...│  │
│  ├───┼───┼───┼───┼───┼───┼───┼───┤  ├───┤  │
│  │ 0 │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │  │119│  │
│  └───┴───┴───┴───┴───┴───┴───┴───┘  └───┘  │
│  ┌───┬───┬───┬───┬───┬───┬───┬───┐         │
│  │100│101│102│103│104│105│106│107│ TRACK   │
│  └───┴───┴───┴───┴───┴───┴───┴───┘         │
│  ═══════════════════════════════  FADERS   │
│  CC48-55                          CC56     │
└─────────────────────────────────────────────┘

Coordinate Conversion

typescript
// (row, col) to note (1-indexed)
const coordToNote = (row: number, col: number): number =>
  (row - 1) * 8 + (col - 1);

// note to (row, col)
const noteToCoord = (note: number) => ({
  row: Math.floor(note / 8) + 1,
  col: (note % 8) + 1
} as const);

// (x, y) to note (0-indexed)
const xyToNote = (x: number, y: number): number => y * 8 + x;

LED Types

RegionNotesLED TypeStates
Pads0-63RGB128 colors + custom RGB
Track100-107Red0=off, 1=on, 2=blink
Scene112-119Green0=off, 1=on, 2=blink