/*
   *  The idle methods allow the application to register callback routines 
   *  which will be called by the view during especially long operations.
   *
   *  The idle methods may also be used to interrupt long renderings or
   *  traversals.  Inside the idler callback the application can check for
   *  Command-Period, Control-C or clicking a "Cancel" button or whatever else
   *  may be used to let the user interrupt rendering.    
   *
   *  It is NOT LEGAL to call QD3D routines inside an idler callback.
   *
   *  Return kQ3Failure to cancel rendering, kQ3Success to continue. Don't
   *  bother posting an error.
   *
   *  Q3View_SetIdleMethod registers a callback that can be called
   *  by the system during rendering.  Unfortunately there is no way yet
   *  to set timer intervals when you want to be called.  Basically, it is
   *  up to the application's idler callback to check clocks to see if you
   *  were called back only a millisecond ago or an hour ago!
   *
   *  Q3View_SetIdleProgressMethod registers a callback that also gives
   *  progress information. This information is supplied by the renderer, and
   *  may or may not be based on real time.
   *
   *  If a renderer doesn't support the progress method, your method will be
   *  called with current == 0 and completed == 0.
   *  
   *  Otherwise, you are GUARANTEED to get called at least 2 or more times:
   *  
   *  ONCE            idleMethod(view, 0, n)      -> Initialize, Show Dialog
   *  zero or more    idleMethod(view, 1..n-1, n) -> Update progress
   *  ONCE            idleMethod(view, n, n)      -> Exit, Hide Dialog
   *  
   *  "current" is guaranteed to be less than or equal to "completed"
   *  "completed" may change values, but current/complete always indicates
   *  the degree of completion.
   *
   *  The calling conventions aid in managing any data associated with a 
   *  progress user interface indicator.
   */
  endif  /* CALL_NOT_IN_CARBON */
  
  typedef CALLBACK_API_C( TQ3Status , TQ3ViewIdleMethod )(TQ3ViewObject view, const void *idlerData);
  typedef CALLBACK_API_C( TQ3Status , TQ3ViewIdleProgressMethod )(TQ3ViewObject view, const void *idlerData, unsigned long current, unsigned long completed);
  if CALL_NOT_IN_CARBON
  EXTERN_API_C( TQ3Status )
  Q3View_SetIdleMethod            (TQ3ViewObject          view,
                                   TQ3ViewIdleMethod      idleMethod,
                                   const void *           idleData);
  
  EXTERN_API_C( TQ3Status )
  Q3View_SetIdleProgressMethod    (TQ3ViewObject          view,
                                   TQ3ViewIdleProgressMethod  idleMethod,
                                   const void *           idleData);