Century Embedded Technologies Nano-X SDK and Developer's Guide
PrevNext

GrReadArea

Name

GrReadArea -- Create a bitmap from the content of a drawable area

Synopsis

void GrReadArea (
  GR_DRAW_ID  id,
  GR_COORD    x,
  GR_COORD    y,
  GR_SIZE     width,
  GR_SIZE     height,
  GR_COLOR8 * colortable
);

Parameters

id

The ID of the window or other drawable area.

x, y

The location in the drawable area to draw the upper left corner of bitmap.

widht, height

The dimensions of the bitmap in pixels.

colortable

A pointer to a packed pixel bitmap large enough to hold the area from the screen.

Description

The GrReadArea function reads the color values from a specified rectangular area into a buffer. If other windows obscure the drawable area id, then the returned values inclued the values of the covering windows. Regions read outside the screen boundaries or from unmapped windows get set to black.

PrevHomeNext
GrRaiseWindowUpGrRect