This group of functions will allow you to apply a image transform that will correct some lens defects. More...
Classes | |
struct | lfModifier |
A modifier object contains optimized data required to rectify a image. More... | |
Defines | |
#define | LF_CR_1(a) (LF_CR_ ## a) |
This macro defines a pixel format consisting of one component. | |
#define | LF_CR_2(a, b) ((LF_CR_ ## a) | ((LF_CR_ ## b) << 4)) |
This macro defines a pixel format consisting of two components. | |
#define | LF_CR_3(a, b, c) |
This macro defines a pixel format consisting of three components. | |
#define | LF_CR_4(a, b, c, d) |
This macro defines a pixel format consisting of four components. | |
#define | LF_CR_5(a, b, c, d, e) |
This macro defines a pixel format consisting of five components. | |
#define | LF_CR_6(a, b, c, d, e, f) |
This macro defines a pixel format consisting of six components. | |
#define | LF_CR_7(a, b, c, d, e, f, g) |
This macro defines a pixel format consisting of seven components. | |
#define | LF_CR_8(a, b, c, d, e, f, g, h) |
This macro defines a pixel format consisting of seven components. | |
Typedefs | |
typedef void(* | lfSubpixelCoordFunc )(void *data, float *iocoord, int count) |
A callback function which modifies the separate coordinates for all color components for every pixel in a strip, This kind of callbacks are used in the first stage of image modification. | |
typedef void(* | lfModifyColorFunc )(void *data, float x, float y, void *pixels, int comp_role, int count) |
A callback function which modifies the colors of a strip of pixels This kind of callbacks are used in the second stage of image modification. | |
typedef void(* | lfModifyCoordFunc )(void *data, float *iocoord, int count) |
A callback function which modifies the coordinates of a strip of pixels. | |
Enumerations | |
enum | { LF_MODIFY_TCA = 0x00000001, LF_MODIFY_VIGNETTING = 0x00000002, LF_MODIFY_CCI = 0x00000004, LF_MODIFY_DISTORTION = 0x00000008, LF_MODIFY_GEOMETRY = 0x00000010, LF_MODIFY_SCALE = 0x00000020, LF_MODIFY_ALL = ~0 } |
A list of bitmask flags used for ordering various image corrections. More... | |
enum | lfPixelFormat { LF_PF_U8, LF_PF_U16, LF_PF_U32, LF_PF_F32, LF_PF_F64 } |
A list of pixel formats supported by internal colour callbacks. More... | |
enum | lfComponentRole { LF_CR_END = 0, LF_CR_NEXT, LF_CR_UNKNOWN, LF_CR_INTENSITY, LF_CR_RED, LF_CR_GREEN, LF_CR_BLUE } |
These constants define the role of every pixel component, four bits each. More... | |
Functions | |
lfModifier * | lf_modifier_new (const lfLens *lens, float crop, int width, int height) |
void | lf_modifier_destroy (lfModifier *modifier) |
int | lf_modifier_initialize (lfModifier *modifier, const lfLens *lens, lfPixelFormat format, float focal, float aperture, float distance, float scale, lfLensType targeom, int flags, cbool reverse) |
void | lf_modifier_add_coord_callback (lfModifier *modifier, lfModifyCoordFunc callback, int priority, void *data, size_t data_size) |
void | lf_modifier_add_subpixel_callback (lfModifier *modifier, lfSubpixelCoordFunc callback, int priority, void *data, size_t data_size) |
void | lf_modifier_add_color_callback (lfModifier *modifier, lfModifyColorFunc callback, int priority, void *data, size_t data_size) |
cbool | lf_modifier_add_subpixel_callback_TCA (lfModifier *modifier, lfLensCalibTCA *model, cbool reverse) |
cbool | lf_modifier_add_color_callback_vignetting (lfModifier *modifier, lfLensCalibVignetting *model, lfPixelFormat format, cbool reverse) |
cbool | lf_modifier_add_color_callback_CCI (lfModifier *modifier, const lfLens *lens, lfPixelFormat format, cbool reverse) |
cbool | lf_modifier_add_coord_callback_distortion (lfModifier *modifier, lfLensCalibDistortion *model, cbool reverse) |
cbool | lf_modifier_add_coord_callback_geometry (lfModifier *modifier, lfLensType from, lfLensType to, float focal) |
cbool | lf_modifier_add_coord_callback_scale (lfModifier *modifier, float scale, cbool reverse) |
float | lf_modifier_get_auto_scale (lfModifier *modifier, cbool reverse) |
cbool | lf_modifier_apply_subpixel_distortion (lfModifier *modifier, float xu, float yu, int width, int height, float *res) |
cbool | lf_modifier_apply_color_modification (lfModifier *modifier, void *pixels, float x, float y, int width, int height, int comp_role, int row_stride) |
cbool | lf_modifier_apply_geometry_distortion (lfModifier *modifier, float xu, float yu, int width, int height, float *res) |
cbool | lf_modifier_apply_subpixel_geometry_distortion (lfModifier *modifier, float xu, float yu, int width, int height, float *res) |
This group of functions will allow you to apply a image transform that will correct some lens defects.
#define LF_CR_3 | ( | a, | |||
b, | |||||
c | ) |
((LF_CR_ ## a) | ((LF_CR_ ## b) << 4) | \ ((LF_CR_ ## c) << 8))
This macro defines a pixel format consisting of three components.
#define LF_CR_4 | ( | a, | |||
b, | |||||
c, | |||||
d | ) |
((LF_CR_ ## a) | ((LF_CR_ ## b) << 4) | \ ((LF_CR_ ## c) << 8) | ((LF_CR_ ## d) << 12))
This macro defines a pixel format consisting of four components.
#define LF_CR_5 | ( | a, | |||
b, | |||||
c, | |||||
d, | |||||
e | ) |
((LF_CR_ ## a) | ((LF_CR_ ## b) << 4) | \ ((LF_CR_ ## c) << 8) | ((LF_CR_ ## d) << 12) | \ ((LF_CR_ ## e) << 16))
This macro defines a pixel format consisting of five components.
#define LF_CR_6 | ( | a, | |||
b, | |||||
c, | |||||
d, | |||||
e, | |||||
f | ) |
((LF_CR_ ## a) | ((LF_CR_ ## b) << 4) | \ ((LF_CR_ ## c) << 8) | ((LF_CR_ ## d) << 12) | \ ((LF_CR_ ## e) << 16) | ((LF_CR_ ## f) << 20))
This macro defines a pixel format consisting of six components.
#define LF_CR_7 | ( | a, | |||
b, | |||||
c, | |||||
d, | |||||
e, | |||||
f, | |||||
g | ) |
((LF_CR_ ## a) | ((LF_CR_ ## b) << 4) | \ ((LF_CR_ ## c) << 8) | ((LF_CR_ ## d) << 12) | \ ((LF_CR_ ## e) << 16) | ((LF_CR_ ## f) << 20) | \ ((LF_CR_ ## g) << 24))
This macro defines a pixel format consisting of seven components.
#define LF_CR_8 | ( | a, | |||
b, | |||||
c, | |||||
d, | |||||
e, | |||||
f, | |||||
g, | |||||
h | ) |
((LF_CR_ ## a) | ((LF_CR_ ## b) << 4) | \ ((LF_CR_ ## c) << 8) | ((LF_CR_ ## d) << 12) | \ ((LF_CR_ ## e) << 16) | ((LF_CR_ ## f) << 20) | \ ((LF_CR_ ## g) << 24) | ((LF_CR_ ## h) << 28))
This macro defines a pixel format consisting of seven components.
typedef void(* lfModifyColorFunc)(void *data, float x, float y, void *pixels, int comp_role, int count) |
A callback function which modifies the colors of a strip of pixels This kind of callbacks are used in the second stage of image modification.
data | A opaque pointer to some data. | |
x | The X coordinate of the beginning of the strip. For next pixels the X coordinate increments sequentialy. | |
y | The Y coordinate of the pixel strip. This is a constant across all pixels of the strip. | |
pixels | A pointer to pixel data. It is the responsability of the function inserting the callback into the chain to provide a callback operating with the correct pixel format. | |
comp_role | The role of every pixel component. This is a bitfield, made by one of the LF_CR_X macros which defines the roles of every pixel field. For example, LF_CR_4(RED,GREEN,BLUE,UNKNOWN) will define a RGBA (or RGBX) pixel format, and the UNKNOWN field will not be modified. | |
count | Number of pixels to proceed. |
typedef void(* lfModifyCoordFunc)(void *data, float *iocoord, int count) |
A callback function which modifies the coordinates of a strip of pixels.
This kind of callbacks are used in third stage of image modification.
data | A opaque pointer to some data. | |
iocoord | A pointer to an array count pixel coordinates (X,Y). The function must replace the coordinates with their new values. | |
count | Number of coordinate groups to handle. |
typedef void(* lfSubpixelCoordFunc)(void *data, float *iocoord, int count) |
A callback function which modifies the separate coordinates for all color components for every pixel in a strip, This kind of callbacks are used in the first stage of image modification.
data | A opaque pointer to some data. | |
iocoord | A pointer to an array of count*3 pixel coordinates (X,Y). The first coordinate pair is for the R component, second for G and third for B of same pixel. There are count*2*3 floats total in this array. | |
count | Number of coordinate groups to handle. |
anonymous enum |
A list of bitmask flags used for ordering various image corrections.
enum lfComponentRole |
These constants define the role of every pixel component, four bits each.
LF_CR_END |
This marks the end of the role list. It doesn't have to be specified explicitly, since LF_CR_X macros always pad the value with zeros |
LF_CR_NEXT |
This value tells that what follows applies to next pixel. This can be used to define Bayer images, e.g. use LF_CR_3(LF_CR_RED, LF_CR_NEXT, LF_CR_GREEN) for even rows and LF_CR_3(LF_CR_GREEN, LF_CR_NEXT, LF_CR_BLUE) for odd rows. |
LF_CR_UNKNOWN |
This component has an unknown/doesn't matter role. |
LF_CR_INTENSITY |
This is the pixel intensity (grayscale). |
LF_CR_RED |
This is the Red pixel component. |
LF_CR_GREEN |
This is the Green pixel component. |
LF_CR_BLUE |
This is the Blue pixel component. |
enum lfPixelFormat |
void lf_modifier_add_color_callback | ( | lfModifier * | modifier, | |
lfModifyColorFunc | callback, | |||
int | priority, | |||
void * | data, | |||
size_t | data_size | |||
) |
cbool lf_modifier_add_color_callback_CCI | ( | lfModifier * | modifier, | |
const lfLens * | lens, | |||
lfPixelFormat | format, | |||
cbool | reverse | |||
) |
cbool lf_modifier_add_color_callback_vignetting | ( | lfModifier * | modifier, | |
lfLensCalibVignetting * | model, | |||
lfPixelFormat | format, | |||
cbool | reverse | |||
) |
void lf_modifier_add_coord_callback | ( | lfModifier * | modifier, | |
lfModifyCoordFunc | callback, | |||
int | priority, | |||
void * | data, | |||
size_t | data_size | |||
) |
cbool lf_modifier_add_coord_callback_distortion | ( | lfModifier * | modifier, | |
lfLensCalibDistortion * | model, | |||
cbool | reverse | |||
) |
cbool lf_modifier_add_coord_callback_geometry | ( | lfModifier * | modifier, | |
lfLensType | from, | |||
lfLensType | to, | |||
float | focal | |||
) |
cbool lf_modifier_add_coord_callback_scale | ( | lfModifier * | modifier, | |
float | scale, | |||
cbool | reverse | |||
) |
void lf_modifier_add_subpixel_callback | ( | lfModifier * | modifier, | |
lfSubpixelCoordFunc | callback, | |||
int | priority, | |||
void * | data, | |||
size_t | data_size | |||
) |
cbool lf_modifier_add_subpixel_callback_TCA | ( | lfModifier * | modifier, | |
lfLensCalibTCA * | model, | |||
cbool | reverse | |||
) |
cbool lf_modifier_apply_color_modification | ( | lfModifier * | modifier, | |
void * | pixels, | |||
float | x, | |||
float | y, | |||
int | width, | |||
int | height, | |||
int | comp_role, | |||
int | row_stride | |||
) |
cbool lf_modifier_apply_geometry_distortion | ( | lfModifier * | modifier, | |
float | xu, | |||
float | yu, | |||
int | width, | |||
int | height, | |||
float * | res | |||
) |
cbool lf_modifier_apply_subpixel_distortion | ( | lfModifier * | modifier, | |
float | xu, | |||
float | yu, | |||
int | width, | |||
int | height, | |||
float * | res | |||
) |
cbool lf_modifier_apply_subpixel_geometry_distortion | ( | lfModifier * | modifier, | |
float | xu, | |||
float | yu, | |||
int | width, | |||
int | height, | |||
float * | res | |||
) |
void lf_modifier_destroy | ( | lfModifier * | modifier | ) |
float lf_modifier_get_auto_scale | ( | lfModifier * | modifier, | |
cbool | reverse | |||
) |
int lf_modifier_initialize | ( | lfModifier * | modifier, | |
const lfLens * | lens, | |||
lfPixelFormat | format, | |||
float | focal, | |||
float | aperture, | |||
float | distance, | |||
float | scale, | |||
lfLensType | targeom, | |||
int | flags, | |||
cbool | reverse | |||
) |
lfModifier* lf_modifier_new | ( | const lfLens * | lens, | |
float | crop, | |||
int | width, | |||
int | height | |||
) |