TINE Cycler API Calls File Reference

TINE Win32 DLL API routines: More...

Functions
void	SystemKillCycleTimer (void)
	Stops the TINE engine 'cycler' thread.
void	SystemStartCycleTimer (void)
	Starts a TINE engine 'cycler' running (SystemCycle()) in a separate thread.
void	SystemWaitCycleTimer (void)
	Waits for the TINE engine 'cycler' thread to stop running.

---

Detailed Description

TINE Win32 DLL API routines:

---

Function Documentation

void SystemKillCycleTimer

(

void

)

Stops the TINE engine 'cycler' thread.

Available in multi-threaded shared-library builds, this routine stops the separate thread where SystemCycle() runs in a tight loop (started via a call to SystemSetCycleTimer().

See also:

SystemStartCycleTimer().

References feclog().

void SystemStartCycleTimer

(

void

)

Starts a TINE engine 'cycler' running (SystemCycle()) in a separate thread.

Available in multi-threaded shared-library builds, this routine starts a separate thread where SystemCycle() is allowed to run in a tight loop. Only one instance of the cycler thread is allowed to run in a single process. On windows systems, the thread will also see to it that windows messages are allowed to be processed.

Note:

Using the Windows DLLs (tine32.dll or tine64.dll) this routine is automatically called when the DLL is loaded. When the shared library libtinemt.so is linked against, the routine is likewise automatically called when the library is loaded, but ONLY if either a) the library is built with -DTINE_START_CYCLER=TRUE or if the environment variable TINE_START_CYCLER = TRUE is set. Builds using the static libraries, tinemt.lib (WINDOWS) or libtinemt.a (UNIX) will need to include tcycler.c in the project in order to make use of this routine.

The developer is always at liberty to manage SystemCycle() in any manner he sees fit. and to, for instance, include other tasks which need to be cycled over together in the same managed loop. However, it should be guaranteed that SystemCycle() runs in a single thread per process.

See also:

SystemKillCycleTimer().

void SystemWaitCycleTimer

(

void

)

Waits for the TINE engine 'cycler' thread to stop running.

Available in multi-threaded shared-library builds, this routine waits for the cycler thread to stop running before continuing.

See also:

SystemStartCycleTimer().