1 /* 2 * Copyright (C) 2007, 2008 Apple Inc. All rights reserved. 3 * Copyright (C) 2007 Justin Haygood (jhaygood (at) reaktix.com) 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of 15 * its contributors may be used to endorse or promote products derived 16 * from this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY 19 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 20 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 21 * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY 22 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 23 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 24 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 25 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28 */ 29 30 #ifndef MainThread_h 31 #define MainThread_h 32 33 namespace WTF { 34 35 class Mutex; 36 37 typedef void MainThreadFunction(void*); 38 39 void callOnMainThread(MainThreadFunction*, void* context); 40 41 // Blocks the thread until the call finishes on the main thread. Misusing this can easily cause deadlocks. 42 void callOnMainThreadAndWait(MainThreadFunction*, void* context); 43 44 void setMainThreadCallbacksPaused(bool paused); 45 46 // Must be called from the main thread (Darwin is an exception to this rule). 47 void initializeMainThread(); 48 49 // These functions are internal to the callOnMainThread implementation. 50 void initializeMainThreadPlatform(); 51 void scheduleDispatchFunctionsOnMainThread(); 52 Mutex& mainThreadFunctionQueueMutex(); 53 void dispatchFunctionsFromMainThread(); 54 55 } // namespace WTF 56 57 using WTF::callOnMainThread; 58 using WTF::callOnMainThreadAndWait; 59 using WTF::setMainThreadCallbacksPaused; 60 61 #endif // MainThread_h 62
