MKScorePerformer.h

/*
  $Id: MKScorePerformer.h 3251 2005-05-11 07:59:04Z leighsmith $
  Defined In: The MusicKit

  Description:
    A MKScorePerformer performs a MKScore object by creating a group of
    MKPartPerformers, one for each MKPart in the MKScore, and controlling the
    group's performance.  MKScorePerformer itself isn't a MKPerformer but it
    does define a number of methods, such as activate, pause, and resume,
    that resemble MKPerformer methods.  When a MKScorePerformer receives such
    a message, it simply forwards it to each of its MKPartPerformer objects,
    which are true MKPerformers.
   
    MKScorePerformer also has a MKPerformer-like status; it can be active,
    inactive, or paused.  The status of a MKScorePerformer is, in general,
    the same as the status of all of its MKPartPerformers.  For instance,
    when you send the activate message to a MKScorePerformer, its status
    becomes MK_active as does the status of all its MKPartPerformers.
    However, you can access and control a MKPartPerformer independent of the
    MKScorePerformer that created it.  Thus, an individual MKPartPerformer's
    status can be different from that of the MKScorePerformer.
   
    A MKScorePerformer's score is set and its MKPartPerformers are created
    when it receives the setScore: message.  If you add MKParts to or remove
    MKParts from the MKScore after sending the setScore: message, the changes
    will not be seen by the MKScorePerformer.

  Original Author: David A. Jaffe

  Copyright (c) 1988-1992, NeXT Computer, Inc.
  Portions Copyright (c) 1994 NeXT Computer, Inc. and reproduced under license from NeXT
  Portions Copyright (c) 1994 Stanford University.
  Portions Copyright (c) 1999-2001, The MusicKit Project.
*/
@class MKScore;
@class MKPartPerformer;

#ifndef __MK_ScorePerformer_H___
#define __MK_ScorePerformer_H___

#import <Foundation/NSObject.h>
#import "MKPerformer.h"

@interface MKScorePerformer : NSObject
{
    MKPerformerStatus status;       
    NSMutableArray *partPerformers; 
    MKScore *score;                 
    double firstTimeTag;            
    double lastTimeTag;   
    double timeShift;     
    double duration;      
    MKConductor *conductor; 
    id delegate;            
    Class partPerformerClass;  
@private
    MKMsgStruct * _deactivateMsgPtr;
}

+ (MKScorePerformer *) scorePerformer;

- init; 

- releasePartPerformers;

- removePartPerformers; 

- setScore: (MKScore *) aScore;

- (MKScore *) score;    

- activate; 

- activateSelf; 

- (void) deactivate; 

- pause; 

- resume; 

- setFirstTimeTag: (double) aTimeTag; 

- setLastTimeTag: (double) aTimeTag; 

- (double) firstTimeTag;    

- (double) lastTimeTag;    

- setTimeShift: (double) aTimeShift; 

- setDuration: (double) aDuration; 

- (double) timeShift;

- (double) duration; 

- copyWithZone: (NSZone *) zone;

 /* Frees the receiver and its MKPartPerformers. */
- (void) dealloc;

- setConductor: (MKConductor *) aConductor; 

- (MKPartPerformer *) partPerformerForPart: (MKPart *) aPart;

- (NSArray *) partPerformers; 
   
- (NSArray *) noteSenders; 

- (int) status;

- setPartPerformerClass: (Class) aPartPerformerSubclass;
  
- (Class) partPerformerClass;

- (void) setDelegate: (id) object;

- delegate;

- (void) encodeWithCoder: (NSCoder *) aCoder;

- (id) initWithCoder: (NSCoder *) aDecoder;

@end

/* Describes the protocol that may be implemented by the delegate: */
#import "MKPerformerDelegate.h"

#endif

---