Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pd/pdlockoffscreen.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pd/pdlockoffscreen.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pd/pdlockoffscreen.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pd/pdlockoffscreen.html on line 8
Lock an offscreen context
int PdLockOffscreen( PdOffscreenContext_t *osc,
PdOSCLockParams_t *params );
- osc
- A pointer to the PdOffscreenContext_t structure for the
offscreen context.
You must call
PdCreateOffscreenLock()
to create an offscreen lock for this context before you call
PdLockOffscreen().
- params
- A pointer to a PdOSCLockParams_t structure (see below)
that defines parameters for the lock.
You can pass NULL for this argument.
ph
This function locks an offscreen context.
The PdOSCLockParams_t structure includes these members:
- uint32_t flags
- Flags, including:
- Pg_OSC_LOCK_TIMED_OUT — blocking occurs only until
the clock has gone past the value of the time_out member.
- struct timespec *time_out
- The absolute time at which to stop blocking if you've set
Pg_OSC_LOCK_TIMED_OUT in the flags member.
This behavior is like that of
sem_timedwait().
- EOK
- The context was succesfully locked.
- Pg_OSC_LOCK_TIMED_OUT
- Time out for lock occurred; the context wasn't locked.
- Pg_OSC_LOCK_INVALID
- The context lock is no longer valid (or never was in the first place
i.e. it wasn't created with PdCreateOffscreenLock()).
- Pg_OSC_LOCK_DEADLOCK
- A deadlock condition was detected.
Photon
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
PdCreateOffscreenLock(),
PdDestroyOffscreenLock(),
PdGetOffscreenContextPtr(),
PdIsOffscreenLocked(),
PdUnlockOffscreen()
“Offscreen locks”
in the Raw Drawing and Animation chapter of the
Photon Programmer's Guide
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pd/pdlockoffscreen.html on line 167
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pd/pdlockoffscreen.html on line 167