Mirrors_UI_SDK/fltk
1
0
Fork 0
mirror of https://github.com/fltk/fltk.git synced 2026-05-29 04:26:27 +08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Fixed documentation errors (typos and formatting) in chapter

Browse Source 
chapter "Advanced FLTK" (Multithreading) and added a short
explanation to sending and retrieving messages.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8047 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Albrecht Schlosser
2010-12-16 10:28:27 +00:00
parent 8ac8d3e8d7
commit e1887bf09c
1 changed files with 13 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/src/advanced.dox
+13 -10
View File
@@ -7,7 +7,7 @@ that will help you to get the most out of FLTK.
\section advanced_multithreading Multithreading \section advanced_multithreading Multithreading
FLTK supports multithreaded application using a locking mechanism FLTK supports multithreaded applications using a locking mechanism
based on "pthreads". We do not provide a threading interface as part of based on "pthreads". We do not provide a threading interface as part of
the library. However a simple example how threads can be implemented the library. However a simple example how threads can be implemented
for all supported platforms can be found in \p test/threads.h for all supported platforms can be found in \p test/threads.h
@@ -30,7 +30,7 @@ locked:
int main() { int main() {
Fl::lock(); Fl::lock();
/* run thread */ /* run thread */
while (Fl::wait() > 0) { while (Fl::wait() > 0) {
if (Fl::thread_message()) { if (Fl::thread_message()) {
/* process your data */ /* process your data */
} }
@@ -48,7 +48,7 @@ with calls to Fl::lock() and Fl::unlock():
Fl::unlock(); // allow other threads to access FLTK again Fl::unlock(); // allow other threads to access FLTK again
\endcode \endcode
You can send messages from child threads to the main thread You can send messages from child threads to the main thread
using Fl::awake(void* message): using Fl::awake(void* message):
\code \code
@@ -56,6 +56,9 @@ using Fl::awake(void* message):
Fl::awake(msg); // send "msg" to main thread Fl::awake(msg); // send "msg" to main thread
\endcode \endcode
A message can be anything you like. The main thread can retrieve
the message by calling Fl::thread_message(). See example above.
You can also tell the main thread to call a function for you You can also tell the main thread to call a function for you
as soon as possible by using as soon as possible by using
Fl::awake(Fl_Awake_Handler cb, void* userdata): Fl::awake(Fl_Awake_Handler cb, void* userdata):
@@ -70,18 +73,18 @@ Fl::awake(Fl_Awake_Handler cb, void* userdata):
Fl::awake(do_something, data); // call something in main thread Fl::awake(do_something, data); // call something in main thread
\endcode \endcode
FLTK supports multiple platforms, some of which allow only the FLTK supports multiple platforms, some of which allow only the
the main thread to handle system events and main thread to handle system events and open or close windows.
open or close windows. The safe thing to do is to adhere to the The safe thing to do is to adhere to the following rules for
following rules for threads on all operating systems: threads on all operating systems:
\li Don't \p show() or \p hide() anything that contains \li Don't \p show() or \p hide() anything that contains
widgets derived from Fl_Window, including dialogs, file widgets derived from Fl_Window, including dialogs, file
choosers, subwindows or those using Fl_Gl_Window. choosers, subwindows or those using Fl_Gl_Window.
\li Don't call Fl::wait(), Fl::flush() or any \li Don't call Fl::wait(), Fl::flush() or any
related methods that will handle system messages related methods that will handle system messages
\li Don't start or cancel timers \li Don't start or cancel timers
@@ -93,7 +96,7 @@ following rules for threads on all operating systems:
to allow for high speed rendering on graphics cards with multiple to allow for high speed rendering on graphics cards with multiple
pipelines pipelines
See also: See also:
Fl::awake(void* message), Fl::awake(void* message),
Fl::lock(), Fl::lock(),
Fl::thread_message(), Fl::thread_message(),