---

Three Useful Idle Manager Calls

There are three useful Idle Manager calls you should consider:

1. QTIdleManagerSetNextIdleTimeNow, which specifies that your component needs an idle now. The only parameter is your Idle Manager.

2. QTIdleManagerSetNextIdleTimeNever, which specifies that your component will not need to be idled until further notice––in other words, don’t idle me.

3. QTIdleManagerSetNextIdleTimeDelta, which specifies that your component needs to be idled this amount of time from now. Using this routine will get you one idle. If you don’t specify anything different, then you’ll continue to be idled all the time because the Idle Manager still thinks you need one back then, which is now. Every time you get idled, you need to tell the Idle Manager again when your next idle needs to be. This call will tell the Idle Manager how long when you pass in a duration, but then you have to tell it what the units of that duration are.

QTIdleManagerSetNextIdleTimeNow

Specifies that your component needs to be idled now.

QTIdleManagerSetNextIdleTimeNow (IdleManager im);

Parameters

im

An idle manager.

Discussion

This routine specifies that the calling component needs to be idled right away, that is, continuously, until further notice.

Introduced in QuickTime 6.

Availability

• Available in Mac OS X v10.2 and later.

Declared In

Movies.h

QTIdleManagerSetNextIdleTimeNever

Specifies that your component will not need to be idled until further notice.

QTIdleManagerSetNextIdleTimeNever (IdleManager im);

Parameters

im

An idle manager.

Discussion

This routine specifies that your component should not be idled.

Introduced in QuickTime 6.

Availability

• Available in Mac OS X v10.2 and later.

Declared In

Movies.h

QTIdleManagerSetNextIdleTimeDelta

Specifies that your component needs to be idled a certain amount of time from now––for example, a quarter of second from now, or three seconds from now.

QTIdleManagerSetNextIdleTimeDelta (IdleManager im,
   TimeValue duration,
   TimeScale scale);

Parameters

im

An idle manager.

duration

The time from now in the scale specified.

scale

The time scale.

Discussion

This routine lets you pass in a duration and a scale. For example, if you need an idle a half second from now, you can pass in a duration of 500 and a scale of 1000, or a pass in a duration of 1 and scale of 2. In both cases, this is a half second. Typically, developers will have a time scale they are used to working in, such as milliseconds or 60ths of a second.

Introduced in QuickTime 6.

Availability

• Available in Mac OS X v10.2 and later.

Declared In

Movies.h

---