OSCAddressSpace.h

#if IPHONE
#import <UIKit/UIKit.h>
#else
#import <Cocoa/Cocoa.h>
#endif
#import "OSCNode.h"




//  OSCAddressSpace delegate protocol
@protocol OSCAddressSpaceDelegateProtocol
- (void) nodeRenamed:(OSCNode *)n;
//  this method is called by other nodes in the address space replying to queries.  the passed message is the reply or error in response to a query- this response needs to be transmitted (sent via an output).  this response can probably be transmitted via OSCManager's "transmitReplyOrError:" method, but the OSC address space and the OSC manager aren't necessarily related so we have this as a separate delegate method.
- (void) queryResponseNeedsToBeSent:(OSCMessage *)m;
@end




//  this is the main instance of OSCAddressSpace.  it is auto-created when this class is initialized
extern id               _mainVVOSCAddressSpace;





@interface OSCAddressSpace : OSCNode {
    id          delegate;
}

+ (id) mainAddressSpace;
+ (void) refreshMenu;
#if !IPHONE
+ (NSMenu *) makeMenuForNode:(OSCNode *)n withTarget:(id)t action:(SEL)a;
+ (NSMenu *) makeMenuForNode:(OSCNode *)n ofType:(NSIndexSet *)ts withTarget:(id)t action:(SEL)a;
#endif

- (void) renameAddress:(NSString *)before to:(NSString *)after;
- (void) renameAddressArray:(NSArray *)before toArray:(NSArray *)after;

- (void) setNode:(OSCNode *)n forAddress:(NSString *)a;
- (void) setNode:(OSCNode *)n forAddress:(NSString *)a createIfMissing:(BOOL)c;
- (void) setNode:(OSCNode *)n forAddressArray:(NSArray *)a;
- (void) setNode:(OSCNode *)n forAddressArray:(NSArray *)a createIfMissing:(BOOL)c;

- (OSCNode *) findNodeForAddress:(NSString *)p createIfMissing:(BOOL)c;
- (NSMutableArray *) findNodesMatchingAddress:(NSString *)a;

//  this method is called whenever a node is added to another node
- (void) nodeRenamed:(OSCNode *)n;

- (void) dispatchMessage:(OSCMessage *)m;
//  Don't call this method externally- this gets called by an OSCNode inside me (or by me), and you probably won't need to ever call this method.  The passed message is a reply or error that needs to be sent back in response to a query.  The passed OSCMessage contains the IP address and port of the destination.  This method just passes the data on to the addres space's delegate- it does NOT actually send anything out, this is something you'll have to implement in the delegate.
- (void) _dispatchReplyOrError:(OSCMessage *)m;

- (void) addDelegate:(id)d forPath:(NSString *)p;
- (void) removeDelegate:(id)d forPath:(NSString *)p;
/*
- (void) addQueryDelegate:(id)d forPath:(NSString *)p;
- (void) removeQueryDelegate:(id)d forPath:(NSString *)p;
*/
@property (assign, readwrite) id delegate;


@end