DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_get_specified_roi - extracts the specified ROI from an image object.

LIBRARY CALL

kobject xvw_get_specified_roi(
   xvobject image,
   int      shape,
   int      val,
   int      policy,
   int      x,
   int      y,
   unsigned int w,
   unsigned int h,
   unsigned int radius,
   unsigned int a,
   unsigned int b,
   int      x2,
   int      y2)

INPUT

OUTPUT

none

RETURN VALUE

The ROI kobject on success, NULL on failure

DESCRIPTION

Obtains a Region of Interest from the image object passed in, where the shape, location, and dimensions of the ROI are specified as parameters rather than interactively by the user; meant for use with a GUI allowing keyboard extraction. Provide values for ROI shape, the value to set in the mask for drawing, whether to fill the ROI shape or not, and ROI presentation policy. For the remaining positional and sizing arguments, specify desired values for those relevant to to the ROI shape specified; the others are ignored. This routine does not support multiple ROI extraction.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvisual/src/roi_util.c

SEE ALSO

xvisual(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.