readcomponent(3G)

NAME
     readcomponent - sets the component source within the framebuffer source
     for pixels that various routines read, useful primarily for monochrome
     image processing.

C SPECIFICATION
     void readcomponent(long mode)

PARAMETERS
     src    expects a symbolic constant that identifies the pixel component
            that is to be used:

            RC_ABGR Indicates that all 4 frame buffer components, ABGR should
            be transferred.  This is the default.

            RC_ALPHA selects the alpha channel of the current framebuffer
            selected by readsource.

            RC_BLUE selects the blue channel of the current framebuffer
            selected by readsource.

            RC_GREEN selects the green channel of the current framebuffer
            selected by readsource.

            RC_RED selects the red channel of the current framebuffer selected
            by readsource.

DESCRIPTION
     readcomponent specifies the component source buffer from the pixel source
     buffer that rectcopy, readpixels, readRGB, rectread, lrectread, and
     fbsubtexload use.

SEE ALSO
     lrectread, readpixels, readRGB, rectcopy, fbsubtexload

NOTES
     This subroutine is available only in immediate mode and only on
     RealityEngine systems running 5.0.1 or later.