![]() |
![]() |
The GX is the base system for the majority of the Adaptive Recognition products. It is a collection of loadable modules and library functions and gives an ease to program interface to the hardware devices.
This file contains the descriptions of classes and functions of the image handling module.
Go to the source code of this file.
Data Structures | |
struct | gxIMAGE |
Structure which stores data of an image. More... | |
Typedefs | |
typedef struct gxIMAGE | gxIMAGE |
Workaround for ANSI C. | |
Enumerations | |
enum | GX_PIXELFORMATS { GX_UNDEF = 0x0000, GX_GRAY = 0x0001, GX_RGB555 = 0x0002, GX_BGR555 = 0x0003, GX_RGB565 = 0x0004, GX_BGR565 = 0x0005, GX_RGB = 0x0006, GX_BGR = 0x0007, GX_RGBA = 0x0008, GX_BGRA = 0x0009, GX_YUV422 = 0x000A, GX_GRAY12 = 0x000B, GX_RGB12 = 0x000C, GX_BGR12 = 0x000D, GX_GBRG = 0x000E, GX_BGGR = 0x000F, GX_RGGB = 0x0010, GX_GRBG = 0x0011, GX_FORMAT_FIRST = GX_GRAY, GX_FORMAT_LAST = GX_GRBG } |
Enumerations for pixel format. More... | |
enum | GX_IMGFILEFORMATS { GX_BMP = 1, GX_JPEG = 2, GX_JPEG2K_JPC = 3, GX_JPEG2K_JP2 = 4, GX_JPEG2K = GX_JPEG2K_JP2, GX_RAW = 5, GX_PNG = 6, GX_WSQ = 7 } |
Enumerations for image file format. More... | |
enum | GX_MIRRORFLAGS { GX_MIRROR_NOMIRROR = 0, GX_MIRROR_HORIZONTAL = 1, GX_MIRROR_VERTICAL = 2 } |
Enumerations for mirror operations. More... | |
enum | GX_ZOOMMODES { GX_ZOOM_NEAREST = 0, GX_ZOOM_LINEAR = 1 } |
Enumerations for zoom modes. More... | |
enum | GX_QUICKCONVERT { GX_CONVERT_NORMAL = 0, GX_CONVERT_QUICK = 1 } |
Enumerations for quick convert. More... | |
enum | GX_QUICKDISPLAY { GX_DISPLAY_NORMAL = 0, GX_DISPLAY_QUICK = 1 } |
Enumerations for quick display. More... | |
enum | GX_IMAGECOMMENTS { GX_IMGCOMM_GENERAL = 0, GX_IMGCOMM_JPEG_APP0, GX_IMGCOMM_JPEG_APP1, GX_IMGCOMM_JPEG_APP2, GX_IMGCOMM_JPEG_APP3, GX_IMGCOMM_JPEG_APP4, GX_IMGCOMM_JPEG_APP5, GX_IMGCOMM_JPEG_APP6, GX_IMGCOMM_JPEG_APP7, GX_IMGCOMM_JPEG_APP8, GX_IMGCOMM_JPEG_APP9, GX_IMGCOMM_JPEG_APP10, GX_IMGCOMM_JPEG_APP11, GX_IMGCOMM_JPEG_APP12, GX_IMGCOMM_JPEG_APP13, GX_IMGCOMM_JPEG_APP14, GX_IMGCOMM_JPEG_APP15, GX_IMGCOMM_INVALIDFORMAT } |
Enumerations for image comments. More... | |
enum | GX_IMAGEPROPERTIES1 { GX_IMGPROP_BMP_FORCE24BPP = GX_CALL_GROUP_GX_BMP, GX_IMGPROP_BMP_ENABLERLE, GX_IMGPROP_JPEG_SCALE_NUM = GX_CALL_GROUP_GX_JPEG, GX_IMGPROP_JPEG_SCALE_DENOM, GX_IMGPROP_JPEG_DCT_METHOD, GX_IMGPROP_JPEG_DO_FANCY_UPSAMPLING, GX_IMGPROP_JPEG_DO_BLOCK_SMOOTHING, GX_IMGPROP_JPEG_QUALITY, GX_IMGPROP_JPEG_PROGRESSIVE, GX_IMGPROP_JPEG_OPTIMIZE_CODING, GX_IMGPROP_JPEG_RESTART_INTERVAL, GX_IMGPROP_JPEG_RESTART_IN_ROWS, GX_IMGPROP_JPEG_SMOOTHING_FACTOR, GX_IMGPROP_JPEG2K_IMGAREATLX = GX_CALL_GROUP_GX_JPEG2K, GX_IMGPROP_JPEG2K_IMGAREATLY, GX_IMGPROP_JPEG2K_TILEGRDTLX, GX_IMGPROP_JPEG2K_TILEGRDTLY, GX_IMGPROP_JPEG2K_TILEWIDTH, GX_IMGPROP_JPEG2K_TILEHEIGHT, GX_IMGPROP_JPEG2K_PRCWIDTH, GX_IMGPROP_JPEG2K_PRCHEIGHT, GX_IMGPROP_JPEG2K_CBLKWIDTH, GX_IMGPROP_JPEG2K_CBLKHEIGHT, GX_IMGPROP_JPEG2K_MODE, GX_IMGPROP_JPEG2K_RATE, GX_IMGPROP_JPEG2K_ILYRRATES, GX_IMGPROP_JPEG2K_PRG, GX_IMGPROP_JPEG2K_NOMCT, GX_IMGPROP_JPEG2K_NUMRLVLS, GX_IMGPROP_JPEG2K_SOP, GX_IMGPROP_JPEG2K_EPH, GX_IMGPROP_JPEG2K_LAZY, GX_IMGPROP_JPEG2K_TERMALL, GX_IMGPROP_JPEG2K_SEGSYM, GX_IMGPROP_JPEG2K_VCAUSAL, GX_IMGPROP_JPEG2K_PTERM, GX_IMGPROP_JPEG2K_RESETPROB, GX_IMGPROP_JPEG2K_NUMGBITS, GX_IMGPROP_WSQ_BITRATE = GX_CALL_GROUP_GX_WSQ } |
Enumerations for image properties. More... | |
Functions | |
static gxi32 | gx_getpixelsize (gxHANDLE handle, gxi32 *size, gxi32 format) |
Returns the size of a pixel in bytes. | |
static gxi32 | gx_convertpixels (gxHANDLE handle, void *target, gxi32 tformat, gxi32 tsline, const void *source, gxi32 sformat, gxi32 ssline, gxi32 xsize, gxi32 ysize) |
Converts pixels to a specified format and size. | |
static gxi32 | gx_fastreconvert (gxHANDLE handle, void *pixels, gxi32 tformat, gxi32 sformat, gxi32 sline, gxi32 xsize, gxi32 ysize) |
Fast converts pixels to a specified format and size. | |
static gxi32 | gx_zoompixels (gxHANDLE handle, void *target, gxi32 tsline, gxi32 txsize, gxi32 tysize, const void *source, gxi32 ssline, gxi32 sxsize, gxi32 sysize, gxi32 format, gxi32 sx1_8, gxi32 sy1_8, gxi32 sx2_8, gxi32 sy2_8) |
Zooms pixels to a specified size. | |
static gxi32 | gx_rotatepixels (gxHANDLE handle, void *target, gxi32 tsline, gxi32 txsize, gxi32 tysize, const void *source, gxi32 ssline, gxi32 sxsize, gxi32 sysize, gxi32 format, gxi32 degree) |
Rotates pixels to a specified degree. | |
static gxi32 | gx_mirrorpixels (gxHANDLE handle, void *target, gxi32 tsline, gxi32 txsize, gxi32 tysize, const void *source, gxi32 ssline, gxi32 sxsize, gxi32 sysize, gxi32 format, gxi32 flags) |
Mirrors pixels to a specified mode. | |
static gxi32 | gx_initimage (gxHANDLE handle, gxIMAGE *pimage) |
Initialization of an image located on the heap or stack. | |
static gxi32 | gx_allocimage (gxHANDLE handle, gxIMAGE **pimage) |
This function allocates a blank image. | |
static gxi32 | gx_freeimage (gxHANDLE handle, gxIMAGE *pimage) |
Frees an image structure including the allocated pixel data. | |
static gxi32 | gx_refimage (gxHANDLE handle, gxIMAGE *pimage) |
Increases the image reference counter. | |
static gxi32 | gx_unrefimage (gxHANDLE handle, gxIMAGE *pimage) |
Decreases the image reference counter. | |
static gxi32 | gx_createimage (gxHANDLE handle, gxIMAGE *pimage, gxi32 format, gxi32 xsize, gxi32 ysize, gxi32 sline) |
Makes an image with proper size and format running on an initialized image structure. | |
static gxi32 | gx_convertimage (gxHANDLE handle, gxIMAGE *pdest, gxIMAGE *psrc, gxi32 format, gxi32 xsize, gxi32 ysize, gxi32 sline) |
Converts an image to a specific format and size. | |
static gxi32 | gx_zoomimage (gxHANDLE handle, gxIMAGE *pdest, gxi32 xsize, gxi32 ysize, gxi32 sline, gxIMAGE *psrc, gxi32 sx1_8, gxi32 sy1_8, gxi32 sx2_8, gxi32 sy2_8) |
Zooms an image to a specified size. | |
static gxi32 | gx_rotateimage (gxHANDLE handle, gxIMAGE *pdest, gxIMAGE *psrc, gxi32 degree) |
Rotates an image to a specified degree. | |
static gxi32 | gx_mirrorimage (gxHANDLE handle, gxIMAGE *pdest, gxIMAGE *psrc, gxi32 flags) |
Mirrors an image to a specified mode. | |
static gxi32 | gx_loadimage (gxHANDLE handle, gxIMAGE *pimage, const wchar_t *filename, gxi32 pixelformat) |
Loads an image from a mass storage device and converts it to a specific pixel format (Unicode version). | |
static gxi32 | gx_loadimagea (gxHANDLE handle, gxIMAGE *pimage, const char *filename, gxi32 pixelformat) |
Loads an image from a mass storage device and converts it to a specific pixel format (ASCII version). | |
static gxi32 | gx_saveimage (gxHANDLE handle, gxIMAGE *pimage, const wchar_t *filename, gxi32 fileformat) |
Saves an image to a mass storage device in the specific file format (Unicode version). | |
static gxi32 | gx_saveimagea (gxHANDLE handle, gxIMAGE *pimage, const char *filename, gxi32 fileformat) |
Saves an image to a mass storage device in the specific file format (ASCII version). | |
static gxi32 | gx_loadfrommem (gxHANDLE handle, gxIMAGE *pimage, const void *buffer, gxi32 buflen, gxi32 pixelformat) |
Loads an image from the memory and converts it to a specific pixel format. | |
static gxi32 | gx_savetomem (gxHANDLE handle, gxIMAGE *pimage, void **buffer, gxi32 *buflen, gxi32 fileformat) |
Saves an image in a specific file format to a specific memory area. | |
static gxi32 | gx_isvalidimage (gxHANDLE handle, const gxIMAGE *pimage) |
Checks if image structure is valid. | |
static gxi32 | gx_copyimage (gxHANDLE handle, gxIMAGE *target, gxIMAGE *source) |
Copies an image to another. | |
static gxi32 | gx_testimagefileformat (gxHANDLE handle, const wchar_t *filename, gxi32 *fileformat) |
Tests if a file is an image file. | |
static gxi32 | gx_testimagefileformata (gxHANDLE handle, const char *filename, gxi32 *fileformat) |
Tests if a file is an image file. | |
static gxi32 | gx_testimagefileformatmem (gxHANDLE handle, const void *buffer, gxi32 buflen, gxi32 *fileformat) |
Tests if a memory area contains an image file. | |
static gxi32 | gx_testimagefileformatid (gxHANDLE handle, const wchar_t *filename, wchar_t *formatid, gxi32 slen) |
Tests if a file is an image file. | |
static gxi32 | gx_testimagefileformatidmem (gxHANDLE handle, const void *buffer, gxi32 buflen, wchar_t *formatid, gxi32 slen) |
Tests if a memory area contains an image file. | |
static gxi32 | gx_imagetovariant (gxHANDLE handle, gxIMAGE *source, gxi32 varid, gxVARIANT *target) |
Embedds an image into a variant. | |
static gxi32 | gx_imagefromvariant (gxHANDLE handle, gxIMAGE **target, gxVARIANT source) |
Loads an embedded image from a variant. | |
static void * | gx_getpixelptr (gxHANDLE handle, gxIMAGE *pimage, gxi32 x, gxi32 y) |
Returns the pointer of the pixel. |
enum GX_PIXELFORMATS |
Enumerations for pixel format.
GX_UNDEF | Undefined format (for gx_loadimage() functions). |
GX_GRAY | 8 bit: 8 bit (grayscale) |
GX_RGB555 | 16 bit: 1-5-5-5 bit (0,R,G,B) |
GX_BGR555 | 16 bit: 1-5-5-5 bit (0,B,G,R) |
GX_RGB565 | 16 bit: 5-6-5 bit (R,G,B) |
GX_BGR565 | 16 bit: 5-6-5 bit (B,G,R) |
GX_RGB | 24 bit: 8-8-8 bit (R,G,B) |
GX_BGR | 24 bit: 8-8-8 bit (B,G,R) |
GX_RGBA | 32 bit: 8-8-8-8 bit (R,G,B,0) |
GX_BGRA | 32 bit: 8-8-8-8 bit (B,G,R,0) |
GX_YUV422 | 32 bit/2 pixel: 8-8-8-8 bit (U,Y1,V,Y2) |
GX_GRAY12 | 16 bit: 4-12 bit (0,grayscale) |
GX_RGB12 | 48 bit: 4-12-4-12-4-12 bit (0,R,0,G,0,B) |
GX_BGR12 | 48 bit: 4-12-4-12-4-12 bit (0,B,0,G,0,R) |
GX_GBRG | 32 bit/4 pixel: 8-8-8-8 bit Bayern-pattern (G,B,R,G) |
GX_BGGR | 32 bit/4 pixel: 8-8-8-8 bit Bayern-pattern (B,G,G,R) |
GX_RGGB | 32 bit/4 pixel: 8-8-8-8 bit Bayern-pattern (R,G,G,B) |
GX_GRBG | 32 bit/4 pixel: 8-8-8-8 bit Bayern-pattern (G,R,B,G) |
GX_FORMAT_FIRST | First available pixel format. |
GX_FORMAT_LAST | Last available pixel format. |
enum GX_IMGFILEFORMATS |
Enumerations for image file format.
enum GX_MIRRORFLAGS |
enum GX_ZOOMMODES |
enum GX_QUICKCONVERT |
enum GX_QUICKDISPLAY |
enum GX_IMAGECOMMENTS |
Enumerations for image comments.
enum GX_IMAGEPROPERTIES1 |
Enumerations for image properties.
static gxi32 gx_getpixelsize | ( | gxHANDLE | handle, | |
gxi32 * | size, | |||
gxi32 | format | |||
) | [static] |
Returns the size of a pixel in bytes.
handle | Handle of the module. | |
size | Size of the pixel format. | |
format | Pixel format (see GX_PIXELFORMATS). |
References gx_call().
static gxi32 gx_convertpixels | ( | gxHANDLE | handle, | |
void * | target, | |||
gxi32 | tformat, | |||
gxi32 | tsline, | |||
const void * | source, | |||
gxi32 | sformat, | |||
gxi32 | ssline, | |||
gxi32 | xsize, | |||
gxi32 | ysize | |||
) | [static] |
Converts pixels to a specified format and size.
handle | Handle of the module. | |
target | Pointer to a pixel data to where the function stores the data. | |
tformat | Pixel format of the target area (see GX_PIXELFORMATS). | |
tsline | Size of a row of the target area in bytes. | |
source | Pointer to a pixel data. | |
sformat | Pixel format of the source area (see GX_PIXELFORMATS). | |
ssline | Size of a row of the source area in bytes. | |
xsize | Horizontal size of the pixel area. | |
ysize | Vertical size of the pixel area. |
References gx_call().
static gxi32 gx_fastreconvert | ( | gxHANDLE | handle, | |
void * | pixels, | |||
gxi32 | tformat, | |||
gxi32 | sformat, | |||
gxi32 | sline, | |||
gxi32 | xsize, | |||
gxi32 | ysize | |||
) | [static] |
Fast converts pixels to a specified format and size.
The function is the same as gx_convertpixels(), only it works on the same memory area.
handle | Handle of the module. | |
pixels | Pointer to a pixel data. | |
tformat | Pixel format of the destination image (see GX_PIXELFORMATS). | |
sformat | Pixel format of the source image (see GX_PIXELFORMATS). | |
sline | Size of a row of the pixel area in bytes. | |
xsize | Horizontal size of the pixel area. | |
ysize | Vertical size of the pixel area. |
References gx_call().
static gxi32 gx_zoompixels | ( | gxHANDLE | handle, | |
void * | target, | |||
gxi32 | tsline, | |||
gxi32 | txsize, | |||
gxi32 | tysize, | |||
const void * | source, | |||
gxi32 | ssline, | |||
gxi32 | sxsize, | |||
gxi32 | sysize, | |||
gxi32 | format, | |||
gxi32 | sx1_8, | |||
gxi32 | sy1_8, | |||
gxi32 | sx2_8, | |||
gxi32 | sy2_8 | |||
) | [static] |
Zooms pixels to a specified size.
handle | Handle of the module. | |
target | Pointer to an allocated area where the zoom function places the converted image. | |
tsline | Size of a row of the destination area. | |
txsize | Horizontal size of the destination area. | |
tysize | Vertical size of the destination area. | |
source | Pointer to pixels of source area. | |
ssline | Size of a row of the source area. | |
sxsize | Horizontal size of the source area. | |
sysize | Vertical size of the source area. | |
format | Pixel format (see GX_PIXELFORMATS). | |
sx1_8 | Left coordinate of zoom area (shifted left with 8 bit = 256) | |
sy1_8 | Top coordinate of zoom area (shifted left with 8 bit = 256) | |
sx2_8 | Right coordinate of zoom area (shifted left with 8 bit = 256) | |
sy2_8 | Bottom coordinate of zoom area (shifted left with 8 bit = 256) |
References gx_call().
static gxi32 gx_rotatepixels | ( | gxHANDLE | handle, | |
void * | target, | |||
gxi32 | tsline, | |||
gxi32 | txsize, | |||
gxi32 | tysize, | |||
const void * | source, | |||
gxi32 | ssline, | |||
gxi32 | sxsize, | |||
gxi32 | sysize, | |||
gxi32 | format, | |||
gxi32 | degree | |||
) | [static] |
Rotates pixels to a specified degree.
handle | Handle of the module. | |
target | Pointer to an allocated area where the rotate function places the rotated image. | |
tsline | Size of a row of the destination area. | |
txsize | Horizontal size of the destination area. | |
tysize | Vertical size of the destination area. | |
source | Pointer to pixels of source area. | |
ssline | Size of a row of the source area. | |
sxsize | Horizontal size of the source area. | |
sysize | Vertical size of the source area. | |
format | Pixel format (see GX_PIXELFORMATS). | |
degree | Degree (Must be 0, 90, 180, 270). |
References gx_call().
static gxi32 gx_mirrorpixels | ( | gxHANDLE | handle, | |
void * | target, | |||
gxi32 | tsline, | |||
gxi32 | txsize, | |||
gxi32 | tysize, | |||
const void * | source, | |||
gxi32 | ssline, | |||
gxi32 | sxsize, | |||
gxi32 | sysize, | |||
gxi32 | format, | |||
gxi32 | flags | |||
) | [static] |
Mirrors pixels to a specified mode.
handle | Handle of the module. | |
target | Pointer to an allocated area where the mirror function places the mirrored image. | |
tsline | Size of a row of the destination area. | |
txsize | Horizontal size of the destination area. | |
tysize | Vertical size of the destination area. | |
source | Pointer to pixels of source area. | |
ssline | Size of a row of the source area. | |
sxsize | Horizontal size of the source area. | |
sysize | Vertical size of the source area. | |
format | Pixel format (see GX_PIXELFORMATS). | |
flags | Mirror flags. It can be GX_MIRROR_HORIZONTAL or/and GX_MIRROR_VERTICAL. (see GX_MIRRORFLAGS) |
References gx_call().
Returns the pointer of the pixel.
handle | Handle of the module. | |
pimage | Pointer to the image. | |
x | Horizontal position of the pixel. | |
y | Vertical position of the pixel. |
References gx_call().