juce/source/src/threads/juce_Process.h

   1 /*
   2   ==============================================================================
   3
   4    This file is part of the JUCE library - "Jules' Utility Class Extensions"
   5    Copyright 2004-11 by Raw Material Software Ltd.
   6
   7   ------------------------------------------------------------------------------
   8
   9    JUCE can be redistributed and/or modified under the terms of the GNU General
  10    Public License (Version 2), as published by the Free Software Foundation.
  11    A copy of the license is included in the JUCE distribution, or can be found
  12    online at www.gnu.org/licenses.
  13
  14    JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
  15    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  16    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  17
  18   ------------------------------------------------------------------------------
  19
  20    To release a closed-source product which uses JUCE, commercial licenses are
  21    available: visit www.rawmaterialsoftware.com/juce for more information.
  22
  23   ==============================================================================
  24 */
  25
  26 #ifndef __JUCE_PROCESS_JUCEHEADER__
  27 #define __JUCE_PROCESS_JUCEHEADER__
  28
  29 #include "../text/juce_String.h"
  30
  31
  32 //==============================================================================
  33 /** Represents the current executable's process.
  34
  35     This contains methods for controlling the current application at the
  36     process-level.
  37
  38     @see Thread, JUCEApplication
  39 */
  40 class JUCE_API  Process
  41 {
  42 public:
  43     //==============================================================================
  44     enum ProcessPriority
  45     {
  46         LowPriority         = 0,
  47         NormalPriority      = 1,
  48         HighPriority        = 2,
  49         RealtimePriority    = 3
  50     };
  51
  52     /** Changes the current process's priority.
  53
  54         @param priority     the process priority, where
  55                             0=low, 1=normal, 2=high, 3=realtime
  56     */
  57     static void setPriority (const ProcessPriority priority);
  58
  59     /** Kills the current process immediately.
  60
  61         This is an emergency process terminator that kills the application
  62         immediately - it's intended only for use only when something goes
  63         horribly wrong.
  64
  65         @see JUCEApplication::quit
  66     */
  67     static void terminate();
  68
  69     //==============================================================================
  70     /** Returns true if this application process is the one that the user is
  71         currently using.
  72     */
  73     static bool isForegroundProcess();
  74
  75     //==============================================================================
  76     /** Raises the current process's privilege level.
  77
  78         Does nothing if this isn't supported by the current OS, or if process
  79         privilege level is fixed.
  80     */
  81     static void raisePrivilege();
  82
  83     /** Lowers the current process's privilege level.
  84
  85         Does nothing if this isn't supported by the current OS, or if process
  86         privilege level is fixed.
  87     */
  88     static void lowerPrivilege();
  89
  90     //==============================================================================
  91     /** Returns true if this process is being hosted by a debugger.
  92     */
  93     static bool JUCE_CALLTYPE isRunningUnderDebugger();
  94
  95
  96 private:
  97     Process();
  98
  99     JUCE_DECLARE_NON_COPYABLE (Process);
 100 };
 101
 102
 103 #endif   // __JUCE_PROCESS_JUCEHEADER__