VSyncClient Class Reference

#import <vsync_waiter_ios.h>

Inheritance diagram for VSyncClient:

Instance Methods
(instancetype)	- initWithTaskRunner:callback:
(void)	- await
(void)	- pause
(void)	- invalidate
	Call invalidate before releasing this object to remove from runloops. More...
(void)	- setMaxRefreshRate:

Properties
BOOL	allowPauseAfterVsync
	Default value is YES. Vsync client will pause vsync callback after receiving a vsync signal. Setting this property to NO can avoid this and vsync client will trigger vsync callback continuously. More...

Detailed Description

Definition at line 47 of file vsync_waiter_ios.h.

Method Documentation

await

- (void) await

Definition at line 108 of file vsync_waiter_ios.mm.

              {
  _displayLink.paused = NO;
}

References _displayLink.

Referenced by flutter::VsyncWaiterIOS::AwaitVSync.

initWithTaskRunner:callback:

- (instancetype) initWithTaskRunner:		(fml::RefPtr<fml::TaskRunner>)	task_runner
callback:		(flutter::VsyncWaiter::Callback)	callback

Definition at line 71 of file vsync_waiter_ios.mm.

                                  :(fml::RefPtr<fml::TaskRunner>)task_runner
                          callback:(flutter::VsyncWaiter::Callback)callback {
  FML_DCHECK(task_runner);
 
  if (self = [super init]) {
    _refreshRate = DisplayLinkManager.displayRefreshRate;
    _allowPauseAfterVsync = YES;
    _callback = std::move(callback);
    _displayLink = [CADisplayLink displayLinkWithTarget:self selector:@selector(onDisplayLink:)];
    _displayLink.paused = YES;
 
    [self setMaxRefreshRate:DisplayLinkManager.displayRefreshRate];
 
    // Strongly retain the the captured link until it is added to the runloop.
    CADisplayLink* localDisplayLink = _displayLink;
    task_runner->PostTask([localDisplayLink]() {
      [localDisplayLink addToRunLoop:NSRunLoop.currentRunLoop forMode:NSRunLoopCommonModes];
    });
  }
 
  return self;
}

References _displayLink, DisplayLinkManager::displayRefreshRate, and setMaxRefreshRate:.

invalidate

- (void) invalidate

Call invalidate before releasing this object to remove from runloops.

Definition at line 139 of file vsync_waiter_ios.mm.

                   {
  [_displayLink invalidate];
  _displayLink = nil;  // Break retain cycle.
}

References _displayLink.

Referenced by flutter::VsyncWaiterIOS::~VsyncWaiterIOS.

pause

- (void) pause

Definition at line 112 of file vsync_waiter_ios.mm.

              {
  _displayLink.paused = YES;
}

References _displayLink.

setMaxRefreshRate:

- (void) setMaxRefreshRate:

(double)

refreshRate

Definition at line 94 of file vsync_waiter_ios.mm.

                         :(double)refreshRate {
  if (!DisplayLinkManager.maxRefreshRateEnabledOnIPhone) {
    return;
  }
  double maxFrameRate = fmax(refreshRate, 60);
  double minFrameRate = fmax(maxFrameRate / 2, 60);
  if (@available(iOS 15.0, *)) {
    _displayLink.preferredFrameRateRange =
        CAFrameRateRangeMake(minFrameRate, maxFrameRate, maxFrameRate);
  } else {
    _displayLink.preferredFramesPerSecond = maxFrameRate;
  }
}

References _displayLink, and DisplayLinkManager::maxRefreshRateEnabledOnIPhone.

Referenced by flutter::VsyncWaiterIOS::AwaitVSync, and initWithTaskRunner:callback:.

Property Documentation

allowPauseAfterVsync

- (BOOL) allowPauseAfterVsync

readwritenonatomicassign

Default value is YES. Vsync client will pause vsync callback after receiving a vsync signal. Setting this property to NO can avoid this and vsync client will trigger vsync callback continuously.

Parameters

allowPauseAfterVsync

Allow vsync client to pause after receiving a vsync signal.

Definition at line 57 of file vsync_waiter_ios.h.

---

The documentation for this class was generated from the following files:

• shell/platform/darwin/ios/framework/Source/vsync_waiter_ios.h
• shell/platform/darwin/ios/framework/Source/vsync_waiter_ios.mm