Inherits from MIKMIDIChannelVoiceCommand : MIKMIDICommand : NSObject
Declared in MIKMIDIControlChangeCommand.h

Overview

A MIDI control change message.

Tasks

Properties

controllerNumber

@property (nonatomic, readonly) NSUInteger controllerNumber
Discussion

The MIDI control number for the command.

Declared In

MIKMIDIControlChangeCommand.h

controllerValue

@property (nonatomic, readonly) NSUInteger controllerValue
Discussion

The controlValue of the command.

This method returns the same value as -value. Note that this is always a 7-bit (0-127) value, even for a fourteen bit command. To retrieve the 14-bit value, use fourteenBitValue.

Declared In

MIKMIDIControlChangeCommand.h

fourteenBitCommand

@property (nonatomic, readonly, getter=isFourteenBitCommand) BOOL fourteenBitCommand
Discussion

YES if the command contains 14-bit value data.

If this property returns YES, fourteenBitValue will return a precision value in the range 0-16383

Declared In

MIKMIDIControlChangeCommand.h

fourteenBitValue

@property (nonatomic, readonly) NSUInteger fourteenBitValue
Discussion

The 14-bit value of the command.

This property always returns a 14-bit value (ranging from 0-16383). If the receiver is not a 14-bit command (isFourteenBitCommand returns NO), the 7 least significant bits will always be 0.

Declared In

MIKMIDIControlChangeCommand.h

Class Methods

commandByCoalescingMSBCommand:andLSBCommand:

+ (instancetype)commandByCoalescingMSBCommand:(MIKMIDIControlChangeCommand *)msbCommand andLSBCommand:(MIKMIDIControlChangeCommand *)lsbCommand
Discussion

Convience method for creating a single, 14-bit control change command from its component messages. The two commands passed into this method must comply with the MIDI specification for 14-bit control change messages.

The MIDI spec allows for 14-bit control change commands. These are actually sent as two sequential commands where the second command has a controller number equal to the first message’s controllerNumber plus 32, and whose value is the least significant 7-bits of the 14-bit value.

Note: This method is used internally by MIKMIDI, to coalesce incoming 14-bit control change commands. it is not generally useful to external users of MIKMIDI. If you’re simply trying to create a new MIKMIDIControlChangeCommand instance, you should use plain alloc/init instead.

Parameters

msbCommand

The command containing the most significant 7 bits of value data (ie. the first command).

lsbCommand

The command containing the least significant 7 bits of value data (ie. the second command).

Return Value

A new, single MIKMIDIControlChangeCommand instance containing 14-bit value data, and whose fourteenBitCommand property is set to YES.

Declared In

MIKMIDIControlChangeCommand.h