All operations on displayed CAPI elements need to be in the thread (that is, the
mp:process) that runs their interface. On some platforms,
contain make a new thread. On Cocoa, all interfaces run in a single thread.
In most cases this issue does not arise, because CAPI callbacks are run in the correct thread. However, if your code needs to communicate with a CAPI window from a random thread, it should use
apply-in-pane-process-if-alive to send the function to the correct thread.
This is why the brief interactive examples in this manual generally use execute-with-interface or apply-in-pane-process when modifying a displayed CAPI element. In contrast, the demo example in Connecting an interface to an application is modified only by callbacks which run in the demo interface's own process, and so there is no need to use execute-with-interface or apply-in-pane-process.
Processes started by CAPI process events in the "standard" way, that is they call
mp:general-handle-event on objects that are sent to them by
mp:process-send. In particular, if you want to "schedule" an event to happen in the current after the current callback returns, you can use
mp:current-process-send. For example, if the
of an output-pane sometimes needs to start another interface, it would be a bad idea to do this inside the
, so instead of
(capi:display new-interface )
you can use
(mp:current-process-send `(capi:display , new-interface ))
which will cause it to happen later.
On systems other than Cocoa, when you run something that is lengthy inside a CAPI process, you can process events in a similar way to the way CAPI processes them by calling process-pending-messages, which processes all pending events and returns. However that may not always work well, because the processing of the event can do arbitrary things, so you should always consider running the lengthy computation in another process.
If your code needs to cause visible updates whilst continuing to do further computation, see Updating windows in real time.
CAPI User Guide and Reference Manual (Windows version) - 25 Feb 2015