OpenCV
3.2.0
Open Source Computer Vision
|
Modules | |
Connections with C++ | |
Classes | |
struct | CvAttrList |
List of attributes. : More... | |
struct | CvBox2D |
struct | CvChain |
struct | CvContour |
struct | CvFileNode |
struct | CvGraph |
struct | CvGraphEdge |
struct | CvGraphScanner |
struct | CvGraphVtx |
struct | CvGraphVtx2D |
struct | CvHistogram |
struct | CvLineIterator |
struct | CvMat |
struct | CvMatND |
struct | CvMemBlock |
struct | CvMemStorage |
struct | CvMemStoragePos |
struct | CvModuleInfo |
struct | CvNArrayIterator |
struct | CvPluginFuncInfo |
struct | CvPoint |
struct | CvPoint2D32f |
struct | CvPoint2D64f |
struct | CvPoint3D32f |
struct | CvPoint3D64f |
struct | CvRect |
struct | CvScalar |
struct | CvSeq |
struct | CvSeqBlock |
struct | CvSeqReader |
struct | CvSeqWriter |
struct | CvSet |
struct | CvSetElem |
struct | CvSize |
struct | CvSize2D32f |
struct | CvSlice |
struct | CvSparseMat |
struct | CvSparseMatIterator |
struct | CvSparseNode |
struct | CvString |
struct | CvStringHashNode |
struct | CvTermCriteria |
struct | CvTreeNodeIterator |
struct | CvTypeInfo |
Type information. More... | |
struct | IplConvKernel |
struct | IplConvKernelFP |
struct | IplImage |
struct | IplROI |
Typedefs | |
typedef void(CV_STDCALL * | Cv_iplAllocateImageData) (IplImage *, int, int) |
typedef IplImage *(CV_STDCALL * | Cv_iplCloneImage) (const IplImage *) |
typedef IplImage *(CV_STDCALL * | Cv_iplCreateImageHeader) (int, int, int, char *, char *, int, int, int, int, int, IplROI *, IplImage *, void *, IplTileInfo *) |
typedef IplROI *(CV_STDCALL * | Cv_iplCreateROI) (int, int, int, int, int) |
typedef void(CV_STDCALL * | Cv_iplDeallocate) (IplImage *, int) |
typedef void | CvArr |
This is the "metatype" used only as a function parameter. More... | |
typedef void *(* | CvCloneFunc) (const void *struct_ptr) |
typedef int(* | CvCmpFunc) (const void *a, const void *b, void *userdata) |
typedef int(* | CvErrorCallback) (int status, const char *func_name, const char *err_msg, const char *file_name, int line, void *userdata) |
typedef struct CvGenericHash | CvFileNodeHash |
typedef struct CvFileStorage | CvFileStorage |
"black box" representation of the file storage associated with a file on disk. More... | |
typedef struct CvFileStorage | CvFileStorage |
typedef int | CvHistType |
typedef int(* | CvIsInstanceFunc) (const void *struct_ptr) |
typedef CvContour | CvPoint2DSeq |
typedef void *(* | CvReadFunc) (CvFileStorage *storage, CvFileNode *node) |
typedef void(* | CvReleaseFunc) (void **struct_dblptr) |
typedef uint64 | CvRNG |
typedef int | CVStatus |
typedef void(* | CvWriteFunc) (CvFileStorage *storage, const char *name, const void *struct_ptr, CvAttrList attributes) |
typedef struct _IplTileInfo | IplTileInfo |
Functions | |
CvMat::CvMat (const cv::Mat &m) | |
void | cvAbsDiff (const CvArr *src1, const CvArr *src2, CvArr *dst) |
void | cvAbsDiffS (const CvArr *src, CvArr *dst, CvScalar value) |
void | cvAdd (const CvArr *src1, const CvArr *src2, CvArr *dst, const CvArr *mask=NULL) |
void | cvAddS (const CvArr *src, CvScalar value, CvArr *dst, const CvArr *mask=NULL) |
void | cvAddWeighted (const CvArr *src1, double alpha, const CvArr *src2, double beta, double gamma, CvArr *dst) |
void * | cvAlloc (size_t size) |
void | cvAnd (const CvArr *src1, const CvArr *src2, CvArr *dst, const CvArr *mask=NULL) |
void | cvAndS (const CvArr *src, CvScalar value, CvArr *dst, const CvArr *mask=NULL) |
CvAttrList | cvAttrList (const char **attr=NULL, CvAttrList *next=NULL) |
const char * | cvAttrValue (const CvAttrList *attr, const char *attr_name) |
CvScalar | cvAvg (const CvArr *arr, const CvArr *mask=NULL) |
void | cvAvgSdv (const CvArr *arr, CvScalar *mean, CvScalar *std_dev, const CvArr *mask=NULL) |
void | cvBackProjectPCA (const CvArr *proj, const CvArr *mean, const CvArr *eigenvects, CvArr *result) |
void | cvCalcCovarMatrix (const CvArr **vects, int count, CvArr *cov_mat, CvArr *avg, int flags) |
void | cvCalcPCA (const CvArr *data, CvArr *mean, CvArr *eigenvals, CvArr *eigenvects, int flags) |
void | cvCartToPolar (const CvArr *x, const CvArr *y, CvArr *magnitude, CvArr *angle=NULL, int angle_in_degrees=0) |
float | cvCbrt (float value) |
void | cvChangeSeqBlock (void *reader, int direction) |
int | cvCheckArr (const CvArr *arr, int flags=0, double min_val=0, double max_val=0) |
int | cvCheckHardwareSupport (int feature) |
CvTermCriteria | cvCheckTermCriteria (CvTermCriteria criteria, double default_eps, int default_max_iters) |
void | cvClearGraph (CvGraph *graph) |
void | cvClearMemStorage (CvMemStorage *storage) |
void | cvClearND (CvArr *arr, const int *idx) |
void | cvClearSeq (CvSeq *seq) |
void | cvClearSet (CvSet *set_header) |
void * | cvClone (const void *struct_ptr) |
Makes a clone of an object. More... | |
CvGraph * | cvCloneGraph (const CvGraph *graph, CvMemStorage *storage) |
IplImage * | cvCloneImage (const IplImage *image) |
CvMat * | cvCloneMat (const CvMat *mat) |
CvMatND * | cvCloneMatND (const CvMatND *mat) |
CvSeq * | cvCloneSeq (const CvSeq *seq, CvMemStorage *storage=NULL) |
CvSparseMat * | cvCloneSparseMat (const CvSparseMat *mat) |
void | cvCmp (const CvArr *src1, const CvArr *src2, CvArr *dst, int cmp_op) |
void | cvCmpS (const CvArr *src, double value, CvArr *dst, int cmp_op) |
void | cvCompleteSymm (CvMat *matrix, int LtoR=0) |
void | cvConvertScale (const CvArr *src, CvArr *dst, double scale=1, double shift=0) |
Converts one array to another with optional linear transformation. More... | |
void | cvConvertScaleAbs (const CvArr *src, CvArr *dst, double scale=1, double shift=0) |
void | cvCopy (const CvArr *src, CvArr *dst, const CvArr *mask=NULL) |
Copies one array to another. More... | |
int | cvCountNonZero (const CvArr *arr) |
CvMemStorage * | cvCreateChildMemStorage (CvMemStorage *parent) |
void | cvCreateData (CvArr *arr) |
Allocates array data. More... | |
CvGraph * | cvCreateGraph (int graph_flags, int header_size, int vtx_size, int edge_size, CvMemStorage *storage) |
CvGraphScanner * | cvCreateGraphScanner (CvGraph *graph, CvGraphVtx *vtx=NULL, int mask=-1) |
IplImage * | cvCreateImage (CvSize size, int depth, int channels) |
Creates an image header and allocates the image data. More... | |
IplImage * | cvCreateImageHeader (CvSize size, int depth, int channels) |
Creates an image header but does not allocate the image data. More... | |
CvMat * | cvCreateMat (int rows, int cols, int type) |
Creates a matrix header and allocates the matrix data. More... | |
CvMat * | cvCreateMatHeader (int rows, int cols, int type) |
Creates a matrix header but does not allocate the matrix data. More... | |
CvMatND * | cvCreateMatND (int dims, const int *sizes, int type) |
Creates the header and allocates the data for a multi-dimensional dense array. More... | |
CvMatND * | cvCreateMatNDHeader (int dims, const int *sizes, int type) |
Creates a new matrix header but does not allocate the matrix data. More... | |
CvMemStorage * | cvCreateMemStorage (int block_size=0) |
CvSeq * | cvCreateSeq (int seq_flags, size_t header_size, size_t elem_size, CvMemStorage *storage) |
void | cvCreateSeqBlock (CvSeqWriter *writer) |
CvSet * | cvCreateSet (int set_flags, int header_size, int elem_size, CvMemStorage *storage) |
CvSparseMat * | cvCreateSparseMat (int dims, const int *sizes, int type) |
Creates sparse array. More... | |
CvSparseMat * | cvCreateSparseMat (const cv::SparseMat &m) |
void | cvCrossProduct (const CvArr *src1, const CvArr *src2, CvArr *dst) |
Calculates the cross product of two 3D vectors. More... | |
void * | cvCvtSeqToArray (const CvSeq *seq, void *elements, CvSlice slice=CV_WHOLE_SEQ) |
void | cvDCT (const CvArr *src, CvArr *dst, int flags) |
void | cvDecRefData (CvArr *arr) |
Decrements an array data reference counter. More... | |
double | cvDet (const CvArr *mat) |
void | cvDFT (const CvArr *src, CvArr *dst, int flags, int nonzero_rows=0) |
void | cvDiv (const CvArr *src1, const CvArr *src2, CvArr *dst, double scale=1) |
double | cvDotProduct (const CvArr *src1, const CvArr *src2) |
Calculates the dot product of two arrays in Euclidean metrics. More... | |
void | cvEigenVV (CvArr *mat, CvArr *evects, CvArr *evals, double eps=0, int lowindex=-1, int highindex=-1) |
CvSeq * | cvEndWriteSeq (CvSeqWriter *writer) |
void | cvEndWriteStruct (CvFileStorage *fs) |
Finishes writing to a file node collection. More... | |
void | cvError (int status, const char *func_name, const char *err_msg, const char *file_name, int line) |
int | cvErrorFromIppStatus (int ipp_status) |
const char * | cvErrorStr (int status) |
void | cvExp (const CvArr *src, CvArr *dst) |
float | cvFastArctan (float y, float x) |
CvGraphEdge * | cvFindGraphEdge (const CvGraph *graph, int start_idx, int end_idx) |
CvGraphEdge * | cvFindGraphEdgeByPtr (const CvGraph *graph, const CvGraphVtx *start_vtx, const CvGraphVtx *end_vtx) |
CvTypeInfo * | cvFindType (const char *type_name) |
Finds a type by its name. More... | |
CvTypeInfo * | cvFirstType (void) |
Returns the beginning of a type list. More... | |
void | cvFlip (const CvArr *src, CvArr *dst=NULL, int flip_mode=0) |
void | cvFlushSeqWriter (CvSeqWriter *writer) |
void | cvFree_ (void *ptr) |
void | cvGEMM (const CvArr *src1, const CvArr *src2, double alpha, const CvArr *src3, double beta, CvArr *dst, int tABC=0) |
CvScalar | cvGet1D (const CvArr *arr, int idx0) |
Return a specific array element. More... | |
CvScalar | cvGet2D (const CvArr *arr, int idx0, int idx1) |
CvScalar | cvGet3D (const CvArr *arr, int idx0, int idx1, int idx2) |
CvMat * | cvGetCol (const CvArr *arr, CvMat *submat, int col) |
CvMat * | cvGetCols (const CvArr *arr, CvMat *submat, int start_col, int end_col) |
Returns one of more array columns. More... | |
CvMat * | cvGetDiag (const CvArr *arr, CvMat *submat, int diag=0) |
Returns one of array diagonals. More... | |
int | cvGetDims (const CvArr *arr, int *sizes=NULL) |
Return number of array dimensions. More... | |
int | cvGetDimSize (const CvArr *arr, int index) |
Returns array size along the specified dimension. More... | |
int | cvGetElemType (const CvArr *arr) |
Returns type of array elements. More... | |
int | cvGetErrInfo (const char **errcode_desc, const char **description, const char **filename, int *line) |
int | cvGetErrMode (void) |
int | cvGetErrStatus (void) |
CvFileNode * | cvGetFileNode (CvFileStorage *fs, CvFileNode *map, const CvStringHashNode *key, int create_missing=0) |
Finds a node in a map or file storage. More... | |
CvFileNode * | cvGetFileNodeByName (const CvFileStorage *fs, const CvFileNode *map, const char *name) |
Finds a node in a map or file storage. More... | |
const char * | cvGetFileNodeName (const CvFileNode *node) |
Returns the name of a file node. More... | |
CvStringHashNode * | cvGetHashedKey (CvFileStorage *fs, const char *name, int len=-1, int create_missing=0) |
Returns a unique pointer for a given name. More... | |
IplImage * | cvGetImage (const CvArr *arr, IplImage *image_header) |
Returns image header for arbitrary array. More... | |
int | cvGetImageCOI (const IplImage *image) |
Returns the index of the channel of interest. More... | |
CvRect | cvGetImageROI (const IplImage *image) |
Returns the image ROI. More... | |
CvMat * | cvGetMat (const CvArr *arr, CvMat *header, int *coi=NULL, int allowND=0) |
Returns matrix header for arbitrary array. More... | |
CvScalar | cvGetND (const CvArr *arr, const int *idx) |
CvSparseNode * | cvGetNextSparseNode (CvSparseMatIterator *mat_iterator) |
Returns the next sparse matrix element. More... | |
int | cvGetNumThreads (void) |
int | cvGetOptimalDFTSize (int size0) |
void | cvGetRawData (const CvArr *arr, uchar **data, int *step=NULL, CvSize *roi_size=NULL) |
Retrieves low-level information about the array. More... | |
double | cvGetReal1D (const CvArr *arr, int idx0) |
Return a specific element of single-channel 1D, 2D, 3D or nD array. More... | |
double | cvGetReal2D (const CvArr *arr, int idx0, int idx1) |
double | cvGetReal3D (const CvArr *arr, int idx0, int idx1, int idx2) |
double | cvGetRealND (const CvArr *arr, const int *idx) |
CvFileNode * | cvGetRootFileNode (const CvFileStorage *fs, int stream_index=0) |
Retrieves one of the top-level nodes of the file storage. More... | |
CvMat * | cvGetRow (const CvArr *arr, CvMat *submat, int row) |
CvMat * | cvGetRows (const CvArr *arr, CvMat *submat, int start_row, int end_row, int delta_row=1) |
Returns array row or row span. More... | |
schar * | cvGetSeqElem (const CvSeq *seq, int index) |
int | cvGetSeqReaderPos (CvSeqReader *reader) |
CvSetElem * | cvGetSetElem (const CvSet *set_header, int idx) |
CvSize | cvGetSize (const CvArr *arr) |
Returns size of matrix or image ROI. More... | |
CvMat * | cvGetSubRect (const CvArr *arr, CvMat *submat, CvRect rect) |
Returns matrix header corresponding to the rectangular sub-array of input image or matrix. More... | |
int | cvGetThreadNum (void) |
int64 | cvGetTickCount (void) |
double | cvGetTickFrequency (void) |
int | cvGraphAddEdge (CvGraph *graph, int start_idx, int end_idx, const CvGraphEdge *edge=NULL, CvGraphEdge **inserted_edge=NULL) |
int | cvGraphAddEdgeByPtr (CvGraph *graph, CvGraphVtx *start_vtx, CvGraphVtx *end_vtx, const CvGraphEdge *edge=NULL, CvGraphEdge **inserted_edge=NULL) |
int | cvGraphAddVtx (CvGraph *graph, const CvGraphVtx *vtx=NULL, CvGraphVtx **inserted_vtx=NULL) |
void | cvGraphRemoveEdge (CvGraph *graph, int start_idx, int end_idx) |
void | cvGraphRemoveEdgeByPtr (CvGraph *graph, CvGraphVtx *start_vtx, CvGraphVtx *end_vtx) |
int | cvGraphRemoveVtx (CvGraph *graph, int index) |
int | cvGraphRemoveVtxByPtr (CvGraph *graph, CvGraphVtx *vtx) |
int | cvGraphVtxDegree (const CvGraph *graph, int vtx_idx) |
int | cvGraphVtxDegreeByPtr (const CvGraph *graph, const CvGraphVtx *vtx) |
int | cvGuiBoxReport (int status, const char *func_name, const char *err_msg, const char *file_name, int line, void *userdata) |
int | cvIncRefData (CvArr *arr) |
Increments array data reference counter. More... | |
IplImage * | cvInitImageHeader (IplImage *image, CvSize size, int depth, int channels, int origin=0, int align=4) |
Initializes an image header that was previously allocated. More... | |
CvMat * | cvInitMatHeader (CvMat *mat, int rows, int cols, int type, void *data=NULL, int step=0x7fffffff) |
Initializes a pre-allocated matrix header. More... | |
CvMatND * | cvInitMatNDHeader (CvMatND *mat, int dims, const int *sizes, int type, void *data=NULL) |
Initializes a pre-allocated multi-dimensional array header. More... | |
int | cvInitNArrayIterator (int count, CvArr **arrs, const CvArr *mask, CvMatND *stubs, CvNArrayIterator *array_iterator, int flags=0) |
CvSparseNode * | cvInitSparseMatIterator (const CvSparseMat *mat, CvSparseMatIterator *mat_iterator) |
Initializes sparse array elements iterator. More... | |
void | cvInitTreeNodeIterator (CvTreeNodeIterator *tree_iterator, const void *first, int max_level) |
void | cvInRange (const CvArr *src, const CvArr *lower, const CvArr *upper, CvArr *dst) |
void | cvInRangeS (const CvArr *src, CvScalar lower, CvScalar upper, CvArr *dst) |
void | cvInsertNodeIntoTree (void *node, void *parent, void *frame) |
double | cvInvert (const CvArr *src, CvArr *dst, int method=0) |
int | cvIplDepth (int type) |
int | cvKMeans2 (const CvArr *samples, int cluster_count, CvArr *labels, CvTermCriteria termcrit, int attempts=1, CvRNG *rng=0, int flags=0, CvArr *_centers=0, double *compactness=0) |
void * | cvLoad (const char *filename, CvMemStorage *memstorage=NULL, const char *name=NULL, const char **real_name=NULL) |
Loads an object from a file. More... | |
void | cvLog (const CvArr *src, CvArr *dst) |
void | cvLUT (const CvArr *src, CvArr *dst, const CvArr *lut) |
double | cvMahalanobis (const CvArr *vec1, const CvArr *vec2, const CvArr *mat) |
CvSeq * | cvMakeSeqHeaderForArray (int seq_type, int header_size, int elem_size, void *elements, int total, CvSeq *seq, CvSeqBlock *block) |
CvMat | cvMat (int rows, int cols, int type, void *data=NULL) |
void | cvMax (const CvArr *src1, const CvArr *src2, CvArr *dst) |
void | cvMaxS (const CvArr *src, double value, CvArr *dst) |
void * | cvMemStorageAlloc (CvMemStorage *storage, size_t size) |
CvString | cvMemStorageAllocString (CvMemStorage *storage, const char *ptr, int len=-1) |
void | cvMerge (const CvArr *src0, const CvArr *src1, const CvArr *src2, const CvArr *src3, CvArr *dst) |
double | cvmGet (const CvMat *mat, int row, int col) |
Returns the particular element of single-channel floating-point matrix. More... | |
void | cvMin (const CvArr *src1, const CvArr *src2, CvArr *dst) |
void | cvMinMaxLoc (const CvArr *arr, double *min_val, double *max_val, CvPoint *min_loc=NULL, CvPoint *max_loc=NULL, const CvArr *mask=NULL) |
void | cvMinS (const CvArr *src, double value, CvArr *dst) |
void | cvMixChannels (const CvArr **src, int src_count, CvArr **dst, int dst_count, const int *from_to, int pair_count) |
void | cvmSet (CvMat *mat, int row, int col, double value) |
Sets a specific element of a single-channel floating-point matrix. More... | |
void | cvMul (const CvArr *src1, const CvArr *src2, CvArr *dst, double scale=1) |
void | cvMulSpectrums (const CvArr *src1, const CvArr *src2, CvArr *dst, int flags) |
void | cvMulTransposed (const CvArr *src, CvArr *dst, int order, const CvArr *delta=NULL, double scale=1.) |
int | cvNextGraphItem (CvGraphScanner *scanner) |
int | cvNextNArraySlice (CvNArrayIterator *array_iterator) |
void * | cvNextTreeNode (CvTreeNodeIterator *tree_iterator) |
double | cvNorm (const CvArr *arr1, const CvArr *arr2=NULL, int norm_type=4, const CvArr *mask=NULL) |
void | cvNormalize (const CvArr *src, CvArr *dst, double a=1., double b=0., int norm_type=4, const CvArr *mask=NULL) |
void | cvNot (const CvArr *src, CvArr *dst) |
int | cvNulDevReport (int status, const char *func_name, const char *err_msg, const char *file_name, int line, void *userdata) |
CvFileStorage * | cvOpenFileStorage (const char *filename, CvMemStorage *memstorage, int flags, const char *encoding=NULL) |
Opens file storage for reading or writing data. More... | |
void | cvOr (const CvArr *src1, const CvArr *src2, CvArr *dst, const CvArr *mask=NULL) |
void | cvOrS (const CvArr *src, CvScalar value, CvArr *dst, const CvArr *mask=NULL) |
void | cvPerspectiveTransform (const CvArr *src, CvArr *dst, const CvMat *mat) |
CvPoint | cvPoint (int x, int y) |
CvPoint2D32f | cvPoint2D32f (double x, double y) |
CvPoint2D64f | cvPoint2D64f (double x, double y) |
CvPoint3D32f | cvPoint3D32f (double x, double y, double z) |
CvPoint3D64f | cvPoint3D64f (double x, double y, double z) |
CvPoint | cvPointFrom32f (CvPoint2D32f point) |
CvPoint2D32f | cvPointTo32f (CvPoint point) |
void | cvPolarToCart (const CvArr *magnitude, const CvArr *angle, CvArr *x, CvArr *y, int angle_in_degrees=0) |
void | cvPow (const CvArr *src, CvArr *dst, double power) |
void * | cvPrevTreeNode (CvTreeNodeIterator *tree_iterator) |
void | cvProjectPCA (const CvArr *data, const CvArr *mean, const CvArr *eigenvects, CvArr *result) |
uchar * | cvPtr1D (const CvArr *arr, int idx0, int *type=NULL) |
Return pointer to a particular array element. More... | |
uchar * | cvPtr2D (const CvArr *arr, int idx0, int idx1, int *type=NULL) |
uchar * | cvPtr3D (const CvArr *arr, int idx0, int idx1, int idx2, int *type=NULL) |
uchar * | cvPtrND (const CvArr *arr, const int *idx, int *type=NULL, int create_node=1, unsigned *precalc_hashval=NULL) |
void | cvRandArr (CvRNG *rng, CvArr *arr, int dist_type, CvScalar param1, CvScalar param2) |
Fills an array with random numbers and updates the RNG state. More... | |
unsigned | cvRandInt (CvRNG *rng) |
Returns a 32-bit unsigned integer and updates RNG. More... | |
double | cvRandReal (CvRNG *rng) |
Returns a floating-point random number and updates RNG. More... | |
void | cvRandShuffle (CvArr *mat, CvRNG *rng, double iter_factor=1.) |
CvArr * | cvRange (CvArr *mat, double start, double end) |
void | cvRawDataToScalar (const void *data, int type, CvScalar *scalar) |
void * | cvRead (CvFileStorage *fs, CvFileNode *node, CvAttrList *attributes=NULL) |
Decodes an object and returns a pointer to it. More... | |
void * | cvReadByName (CvFileStorage *fs, const CvFileNode *map, const char *name, CvAttrList *attributes=NULL) |
Finds an object by name and decodes it. More... | |
int | cvReadInt (const CvFileNode *node, int default_value=0) |
Retrieves an integer value from a file node. More... | |
int | cvReadIntByName (const CvFileStorage *fs, const CvFileNode *map, const char *name, int default_value=0) |
Finds a file node and returns its value. More... | |
void | cvReadRawData (const CvFileStorage *fs, const CvFileNode *src, void *dst, const char *dt) |
Reads multiple numbers. More... | |
void | cvReadRawDataSlice (const CvFileStorage *fs, CvSeqReader *reader, int count, void *dst, const char *dt) |
Initializes file node sequence reader. More... | |
double | cvReadReal (const CvFileNode *node, double default_value=0.) |
Retrieves a floating-point value from a file node. More... | |
double | cvReadRealByName (const CvFileStorage *fs, const CvFileNode *map, const char *name, double default_value=0.) |
Finds a file node and returns its value. More... | |
const char * | cvReadString (const CvFileNode *node, const char *default_value=NULL) |
Retrieves a text string from a file node. More... | |
const char * | cvReadStringByName (const CvFileStorage *fs, const CvFileNode *map, const char *name, const char *default_value=NULL) |
Finds a file node by its name and returns its value. More... | |
CvScalar | cvRealScalar (double val0) |
CvRect | cvRect (int x, int y, int width, int height) |
IplROI | cvRectToROI (CvRect rect, int coi) |
CvErrorCallback | cvRedirectError (CvErrorCallback error_handler, void *userdata=NULL, void **prev_userdata=NULL) |
void | cvReduce (const CvArr *src, CvArr *dst, int dim=-1, int op=0) |
void | cvRegisterType (const CvTypeInfo *info) |
Registers a new type. More... | |
void | cvRelease (void **struct_ptr) |
Releases an object. More... | |
void | cvReleaseData (CvArr *arr) |
Releases array data. More... | |
void | cvReleaseFileStorage (CvFileStorage **fs) |
Releases file storage. More... | |
void | cvReleaseGraphScanner (CvGraphScanner **scanner) |
void | cvReleaseImage (IplImage **image) |
Deallocates the image header and the image data. More... | |
void | cvReleaseImageHeader (IplImage **image) |
Deallocates an image header. More... | |
void | cvReleaseMat (CvMat **mat) |
Deallocates a matrix. More... | |
void | cvReleaseMatND (CvMatND **mat) |
Deallocates a multi-dimensional array. More... | |
void | cvReleaseMemStorage (CvMemStorage **storage) |
void | cvReleaseSparseMat (CvSparseMat **mat) |
Deallocates sparse array. More... | |
void | cvRemoveNodeFromTree (void *node, void *frame) |
void | cvRepeat (const CvArr *src, CvArr *dst) |
void | cvResetImageROI (IplImage *image) |
Resets the image ROI to include the entire image and releases the ROI structure. More... | |
CvMat * | cvReshape (const CvArr *arr, CvMat *header, int new_cn, int new_rows=0) |
Changes shape of matrix/image without copying data. More... | |
CvArr * | cvReshapeMatND (const CvArr *arr, int sizeof_header, CvArr *header, int new_cn, int new_dims, int *new_sizes) |
Changes the shape of a multi-dimensional array without copying the data. More... | |
void | cvRestoreMemStoragePos (CvMemStorage *storage, CvMemStoragePos *pos) |
CvRNG | cvRNG (int64 seed=-1) |
Initializes a random number generator state. More... | |
CvRect | cvROIToRect (IplROI roi) |
void | cvSave (const char *filename, const void *struct_ptr, const char *name=NULL, const char *comment=NULL, CvAttrList attributes=cvAttrList()) |
Saves an object to a file. More... | |
void | cvSaveMemStoragePos (const CvMemStorage *storage, CvMemStoragePos *pos) |
CvScalar | cvScalar (double val0, double val1=0, double val2=0, double val3=0) |
CvScalar | cvScalarAll (double val0123) |
void | cvScalarToRawData (const CvScalar *scalar, void *data, int type, int extend_to_12=0) |
void | cvScaleAdd (const CvArr *src1, CvScalar scale, const CvArr *src2, CvArr *dst) |
int | cvSeqElemIdx (const CvSeq *seq, const void *element, CvSeqBlock **block=NULL) |
schar * | cvSeqInsert (CvSeq *seq, int before_index, const void *element=NULL) |
void | cvSeqInsertSlice (CvSeq *seq, int before_index, const CvArr *from_arr) |
void | cvSeqInvert (CvSeq *seq) |
int | cvSeqPartition (const CvSeq *seq, CvMemStorage *storage, CvSeq **labels, CvCmpFunc is_equal, void *userdata) |
void | cvSeqPop (CvSeq *seq, void *element=NULL) |
void | cvSeqPopFront (CvSeq *seq, void *element=NULL) |
void | cvSeqPopMulti (CvSeq *seq, void *elements, int count, int in_front=0) |
schar * | cvSeqPush (CvSeq *seq, const void *element=NULL) |
schar * | cvSeqPushFront (CvSeq *seq, const void *element=NULL) |
void | cvSeqPushMulti (CvSeq *seq, const void *elements, int count, int in_front=0) |
void | cvSeqRemove (CvSeq *seq, int index) |
void | cvSeqRemoveSlice (CvSeq *seq, CvSlice slice) |
schar * | cvSeqSearch (CvSeq *seq, const void *elem, CvCmpFunc func, int is_sorted, int *elem_idx, void *userdata=NULL) |
CvSeq * | cvSeqSlice (const CvSeq *seq, CvSlice slice, CvMemStorage *storage=NULL, int copy_data=0) |
void | cvSeqSort (CvSeq *seq, CvCmpFunc func, void *userdata=NULL) |
void | cvSet (CvArr *arr, CvScalar value, const CvArr *mask=NULL) |
Sets every element of an array to a given value. More... | |
void | cvSet1D (CvArr *arr, int idx0, CvScalar value) |
Change the particular array element. More... | |
void | cvSet2D (CvArr *arr, int idx0, int idx1, CvScalar value) |
void | cvSet3D (CvArr *arr, int idx0, int idx1, int idx2, CvScalar value) |
int | cvSetAdd (CvSet *set_header, CvSetElem *elem=NULL, CvSetElem **inserted_elem=NULL) |
void | cvSetData (CvArr *arr, void *data, int step) |
Assigns user data to the array header. More... | |
int | cvSetErrMode (int mode) |
void | cvSetErrStatus (int status) |
void | cvSetIdentity (CvArr *mat, CvScalar value=cvRealScalar(1)) |
void | cvSetImageCOI (IplImage *image, int coi) |
Sets the channel of interest in an IplImage. More... | |
void | cvSetImageROI (IplImage *image, CvRect rect) |
Sets an image Region Of Interest (ROI) for a given rectangle. More... | |
void | cvSetIPLAllocators (Cv_iplCreateImageHeader create_header, Cv_iplAllocateImageData allocate_data, Cv_iplDeallocate deallocate, Cv_iplCreateROI create_roi, Cv_iplCloneImage clone_image) |
Makes OpenCV use IPL functions for allocating IplImage and IplROI structures. More... | |
void | cvSetND (CvArr *arr, const int *idx, CvScalar value) |
CvSetElem * | cvSetNew (CvSet *set_header) |
void | cvSetNumThreads (int threads=0) |
void | cvSetReal1D (CvArr *arr, int idx0, double value) |
Change a specific array element. More... | |
void | cvSetReal2D (CvArr *arr, int idx0, int idx1, double value) |
void | cvSetReal3D (CvArr *arr, int idx0, int idx1, int idx2, double value) |
void | cvSetRealND (CvArr *arr, const int *idx, double value) |
void | cvSetRemove (CvSet *set_header, int index) |
void | cvSetRemoveByPtr (CvSet *set_header, void *elem) |
void | cvSetSeqBlockSize (CvSeq *seq, int delta_elems) |
void | cvSetSeqReaderPos (CvSeqReader *reader, int index, int is_relative=0) |
void | cvSetZero (CvArr *arr) |
Clears the array. More... | |
CvSize | cvSize (int width, int height) |
CvSize2D32f | cvSize2D32f (double width, double height) |
CvSlice | cvSlice (int start, int end) |
int | cvSliceLength (CvSlice slice, const CvSeq *seq) |
int | cvSolve (const CvArr *src1, const CvArr *src2, CvArr *dst, int method=0) |
int | cvSolveCubic (const CvMat *coeffs, CvMat *roots) |
void | cvSolvePoly (const CvMat *coeffs, CvMat *roots2, int maxiter=20, int fig=100) |
void | cvSort (const CvArr *src, CvArr *dst=NULL, CvArr *idxmat=NULL, int flags=0) |
void | cvSplit (const CvArr *src, CvArr *dst0, CvArr *dst1, CvArr *dst2, CvArr *dst3) |
void | cvStartAppendToSeq (CvSeq *seq, CvSeqWriter *writer) |
void | cvStartNextStream (CvFileStorage *fs) |
Starts the next stream. More... | |
void | cvStartReadRawData (const CvFileStorage *fs, const CvFileNode *src, CvSeqReader *reader) |
Initializes the file node sequence reader. More... | |
void | cvStartReadSeq (const CvSeq *seq, CvSeqReader *reader, int reverse=0) |
void | cvStartWriteSeq (int seq_flags, int header_size, int elem_size, CvMemStorage *storage, CvSeqWriter *writer) |
void | cvStartWriteStruct (CvFileStorage *fs, const char *name, int struct_flags, const char *type_name=NULL, CvAttrList attributes=cvAttrList()) |
Starts writing a new structure. More... | |
int | cvStdErrReport (int status, const char *func_name, const char *err_msg, const char *file_name, int line, void *userdata) |
void | cvSub (const CvArr *src1, const CvArr *src2, CvArr *dst, const CvArr *mask=NULL) |
void | cvSubRS (const CvArr *src, CvScalar value, CvArr *dst, const CvArr *mask=NULL) |
void | cvSubS (const CvArr *src, CvScalar value, CvArr *dst, const CvArr *mask=NULL) |
CvScalar | cvSum (const CvArr *arr) |
void | cvSVBkSb (const CvArr *W, const CvArr *U, const CvArr *V, const CvArr *B, CvArr *X, int flags) |
void | cvSVD (CvArr *A, CvArr *W, CvArr *U=NULL, CvArr *V=NULL, int flags=0) |
CvTermCriteria | cvTermCriteria (int type, int max_iter, double epsilon) |
CvScalar | cvTrace (const CvArr *mat) |
void | cvTransform (const CvArr *src, CvArr *dst, const CvMat *transmat, const CvMat *shiftvec=NULL) |
void | cvTranspose (const CvArr *src, CvArr *dst) |
CvSeq * | cvTreeToNodeSeq (const void *first, int header_size, CvMemStorage *storage) |
CvTypeInfo * | cvTypeOf (const void *struct_ptr) |
Returns the type of an object. More... | |
void | cvUnregisterType (const char *type_name) |
Unregisters the type. More... | |
int | cvUseOptimized (int on_off) |
void | cvWrite (CvFileStorage *fs, const char *name, const void *ptr, CvAttrList attributes=cvAttrList()) |
Writes an object to file storage. More... | |
void | cvWriteComment (CvFileStorage *fs, const char *comment, int eol_comment) |
Writes a comment. More... | |
void | cvWriteFileNode (CvFileStorage *fs, const char *new_node_name, const CvFileNode *node, int embed) |
Writes a file node to another file storage. More... | |
void | cvWriteInt (CvFileStorage *fs, const char *name, int value) |
Writes an integer value. More... | |
void | cvWriteRawData (CvFileStorage *fs, const void *src, int len, const char *dt) |
Writes multiple numbers. More... | |
void | cvWriteRawDataBase64 (CvFileStorage *fs, const void *src, int len, const char *dt) |
Writes multiple numbers in Base64. More... | |
void | cvWriteReal (CvFileStorage *fs, const char *name, double value) |
Writes a floating-point value. More... | |
void | cvWriteString (CvFileStorage *fs, const char *name, const char *str, int quote=0) |
Writes a text string. More... | |
void | cvXor (const CvArr *src1, const CvArr *src2, CvArr *dst, const CvArr *mask=NULL) |
void | cvXorS (const CvArr *src, CvScalar value, CvArr *dst, const CvArr *mask=NULL) |
Flags for cvCalcCovarMatrix | |
| |
#define | CV_COVAR_SCRAMBLED 0 |
#define | CV_COVAR_NORMAL 1 |
#define | CV_COVAR_USE_AVG 2 |
#define | CV_COVAR_SCALE 4 |
#define | CV_COVAR_ROWS 8 |
#define | CV_COVAR_COLS 16 |
Flags for cvNorm and cvNormalize | |
#define | CV_C 1 |
#define | CV_L1 2 |
#define | CV_L2 4 |
#define | CV_NORM_MASK 7 |
#define | CV_RELATIVE 8 |
#define | CV_DIFF 16 |
#define | CV_MINMAX 32 |
#define | CV_DIFF_C (CV_DIFF | CV_C) |
#define | CV_DIFF_L1 (CV_DIFF | CV_L1) |
#define | CV_DIFF_L2 (CV_DIFF | CV_L2) |
#define | CV_RELATIVE_C (CV_RELATIVE | CV_C) |
#define | CV_RELATIVE_L1 (CV_RELATIVE | CV_L1) |
#define | CV_RELATIVE_L2 (CV_RELATIVE | CV_L2) |
Flags for cvReduce | |
#define | CV_REDUCE_SUM 0 |
#define | CV_REDUCE_AVG 1 |
#define | CV_REDUCE_MAX 2 |
#define | CV_REDUCE_MIN 3 |
Flags for cvDFT, cvDCT and cvMulSpectrums | |
#define | CV_DXT_FORWARD 0 |
#define | CV_DXT_INVERSE 1 |
#define | CV_DXT_SCALE 2 |
#define | CV_DXT_INV_SCALE (CV_DXT_INVERSE + CV_DXT_SCALE) |
#define | CV_DXT_INVERSE_SCALE CV_DXT_INV_SCALE |
#define | CV_DXT_ROWS 4 |
#define | CV_DXT_MUL_CONJ 8 |
Graph | |
We represent a graph as a set of vertices. Vertices contain their adjacency lists (more exactly, pointers to first incoming or outcoming edge (or 0 if isolated vertex)). Edges are stored in another set. There is a singly-linked list of incoming/outcoming edges for each vertex. Each edge consists of:
| |
#define | CV_GRAPH_EDGE_FIELDS() |
#define | CV_GRAPH_VERTEX_FIELDS() |
#define | CV_GRAPH_FIELDS() |
#define | CV_TYPE_NAME_GRAPH "opencv-graph" |
#define __CV_BEGIN__ { |
#define __CV_END__ goto exit; exit: ; } |
#define __CV_EXIT__ goto exit |
#define CV_ARE_CNS_EQ | ( | mat1, | |
mat2 | |||
) | ((((mat1)->type ^ (mat2)->type) & CV_MAT_CN_MASK) == 0) |
#define CV_ARE_DEPTHS_EQ | ( | mat1, | |
mat2 | |||
) | ((((mat1)->type ^ (mat2)->type) & CV_MAT_DEPTH_MASK) == 0) |
#define CV_ARE_SIZES_EQ | ( | mat1, | |
mat2 | |||
) | ((mat1)->rows == (mat2)->rows && (mat1)->cols == (mat2)->cols) |
#define CV_ARE_TYPES_EQ | ( | mat1, | |
mat2 | |||
) | ((((mat1)->type ^ (mat2)->type) & CV_MAT_TYPE_MASK) == 0) |
#define CV_ASSERT | ( | Condition | ) |
Runtime assertion macro
#define CV_AUTO_STEP 0x7fffffff |
#define CV_AUTOSTEP 0x7fffffff |
#define CV_BACK 0 |
#define CV_C 1 |
#define CV_CALL | ( | Func | ) |
CV_CALL macro calls CV (or IPL) function, checks error status and signals a error if the function failed. Useful in "parent node" error procesing mode
#define CV_CHECK | ( | ) |
CV_CHECK macro checks error status after CV (or IPL) function call. If error detected, control will be transferred to the exit label.
#define CV_CHECK_QUIET 2 |
#define CV_CHECK_RANGE 1 |
#define CV_CHOLESKY 3 |
#define CV_CMP | ( | a, | |
b | |||
) | (((a) > (b)) - ((a) < (b))) |
#define CV_CMP_EQ 0 |
#define CV_CMP_GE 2 |
#define CV_CMP_GT 1 |
#define CV_CMP_LE 4 |
#define CV_CMP_LT 3 |
#define CV_CMP_NE 5 |
#define CV_CONTOUR_FIELDS | ( | ) |
#define CV_COVAR_COLS 16 |
flag for cvCalcCovarMatrix, all the input vectors are stored in a single matrix, as its columns
#define CV_COVAR_NORMAL 1 |
flag for cvCalcCovarMatrix, [v1-avg, v2-avg,...] * transpose([v1-avg,v2-avg,...])
#define CV_COVAR_ROWS 8 |
flag for cvCalcCovarMatrix, all the input vectors are stored in a single matrix, as its rows
#define CV_COVAR_SCALE 4 |
flag for cvCalcCovarMatrix, scale the covariance matrix coefficients by number of the vectors
#define CV_COVAR_SCRAMBLED 0 |
flag for cvCalcCovarMatrix, transpose([v1-avg, v2-avg,...]) * [v1-avg,v2-avg,...]
#define CV_COVAR_USE_AVG 2 |
flag for cvCalcCovarMatrix, do not calc average (i.e. mean vector) - use the input vector instead (useful for calculating covariance matrix by parts)
#define CV_CURRENT_POINT | ( | reader | ) | (*((CvPoint*)((reader).ptr))) |
#define CV_DIFF 16 |
#define CV_DXT_FORWARD 0 |
#define CV_DXT_INV_SCALE (CV_DXT_INVERSE + CV_DXT_SCALE) |
#define CV_DXT_INVERSE 1 |
#define CV_DXT_INVERSE_SCALE CV_DXT_INV_SCALE |
#define CV_DXT_MUL_CONJ 8 |
conjugate the second argument of cvMulSpectrums
#define CV_DXT_ROWS 4 |
transform each row individually
#define CV_DXT_SCALE 2 |
divide result by size of array
#define CV_ErrModeLeaf 0 /* Print error and exit program */ |
#define CV_ErrModeParent 1 /* Print error and continue */ |
#define CV_ErrModeSilent 2 /* Don't print and continue */ |
#define CV_ERROR | ( | Code, | |
Msg | |||
) |
CV_ERROR macro unconditionally raises error with passed code and message. After raising error, control will be transferred to the exit label.
#define CV_FRONT 1 |
#define CV_FUNCNAME | ( | Name | ) | static char cvFuncName[] = Name |
CV_FUNCNAME macro defines icvFuncName constant which is used by CV_ERROR macro
#define CV_GEMM_A_T 1 |
#define CV_GEMM_B_T 2 |
#define CV_GEMM_C_T 4 |
#define CV_GET_SEQ_ELEM | ( | elem_type, | |
seq, | |||
index | |||
) | CV_SEQ_ELEM( (seq), elem_type, (index) ) |
#define CV_GRAPH CV_SEQ_KIND_GRAPH |
#define CV_GRAPH_ALL_ITEMS -1 |
#define CV_GRAPH_ANY_EDGE 30 |
#define CV_GRAPH_BACK_EDGE 4 |
#define CV_GRAPH_BACKTRACKING 64 |
#define CV_GRAPH_CROSS_EDGE 16 |
#define CV_GRAPH_EDGE_FIELDS | ( | ) |
#define CV_GRAPH_FIELDS | ( | ) |
Graph is "derived" from the set (this is set a of vertices) and includes another set (edges)
#define CV_GRAPH_FLAG_ORIENTED (1 << CV_SEQ_FLAG_SHIFT) |
flags for graphs
#define CV_GRAPH_FORWARD_EDGE 8 |
#define CV_GRAPH_FORWARD_EDGE_FLAG (1 << 28) |
#define CV_GRAPH_ITEM_VISITED_FLAG (1 << 30) |
flags for graph vertices and edges
#define CV_GRAPH_NEW_TREE 32 |
#define CV_GRAPH_OVER -1 |
#define CV_GRAPH_SEARCH_TREE_NODE_FLAG (1 << 29) |
#define CV_GRAPH_TREE_EDGE 2 |
#define CV_GRAPH_VERTEX 1 |
#define CV_GRAPH_VERTEX_FIELDS | ( | ) |
#define CV_HIST_ARRAY 0 |
#define CV_HIST_HAS_RANGES | ( | hist | ) | (((hist)->type & CV_HIST_RANGES_FLAG) != 0) |
#define CV_HIST_MAGIC_VAL 0x42450000 |
#define CV_HIST_RANGES_FLAG (1 << 11) |
indicates whether bin ranges are set already or not
#define CV_HIST_SPARSE 1 |
#define CV_HIST_TREE CV_HIST_SPARSE |
#define CV_HIST_UNIFORM 1 |
should be used as a parameter only, it turns to CV_HIST_UNIFORM_FLAG of hist->type
#define CV_HIST_UNIFORM_FLAG (1 << 10) |
#define CV_IABS | ( | a | ) | abs(a) |
absolute value without jumps
#define CV_IMAGE_ELEM | ( | image, | |
elemtype, | |||
row, | |||
col | |||
) | (((elemtype*)((image)->imageData + (image)->widthStep*(row)))[(col)]) |
get reference to pixel at (col,row), for multi-channel images (col) should be multiplied by number of channels
#define CV_IMAX | ( | a, | |
b | |||
) | ((a) ^ (((a)^(b)) & (((a) > (b)) - 1))) |
#define CV_IMIN | ( | a, | |
b | |||
) | ((a) ^ (((a)^(b)) & (((a) < (b)) - 1))) |
min & max without jumps
#define CV_IS_GRAPH | ( | seq | ) | (CV_IS_SET(seq) && CV_SEQ_KIND((CvSet*)(seq)) == CV_SEQ_KIND_GRAPH) |
#define CV_IS_GRAPH_EDGE_VISITED | ( | edge | ) | (((CvGraphEdge*)(edge))->flags & CV_GRAPH_ITEM_VISITED_FLAG) |
#define CV_IS_GRAPH_ORIENTED | ( | seq | ) | (((seq)->flags & CV_GRAPH_FLAG_ORIENTED) != 0) |
#define CV_IS_GRAPH_VERTEX_VISITED | ( | vtx | ) | (((CvGraphVtx*)(vtx))->flags & CV_GRAPH_ITEM_VISITED_FLAG) |
#define CV_IS_HIST | ( | hist | ) |
#define CV_IS_IMAGE | ( | img | ) | (CV_IS_IMAGE_HDR(img) && ((IplImage*)img)->imageData != NULL) |
#define CV_IS_IMAGE_HDR | ( | img | ) | ((img) != NULL && ((const IplImage*)(img))->nSize == sizeof(IplImage)) |
#define CV_IS_MASK_ARR | ( | mat | ) | (((mat)->type & (CV_MAT_TYPE_MASK & ~CV_8SC1)) == 0) |
#define CV_IS_MAT | ( | mat | ) | (CV_IS_MAT_HDR(mat) && ((const CvMat*)(mat))->data.ptr != NULL) |
#define CV_IS_MAT_CONST | ( | mat | ) | (((mat)->rows|(mat)->cols) == 1) |
#define CV_IS_MAT_HDR | ( | mat | ) |
#define CV_IS_MAT_HDR_Z | ( | mat | ) |
#define CV_IS_MATND | ( | mat | ) | (CV_IS_MATND_HDR(mat) && ((const CvMatND*)(mat))->data.ptr != NULL) |
#define CV_IS_MATND_HDR | ( | mat | ) | ((mat) != NULL && (((const CvMatND*)(mat))->type & CV_MAGIC_MASK) == CV_MATND_MAGIC_VAL) |
#define CV_IS_SEQ | ( | seq | ) | ((seq) != NULL && (((CvSeq*)(seq))->flags & CV_MAGIC_MASK) == CV_SEQ_MAGIC_VAL) |
#define CV_IS_SEQ_CHAIN | ( | seq | ) | (CV_SEQ_KIND(seq) == CV_SEQ_KIND_CURVE && (seq)->elem_size == 1) |
#define CV_IS_SEQ_CHAIN_CONTOUR | ( | seq | ) | (CV_IS_SEQ_CHAIN( seq ) && CV_IS_SEQ_CLOSED( seq )) |
#define CV_IS_SEQ_CLOSED | ( | seq | ) | (((seq)->flags & CV_SEQ_FLAG_CLOSED) != 0) |
#define CV_IS_SEQ_CONTOUR | ( | seq | ) | (CV_IS_SEQ_CLOSED(seq) && (CV_IS_SEQ_POLYLINE(seq) || CV_IS_SEQ_CHAIN(seq))) |
#define CV_IS_SEQ_CONVEX | ( | seq | ) | 0 |
#define CV_IS_SEQ_CURVE | ( | seq | ) | (CV_SEQ_KIND(seq) == CV_SEQ_KIND_CURVE) |
#define CV_IS_SEQ_HOLE | ( | seq | ) | (((seq)->flags & CV_SEQ_FLAG_HOLE) != 0) |
#define CV_IS_SEQ_INDEX | ( | seq | ) |
flag checking
#define CV_IS_SEQ_POINT_SET | ( | seq | ) | ((CV_SEQ_ELTYPE(seq) == CV_32SC2 || CV_SEQ_ELTYPE(seq) == CV_32FC2)) |
type checking macros
#define CV_IS_SEQ_POINT_SUBSET | ( | seq | ) | (CV_IS_SEQ_INDEX( seq ) || CV_SEQ_ELTYPE(seq) == CV_SEQ_ELTYPE_PPOINT) |
#define CV_IS_SEQ_POLYGON | ( | seq | ) | (CV_IS_SEQ_POLYLINE(seq) && CV_IS_SEQ_CLOSED(seq)) |
#define CV_IS_SEQ_POLYGON_TREE | ( | seq | ) |
#define CV_IS_SEQ_POLYLINE | ( | seq | ) | (CV_SEQ_KIND(seq) == CV_SEQ_KIND_CURVE && CV_IS_SEQ_POINT_SET(seq)) |
#define CV_IS_SEQ_SIMPLE | ( | seq | ) | 1 |
#define CV_IS_SET | ( | set | ) | ((set) != NULL && (((CvSeq*)(set))->flags & CV_MAGIC_MASK) == CV_SET_MAGIC_VAL) |
#define CV_IS_SET_ELEM | ( | ptr | ) | (((CvSetElem*)(ptr))->flags >= 0) |
Checks whether the element pointed by ptr belongs to a set or not
#define CV_IS_SPARSE_HIST | ( | hist | ) | CV_IS_SPARSE_MAT((hist)->bins) |
#define CV_IS_SPARSE_MAT | ( | mat | ) | CV_IS_SPARSE_MAT_HDR(mat) |
#define CV_IS_SPARSE_MAT_HDR | ( | mat | ) |
#define CV_IS_STORAGE | ( | storage | ) |
#define CV_IS_SUBDIV2D | ( | seq | ) | (CV_IS_SET(seq) && CV_SEQ_KIND((CvSet*)(seq)) == CV_SEQ_KIND_SUBDIV2D) |
#define CV_IS_UNIFORM_HIST | ( | hist | ) | (((hist)->type & CV_HIST_UNIFORM_FLAG) != 0) |
#define CV_KMEANS_USE_INITIAL_LABELS 1 |
The function implements the K-means algorithm for clustering an array of sample vectors in a specified number of classes
#define CV_L1 2 |
#define CV_L2 4 |
#define CV_LU 0 |
#define CV_MAGIC_MASK 0xFFFF0000 |
#define CV_MAT_ELEM | ( | mat, | |
elemtype, | |||
row, | |||
col | |||
) | (*(elemtype*)CV_MAT_ELEM_PTR_FAST( mat, row, col, sizeof(elemtype))) |
#define CV_MAT_ELEM_PTR | ( | mat, | |
row, | |||
col | |||
) | CV_MAT_ELEM_PTR_FAST( mat, row, col, CV_ELEM_SIZE((mat).type) ) |
#define CV_MAT_ELEM_PTR_FAST | ( | mat, | |
row, | |||
col, | |||
pix_size | |||
) |
#define CV_MAT_MAGIC_VAL 0x42420000 |
#define CV_MATND_MAGIC_VAL 0x42430000 |
#define CV_MAX_ARR 10 |
#define CV_MAX_DIM 32 |
#define CV_MAX_DIM_HEAP 1024 |
#define CV_MINMAX 32 |
#define CV_NEXT_GRAPH_EDGE | ( | edge, | |
vertex | |||
) |
Return next graph edge for given vertex:
#define CV_NEXT_SEQ_ELEM | ( | elem_size, | |
reader | |||
) |
Move reader position forward:
#define CV_NO_CN_CHECK 2 |
#define CV_NO_DEPTH_CHECK 1 |
#define CV_NO_SIZE_CHECK 4 |
#define CV_NODE_EMPTY 32 |
#define CV_NODE_FLOAT CV_NODE_REAL |
#define CV_NODE_FLOW 8 |
file node flags Used only for writing structures in YAML format.
#define CV_NODE_HAS_NAME | ( | flags | ) | (((flags) & CV_NODE_NAMED) != 0) |
#define CV_NODE_IDX | ( | mat, | |
node | |||
) | ((int*)((uchar*)(node) + (mat)->idxoffset)) |
#define CV_NODE_INT 1 |
#define CV_NODE_INTEGER CV_NODE_INT |
#define CV_NODE_IS_COLLECTION | ( | flags | ) | (CV_NODE_TYPE(flags) >= CV_NODE_SEQ) |
#define CV_NODE_IS_EMPTY | ( | flags | ) | (((flags) & CV_NODE_EMPTY) != 0) |
#define CV_NODE_IS_FLOW | ( | flags | ) | (((flags) & CV_NODE_FLOW) != 0) |
#define CV_NODE_IS_INT | ( | flags | ) | (CV_NODE_TYPE(flags) == CV_NODE_INT) |
#define CV_NODE_IS_MAP | ( | flags | ) | (CV_NODE_TYPE(flags) == CV_NODE_MAP) |
#define CV_NODE_IS_REAL | ( | flags | ) | (CV_NODE_TYPE(flags) == CV_NODE_REAL) |
#define CV_NODE_IS_SEQ | ( | flags | ) | (CV_NODE_TYPE(flags) == CV_NODE_SEQ) |
#define CV_NODE_IS_STRING | ( | flags | ) | (CV_NODE_TYPE(flags) == CV_NODE_STRING) |
#define CV_NODE_IS_USER | ( | flags | ) | (((flags) & CV_NODE_USER) != 0) |
#define CV_NODE_MAP 6 |
#define CV_NODE_NAMED 64 |
#define CV_NODE_NONE 0 |
#define CV_NODE_REAL 2 |
#define CV_NODE_REF 4 |
not used
#define CV_NODE_SEQ 5 |
#define CV_NODE_SEQ_IS_SIMPLE | ( | seq | ) | (((seq)->flags & CV_NODE_SEQ_SIMPLE) != 0) |
#define CV_NODE_SEQ_SIMPLE 256 |
#define CV_NODE_STR 3 |
#define CV_NODE_STRING CV_NODE_STR |
#define CV_NODE_TYPE | ( | flags | ) | ((flags) & CV_NODE_TYPE_MASK) |
#define CV_NODE_TYPE_MASK 7 |
#define CV_NODE_USER 16 |
#define CV_NODE_VAL | ( | mat, | |
node | |||
) | ((void*)((uchar*)(node) + (mat)->valoffset)) |
#define CV_NORM_MASK 7 |
#define CV_NORMAL 16 |
#define CV_ORIENTED_GRAPH (CV_SEQ_KIND_GRAPH|CV_GRAPH_FLAG_ORIENTED) |
#define CV_PCA_DATA_AS_COL 1 |
#define CV_PCA_DATA_AS_ROW 0 |
#define CV_PCA_USE_AVG 2 |
#define CV_PREV_POINT | ( | reader | ) | (*((CvPoint*)((reader).prev_elem))) |
#define CV_PREV_SEQ_ELEM | ( | elem_size, | |
reader | |||
) |
Move reader position backward:
#define CV_QR 4 |
#define CV_RAND_NORMAL 1 |
#define CV_RAND_UNI 0 |
#define CV_READ_CHAIN_POINT | ( | _pt, | |
reader | |||
) |
#define CV_READ_EDGE | ( | pt1, | |
pt2, | |||
reader | |||
) |
#define CV_READ_SEQ_ELEM | ( | elem, | |
reader | |||
) |
Read element and move read position forward:
#define CV_REDUCE_AVG 1 |
#define CV_REDUCE_MAX 2 |
#define CV_REDUCE_MIN 3 |
#define CV_REDUCE_SUM 0 |
#define CV_RELATIVE 8 |
#define CV_RELATIVE_C (CV_RELATIVE | CV_C) |
#define CV_RELATIVE_L1 (CV_RELATIVE | CV_L1) |
#define CV_RELATIVE_L2 (CV_RELATIVE | CV_L2) |
#define CV_REV_READ_SEQ_ELEM | ( | elem, | |
reader | |||
) |
Read element and move read position backward:
#define CV_RNG_COEFF 4164903690U |
#define CV_SEQ_CHAIN (CV_SEQ_KIND_CURVE | CV_SEQ_ELTYPE_CODE) |
chain-coded curves
#define CV_SEQ_CHAIN_CONTOUR (CV_SEQ_FLAG_CLOSED | CV_SEQ_CHAIN) |
#define CV_SEQ_CONNECTED_COMP (CV_SEQ_KIND_GENERIC | CV_SEQ_ELTYPE_CONNECTED_COMP) |
sequence of the connected components
#define CV_SEQ_CONTOUR CV_SEQ_POLYGON |
#define CV_SEQ_ELEM | ( | seq, | |
elem_type, | |||
index | |||
) |
#define CV_SEQ_ELTYPE | ( | seq | ) | ((seq)->flags & CV_SEQ_ELTYPE_MASK) |
#define CV_SEQ_ELTYPE_BITS 12 |
#define CV_SEQ_ELTYPE_CODE CV_8UC1 |
freeman code: 0..7
#define CV_SEQ_ELTYPE_CONNECTED_COMP 0 |
connected component
#define CV_SEQ_ELTYPE_GENERIC 0 |
#define CV_SEQ_ELTYPE_GRAPH_EDGE 0 |
&next_o, &next_d, &vtx_o, &vtx_d
#define CV_SEQ_ELTYPE_GRAPH_VERTEX 0 |
first_edge, &(x,y)
#define CV_SEQ_ELTYPE_INDEX CV_32SC1 |
#(x,y)
#define CV_SEQ_ELTYPE_MASK ((1 << CV_SEQ_ELTYPE_BITS) - 1) |
#define CV_SEQ_ELTYPE_POINT CV_32SC2 |
(x,y)
#define CV_SEQ_ELTYPE_POINT3D CV_32FC3 |
(x,y,z)
#define CV_SEQ_ELTYPE_PPOINT CV_SEQ_ELTYPE_PTR |
&(x,y)
#define CV_SEQ_ELTYPE_PTR CV_USRTYPE1 |
#define CV_SEQ_ELTYPE_TRIAN_ATR 0 |
vertex of the binary tree
#define CV_SEQ_FLAG_CLOSED (1 << CV_SEQ_FLAG_SHIFT) |
flags for curves
#define CV_SEQ_FLAG_CONVEX (0 << CV_SEQ_FLAG_SHIFT) |
#define CV_SEQ_FLAG_HOLE (2 << CV_SEQ_FLAG_SHIFT) |
#define CV_SEQ_FLAG_SHIFT (CV_SEQ_KIND_BITS + CV_SEQ_ELTYPE_BITS) |
#define CV_SEQ_FLAG_SIMPLE (0 << CV_SEQ_FLAG_SHIFT) |
#define CV_SEQ_INDEX (CV_SEQ_KIND_GENERIC | CV_SEQ_ELTYPE_INDEX) |
sequence of the integer numbers
#define CV_SEQ_KIND | ( | seq | ) | ((seq)->flags & CV_SEQ_KIND_MASK ) |
#define CV_SEQ_KIND_BIN_TREE (2 << CV_SEQ_ELTYPE_BITS) |
#define CV_SEQ_KIND_BITS 2 |
#define CV_SEQ_KIND_CURVE (1 << CV_SEQ_ELTYPE_BITS) |
#define CV_SEQ_KIND_GENERIC (0 << CV_SEQ_ELTYPE_BITS) |
types of sequences
#define CV_SEQ_KIND_GRAPH (1 << CV_SEQ_ELTYPE_BITS) |
types of sparse sequences (sets)
#define CV_SEQ_KIND_MASK (((1 << CV_SEQ_KIND_BITS) - 1)<<CV_SEQ_ELTYPE_BITS) |
#define CV_SEQ_KIND_SUBDIV2D (2 << CV_SEQ_ELTYPE_BITS) |
#define CV_SEQ_MAGIC_VAL 0x42990000 |
#define CV_SEQ_POINT3D_SET (CV_SEQ_KIND_GENERIC| CV_SEQ_ELTYPE_POINT3D) |
#define CV_SEQ_POINT_SET (CV_SEQ_KIND_GENERIC| CV_SEQ_ELTYPE_POINT) |
point sets
#define CV_SEQ_POLYGON (CV_SEQ_FLAG_CLOSED | CV_SEQ_POLYLINE ) |
#define CV_SEQ_POLYGON_TREE (CV_SEQ_KIND_BIN_TREE | CV_SEQ_ELTYPE_TRIAN_ATR) |
binary tree for the contour
#define CV_SEQ_POLYLINE (CV_SEQ_KIND_CURVE | CV_SEQ_ELTYPE_POINT) |
#define CV_SEQ_READER_FIELDS | ( | ) |
pointer to previous element
#define CV_SEQ_SIMPLE_POLYGON (CV_SEQ_FLAG_SIMPLE | CV_SEQ_POLYGON ) |
#define CV_SEQ_WRITER_FIELDS | ( | ) |
pointer to the end of block
#define CV_SEQUENCE_FIELDS | ( | ) |
Read/Write sequence. Elements can be dynamically inserted to or deleted from the sequence.Pointer to the first sequence block.
#define CV_SET_ELEM_FIELDS | ( | elem_type | ) |
Set Order is not preserved. There can be gaps between sequence elements. After the element has been inserted it stays in the same place all the time. The MSB(most-significant or sign bit) of the first field (flags) is 0 iff the element exists.
#define CV_SET_ELEM_FREE_FLAG (1 << (sizeof(int)*8-1)) |
#define CV_SET_ELEM_IDX_MASK ((1 << 26) - 1) |
#define CV_SET_FIELDS | ( | ) |
#define CV_SET_MAGIC_VAL 0x42980000 |
#define CV_SIGN | ( | a | ) | CV_CMP((a),0) |
#define CV_SORT_ASCENDING 0 |
#define CV_SORT_DESCENDING 16 |
#define CV_SORT_EVERY_COLUMN 1 |
#define CV_SORT_EVERY_ROW 0 |
#define CV_SPARSE_MAT_MAGIC_VAL 0x42440000 |
#define CV_STORAGE_APPEND 2 |
#define CV_STORAGE_BASE64 64 |
#define CV_STORAGE_FORMAT_AUTO 0 |
#define CV_STORAGE_FORMAT_JSON 24 |
#define CV_STORAGE_FORMAT_MASK (7<<3) |
#define CV_STORAGE_FORMAT_XML 8 |
#define CV_STORAGE_FORMAT_YAML 16 |
#define CV_STORAGE_MAGIC_VAL 0x42890000 |
#define CV_STORAGE_MEMORY 4 |
#define CV_STORAGE_READ 0 |
Storage flags:
#define CV_STORAGE_WRITE 1 |
#define CV_STORAGE_WRITE_BASE64 (CV_STORAGE_BASE64 | CV_STORAGE_WRITE) |
#define CV_STORAGE_WRITE_BINARY CV_STORAGE_WRITE |
#define CV_STORAGE_WRITE_TEXT CV_STORAGE_WRITE |
#define CV_SVD 1 |
#define CV_SVD_MODIFY_A 1 |
#define CV_SVD_SYM 2 |
#define CV_SVD_U_T 2 |
#define CV_SVD_V_T 4 |
#define CV_SWAP | ( | a, | |
b, | |||
t | |||
) | ((t) = (a), (a) = (b), (b) = (t)) |
#define CV_TERMCRIT_EPS 2 |
#define CV_TERMCRIT_ITER 1 |
#define CV_TERMCRIT_NUMBER CV_TERMCRIT_ITER |
#define CV_TREE_NODE_FIELDS | ( | node_type | ) |
2nd next sequence.
#define CV_TURN_ON_IPL_COMPATIBILITY | ( | ) |
#define CV_TYPE_NAME_GRAPH "opencv-graph" |
#define CV_TYPE_NAME_IMAGE "opencv-image" |
#define CV_TYPE_NAME_MAT "opencv-matrix" |
#define CV_TYPE_NAME_MATND "opencv-nd-matrix" |
#define CV_TYPE_NAME_SEQ "opencv-sequence" |
#define CV_TYPE_NAME_SEQ_TREE "opencv-sequence-tree" |
#define CV_TYPE_NAME_SPARSE_MAT "opencv-sparse-matrix" |
#define CV_WHOLE_ARR cvSlice( 0, 0x3fffffff ) |
#define CV_WHOLE_SEQ cvSlice(0, CV_WHOLE_SEQ_END_INDEX) |
#define CV_WHOLE_SEQ_END_INDEX 0x3fffffff |
#define CV_WRITE_SEQ_ELEM | ( | elem, | |
writer | |||
) |
#define CV_WRITE_SEQ_ELEM_VAR | ( | elem_ptr, | |
writer | |||
) |
Add element to sequence:
#define cvAbs | ( | src, | |
dst | |||
) | cvAbsDiffS( (src), (dst), cvScalarAll(0)) |
#define cvAXPY | ( | A, | |
real_scalar, | |||
B, | |||
C | |||
) | cvScaleAdd(A, cvRealScalar(real_scalar), B, C) |
#define cvCheckArray cvCheckArr |
#define cvConvert | ( | src, | |
dst | |||
) | cvConvertScale( (src), (dst), 1, 0 ) |
#define cvCvtScale cvConvertScale |
#define cvCvtScaleAbs cvConvertScaleAbs |
#define cvFFT cvDFT |
#define cvFree | ( | ptr | ) | (cvFree_(*(ptr)), *(ptr)=0) |
#define cvGetGraphVtx | ( | graph, | |
idx | |||
) | (CvGraphVtx*)cvGetSetElem((CvSet*)(graph), (idx)) |
Retrieves graph vertex by given index
#define cvGetSubArr cvGetSubRect |
#define cvGraphEdgeIdx | ( | graph, | |
edge | |||
) | ((edge)->flags & CV_SET_ELEM_IDX_MASK) |
Retrieves index of a graph edge given its pointer
#define cvGraphFindEdge cvFindGraphEdge |
#define cvGraphFindEdgeByPtr cvFindGraphEdgeByPtr |
#define cvGraphGetEdgeCount | ( | graph | ) | ((graph)->edges->active_count) |
#define cvGraphGetVtxCount | ( | graph | ) | ((graph)->active_count) |
#define cvGraphVtxIdx | ( | graph, | |
vtx | |||
) | ((vtx)->flags & CV_SET_ELEM_IDX_MASK) |
Retrieves index of a graph vertex given its pointer
#define cvInv cvInvert |
#define cvInvSqrt | ( | value | ) | ((float)(1./sqrt(value))) |
#define cvMahalonobis cvMahalanobis |
#define cvMatMul | ( | src1, | |
src2, | |||
dst | |||
) | cvMatMulAdd( (src1), (src2), NULL, (dst)) |
#define cvMatMulAdd | ( | src1, | |
src2, | |||
src3, | |||
dst | |||
) | cvGEMM( (src1), (src2), 1., (src3), 1., (dst), 0 ) |
Matrix transform: dst = A*B + C, C is optional
#define cvMatMulAddEx cvGEMM |
#define cvMatMulAddS cvTransform |
#define cvMirror cvFlip |
#define cvReshapeND | ( | arr, | |
header, | |||
new_cn, | |||
new_dims, | |||
new_sizes | |||
) |
#define cvScale cvConvertScale |
#define cvSqrt | ( | value | ) | ((float)sqrt(value)) |
#define cvT cvTranspose |
#define cvZero cvSetZero |
#define IPL2CV_DEPTH | ( | depth | ) |
#define IPL_ALIGN_16BYTES 16 |
#define IPL_ALIGN_32BYTES 32 |
#define IPL_ALIGN_4BYTES 4 |
#define IPL_ALIGN_8BYTES 8 |
#define IPL_ALIGN_DWORD IPL_ALIGN_4BYTES |
#define IPL_ALIGN_QWORD IPL_ALIGN_8BYTES |
#define IPL_BORDER_CONSTANT 0 |
#define IPL_BORDER_REFLECT 2 |
#define IPL_BORDER_REFLECT_101 4 |
extra border mode
#define IPL_BORDER_REPLICATE 1 |
#define IPL_BORDER_TRANSPARENT 5 |
#define IPL_BORDER_WRAP 3 |
#define IPL_DATA_ORDER_PIXEL 0 |
#define IPL_DATA_ORDER_PLANE 1 |
#define IPL_DEPTH_16S (IPL_DEPTH_SIGN|16) |
#define IPL_DEPTH_16U 16 |
#define IPL_DEPTH_1U 1 |
#define IPL_DEPTH_32F 32 |
#define IPL_DEPTH_32S (IPL_DEPTH_SIGN|32) |
#define IPL_DEPTH_64F 64 |
for storing double-precision floating point data in IplImage's
#define IPL_DEPTH_8S (IPL_DEPTH_SIGN| 8) |
#define IPL_DEPTH_8U 8 |
#define IPL_DEPTH_SIGN 0x80000000 |
#define IPL_IMAGE_DATA 2 |
#define IPL_IMAGE_HEADER 1 |
#define IPL_IMAGE_MAGIC_VAL ((int)sizeof(IplImage)) |
#define IPL_IMAGE_ROI 4 |
#define IPL_ORIGIN_BL 1 |
#define IPL_ORIGIN_TL 0 |
#define OPENCV_ASSERT | ( | expr, | |
func, | |||
context | |||
) |
#define OPENCV_CALL | ( | Func | ) |
#define OPENCV_ERROR | ( | status, | |
func, | |||
context | |||
) | cvError((status),(func),(context),__FILE__,__LINE__) |
typedef void(CV_STDCALL* Cv_iplAllocateImageData) (IplImage *, int, int) |
typedef IplImage*(CV_STDCALL* Cv_iplCloneImage) (const IplImage *) |
typedef IplImage*(CV_STDCALL* Cv_iplCreateImageHeader) (int, int, int, char *, char *, int, int, int, int, int, IplROI *, IplImage *, void *, IplTileInfo *) |
typedef IplROI*(CV_STDCALL* Cv_iplCreateROI) (int, int, int, int, int) |
typedef void(CV_STDCALL* Cv_iplDeallocate) (IplImage *, int) |
typedef void CvArr |
This is the "metatype" used only as a function parameter.
It denotes that the function accepts arrays of multiple types, such as IplImage*, CvMat* or even CvSeq* sometimes. The particular array type is determined at runtime by analyzing the first 4 bytes of the header. In C++ interface the role of CvArr is played by InputArray and OutputArray.
typedef void*( * CvCloneFunc) (const void *struct_ptr) |
typedef int(* CvCmpFunc) (const void *a, const void *b, void *userdata) |
a < b ? -1 : a > b ? 1 : 0
typedef int( * CvErrorCallback) (int status, const char *func_name, const char *err_msg, const char *file_name, int line, void *userdata) |
typedef struct CvGenericHash CvFileNodeHash |
typedef struct CvFileStorage CvFileStorage |
"black box" representation of the file storage associated with a file on disk.
Several functions that are described below take CvFileStorage* as inputs and allow the user to save or to load hierarchical collections that consist of scalar values, standard CXCore objects (such as matrices, sequences, graphs), and user-defined objects.
OpenCV can read and write data in XML (http://www.w3c.org/XML), YAML (http://www.yaml.org) or JSON (http://www.json.org/) formats. Below is an example of 3x3 floating-point identity matrix A, stored in XML and YAML files using CXCore functions: XML:
YAML:
As it can be seen from the examples, XML uses nested tags to represent hierarchy, while YAML uses indentation for that purpose (similar to the Python programming language).
The same functions can read and write data in both formats; the particular format is determined by the extension of the opened file, ".xml" for XML files, ".yml" or ".yaml" for YAML and ".json" for JSON.
typedef struct CvFileStorage CvFileStorage |
"black box" file storage
typedef int CvHistType |
typedef int( * CvIsInstanceFunc) (const void *struct_ptr) |
typedef CvContour CvPoint2DSeq |
typedef void*( * CvReadFunc) (CvFileStorage *storage, CvFileNode *node) |
typedef void( * CvReleaseFunc) (void **struct_dblptr) |
typedef int CVStatus |
typedef void( * CvWriteFunc) (CvFileStorage *storage, const char *name, const void *struct_ptr, CvAttrList attributes) |
typedef struct _IplTileInfo IplTileInfo |
anonymous enum |
Enumerator | |
---|---|
CV_StsOk | everything is ok |
CV_StsBackTrace | pseudo error for back trace |
CV_StsError | unknown /unspecified error |
CV_StsInternal | internal error (bad state) |
CV_StsNoMem | insufficient memory |
CV_StsBadArg | function arg/param is bad |
CV_StsBadFunc | unsupported function |
CV_StsNoConv | iter. didn't converge |
CV_StsAutoTrace | tracing |
CV_HeaderIsNull | image header is NULL |
CV_BadImageSize | image size is invalid |
CV_BadOffset | offset is invalid |
CV_BadDataPtr | |
CV_BadStep | |
CV_BadModelOrChSeq | |
CV_BadNumChannels | |
CV_BadNumChannel1U | |
CV_BadDepth | |
CV_BadAlphaChannel | |
CV_BadOrder | |
CV_BadOrigin | |
CV_BadAlign | |
CV_BadCallBack | |
CV_BadTileSize | |
CV_BadCOI | |
CV_BadROISize | |
CV_MaskIsTiled | |
CV_StsNullPtr | null pointer |
CV_StsVecLengthErr | incorrect vector length |
CV_StsFilterStructContentErr | incorr. filter structure content |
CV_StsKernelStructContentErr | incorr. transform kernel content |
CV_StsFilterOffsetErr | incorrect filter offset value |
CV_StsBadSize | the input/output structure size is incorrect |
CV_StsDivByZero | division by zero |
CV_StsInplaceNotSupported | in-place operation is not supported |
CV_StsObjectNotFound | request can't be completed |
CV_StsUnmatchedFormats | formats of input/output arrays differ |
CV_StsBadFlag | flag is wrong or not supported |
CV_StsBadPoint | bad CvPoint |
CV_StsBadMask | bad format of mask (neither 8uC1 nor 8sC1) |
CV_StsUnmatchedSizes | sizes of input/output structures do not match |
CV_StsUnsupportedFormat | the data format/type is not supported by the function |
CV_StsOutOfRange | some of parameters are out of range |
CV_StsParseError | invalid syntax/structure of the parsed file |
CV_StsNotImplemented | the requested function/feature is not implemented |
CV_StsBadMemBlock | an allocated block has been corrupted |
CV_StsAssert | assertion failed |
CV_GpuNotSupported | |
CV_GpuApiCallError | |
CV_OpenGlNotSupported | |
CV_OpenGlApiCallError | |
CV_OpenCLApiCallError | |
CV_OpenCLDoubleNotSupported | |
CV_OpenCLInitError | |
CV_OpenCLNoAMDBlasFft |
CvMat::CvMat | ( | const cv::Mat & | m | ) |
dst(x,y,c) = abs(src1(x,y,c) - src2(x,y,c))
dst(x,y,c) = abs(src(x,y,c) - value(c))
dst(mask) = src1(mask) + src2(mask)
dst(mask) = src(mask) + value
void cvAddWeighted | ( | const CvArr * | src1, |
double | alpha, | ||
const CvArr * | src2, | ||
double | beta, | ||
double | gamma, | ||
CvArr * | dst | ||
) |
dst = src1 * alpha + src2 * beta + gamma
void* cvAlloc | ( | size_t | size | ) |
malloc
wrapper. If there is no enough memory, the function (as well as other OpenCV functions that call cvAlloc) raises an error.
dst(idx) = src1(idx) & src2(idx)
dst(idx) = src(idx) & value
CvAttrList cvAttrList | ( | const char ** | attr = NULL , |
CvAttrList * | next = NULL |
||
) |
initializes CvAttrList structure
const char* cvAttrValue | ( | const CvAttrList * | attr, |
const char * | attr_name | ||
) |
returns attribute value or 0 (NULL) if there is no such attribute
Calculates mean value of array elements
Calculates mean and standard deviation of pixel values
void cvBackProjectPCA | ( | const CvArr * | proj, |
const CvArr * | mean, | ||
const CvArr * | eigenvects, | ||
CvArr * | result | ||
) |
Calculates covariation matrix for a set of vectors
void cvCalcPCA | ( | const CvArr * | data, |
CvArr * | mean, | ||
CvArr * | eigenvals, | ||
CvArr * | eigenvects, | ||
int | flags | ||
) |
void cvCartToPolar | ( | const CvArr * | x, |
const CvArr * | y, | ||
CvArr * | magnitude, | ||
CvArr * | angle = NULL , |
||
int | angle_in_degrees = 0 |
||
) |
Does cartesian->polar coordinates conversion. Either of output components (magnitude or angle) is optional
float cvCbrt | ( | float | value | ) |
Fast cubic root calculation
void cvChangeSeqBlock | ( | void * | reader, |
int | direction | ||
) |
int cvCheckArr | ( | const CvArr * | arr, |
int | flags = 0 , |
||
double | min_val = 0 , |
||
double | max_val = 0 |
||
) |
Checks array values for NaNs, Infs or simply for too large numbers (if CV_CHECK_RANGE is set). If CV_CHECK_QUIET is set, no runtime errors is raised (function returns zero value in case of "bad" values). Otherwise cvError is called
int cvCheckHardwareSupport | ( | int | feature | ) |
CvTermCriteria cvCheckTermCriteria | ( | CvTermCriteria | criteria, |
double | default_eps, | ||
int | default_max_iters | ||
) |
checks termination criteria validity and sets eps to default_eps (if it is not set), max_iter to default_max_iters (if it is not set)
void cvClearGraph | ( | CvGraph * | graph | ) |
Remove all vertices and edges from the graph
void cvClearMemStorage | ( | CvMemStorage * | storage | ) |
Clears memory storage. This is the only way(!!!) (besides cvRestoreMemStoragePos) to reuse memory allocated for the storage - cvClearSeq,cvClearSet ... do not free any memory. A child storage returns all the blocks to the parent when it is cleared
void cvClearND | ( | CvArr * | arr, |
const int * | idx | ||
) |
clears element of ND dense array, in case of sparse arrays it deletes the specified node
void cvClearSeq | ( | CvSeq * | seq | ) |
Removes all the elements from the sequence. The freed memory can be reused later only by the same sequence unless cvClearMemStorage or cvRestoreMemStoragePos is called
void cvClearSet | ( | CvSet * | set_header | ) |
Removes all the elements from the set
void* cvClone | ( | const void * | struct_ptr | ) |
Makes a clone of an object.
The function finds the type of a given object and calls clone with the passed object. Of course, if you know the object type, for example, struct_ptr is CvMat*, it is faster to call the specific function, like cvCloneMat.
struct_ptr | The object to clone |
CvGraph* cvCloneGraph | ( | const CvGraph * | graph, |
CvMemStorage * | storage | ||
) |
Creates a copy of graph
Creates an exact copy of the input matrix (except, may be, step value)
CvSeq* cvCloneSeq | ( | const CvSeq * | seq, |
CvMemStorage * | storage = NULL |
||
) |
CvSparseMat* cvCloneSparseMat | ( | const CvSparseMat * | mat | ) |
Creates a copy of CvSparseMat (except, may be, zero items)
The comparison operation support single-channel arrays only. Destination image should be 8uC1 or 8sC1 dst(idx) = src1(idx) cmp_op src2(idx)
dst(idx) = src1(idx) cmp_op value
void cvCompleteSymm | ( | CvMat * | matrix, |
int | LtoR = 0 |
||
) |
Completes the symmetric matrix from the lower (LtoR=0) or from the upper (LtoR!=0) part
Converts one array to another with optional linear transformation.
The function has several different purposes, and thus has several different names. It copies one array to another with optional scaling, which is performed first, and/or optional type conversion, performed after:
\[\texttt{dst} (I) = \texttt{scale} \texttt{src} (I) + ( \texttt{shift} _0, \texttt{shift} _1,...)\]
All the channels of multi-channel arrays are processed independently.
The type of conversion is done with rounding and saturation, that is if the result of scaling + conversion can not be represented exactly by a value of the destination array element type, it is set to the nearest representable value on the real axis.
src | Source array |
dst | Destination array |
scale | Scale factor |
shift | Value added to the scaled source array elements |
Performs linear transformation on every source array element, stores absolute value of the result: dst(x,y,c) = abs(scale*src(x,y,c)+shift). destination array must have 8u type. In other cases one may use cvConvertScale + cvAbsDiffS
Copies one array to another.
The function copies selected elements from an input array to an output array:
\[\texttt{dst} (I)= \texttt{src} (I) \quad \text{if} \quad \texttt{mask} (I) \ne 0.\]
If any of the passed arrays is of IplImage type, then its ROI and COI fields are used. Both arrays must have the same type, the same number of dimensions, and the same size. The function can also copy sparse arrays (mask is not supported in this case).
src | The source array |
dst | The destination array |
mask | Operation mask, 8-bit single channel array; specifies elements of the destination array to be changed |
int cvCountNonZero | ( | const CvArr * | arr | ) |
Calculates number of non-zero pixels
CvMemStorage* cvCreateChildMemStorage | ( | CvMemStorage * | parent | ) |
Creates a memory storage that will borrow memory blocks from parent storage
void cvCreateData | ( | CvArr * | arr | ) |
Allocates array data.
The function allocates image, matrix or multi-dimensional dense array data. Note that in the case of matrix types OpenCV allocation functions are used. In the case of IplImage they are used unless CV_TURN_ON_IPL_COMPATIBILITY() has been called before. In the latter case IPL functions are used to allocate the data.
arr | Array header |
CvGraph* cvCreateGraph | ( | int | graph_flags, |
int | header_size, | ||
int | vtx_size, | ||
int | edge_size, | ||
CvMemStorage * | storage | ||
) |
Creates new graph
CvGraphScanner* cvCreateGraphScanner | ( | CvGraph * | graph, |
CvGraphVtx * | vtx = NULL , |
||
int | mask = -1 |
||
) |
Creates new graph scanner.
Creates an image header and allocates the image data.
This function call is equivalent to the following code:
Creates an image header but does not allocate the image data.
size | Image width and height |
depth | Image depth (see cvCreateImage ) |
channels | Number of channels (see cvCreateImage ) |
CvMat* cvCreateMat | ( | int | rows, |
int | cols, | ||
int | type | ||
) |
Creates a matrix header and allocates the matrix data.
The function call is equivalent to the following code:
rows | Number of rows in the matrix |
cols | Number of columns in the matrix |
type | The type of the matrix elements in the form CV_<bit depth><S|U|F>C<number of channels> , where S=signed, U=unsigned, F=float. For example, CV _ 8UC1 means the elements are 8-bit unsigned and the there is 1 channel, and CV _ 32SC2 means the elements are 32-bit signed and there are 2 channels. |
CvMat* cvCreateMatHeader | ( | int | rows, |
int | cols, | ||
int | type | ||
) |
Creates a matrix header but does not allocate the matrix data.
The function allocates a new matrix header and returns a pointer to it. The matrix data can then be allocated using cvCreateData or set explicitly to user-allocated data via cvSetData.
rows | Number of rows in the matrix |
cols | Number of columns in the matrix |
type | Type of the matrix elements, see cvCreateMat |
CvMatND* cvCreateMatND | ( | int | dims, |
const int * | sizes, | ||
int | type | ||
) |
Creates the header and allocates the data for a multi-dimensional dense array.
This function call is equivalent to the following code:
dims | Number of array dimensions. This must not exceed CV_MAX_DIM (32 by default, but can be changed at build time). |
sizes | Array of dimension sizes. |
type | Type of array elements, see cvCreateMat . |
CvMatND* cvCreateMatNDHeader | ( | int | dims, |
const int * | sizes, | ||
int | type | ||
) |
Creates a new matrix header but does not allocate the matrix data.
The function allocates a header for a multi-dimensional dense array. The array data can further be allocated using cvCreateData or set explicitly to user-allocated data via cvSetData.
dims | Number of array dimensions |
sizes | Array of dimension sizes |
type | Type of array elements, see cvCreateMat |
CvMemStorage* cvCreateMemStorage | ( | int | block_size = 0 | ) |
Creates new memory storage. block_size == 0 means that default, somewhat optimal size, is used (currently, it is 64K)
CvSeq* cvCreateSeq | ( | int | seq_flags, |
size_t | header_size, | ||
size_t | elem_size, | ||
CvMemStorage * | storage | ||
) |
Creates new empty sequence that will reside in the specified storage
void cvCreateSeqBlock | ( | CvSeqWriter * | writer | ) |
CvSet* cvCreateSet | ( | int | set_flags, |
int | header_size, | ||
int | elem_size, | ||
CvMemStorage * | storage | ||
) |
Creates a new set
CvSparseMat* cvCreateSparseMat | ( | int | dims, |
const int * | sizes, | ||
int | type | ||
) |
Creates sparse array.
The function allocates a multi-dimensional sparse array. Initially the array contain no elements, that is PtrND and other related functions will return 0 for every index.
dims | Number of array dimensions. In contrast to the dense matrix, the number of dimensions is practically unlimited (up to \(2^{16}\) ). |
sizes | Array of dimension sizes |
type | Type of array elements. The same as for CvMat |
CvSparseMat* cvCreateSparseMat | ( | const cv::SparseMat & | m | ) |
Calculates the cross product of two 3D vectors.
The function calculates the cross product of two 3D vectors:
\[\texttt{dst} = \texttt{src1} \times \texttt{src2}\]
or:
\[\begin{array}{l} \texttt{dst} _1 = \texttt{src1} _2 \texttt{src2} _3 - \texttt{src1} _3 \texttt{src2} _2 \\ \texttt{dst} _2 = \texttt{src1} _3 \texttt{src2} _1 - \texttt{src1} _1 \texttt{src2} _3 \\ \texttt{dst} _3 = \texttt{src1} _1 \texttt{src2} _2 - \texttt{src1} _2 \texttt{src2} _1 \end{array}\]
src1 | The first source vector |
src2 | The second source vector |
dst | The destination vector |
void* cvCvtSeqToArray | ( | const CvSeq * | seq, |
void * | elements, | ||
CvSlice | slice = CV_WHOLE_SEQ |
||
) |
Copies sequence content to a continuous piece of memory
Discrete Cosine Transform
void cvDecRefData | ( | CvArr * | arr | ) |
Decrements an array data reference counter.
The function decrements the data reference counter in a CvMat or CvMatND if the reference counter
pointer is not NULL. If the counter reaches zero, the data is deallocated. In the current implementation the reference counter is not NULL only if the data was allocated using the cvCreateData function. The counter will be NULL in other cases such as: external data was assigned to the header using cvSetData, header is part of a larger matrix or image, or the header was converted from an image or n-dimensional matrix header.
arr | Pointer to an array header |
double cvDet | ( | const CvArr * | mat | ) |
Calculates determinant of input matrix
Discrete Fourier Transform: complex->complex, real->ccs (forward), ccs->real (inverse)
element-wise division/inversion with scaling: dst(idx) = src1(idx) * scale / src2(idx) or dst(idx) = scale / src2(idx) if src1 == 0
Calculates the dot product of two arrays in Euclidean metrics.
The function calculates and returns the Euclidean dot product of two arrays.
\[src1 \bullet src2 = \sum _I ( \texttt{src1} (I) \texttt{src2} (I))\]
In the case of multiple channel arrays, the results for all channels are accumulated. In particular, cvDotProduct(a,a) where a is a complex vector, will return \(||\texttt{a}||^2\). The function can process multi-dimensional arrays, row by row, layer by layer, and so on.
src1 | The first source array |
src2 | The second source array |
void cvEigenVV | ( | CvArr * | mat, |
CvArr * | evects, | ||
CvArr * | evals, | ||
double | eps = 0 , |
||
int | lowindex = -1 , |
||
int | highindex = -1 |
||
) |
Finds eigen values and vectors of a symmetric matrix
CvSeq* cvEndWriteSeq | ( | CvSeqWriter * | writer | ) |
Closes sequence writer, updates sequence header and returns pointer to the resultant sequence (which may be useful if the sequence was created using cvStartWriteSeq))
void cvEndWriteStruct | ( | CvFileStorage * | fs | ) |
void cvError | ( | int | status, |
const char * | func_name, | ||
const char * | err_msg, | ||
const char * | file_name, | ||
int | line | ||
) |
Sets error status and performs some additonal actions (displaying message box, writing message to stderr, terminating application etc.) depending on the current error mode
int cvErrorFromIppStatus | ( | int | ipp_status | ) |
Maps IPP error codes to the counterparts from OpenCV
const char* cvErrorStr | ( | int | status | ) |
Retrieves textual description of the error given its code
Does exponention: dst(idx) = exp(src(idx)). Overflow is not handled yet. Underflow is handled. Maximal relative error is ~7e-6 for single-precision input
float cvFastArctan | ( | float | y, |
float | x | ||
) |
Fast arctangent calculation
CvGraphEdge* cvFindGraphEdge | ( | const CvGraph * | graph, |
int | start_idx, | ||
int | end_idx | ||
) |
Find edge connecting two vertices
CvGraphEdge* cvFindGraphEdgeByPtr | ( | const CvGraph * | graph, |
const CvGraphVtx * | start_vtx, | ||
const CvGraphVtx * | end_vtx | ||
) |
CvTypeInfo* cvFindType | ( | const char * | type_name | ) |
Finds a type by its name.
The function finds a registered type by its name. It returns NULL if there is no type with the specified name.
type_name | Type name |
CvTypeInfo* cvFirstType | ( | void | ) |
Returns the beginning of a type list.
The function returns the first type in the list of registered types. Navigation through the list can be done via the prev and next fields of the CvTypeInfo structure.
Mirror array data around horizontal (flip=0), vertical (flip=1) or both(flip=-1) axises: cvFlip(src) flips images vertically and sequences horizontally (inplace)
void cvFlushSeqWriter | ( | CvSeqWriter * | writer | ) |
Updates sequence header. May be useful to get access to some of previously written elements via cvGetSeqElem or sequence reader
void cvFree_ | ( | void * | ptr | ) |
free
wrapper. Here and further all the memory releasing functions (that all call cvFree) take double pointer in order to to clear pointer to the data after releasing it. Passing pointer to NULL pointer is Ok: nothing happens in this case
void cvGEMM | ( | const CvArr * | src1, |
const CvArr * | src2, | ||
double | alpha, | ||
const CvArr * | src3, | ||
double | beta, | ||
CvArr * | dst, | ||
int | tABC = 0 |
||
) |
Extended matrix transform: dst = alpha*op(A)*op(B) + beta*op(C), where op(X) is X or X^T
Return a specific array element.
The functions return a specific array element. In the case of a sparse array the functions return 0 if the requested node does not exist (no new node is created by the functions).
arr | Input array |
idx0 | The first zero-based component of the element index |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array |
submat | Pointer to the resulting sub-array header |
col | Zero-based index of the selected column |
Returns one of more array columns.
The functions return the header, corresponding to a specified column span of the input array. That
is, no data is copied. Therefore, any modifications of the submatrix will affect the original array. If you need to copy the columns, use cvCloneMat. cvGetCol(arr, submat, col) is a shortcut for cvGetCols(arr, submat, col, col+1).
arr | Input array |
submat | Pointer to the resulting sub-array header |
start_col | Zero-based index of the starting column (inclusive) of the span |
end_col | Zero-based index of the ending column (exclusive) of the span |
Returns one of array diagonals.
The function returns the header, corresponding to a specified diagonal of the input array.
arr | Input array |
submat | Pointer to the resulting sub-array header |
diag | Index of the array diagonal. Zero value corresponds to the main diagonal, -1 corresponds to the diagonal above the main, 1 corresponds to the diagonal below the main, and so forth. |
int cvGetDims | ( | const CvArr * | arr, |
int * | sizes = NULL |
||
) |
Return number of array dimensions.
The function returns the array dimensionality and the array of dimension sizes. In the case of IplImage or CvMat it always returns 2 regardless of number of image/matrix rows. For example, the following code calculates total number of array elements:
arr | Input array |
sizes | Optional output vector of the array dimension sizes. For 2d arrays the number of rows (height) goes first, number of columns (width) next. |
int cvGetDimSize | ( | const CvArr * | arr, |
int | index | ||
) |
Returns array size along the specified dimension.
arr | Input array |
index | Zero-based dimension index (for matrices 0 means number of rows, 1 means number of columns; for images 0 means height, 1 means width) |
int cvGetElemType | ( | const CvArr * | arr | ) |
Returns type of array elements.
The function returns type of the array elements. In the case of IplImage the type is converted to CvMat-like representation. For example, if the image has been created as:
The code cvGetElemType(img) will return CV_8UC3.
arr | Input array |
int cvGetErrInfo | ( | const char ** | errcode_desc, |
const char ** | description, | ||
const char ** | filename, | ||
int * | line | ||
) |
Retrieves detailed information about the last error occured
int cvGetErrMode | ( | void | ) |
Retrives current error processing mode
int cvGetErrStatus | ( | void | ) |
Get current OpenCV error status
CvFileNode* cvGetFileNode | ( | CvFileStorage * | fs, |
CvFileNode * | map, | ||
const CvStringHashNode * | key, | ||
int | create_missing = 0 |
||
) |
Finds a node in a map or file storage.
The function finds a file node. It is a faster version of cvGetFileNodeByName (see cvGetHashedKey discussion). Also, the function can insert a new node, if it is not in the map yet.
fs | File storage |
map | The parent map. If it is NULL, the function searches a top-level node. If both map and key are NULLs, the function returns the root file node - a map that contains top-level nodes. |
key | Unique pointer to the node name, retrieved with cvGetHashedKey |
create_missing | Flag that specifies whether an absent node should be added to the map |
CvFileNode* cvGetFileNodeByName | ( | const CvFileStorage * | fs, |
const CvFileNode * | map, | ||
const char * | name | ||
) |
Finds a node in a map or file storage.
The function finds a file node by name. The node is searched either in map or, if the pointer is NULL, among the top-level file storage nodes. Using this function for maps and cvGetSeqElem (or sequence reader) for sequences, it is possible to navigate through the file storage. To speed up multiple queries for a certain key (e.g., in the case of an array of structures) one may use a combination of cvGetHashedKey and cvGetFileNode.
fs | File storage |
map | The parent map. If it is NULL, the function searches in all the top-level nodes (streams), starting with the first one. |
name | The file node name |
const char* cvGetFileNodeName | ( | const CvFileNode * | node | ) |
Returns the name of a file node.
The function returns the name of a file node or NULL, if the file node does not have a name or if node is NULL.
node | File node |
CvStringHashNode* cvGetHashedKey | ( | CvFileStorage * | fs, |
const char * | name, | ||
int | len = -1 , |
||
int | create_missing = 0 |
||
) |
Returns a unique pointer for a given name.
The function returns a unique pointer for each particular file node name. This pointer can be then passed to the cvGetFileNode function that is faster than cvGetFileNodeByName because it compares text strings by comparing pointers rather than the strings' content.
Consider the following example where an array of points is encoded as a sequence of 2-entry maps:
Then, it is possible to get hashed "x" and "y" pointers to speed up decoding of the points. :
Please note that whatever method of accessing a map you are using, it is still much slower than using plain sequences; for example, in the above example, it is more efficient to encode the points as pairs of integers in a single numeric sequence.
fs | File storage |
name | Literal node name |
len | Length of the name (if it is known apriori), or -1 if it needs to be calculated |
create_missing | Flag that specifies, whether an absent key should be added into the hash table |
Returns image header for arbitrary array.
The function returns the image header for the input array that can be a matrix (CvMat) or image (IplImage). In the case of an image the function simply returns the input pointer. In the case of CvMat it initializes an image_header structure with the parameters of the input matrix. Note that if we transform IplImage to CvMat using cvGetMat and then transform CvMat back to IplImage using this function, we will get different headers if the ROI is set in the original image.
arr | Input array |
image_header | Pointer to IplImage structure used as a temporary buffer |
int cvGetImageCOI | ( | const IplImage * | image | ) |
Returns the index of the channel of interest.
Returns the channel of interest of in an IplImage. Returned values correspond to the coi in cvSetImageCOI.
image | A pointer to the image header |
Returns the image ROI.
If there is no ROI set, cvRect(0,0,image->width,image->height) is returned.
image | A pointer to the image header |
Returns matrix header for arbitrary array.
The function returns a matrix header for the input array that can be a matrix - CvMat, an image - IplImage, or a multi-dimensional dense array - CvMatND (the third option is allowed only if allowND != 0) . In the case of matrix the function simply returns the input pointer. In the case of IplImage* or CvMatND it initializes the header structure with parameters of the current image ROI and returns &header. Because COI is not supported by CvMat, it is returned separately.
The function provides an easy way to handle both types of arrays - IplImage and CvMat using the same code. Input array must have non-zero data pointer, otherwise the function will report an error.
arr | Input array |
header | Pointer to CvMat structure used as a temporary buffer |
coi | Optional output parameter for storing COI |
allowND | If non-zero, the function accepts multi-dimensional dense arrays (CvMatND*) and returns 2D matrix (if CvMatND has two dimensions) or 1D matrix (when CvMatND has 1 dimension or more than 2 dimensions). The CvMatND array must be continuous. |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array |
idx | Array of the element indices |
CvSparseNode* cvGetNextSparseNode | ( | CvSparseMatIterator * | mat_iterator | ) |
Returns the next sparse matrix element.
The function moves iterator to the next sparse matrix element and returns pointer to it. In the current version there is no any particular order of the elements, because they are stored in the hash table. The sample below demonstrates how to iterate through the sparse matrix:
mat_iterator | Sparse array iterator |
int cvGetNumThreads | ( | void | ) |
retrieve/set the number of threads used in OpenMP implementations
int cvGetOptimalDFTSize | ( | int | size0 | ) |
Finds optimal DFT vector size >= size0
Retrieves low-level information about the array.
The function fills output variables with low-level information about the array data. All output
parameters are optional, so some of the pointers may be set to NULL. If the array is IplImage with ROI set, the parameters of ROI are returned.
The following example shows how to get access to array elements. It computes absolute values of the array elements :
arr | Array header |
data | Output pointer to the whole image origin or ROI origin if ROI is set |
step | Output full row length in bytes |
roi_size | Output ROI size |
double cvGetReal1D | ( | const CvArr * | arr, |
int | idx0 | ||
) |
Return a specific element of single-channel 1D, 2D, 3D or nD array.
Returns a specific element of a single-channel array. If the array has multiple channels, a runtime error is raised. Note that Get?D functions can be used safely for both single-channel and multiple-channel arrays though they are a bit slower.
In the case of a sparse array the functions return 0 if the requested node does not exist (no new node is created by the functions).
arr | Input array. Must have a single channel. |
idx0 | The first zero-based component of the element index |
double cvGetReal2D | ( | const CvArr * | arr, |
int | idx0, | ||
int | idx1 | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
double cvGetReal3D | ( | const CvArr * | arr, |
int | idx0, | ||
int | idx1, | ||
int | idx2 | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
double cvGetRealND | ( | const CvArr * | arr, |
const int * | idx | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array. Must have a single channel. |
idx | Array of the element indices |
CvFileNode* cvGetRootFileNode | ( | const CvFileStorage * | fs, |
int | stream_index = 0 |
||
) |
Retrieves one of the top-level nodes of the file storage.
The function returns one of the top-level file nodes. The top-level nodes do not have a name, they correspond to the streams that are stored one after another in the file storage. If the index is out of range, the function returns a NULL pointer, so all the top-level nodes can be iterated by subsequent calls to the function with stream_index=0,1,..., until the NULL pointer is returned. This function can be used as a base for recursive traversal of the file storage.
fs | File storage |
stream_index | Zero-based index of the stream. See cvStartNextStream . In most cases, there is only one stream in the file; however, there can be several. |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array |
submat | Pointer to the resulting sub-array header |
row | Zero-based index of the selected row |
CvMat* cvGetRows | ( | const CvArr * | arr, |
CvMat * | submat, | ||
int | start_row, | ||
int | end_row, | ||
int | delta_row = 1 |
||
) |
Returns array row or row span.
The functions return the header, corresponding to a specified row/row span of the input array. cvGetRow(arr, submat, row) is a shortcut for cvGetRows(arr, submat, row, row+1).
arr | Input array |
submat | Pointer to the resulting sub-array header |
start_row | Zero-based index of the starting row (inclusive) of the span |
end_row | Zero-based index of the ending row (exclusive) of the span |
delta_row | Index step in the row span. That is, the function extracts every delta_row -th row from start_row and up to (but not including) end_row . |
Retrieves pointer to specified sequence element. Negative indices are supported and mean counting from the end (e.g -1 means the last sequence element)
int cvGetSeqReaderPos | ( | CvSeqReader * | reader | ) |
Returns current sequence reader position (currently observed sequence element)
Returns a set element by index. If the element doesn't belong to the set, NULL is returned
Returns size of matrix or image ROI.
The function returns number of rows (CvSize::height) and number of columns (CvSize::width) of the input matrix or image. In the case of image the size of ROI is returned.
arr | array header |
Returns matrix header corresponding to the rectangular sub-array of input image or matrix.
The function returns header, corresponding to a specified rectangle of the input array. In other
words, it allows the user to treat a rectangular part of input array as a stand-alone array. ROI is taken into account by the function so the sub-array of ROI is actually extracted.
arr | Input array |
submat | Pointer to the resultant sub-array header |
rect | Zero-based coordinates of the rectangle of interest |
int cvGetThreadNum | ( | void | ) |
get index of the thread being executed
int64 cvGetTickCount | ( | void | ) |
helper functions for RNG initialization and accurate time measurement: uses internal clock counter on x86
double cvGetTickFrequency | ( | void | ) |
int cvGraphAddEdge | ( | CvGraph * | graph, |
int | start_idx, | ||
int | end_idx, | ||
const CvGraphEdge * | edge = NULL , |
||
CvGraphEdge ** | inserted_edge = NULL |
||
) |
Link two vertices specifed by indices or pointers if they are not connected or return pointer to already existing edge connecting the vertices. Functions return 1 if a new edge was created, 0 otherwise
int cvGraphAddEdgeByPtr | ( | CvGraph * | graph, |
CvGraphVtx * | start_vtx, | ||
CvGraphVtx * | end_vtx, | ||
const CvGraphEdge * | edge = NULL , |
||
CvGraphEdge ** | inserted_edge = NULL |
||
) |
int cvGraphAddVtx | ( | CvGraph * | graph, |
const CvGraphVtx * | vtx = NULL , |
||
CvGraphVtx ** | inserted_vtx = NULL |
||
) |
Adds new vertex to the graph
void cvGraphRemoveEdge | ( | CvGraph * | graph, |
int | start_idx, | ||
int | end_idx | ||
) |
Remove edge connecting two vertices
void cvGraphRemoveEdgeByPtr | ( | CvGraph * | graph, |
CvGraphVtx * | start_vtx, | ||
CvGraphVtx * | end_vtx | ||
) |
int cvGraphRemoveVtx | ( | CvGraph * | graph, |
int | index | ||
) |
Removes vertex from the graph together with all incident edges
int cvGraphRemoveVtxByPtr | ( | CvGraph * | graph, |
CvGraphVtx * | vtx | ||
) |
int cvGraphVtxDegree | ( | const CvGraph * | graph, |
int | vtx_idx | ||
) |
Count number of edges incident to the vertex
int cvGraphVtxDegreeByPtr | ( | const CvGraph * | graph, |
const CvGraphVtx * | vtx | ||
) |
int cvGuiBoxReport | ( | int | status, |
const char * | func_name, | ||
const char * | err_msg, | ||
const char * | file_name, | ||
int | line, | ||
void * | userdata | ||
) |
Output to MessageBox(WIN32)
int cvIncRefData | ( | CvArr * | arr | ) |
IplImage* cvInitImageHeader | ( | IplImage * | image, |
CvSize | size, | ||
int | depth, | ||
int | channels, | ||
int | origin = 0 , |
||
int | align = 4 |
||
) |
Initializes an image header that was previously allocated.
The returned IplImage* points to the initialized header.
image | Image header to initialize |
size | Image width and height |
depth | Image depth (see cvCreateImage ) |
channels | Number of channels (see cvCreateImage ) |
origin | Top-left IPL_ORIGIN_TL or bottom-left IPL_ORIGIN_BL |
align | Alignment for image rows, typically 4 or 8 bytes |
CvMat* cvInitMatHeader | ( | CvMat * | mat, |
int | rows, | ||
int | cols, | ||
int | type, | ||
void * | data = NULL , |
||
int | step = 0x7fffffff |
||
) |
Initializes a pre-allocated matrix header.
This function is often used to process raw data with OpenCV matrix functions. For example, the following code computes the matrix product of two matrices, stored as ordinary arrays:
mat | A pointer to the matrix header to be initialized |
rows | Number of rows in the matrix |
cols | Number of columns in the matrix |
type | Type of the matrix elements, see cvCreateMat . |
data | Optional: data pointer assigned to the matrix header |
step | Optional: full row width in bytes of the assigned data. By default, the minimal possible step is used which assumes there are no gaps between subsequent rows of the matrix. |
CvMatND* cvInitMatNDHeader | ( | CvMatND * | mat, |
int | dims, | ||
const int * | sizes, | ||
int | type, | ||
void * | data = NULL |
||
) |
Initializes a pre-allocated multi-dimensional array header.
mat | A pointer to the array header to be initialized |
dims | The number of array dimensions |
sizes | An array of dimension sizes |
type | Type of array elements, see cvCreateMat |
data | Optional data pointer assigned to the matrix header |
int cvInitNArrayIterator | ( | int | count, |
CvArr ** | arrs, | ||
const CvArr * | mask, | ||
CvMatND * | stubs, | ||
CvNArrayIterator * | array_iterator, | ||
int | flags = 0 |
||
) |
initializes iterator that traverses through several arrays simulteneously (the function together with cvNextArraySlice is used for N-ari element-wise operations)
CvSparseNode* cvInitSparseMatIterator | ( | const CvSparseMat * | mat, |
CvSparseMatIterator * | mat_iterator | ||
) |
Initializes sparse array elements iterator.
The function initializes iterator of sparse array elements and returns pointer to the first element, or NULL if the array is empty.
mat | Input array |
mat_iterator | Initialized iterator |
void cvInitTreeNodeIterator | ( | CvTreeNodeIterator * | tree_iterator, |
const void * | first, | ||
int | max_level | ||
) |
dst(idx) = lower(idx) <= src(idx) < upper(idx)
dst(idx) = lower <= src(idx) < upper
void cvInsertNodeIntoTree | ( | void * | node, |
void * | parent, | ||
void * | frame | ||
) |
Inserts sequence into tree with specified "parent" sequence. If parent is equal to frame (e.g. the most external contour), then added contour will have null pointer to parent.
int cvIplDepth | ( | int | type | ) |
int cvKMeans2 | ( | const CvArr * | samples, |
int | cluster_count, | ||
CvArr * | labels, | ||
CvTermCriteria | termcrit, | ||
int | attempts = 1 , |
||
CvRNG * | rng = 0 , |
||
int | flags = 0 , |
||
CvArr * | _centers = 0 , |
||
double * | compactness = 0 |
||
) |
void* cvLoad | ( | const char * | filename, |
CvMemStorage * | memstorage = NULL , |
||
const char * | name = NULL , |
||
const char ** | real_name = NULL |
||
) |
Loads an object from a file.
The function loads an object from a file. It basically reads the specified file, find the first top-level node and calls cvRead for that node. If the file node does not have type information or the type information can not be found by the type name, the function returns NULL. After the object is loaded, the file storage is closed and all the temporary buffers are deleted. Thus, to load a dynamic structure, such as a sequence, contour, or graph, one should pass a valid memory storage destination to the function.
filename | File name |
memstorage | Memory storage for dynamic structures, such as CvSeq or CvGraph . It is not used for matrices or images. |
name | Optional object name. If it is NULL, the first top-level object in the storage will be loaded. |
real_name | Optional output parameter that will contain the name of the loaded object (useful if name=NULL ) |
Calculates natural logarithms: dst(idx) = log(abs(src(idx))). Logarithm of 0 gives large negative number(~-700) Maximal relative error is ~3e-7 for single-precision output
Does look-up transformation. Elements of the source array (that should be 8uC1 or 8sC1) are used as indexes in lutarr 256-element table
Calculates Mahalanobis(weighted) distance
CvSeq* cvMakeSeqHeaderForArray | ( | int | seq_type, |
int | header_size, | ||
int | elem_size, | ||
void * | elements, | ||
int | total, | ||
CvSeq * | seq, | ||
CvSeqBlock * | block | ||
) |
Creates sequence header for array. After that all the operations on sequences that do not alter the content can be applied to the resultant sequence
CvMat cvMat | ( | int | rows, |
int | cols, | ||
int | type, | ||
void * | data = NULL |
||
) |
Inline constructor. No data is allocated internally!!! (Use together with cvCreateData, or use cvCreateMat instead to get a matrix with allocated data):
dst(idx) = max(src1(idx),src2(idx))
void* cvMemStorageAlloc | ( | CvMemStorage * | storage, |
size_t | size | ||
) |
Allocates continuous buffer of the specified size in the storage
CvString cvMemStorageAllocString | ( | CvMemStorage * | storage, |
const char * | ptr, | ||
int | len = -1 |
||
) |
Allocates string in memory storage
void cvMerge | ( | const CvArr * | src0, |
const CvArr * | src1, | ||
const CvArr * | src2, | ||
const CvArr * | src3, | ||
CvArr * | dst | ||
) |
Merges a set of single-channel arrays into the single multi-channel array or inserts one particular [color] plane to the array
double cvmGet | ( | const CvMat * | mat, |
int | row, | ||
int | col | ||
) |
Returns the particular element of single-channel floating-point matrix.
The function is a fast replacement for cvGetReal2D in the case of single-channel floating-point matrices. It is faster because it is inline, it does fewer checks for array type and array element type, and it checks for the row and column ranges only in debug mode.
mat | Input matrix |
row | The zero-based index of row |
col | The zero-based index of column |
dst(idx) = min(src1(idx),src2(idx))
void cvMinMaxLoc | ( | const CvArr * | arr, |
double * | min_val, | ||
double * | max_val, | ||
CvPoint * | min_loc = NULL , |
||
CvPoint * | max_loc = NULL , |
||
const CvArr * | mask = NULL |
||
) |
Finds global minimum, maximum and their positions
void cvMixChannels | ( | const CvArr ** | src, |
int | src_count, | ||
CvArr ** | dst, | ||
int | dst_count, | ||
const int * | from_to, | ||
int | pair_count | ||
) |
Copies several channels from input arrays to certain channels of output arrays
void cvmSet | ( | CvMat * | mat, |
int | row, | ||
int | col, | ||
double | value | ||
) |
Sets a specific element of a single-channel floating-point matrix.
The function is a fast replacement for cvSetReal2D in the case of single-channel floating-point matrices. It is faster because it is inline, it does fewer checks for array type and array element type, and it checks for the row and column ranges only in debug mode.
mat | The matrix |
row | The zero-based index of row |
col | The zero-based index of column |
value | The new value of the matrix element |
dst(idx) = src1(idx) * src2(idx) * scale (scaled element-wise multiplication of 2 arrays)
Multiply results of DFTs: DFT(X)*DFT(Y) or DFT(X)*conj(DFT(Y))
void cvMulTransposed | ( | const CvArr * | src, |
CvArr * | dst, | ||
int | order, | ||
const CvArr * | delta = NULL , |
||
double | scale = 1. |
||
) |
Calculates (A-delta)*(A-delta)^T (order=0) or (A-delta)^T*(A-delta) (order=1)
int cvNextGraphItem | ( | CvGraphScanner * | scanner | ) |
Get next graph element
int cvNextNArraySlice | ( | CvNArrayIterator * | array_iterator | ) |
returns zero value if iteration is finished, non-zero (slice length) otherwise
void* cvNextTreeNode | ( | CvTreeNodeIterator * | tree_iterator | ) |
double cvNorm | ( | const CvArr * | arr1, |
const CvArr * | arr2 = NULL , |
||
int | norm_type = 4 , |
||
const CvArr * | mask = NULL |
||
) |
Finds norm, difference norm or relative difference norm for an array (or two arrays)
void cvNormalize | ( | const CvArr * | src, |
CvArr * | dst, | ||
double | a = 1. , |
||
double | b = 0. , |
||
int | norm_type = 4 , |
||
const CvArr * | mask = NULL |
||
) |
int cvNulDevReport | ( | int | status, |
const char * | func_name, | ||
const char * | err_msg, | ||
const char * | file_name, | ||
int | line, | ||
void * | userdata | ||
) |
Output nothing
CvFileStorage* cvOpenFileStorage | ( | const char * | filename, |
CvMemStorage * | memstorage, | ||
int | flags, | ||
const char * | encoding = NULL |
||
) |
Opens file storage for reading or writing data.
The function opens file storage for reading or writing data. In the latter case, a new file is created or an existing file is rewritten. The type of the read or written file is determined by the filename extension: .xml for XML, .yml or .yaml for YAML and .json for JSON.
At the same time, it also supports adding parameters like "example.xml?base64". The three ways are the same:
The function returns a pointer to the CvFileStorage structure. If the file cannot be opened then the function returns NULL.
filename | Name of the file associated with the storage |
memstorage | Memory storage used for temporary data and for : storing dynamic structures, such as CvSeq or CvGraph . If it is NULL, a temporary memory storage is created and used. |
flags | Can be one of the following: (use CV_STORAGE_WRITE | CV_STORAGE_WRITE_BASE64 to write rawdata in Base64) |
encoding |
dst(idx) = src1(idx) | src2(idx)
dst(idx) = src(idx) | value
Does perspective transform on every element of input array
CvPoint2D32f cvPoint2D32f | ( | double | x, |
double | y | ||
) |
constructs CvPoint2D32f structure.
CvPoint2D64f cvPoint2D64f | ( | double | x, |
double | y | ||
) |
constructs CvPoint2D64f structure.
CvPoint3D32f cvPoint3D32f | ( | double | x, |
double | y, | ||
double | z | ||
) |
constructs CvPoint3D32f structure.
CvPoint3D64f cvPoint3D64f | ( | double | x, |
double | y, | ||
double | z | ||
) |
constructs CvPoint3D64f structure.
CvPoint cvPointFrom32f | ( | CvPoint2D32f | point | ) |
converts CvPoint2D32f to CvPoint.
CvPoint2D32f cvPointTo32f | ( | CvPoint | point | ) |
converts CvPoint to CvPoint2D32f.
void cvPolarToCart | ( | const CvArr * | magnitude, |
const CvArr * | angle, | ||
CvArr * | x, | ||
CvArr * | y, | ||
int | angle_in_degrees = 0 |
||
) |
Does polar->cartesian coordinates conversion. Either of output components (magnitude or angle) is optional. If magnitude is missing it is assumed to be all 1's
Does powering: dst(idx) = src(idx)^power
void* cvPrevTreeNode | ( | CvTreeNodeIterator * | tree_iterator | ) |
void cvProjectPCA | ( | const CvArr * | data, |
const CvArr * | mean, | ||
const CvArr * | eigenvects, | ||
CvArr * | result | ||
) |
Return pointer to a particular array element.
The functions return a pointer to a specific array element. Number of array dimension should match to the number of indices passed to the function except for cvPtr1D function that can be used for sequential access to 1D, 2D or nD dense arrays.
The functions can be used for sparse arrays as well - if the requested node does not exist they create it and set it to zero.
All these as well as other functions accessing array elements ( cvGetND , cvGetRealND , cvSet , cvSetND , cvSetRealND ) raise an error in case if the element index is out of range.
arr | Input array |
idx0 | The first zero-based component of the element index |
type | Optional output parameter: type of matrix elements |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
uchar* cvPtrND | ( | const CvArr * | arr, |
const int * | idx, | ||
int * | type = NULL , |
||
int | create_node = 1 , |
||
unsigned * | precalc_hashval = NULL |
||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array |
idx | Array of the element indices |
type | Optional output parameter: type of matrix elements |
create_node | Optional input parameter for sparse matrices. Non-zero value of the parameter means that the requested element is created if it does not exist already. |
precalc_hashval | Optional input parameter for sparse matrices. If the pointer is not NULL, the function does not recalculate the node hash value, but takes it from the specified location. It is useful for speeding up pair-wise operations (TODO: provide an example) |
Fills an array with random numbers and updates the RNG state.
The function fills the destination array with uniformly or normally distributed random numbers.
rng | CvRNG state initialized by cvRNG |
arr | The destination array |
dist_type | Distribution type
|
param1 | The first parameter of the distribution. In the case of a uniform distribution it is the inclusive lower boundary of the random numbers range. In the case of a normal distribution it is the mean value of the random numbers. |
param2 | The second parameter of the distribution. In the case of a uniform distribution it is the exclusive upper boundary of the random numbers range. In the case of a normal distribution it is the standard deviation of the random numbers. |
unsigned cvRandInt | ( | CvRNG * | rng | ) |
Returns a 32-bit unsigned integer and updates RNG.
The function returns a uniformly-distributed random 32-bit unsigned integer and updates the RNG state. It is similar to the rand() function from the C runtime library, except that OpenCV functions always generates a 32-bit random number, regardless of the platform.
rng | CvRNG state initialized by cvRNG. |
double cvRandReal | ( | CvRNG * | rng | ) |
Returns a floating-point random number and updates RNG.
The function returns a uniformly-distributed random floating-point number between 0 and 1 (1 is not included).
rng | RNG state initialized by cvRNG |
void cvRawDataToScalar | ( | const void * | data, |
int | type, | ||
CvScalar * | scalar | ||
) |
void* cvRead | ( | CvFileStorage * | fs, |
CvFileNode * | node, | ||
CvAttrList * | attributes = NULL |
||
) |
Decodes an object and returns a pointer to it.
The function decodes a user object (creates an object in a native representation from the file storage subtree) and returns it. The object to be decoded must be an instance of a registered type that supports the read method (see CvTypeInfo). The type of the object is determined by the type name that is encoded in the file. If the object is a dynamic structure, it is created either in memory storage and passed to cvOpenFileStorage or, if a NULL pointer was passed, in temporary memory storage, which is released when cvReleaseFileStorage is called. Otherwise, if the object is not a dynamic structure, it is created in a heap and should be released with a specialized function or by using the generic cvRelease.
fs | File storage |
node | The root object node |
attributes | Unused parameter |
void* cvReadByName | ( | CvFileStorage * | fs, |
const CvFileNode * | map, | ||
const char * | name, | ||
CvAttrList * | attributes = NULL |
||
) |
Finds an object by name and decodes it.
The function is a simple superposition of cvGetFileNodeByName and cvRead.
fs | File storage |
map | The parent map. If it is NULL, the function searches a top-level node. |
name | The node name |
attributes | Unused parameter |
int cvReadInt | ( | const CvFileNode * | node, |
int | default_value = 0 |
||
) |
Retrieves an integer value from a file node.
The function returns an integer that is represented by the file node. If the file node is NULL, the default_value is returned (thus, it is convenient to call the function right after cvGetFileNode without checking for a NULL pointer). If the file node has type CV_NODE_INT, then node->data.i is returned. If the file node has type CV_NODE_REAL, then node->data.f is converted to an integer and returned. Otherwise the error is reported.
node | File node |
default_value | The value that is returned if node is NULL |
int cvReadIntByName | ( | const CvFileStorage * | fs, |
const CvFileNode * | map, | ||
const char * | name, | ||
int | default_value = 0 |
||
) |
Finds a file node and returns its value.
The function is a simple superposition of cvGetFileNodeByName and cvReadInt.
fs | File storage |
map | The parent map. If it is NULL, the function searches a top-level node. |
name | The node name |
default_value | The value that is returned if the file node is not found |
void cvReadRawData | ( | const CvFileStorage * | fs, |
const CvFileNode * | src, | ||
void * | dst, | ||
const char * | dt | ||
) |
Reads multiple numbers.
The function reads elements from a file node that represents a sequence of scalars.
fs | File storage |
src | The file node (a sequence) to read numbers from |
dst | Pointer to the destination array |
dt | Specification of each array element. It has the same format as in cvWriteRawData . |
void cvReadRawDataSlice | ( | const CvFileStorage * | fs, |
CvSeqReader * | reader, | ||
int | count, | ||
void * | dst, | ||
const char * | dt | ||
) |
Initializes file node sequence reader.
The function reads one or more elements from the file node, representing a sequence, to a user-specified array. The total number of read sequence elements is a product of total and the number of components in each array element. For example, if dt=2if, the function will read total*3 sequence elements. As with any sequence, some parts of the file node sequence can be skipped or read repeatedly by repositioning the reader using cvSetSeqReaderPos.
fs | File storage |
reader | The sequence reader. Initialize it with cvStartReadRawData . |
count | The number of elements to read |
dst | Pointer to the destination array |
dt | Specification of each array element. It has the same format as in cvWriteRawData . |
double cvReadReal | ( | const CvFileNode * | node, |
double | default_value = 0. |
||
) |
Retrieves a floating-point value from a file node.
The function returns a floating-point value that is represented by the file node. If the file node is NULL, the default_value is returned (thus, it is convenient to call the function right after cvGetFileNode without checking for a NULL pointer). If the file node has type CV_NODE_REAL , then node->data.f is returned. If the file node has type CV_NODE_INT , then node-:math:>data.f is converted to floating-point and returned. Otherwise the result is not determined.
node | File node |
default_value | The value that is returned if node is NULL |
double cvReadRealByName | ( | const CvFileStorage * | fs, |
const CvFileNode * | map, | ||
const char * | name, | ||
double | default_value = 0. |
||
) |
Finds a file node and returns its value.
The function is a simple superposition of cvGetFileNodeByName and cvReadReal .
fs | File storage |
map | The parent map. If it is NULL, the function searches a top-level node. |
name | The node name |
default_value | The value that is returned if the file node is not found |
const char* cvReadString | ( | const CvFileNode * | node, |
const char * | default_value = NULL |
||
) |
Retrieves a text string from a file node.
The function returns a text string that is represented by the file node. If the file node is NULL, the default_value is returned (thus, it is convenient to call the function right after cvGetFileNode without checking for a NULL pointer). If the file node has type CV_NODE_STR , then node-:math:>data.str.ptr is returned. Otherwise the result is not determined.
node | File node |
default_value | The value that is returned if node is NULL |
const char* cvReadStringByName | ( | const CvFileStorage * | fs, |
const CvFileNode * | map, | ||
const char * | name, | ||
const char * | default_value = NULL |
||
) |
Finds a file node by its name and returns its value.
The function is a simple superposition of cvGetFileNodeByName and cvReadString .
fs | File storage |
map | The parent map. If it is NULL, the function searches a top-level node. |
name | The node name |
default_value | The value that is returned if the file node is not found |
CvScalar cvRealScalar | ( | double | val0 | ) |
CvErrorCallback cvRedirectError | ( | CvErrorCallback | error_handler, |
void * | userdata = NULL , |
||
void ** | prev_userdata = NULL |
||
) |
Assigns a new error-handling function
void cvRegisterType | ( | const CvTypeInfo * | info | ) |
Registers a new type.
The function registers a new type, which is described by info . The function creates a copy of the structure, so the user should delete it after calling the function.
info | Type info structure |
void cvRelease | ( | void ** | struct_ptr | ) |
Releases an object.
The function finds the type of a given object and calls release with the double pointer.
struct_ptr | Double pointer to the object |
void cvReleaseData | ( | CvArr * | arr | ) |
Releases array data.
The function releases the array data. In the case of CvMat or CvMatND it simply calls cvDecRefData(), that is the function can not deallocate external data. See also the note to cvCreateData .
arr | Array header |
void cvReleaseFileStorage | ( | CvFileStorage ** | fs | ) |
Releases file storage.
The function closes the file associated with the storage and releases all the temporary structures. It must be called after all I/O operations with the storage are finished.
fs | Double pointer to the released file storage |
void cvReleaseGraphScanner | ( | CvGraphScanner ** | scanner | ) |
Releases graph scanner.
void cvReleaseImage | ( | IplImage ** | image | ) |
Deallocates the image header and the image data.
This call is a shortened form of :
image | Double pointer to the image header |
void cvReleaseImageHeader | ( | IplImage ** | image | ) |
Deallocates an image header.
This call is an analogue of :
but it does not use IPL functions by default (see the CV_TURN_ON_IPL_COMPATIBILITY macro).
image | Double pointer to the image header |
void cvReleaseMat | ( | CvMat ** | mat | ) |
Deallocates a matrix.
The function decrements the matrix data reference counter and deallocates matrix header. If the data reference counter is 0, it also deallocates the data. :
mat | Double pointer to the matrix |
void cvReleaseMatND | ( | CvMatND ** | mat | ) |
Deallocates a multi-dimensional array.
The function decrements the array data reference counter and releases the array header. If the reference counter reaches 0, it also deallocates the data. :
mat | Double pointer to the array |
void cvReleaseMemStorage | ( | CvMemStorage ** | storage | ) |
Releases memory storage. All the children of a parent must be released before the parent. A child storage returns all the blocks to parent when it is released
void cvReleaseSparseMat | ( | CvSparseMat ** | mat | ) |
Deallocates sparse array.
The function releases the sparse array and clears the array pointer upon exit.
mat | Double pointer to the array |
void cvRemoveNodeFromTree | ( | void * | node, |
void * | frame | ||
) |
Removes contour from tree (together with the contour children).
Repeats source 2d array several times in both horizontal and vertical direction to fill destination array
void cvResetImageROI | ( | IplImage * | image | ) |
Resets the image ROI to include the entire image and releases the ROI structure.
This produces a similar result to the following, but in addition it releases the ROI structure. :
image | A pointer to the image header |
Changes shape of matrix/image without copying data.
The function initializes the CvMat header so that it points to the same data as the original array but has a different shape - different number of channels, different number of rows, or both.
The following example code creates one image buffer and two image headers, the first is for a 320x240x3 image and the second is for a 960x240x1 image:
And the next example converts a 3x3 matrix to a single 1x9 vector:
arr | Input array |
header | Output header to be filled |
new_cn | New number of channels. 'new_cn = 0' means that the number of channels remains unchanged. |
new_rows | New number of rows. 'new_rows = 0' means that the number of rows remains unchanged unless it needs to be changed according to new_cn value. |
CvArr* cvReshapeMatND | ( | const CvArr * | arr, |
int | sizeof_header, | ||
CvArr * | header, | ||
int | new_cn, | ||
int | new_dims, | ||
int * | new_sizes | ||
) |
Changes the shape of a multi-dimensional array without copying the data.
The function is an advanced version of cvReshape that can work with multi-dimensional arrays as well (though it can work with ordinary images and matrices) and change the number of dimensions.
Below are the two samples from the cvReshape description rewritten using cvReshapeMatND:
In C, the header file for this function includes a convenient macro cvReshapeND that does away with the sizeof_header parameter. So, the lines containing the call to cvReshapeMatND in the examples may be replaced as follow:
arr | Input array |
sizeof_header | Size of output header to distinguish between IplImage, CvMat and CvMatND output headers |
header | Output header to be filled |
new_cn | New number of channels. new_cn = 0 means that the number of channels remains unchanged. |
new_dims | New number of dimensions. new_dims = 0 means that the number of dimensions remains the same. |
new_sizes | Array of new dimension sizes. Only new_dims-1 values are used, because the total number of elements must remain the same. Thus, if new_dims = 1, new_sizes array is not used. |
void cvRestoreMemStoragePos | ( | CvMemStorage * | storage, |
CvMemStoragePos * | pos | ||
) |
Restore a storage "free memory" position
Initializes a random number generator state.
The function initializes a random number generator and returns the state. The pointer to the state can be then passed to the cvRandInt, cvRandReal and cvRandArr functions. In the current implementation a multiply-with-carry generator is used.
seed | 64-bit value used to initiate a random sequence |
void cvSave | ( | const char * | filename, |
const void * | struct_ptr, | ||
const char * | name = NULL , |
||
const char * | comment = NULL , |
||
CvAttrList | attributes = cvAttrList() |
||
) |
Saves an object to a file.
The function saves an object to a file. It provides a simple interface to cvWrite .
filename | File name |
struct_ptr | Object to save |
name | Optional object name. If it is NULL, the name will be formed from filename . |
comment | Optional comment to put in the beginning of the file |
attributes | Optional attributes passed to cvWrite |
void cvSaveMemStoragePos | ( | const CvMemStorage * | storage, |
CvMemStoragePos * | pos | ||
) |
Remember a storage "free memory" position
CvScalar cvScalar | ( | double | val0, |
double | val1 = 0 , |
||
double | val2 = 0 , |
||
double | val3 = 0 |
||
) |
CvScalar cvScalarAll | ( | double | val0123 | ) |
void cvScalarToRawData | ( | const CvScalar * | scalar, |
void * | data, | ||
int | type, | ||
int | extend_to_12 = 0 |
||
) |
low-level scalar <-> raw data conversion functions
dst = src1 * scale + src2
int cvSeqElemIdx | ( | const CvSeq * | seq, |
const void * | element, | ||
CvSeqBlock ** | block = NULL |
||
) |
Calculates index of the specified sequence element. Returns -1 if element does not belong to the sequence
Inserts a new element in the middle of sequence. cvSeqInsert(seq,0,elem) == cvSeqPushFront(seq,elem)
Inserts a sequence or array into another sequence
void cvSeqInvert | ( | CvSeq * | seq | ) |
Reverses order of sequence elements in-place
int cvSeqPartition | ( | const CvSeq * | seq, |
CvMemStorage * | storage, | ||
CvSeq ** | labels, | ||
CvCmpFunc | is_equal, | ||
void * | userdata | ||
) |
Splits sequence into one or more equivalence classes using the specified criteria
void cvSeqPop | ( | CvSeq * | seq, |
void * | element = NULL |
||
) |
Removes the last element from sequence and optionally saves it
void cvSeqPopFront | ( | CvSeq * | seq, |
void * | element = NULL |
||
) |
Removes the first element from sequence and optioanally saves it
void cvSeqPopMulti | ( | CvSeq * | seq, |
void * | elements, | ||
int | count, | ||
int | in_front = 0 |
||
) |
Removes several elements from the end of sequence and optionally saves them
Adds new element to the end of sequence. Returns pointer to the element
Adds new element to the beginning of sequence. Returns pointer to it
void cvSeqPushMulti | ( | CvSeq * | seq, |
const void * | elements, | ||
int | count, | ||
int | in_front = 0 |
||
) |
Adds several new elements to the end of sequence
void cvSeqRemove | ( | CvSeq * | seq, |
int | index | ||
) |
Removes specified sequence element
schar* cvSeqSearch | ( | CvSeq * | seq, |
const void * | elem, | ||
CvCmpFunc | func, | ||
int | is_sorted, | ||
int * | elem_idx, | ||
void * | userdata = NULL |
||
) |
Finds element in a [sorted] sequence
CvSeq* cvSeqSlice | ( | const CvSeq * | seq, |
CvSlice | slice, | ||
CvMemStorage * | storage = NULL , |
||
int | copy_data = 0 |
||
) |
Extracts sequence slice (with or without copying sequence elements)
Sorts sequence in-place given element comparison function
Sets every element of an array to a given value.
The function copies the scalar value to every selected element of the destination array:
\[\texttt{arr} (I)= \texttt{value} \quad \text{if} \quad \texttt{mask} (I) \ne 0\]
If array arr is of IplImage type, then is ROI used, but COI must not be set.
arr | The destination array |
value | Fill value |
mask | Operation mask, 8-bit single channel array; specifies elements of the destination array to be changed |
Change the particular array element.
The functions assign the new value to a particular array element. In the case of a sparse array the functions create the node if it does not exist yet.
arr | Input array |
idx0 | The first zero-based component of the element index |
value | The assigned value |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Adds new element to the set and returns pointer to it
void cvSetData | ( | CvArr * | arr, |
void * | data, | ||
int | step | ||
) |
Assigns user data to the array header.
The function assigns user data to the array header. Header should be initialized before using cvCreateMatHeader, cvCreateImageHeader, cvCreateMatNDHeader, cvInitMatHeader, cvInitImageHeader or cvInitMatNDHeader.
arr | Array header |
data | User data |
step | Full row length in bytes |
int cvSetErrMode | ( | int | mode | ) |
Sets error processing mode, returns previously used mode
void cvSetErrStatus | ( | int | status | ) |
Sets error status silently
void cvSetIdentity | ( | CvArr * | mat, |
CvScalar | value = cvRealScalar(1) |
||
) |
void cvSetImageCOI | ( | IplImage * | image, |
int | coi | ||
) |
Sets the channel of interest in an IplImage.
If the ROI is set to NULL and the coi is not 0, the ROI is allocated. Most OpenCV functions do not* support the COI setting, so to process an individual image/matrix channel one may copy (via cvCopy or cvSplit) the channel to a separate image/matrix, process it and then copy the result back (via cvCopy or cvMerge) if needed.
image | A pointer to the image header |
coi | The channel of interest. 0 - all channels are selected, 1 - first channel is selected, etc. Note that the channel indices become 1-based. |
Sets an image Region Of Interest (ROI) for a given rectangle.
If the original image ROI was NULL and the rect is not the whole image, the ROI structure is allocated.
Most OpenCV functions support the use of ROI and treat the image rectangle as a separate image. For example, all of the pixel coordinates are counted from the top-left (or bottom-left) corner of the ROI, not the original image.
image | A pointer to the image header |
rect | The ROI rectangle |
void cvSetIPLAllocators | ( | Cv_iplCreateImageHeader | create_header, |
Cv_iplAllocateImageData | allocate_data, | ||
Cv_iplDeallocate | deallocate, | ||
Cv_iplCreateROI | create_roi, | ||
Cv_iplCloneImage | clone_image | ||
) |
Makes OpenCV use IPL functions for allocating IplImage and IplROI structures.
Normally, the function is not called directly. Instead, a simple macro CV_TURN_ON_IPL_COMPATIBILITY() is used that calls cvSetIPLAllocators and passes there pointers to IPL allocation functions. :
create_header | pointer to a function, creating IPL image header. |
allocate_data | pointer to a function, allocating IPL image data. |
deallocate | pointer to a function, deallocating IPL image. |
create_roi | pointer to a function, creating IPL image ROI (i.e. Region of Interest). |
clone_image | pointer to a function, cloning an IPL image. |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array |
idx | Array of the element indices |
value | The assigned value |
void cvSetNumThreads | ( | int | threads = 0 | ) |
void cvSetReal1D | ( | CvArr * | arr, |
int | idx0, | ||
double | value | ||
) |
Change a specific array element.
The functions assign a new value to a specific element of a single-channel array. If the array has multiple channels, a runtime error is raised. Note that the Set*D function can be used safely for both single-channel and multiple-channel arrays, though they are a bit slower.
In the case of a sparse array the functions create the node if it does not yet exist.
arr | Input array |
idx0 | The first zero-based component of the element index |
value | The assigned value |
void cvSetReal2D | ( | CvArr * | arr, |
int | idx0, | ||
int | idx1, | ||
double | value | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
void cvSetReal3D | ( | CvArr * | arr, |
int | idx0, | ||
int | idx1, | ||
int | idx2, | ||
double | value | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
void cvSetRealND | ( | CvArr * | arr, |
const int * | idx, | ||
double | value | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
arr | Input array |
idx | Array of the element indices |
value | The assigned value |
void cvSetRemove | ( | CvSet * | set_header, |
int | index | ||
) |
Removes element from the set by its index
void cvSetRemoveByPtr | ( | CvSet * | set_header, |
void * | elem | ||
) |
Removes set element given its pointer
void cvSetSeqBlockSize | ( | CvSeq * | seq, |
int | delta_elems | ||
) |
Changes default size (granularity) of sequence blocks. The default size is ~1Kbyte
void cvSetSeqReaderPos | ( | CvSeqReader * | reader, |
int | index, | ||
int | is_relative = 0 |
||
) |
Changes sequence reader position. It may seek to an absolute or to relative to the current position
void cvSetZero | ( | CvArr * | arr | ) |
Clears the array.
The function clears the array. In the case of dense arrays (CvMat, CvMatND or IplImage), cvZero(array) is equivalent to cvSet(array,cvScalarAll(0),0). In the case of sparse arrays all the elements are removed.
arr | Array to be cleared |
CvSize2D32f cvSize2D32f | ( | double | width, |
double | height | ||
) |
constructs CvSize2D32f structure.
CvSlice cvSlice | ( | int | start, |
int | end | ||
) |
Calculates length of sequence slice (with support of negative indices).
Solves linear system (src1)*(dst) = (src2) (returns 0 if src1 is a singular and CV_LU method is used)
Finds all real and complex roots of a polynomial equation
Splits a multi-channel array into the set of single-channel arrays or extracts particular [color] plane
void cvStartAppendToSeq | ( | CvSeq * | seq, |
CvSeqWriter * | writer | ||
) |
Initializes sequence writer. The new elements will be added to the end of sequence
void cvStartNextStream | ( | CvFileStorage * | fs | ) |
Starts the next stream.
The function finishes the currently written stream and starts the next stream. In the case of XML the file with multiple streams looks like this:
The YAML file will look like this:
This is useful for concatenating files or for resuming the writing process.
fs | File storage |
void cvStartReadRawData | ( | const CvFileStorage * | fs, |
const CvFileNode * | src, | ||
CvSeqReader * | reader | ||
) |
Initializes the file node sequence reader.
The function initializes the sequence reader to read data from a file node. The initialized reader can be then passed to cvReadRawDataSlice.
fs | File storage |
src | The file node (a sequence) to read numbers from |
reader | Pointer to the sequence reader |
void cvStartReadSeq | ( | const CvSeq * | seq, |
CvSeqReader * | reader, | ||
int | reverse = 0 |
||
) |
Initializes sequence reader. The sequence can be read in forward or backward direction
void cvStartWriteSeq | ( | int | seq_flags, |
int | header_size, | ||
int | elem_size, | ||
CvMemStorage * | storage, | ||
CvSeqWriter * | writer | ||
) |
Combination of cvCreateSeq and cvStartAppendToSeq
void cvStartWriteStruct | ( | CvFileStorage * | fs, |
const char * | name, | ||
int | struct_flags, | ||
const char * | type_name = NULL , |
||
CvAttrList | attributes = cvAttrList() |
||
) |
Starts writing a new structure.
The function starts writing a compound structure (collection) that can be a sequence or a map. After all the structure fields, which can be scalars or structures, are written, cvEndWriteStruct should be called. The function can be used to group some objects or to implement the write function for a some user object (see CvTypeInfo).
fs | File storage |
name | Name of the written structure. The structure can be accessed by this name when the storage is read. |
struct_flags | A combination one of the following values:
|
type_name | Optional parameter - the object type name. In case of XML it is written as a type_id attribute of the structure opening tag. In the case of YAML it is written after a colon following the structure name (see the example in CvFileStorage description). In case of JSON it is written as a name/value pair. Mainly it is used with user objects. When the storage is read, the encoded type name is used to determine the object type (see CvTypeInfo and cvFindType ). |
attributes | This parameter is not used in the current implementation |
int cvStdErrReport | ( | int | status, |
const char * | func_name, | ||
const char * | err_msg, | ||
const char * | file_name, | ||
int | line, | ||
void * | userdata | ||
) |
Output to console(fprintf(stderr,...))
dst(mask) = src1(mask) - src2(mask)
dst(mask) = value - src(mask)
dst(mask) = src(mask) - value = src(mask) + (-value)
void cvSVBkSb | ( | const CvArr * | W, |
const CvArr * | U, | ||
const CvArr * | V, | ||
const CvArr * | B, | ||
CvArr * | X, | ||
int | flags | ||
) |
Performs Singular Value Back Substitution (solves A*X = B): flags must be the same as in cvSVD
Performs Singular Value Decomposition of a matrix
CvTermCriteria cvTermCriteria | ( | int | type, |
int | max_iter, | ||
double | epsilon | ||
) |
Calculates trace of the matrix (sum of elements on the main diagonal)
void cvTransform | ( | const CvArr * | src, |
CvArr * | dst, | ||
const CvMat * | transmat, | ||
const CvMat * | shiftvec = NULL |
||
) |
Transforms each element of source array and stores resultant vectors in destination array
Tranposes matrix. Square matrices can be transposed in-place
CvSeq* cvTreeToNodeSeq | ( | const void * | first, |
int | header_size, | ||
CvMemStorage * | storage | ||
) |
Gathers pointers to all the sequences, accessible from the first
, to the single sequence
CvTypeInfo* cvTypeOf | ( | const void * | struct_ptr | ) |
Returns the type of an object.
The function finds the type of a given object. It iterates through the list of registered types and calls the is_instance function/method for every type info structure with that object until one of them returns non-zero or until the whole list has been traversed. In the latter case, the function returns NULL.
struct_ptr | The object pointer |
void cvUnregisterType | ( | const char * | type_name | ) |
Unregisters the type.
The function unregisters a type with a specified name. If the name is unknown, it is possible to locate the type info by an instance of the type using cvTypeOf or by iterating the type list, starting from cvFirstType, and then calling cvUnregisterType(info->typeName).
type_name | Name of an unregistered type |
int cvUseOptimized | ( | int | on_off | ) |
Loads optimized functions from IPP, MKL etc. or switches back to pure C code
void cvWrite | ( | CvFileStorage * | fs, |
const char * | name, | ||
const void * | ptr, | ||
CvAttrList | attributes = cvAttrList() |
||
) |
Writes an object to file storage.
The function writes an object to file storage. First, the appropriate type info is found using cvTypeOf. Then, the write method associated with the type info is called.
Attributes are used to customize the writing procedure. The standard types support the following attributes (all the dt attributes have the same format as in cvWriteRawData):
Below is the code that creates the YAML file shown in the CvFileStorage description:
fs | File storage |
name | Name of the written object. Should be NULL if and only if the parent structure is a sequence. |
ptr | Pointer to the object |
attributes | The attributes of the object. They are specific for each particular type (see the discussion below). |
void cvWriteComment | ( | CvFileStorage * | fs, |
const char * | comment, | ||
int | eol_comment | ||
) |
Writes a comment.
The function writes a comment into file storage. The comments are skipped when the storage is read.
fs | File storage |
comment | The written comment, single-line or multi-line |
eol_comment | If non-zero, the function tries to put the comment at the end of current line. If the flag is zero, if the comment is multi-line, or if it does not fit at the end of the current line, the comment starts a new line. |
void cvWriteFileNode | ( | CvFileStorage * | fs, |
const char * | new_node_name, | ||
const CvFileNode * | node, | ||
int | embed | ||
) |
Writes a file node to another file storage.
The function writes a copy of a file node to file storage. Possible applications of the function are merging several file storages into one and conversion between XML, YAML and JSON formats.
fs | Destination file storage |
new_node_name | New name of the file node in the destination file storage. To keep the existing name, use cvcvGetFileNodeName |
node | The written node |
embed | If the written node is a collection and this parameter is not zero, no extra level of hierarchy is created. Instead, all the elements of node are written into the currently written structure. Of course, map elements can only be embedded into another map, and sequence elements can only be embedded into another sequence. |
void cvWriteInt | ( | CvFileStorage * | fs, |
const char * | name, | ||
int | value | ||
) |
Writes an integer value.
The function writes a single integer value (with or without a name) to the file storage.
fs | File storage |
name | Name of the written value. Should be NULL if and only if the parent structure is a sequence. |
value | The written value |
void cvWriteRawData | ( | CvFileStorage * | fs, |
const void * | src, | ||
int | len, | ||
const char * | dt | ||
) |
Writes multiple numbers.
The function writes an array, whose elements consist of single or multiple numbers. The function call can be replaced with a loop containing a few cvWriteInt and cvWriteReal calls, but a single call is more efficient. Note that because none of the elements have a name, they should be written to a sequence rather than a map.
fs | File storage |
src | Pointer to the written array |
len | Number of the array elements to write |
dt | Specification of each array element, see format specification |
void cvWriteRawDataBase64 | ( | CvFileStorage * | fs, |
const void * | src, | ||
int | len, | ||
const char * | dt | ||
) |
Writes multiple numbers in Base64.
If either CV_STORAGE_WRITE_BASE64 or cv::FileStorage::WRITE_BASE64 is used, this function will be the same as cvWriteRawData. If neither, the main difference is that it outputs a sequence in Base64 encoding rather than in plain text.
This function can only be used to write a sequence with a type "binary".
Consider the following two examples where their output is the same:
and
fs | File storage |
src | Pointer to the written array |
len | Number of the array elements to write |
dt | Specification of each array element, see format specification |
void cvWriteReal | ( | CvFileStorage * | fs, |
const char * | name, | ||
double | value | ||
) |
Writes a floating-point value.
The function writes a single floating-point value (with or without a name) to file storage. Special values are encoded as follows: NaN (Not A Number) as .NaN, infinity as +.Inf or -.Inf.
The following example shows how to use the low-level writing functions to store custom structures, such as termination criteria, without registering a new type. :
fs | File storage |
name | Name of the written value. Should be NULL if and only if the parent structure is a sequence. |
value | The written value |
void cvWriteString | ( | CvFileStorage * | fs, |
const char * | name, | ||
const char * | str, | ||
int | quote = 0 |
||
) |
Writes a text string.
The function writes a text string to file storage.
fs | File storage |
name | Name of the written string . Should be NULL if and only if the parent structure is a sequence. |
str | The written text string |
quote | If non-zero, the written string is put in quotes, regardless of whether they are required. Otherwise, if the flag is zero, quotes are used only when they are required (e.g. when the string starts with a digit or contains spaces). |
dst(idx) = src1(idx) ^ src2(idx)