Powered by Mintlify
Auto-generate your docs
Number input class for controlling Rive state machines in the iOS Runtime.
RiveSMINumber represents a numeric input in a Rive state machine. Use this class to get and set floating-point values that control state transitions and animations.
Inherits from RiveSMIInput.
- (float)value;
float
- (void)setValue:(float)newValue;
newValue - The new floating-point value to set// Get a number input from the state machine
RiveSMINumber* speed = (RiveSMINumber*)[stateMachine inputFromName:@"speed"];
// Set the value
[speed setValue:2.5];
// Get the current value
float currentSpeed = [speed value];
NSLog(@"Current speed: %.2f", currentSpeed);
// Control animation speed based on user interaction
RiveSMINumber* animationSpeed = (RiveSMINumber*)[stateMachine inputFromName:@"animationSpeed"];
// Slow motion
[animationSpeed setValue:0.5];
// Normal speed
[animationSpeed setValue:1.0];
// Fast forward
[animationSpeed setValue:2.0];
// Initialize Rive view and get state machine
RiveStateMachineInstance* stateMachine = [riveView stateMachine:@"State Machine 1"];
// Get number inputs
RiveSMINumber* level = (RiveSMINumber*)[stateMachine inputFromName:@"level"];
RiveSMINumber* progress = (RiveSMINumber*)[stateMachine inputFromName:@"progress"];
// Update based on game state
[level setValue:5];
[progress setValue:0.75]; // 75% complete
// Advance the state machine
[stateMachine advanceBy:deltaTime];
RiveSMINumber* counter = (RiveSMINumber*)[stateMachine inputFromName:@"counter"];
// Increment the value
float currentValue = [counter value];
[counter setValue:currentValue + 1.0];
// Connect a UISlider to a Rive number input
- (IBAction)sliderValueChanged:(UISlider*)slider {
RiveSMINumber* volumeInput = (RiveSMINumber*)[stateMachine inputFromName:@"volume"];
[volumeInput setValue:slider.value];
}
RiveSMIInput* input = [stateMachine inputFromName:@"myInput"];
if ([input isNumber]) {
RiveSMINumber* numberInput = (RiveSMINumber*)input;
[numberInput setValue:100.0];
}