Why is the delay property in captureFromWidget needed?

[aytunch]

We have a Duration field called delay which defaults to 1 second inside of captureFromWidget

In which cases should we change it? and is it safe between different devices? For instance would an old android device need a higher delay? is it about performance?

In the code it states:

Value for [delay] should increase with widget tree size. Prefered value is 1 seconds

[kvenn]

I'd also like to know this the Readme covers it a little, but I'm curious if there's a heuristic other than trial-and-error to figure out how short the delay can be.

Relevant bit

Sometimes rastergraphics like images may not be captured by the plugin with default configurations. The issue is discussed here.

...screenshot is taken before the GPU thread is done rasterizing the frame
so the screenshot of the previous frame is taken, which is wrong.

The solution is to add a small delay before capturing.

screenshotController.capture(delay: Duration(milliseconds: 10))