SDL  2.0
SDL_systhread.cpp
Go to the documentation of this file.
1 /*
2  Simple DirectMedia Layer
3  Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
4 
5  This software is provided 'as-is', without any express or implied
6  warranty. In no event will the authors be held liable for any damages
7  arising from the use of this software.
8 
9  Permission is granted to anyone to use this software for any purpose,
10  including commercial applications, and to alter it and redistribute it
11  freely, subject to the following restrictions:
12 
13  1. The origin of this software must not be misrepresented; you must not
14  claim that you wrote the original software. If you use this software
15  in a product, an acknowledgment in the product documentation would be
16  appreciated but is not required.
17  2. Altered source versions must be plainly marked as such, and must not be
18  misrepresented as being the original software.
19  3. This notice may not be removed or altered from any source distribution.
20 */
21 #include "../../SDL_internal.h"
22 
23 /* Thread management routines for SDL */
24 
25 extern "C" {
26 #include "SDL_thread.h"
27 #include "../SDL_thread_c.h"
28 #include "../SDL_systhread.h"
29 #include "SDL_log.h"
30 }
31 
32 #include <mutex>
33 #include <thread>
34 #include <system_error>
35 
36 #ifdef __WINRT__
37 #include <Windows.h>
38 #endif
39 
40 static void
41 RunThread(void *args)
42 {
43  SDL_RunThread(args);
44 }
45 
46 extern "C"
47 int
48 SDL_SYS_CreateThread(SDL_Thread * thread, void *args)
49 {
50  try {
51  // !!! FIXME: no way to set a thread stack size here.
52  std::thread cpp_thread(RunThread, args);
53  thread->handle = (void *) new std::thread(std::move(cpp_thread));
54  return 0;
55  } catch (std::system_error & ex) {
56  SDL_SetError("unable to start a C++ thread: code=%d; %s", ex.code(), ex.what());
57  return -1;
58  } catch (std::bad_alloc &) {
60  return -1;
61  }
62 }
63 
64 extern "C"
65 void
67 {
68  // Make sure a thread ID gets assigned ASAP, for debugging purposes:
69  SDL_ThreadID();
70  return;
71 }
72 
73 extern "C"
76 {
77 #ifdef __WINRT__
78  return GetCurrentThreadId();
79 #else
80  // HACK: Mimick a thread ID, if one isn't otherwise available.
81  static thread_local SDL_threadID current_thread_id = 0;
82  static SDL_threadID next_thread_id = 1;
83  static std::mutex next_thread_id_mutex;
84 
85  if (current_thread_id == 0) {
86  std::lock_guard<std::mutex> lock(next_thread_id_mutex);
87  current_thread_id = next_thread_id;
88  ++next_thread_id;
89  }
90 
91  return current_thread_id;
92 #endif
93 }
94 
95 extern "C"
96 int
98 {
99 #ifdef __WINRT__
100  int value;
101 
102  if (priority == SDL_THREAD_PRIORITY_LOW) {
103  value = THREAD_PRIORITY_LOWEST;
104  }
105  else if (priority == SDL_THREAD_PRIORITY_HIGH) {
106  value = THREAD_PRIORITY_HIGHEST;
107  }
108  else if (priority == SDL_THREAD_PRIORITY_TIME_CRITICAL) {
109  // FIXME: WinRT does not support TIME_CRITICAL! -flibit
110  SDL_LogWarn(SDL_LOG_CATEGORY_SYSTEM, "TIME_CRITICAL unsupported, falling back to HIGHEST");
111  value = THREAD_PRIORITY_HIGHEST;
112  }
113  else {
114  value = THREAD_PRIORITY_NORMAL;
115  }
116  if (!SetThreadPriority(GetCurrentThread(), value)) {
117  return WIN_SetError("SetThreadPriority()");
118  }
119  return 0;
120 #else
121  return SDL_Unsupported();
122 #endif
123 }
124 
125 extern "C"
126 void
128 {
129  if ( ! thread) {
130  return;
131  }
132 
133  try {
134  std::thread * cpp_thread = (std::thread *) thread->handle;
135  if (cpp_thread->joinable()) {
136  cpp_thread->join();
137  }
138  } catch (std::system_error &) {
139  // An error occurred when joining the thread. SDL_WaitThread does not,
140  // however, seem to provide a means to report errors to its callers
141  // though!
142  }
143 }
144 
145 extern "C"
146 void
148 {
149  if ( ! thread) {
150  return;
151  }
152 
153  try {
154  std::thread * cpp_thread = (std::thread *) thread->handle;
155  if (cpp_thread->joinable()) {
156  cpp_thread->detach();
157  }
158  } catch (std::system_error &) {
159  // An error occurred when detaching the thread. SDL_DetachThread does not,
160  // however, seem to provide a means to report errors to its callers
161  // though!
162  }
163 }
164 
165 extern "C"
166 SDL_TLSData *
168 {
169  return SDL_Generic_GetTLSData();
170 }
171 
172 extern "C"
173 int
175 {
177 }
178 
179 /* vi: set ts=4 sw=4 expandtab: */
SDL_TLSData
Definition: SDL_thread_c.h:70
SDL_ThreadID
SDL_threadID SDL_ThreadID(void)
Definition: SDL_systhread.cpp:75
SDL_Generic_SetTLSData
int SDL_Generic_SetTLSData(SDL_TLSData *storage)
Definition: SDL_thread.c:163
if
set set set set set set set macro pixldst1 abits if abits op else op endif endm macro pixldst2 abits if abits op else op endif endm macro pixldst4 abits if abits op else op endif endm macro pixldst0 abits op endm macro pixldst3 mem_operand op endm macro pixldst30 mem_operand op endm macro pixldst abits if abits elseif abits elseif abits elseif abits elseif abits pixldst0 abits else pixldst0 abits pixldst0 abits pixldst0 abits pixldst0 abits endif elseif abits else pixldst0 abits pixldst0 abits endif elseif abits else error unsupported bpp *numpix else pixst endif endm macro pixld1_s mem_operand if asr adds SRC_WIDTH_FIXED bpl add asl mov asr adds SRC_WIDTH_FIXED bpl add asl mov asr adds SRC_WIDTH_FIXED bpl add asl mov asr adds SRC_WIDTH_FIXED bpl add asl elseif asr adds SRC_WIDTH_FIXED bpl add asl mov asr adds SRC_WIDTH_FIXED bpl add asl else error unsupported endif endm macro pixld2_s mem_operand if mov asr add asl add asl mov asr sub UNIT_X add asl mov asr add asl add asl mov asr add UNIT_X add asl else pixld1_s mem_operand pixld1_s mem_operand endif endm macro pixld0_s mem_operand if asr adds SRC_WIDTH_FIXED bpl add asl elseif asr adds SRC_WIDTH_FIXED bpl add asl endif endm macro pixld_s_internal mem_operand if mem_operand pixld2_s mem_operand pixdeinterleave basereg elseif mem_operand elseif mem_operand elseif mem_operand elseif mem_operand pixld0_s mem_operand else pixld0_s mem_operand pixld0_s mem_operand pixld0_s mem_operand pixld0_s mem_operand endif elseif mem_operand else pixld0_s mem_operand pixld0_s mem_operand endif elseif mem_operand else error unsupported mem_operand if bpp mem_operand endif endm macro vuzp8 reg2 vuzp d d &reg2 endm macro vzip8 reg2 vzip d d &reg2 endm macro pixdeinterleave basereg basereg basereg basereg basereg endif endm macro pixinterleave basereg basereg basereg basereg basereg endif endm macro PF boost_increment endif if endif PF tst PF addne PF subne PF cmp ORIG_W if endif if endif if endif PF subge ORIG_W PF subges if endif if endif if endif endif endm macro cache_preload_simple endif if dst_r_bpp pld[DST_R, #(PREFETCH_DISTANCE_SIMPLE *dst_r_bpp/8)] endif if mask_bpp pld if[MASK, #(PREFETCH_DISTANCE_SIMPLE *mask_bpp/8)] endif endif endm macro fetch_mask_pixblock pixld mask_basereg pixblock_size MASK endm macro ensure_destination_ptr_alignment process_pixblock_tail_head if beq irp skip1(dst_w_bpp<=(lowbit *8)) &&((lowbit *8)<(pixblock_size *dst_w_bpp)) .if lowbit< 16 tst DST_R
Definition: pixman-arm-neon-asm.h:469
SDL_SYS_DetachThread
void SDL_SYS_DetachThread(SDL_Thread *thread)
Definition: SDL_systhread.cpp:147
SDL_RunThread
void SDL_RunThread(void *data)
Definition: SDL_thread.c:271
SDL_THREAD_PRIORITY_TIME_CRITICAL
@ SDL_THREAD_PRIORITY_TIME_CRITICAL
Definition: SDL_thread.h:63
SDL_log.h
mutex
static SDL_mutex * mutex
Definition: testlock.c:23
SDL_THREAD_PRIORITY_HIGH
@ SDL_THREAD_PRIORITY_HIGH
Definition: SDL_thread.h:62
SDL_Thread
Definition: SDL_thread_c.h:54
SDL_THREAD_PRIORITY_LOW
@ SDL_THREAD_PRIORITY_LOW
Definition: SDL_thread.h:60
data
GLint GLenum GLsizei GLsizei GLsizei GLint GLsizei const GLvoid * data
Definition: SDL_opengl.h:1974
SDL_SYS_SetupThread
void SDL_SYS_SetupThread(const char *name)
Definition: SDL_systhread.cpp:66
SDL_SYS_WaitThread
void SDL_SYS_WaitThread(SDL_Thread *thread)
Definition: SDL_systhread.cpp:127
SDL_thread.h
name
GLuint const GLchar * name
Definition: SDL_opengl_glext.h:663
SDL_SYS_CreateThread
int SDL_SYS_CreateThread(SDL_Thread *thread, void *args)
Definition: SDL_systhread.cpp:48
SDL_SYS_GetTLSData
SDL_TLSData * SDL_SYS_GetTLSData(void)
Definition: SDL_systhread.cpp:167
SDL_OutOfMemory
#define SDL_OutOfMemory()
Definition: SDL_error.h:52
SDL_threadID
unsigned long SDL_threadID
Definition: SDL_thread.h:49
value
GLsizei const GLfloat * value
Definition: SDL_opengl_glext.h:701
SDL_SetError
#define SDL_SetError
Definition: SDL_dynapi_overrides.h:30
WIN_SetError
int WIN_SetError(const char *prefix)
SDL_Generic_GetTLSData
SDL_TLSData * SDL_Generic_GetTLSData(void)
Definition: SDL_thread.c:124
SDL_LOG_CATEGORY_SYSTEM
@ SDL_LOG_CATEGORY_SYSTEM
Definition: SDL_log.h:69
SDL_Thread::handle
SYS_ThreadHandle handle
Definition: SDL_thread_c.h:57
SDL_SYS_SetTLSData
int SDL_SYS_SetTLSData(SDL_TLSData *data)
Definition: SDL_systhread.cpp:174
SDL_Unsupported
#define SDL_Unsupported()
Definition: SDL_error.h:53
SDL_ThreadPriority
SDL_ThreadPriority
Definition: SDL_thread.h:59
RunThread
static void RunThread(void *args)
Definition: SDL_systhread.cpp:41
SDL_LogWarn
#define SDL_LogWarn
Definition: SDL_dynapi_overrides.h:35
SDL_SYS_SetThreadPriority
int SDL_SYS_SetThreadPriority(SDL_ThreadPriority priority)
Definition: SDL_systhread.cpp:97
lock
SDL_mutex * lock
Definition: SDL_events.c:83