LOTimingThread.h

00001 /*
00002  *
00003  * Copyright (c) 2006, Ben Suffolk <ben@usbdmx.com>
00004  * All rights reserved.
00005  *
00006  * Redistribution and use in source and binary forms, with or without 
00007  * modification, are permitted provided that the following conditions are met:
00008  *
00009  * 1. Redistributions of source code must retain the above copyright notice,
00010  *    this list of conditions and the following disclaimer.
00011  *
00012  * 2. Redistributions in binary form must reproduce the above copyright notice,
00013  *    this list of conditions and the following disclaimer in the documentation
00014  *    and/or other materials provided with the distribution.
00015  *
00016  * 3. Neither the name of the usbdmx.com web site nor the names of its 
00017  *    contributors may be used to endorse or promote products derived from this
00018  *    software without specific prior written permission.
00019  *
00020  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
00021  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
00022  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
00023  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
00024  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
00025  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
00026  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
00027  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
00028  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
00029  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00030  * POSSIBILITY OF SUCH DAMAGE.
00031  *
00032  * $Id: LOTimingThread.h 258 2010-06-07 09:35:39Z ben.suffolk $
00033  *
00034  */
00035 
00036 #import <Cocoa/Cocoa.h>
00037 
00038 #define LOTIMING_THREAD_STOP   0x01
00039 #define LOTIMING_THREAD_INVOKE 0x02
00040 
00041 #define LOTimingThreadDidCatchExceptionNotification @"LOTimingThreadDidCatchExceptionNotification"
00042 #define LOTimingThreadTapIntervalDidChange @"LOTimingThreadTapIntervalDidChange"
00043 #define LOTimingThreadDidCrash @"LOTimingThreadDidCrash"
00044 
00051 @interface LOTimingThread : NSObject
00052 {
00053  BOOL timingThreadRunning;    
00054  NSLock *threadRunningLock;   
00055  NSPort *timingPort;          
00056  NSThread *timingThread;      
00057  NSLock *lock;                
00058  NSLock *restartLock;         
00059  NSMutableArray *invocations; 
00060  
00061  NSDate *lastTap;                
00062  unsigned tapCount;              
00063  NSTimeInterval tapProgress[4];  
00064  NSTimeInterval tapInterval;     
00065 }
00066 
00067 
00073 - (void)stopThread;
00074 
00075 
00081 - (NSThread *)timingThread;
00082 
00083 
00092 - (BOOL)tap;
00093 
00094 
00102 - (NSTimeInterval)tapInterval;
00103 
00104 
00112 - (unsigned)tapBPM;
00113 
00114 
00120 + (LOTimingThread *)sharedTimingThread;
00121 
00122 
00128 - (void)performSelector:(SEL)aSelector onObject:(id)anObject;
00129 
00130 
00137 - (void)performSelector:(SEL)aSelector withObject:(id)anObject onObject:(id)theObject;
00138 
00139 
00146 - (void)performSelector:(SEL)aSelector withObject:(id)anObject withObject:(id)anotherObject onObject:(id)theObject;
00147 
00148 
00156 - (void)performSelector:(SEL)aSelector onObject:(id)theObject withParams:(void *)firstParam, ...;
00157 
00158 
00164 - (void)invoke:(NSInvocation *)invocation;
00165 
00166 
00167 @end