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/pg/pgcreatedriverregion.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/pg/pgcreatedriverregion.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/pg/pgcreatedriverregion.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/pg/pgcreatedriverregion.html on line 8
Create a region that's owned by the graphics driver
PhRid_t PgCreateDriverRegion(
PdOffscreenContext_t *osc,
PhPoint_t *origin,
PhRect_t *rect,
PhRid_t parent );
- osc
- A pointer to the
PdOffscreenContext_t
structure for the offscreen context.
This argument must not be NULL.
- origin
- NULL, or a pointer to a
PhPoint_t
structure that specifies the origin of the region, relative to its parent.
The default is (0,0) if this argument is NULL.
- rect
- NULL, or a pointer to a
PhRect_t
structure that specifies the region rectangle, relative to its origin.
If this argument is NULL, the function uses a rectangle whose
members are set to 0.
- parent
- The ID of the parent region, or -1 if you don't want to specify it.
ph
PgCreateDriverRegion() creates a region that's owned by the
graphics driver and is sensitive to draw events.
The region parent defaults to the driver's input group's parent region.
PhRegionOpen()
defines all of the other default settings for the region.
All draw events collected by the driver region are targeted at
the specified offscreen context.
The driver region persists until you explicitly close it (which we don't
recommend) or until the corresponding offscreen context is destroyed.
A few notes:
- A single offscreen context is not usually associated with
more than one driver region.
- The draw event translation isn't cleared when the drawstream
is directed to the offscreen context.
- The driver region can be offset from its offscreen context using
PdSetOffscreenTranslation().
- Client applications can manipulate a driver region by using its region ID.
We don't generally recommend this.
- The driver region's handle (Ph_REGION_HANDLE) is reserved
for use by the graphics driver.
Don't change it.
- Since the region is owned by the graphics driver, all events
collected by the region — including input events — are
delivered to the graphics driver and not to the application that called
this function.
A nonnegative region id, or -1 if an error occurred.
- EFAULT
- The function couldn't access the offscreen context.
- EINVAL
- The osc argument is NULL, or the call to
PhRegionOpen() failed.
Photon
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
PdOffscreenContext_t,
PdSetOffscreenTranslation(),
PdSetTargetDevice(),
PhPoint_t,
PhRect_t,
PhRegionOpen()
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/pg/pgcreatedriverregion.html on line 202
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/pg/pgcreatedriverregion.html on line 202