Dokumentacja pliku cxcore.h

cxcore.h - podstawe struktury, operacje na tablicach, dynamiczne struktury, odczyt/zapis danych i obsługa błędów Więcej...

#include "cxtypes.h"
#include "cxerror.h"
#include "cvver.h"

Wykres zależności załączania dla cxcore.h:

Ten wykres pokazuje, które pliki bezpośrednio lub pośrednio załączają ten plik:

Definicje
#define	cvZero   cvSetZero
Funkcje
IplImage *	cvCreateImage (CvSize size, int depth, int channels)
	tworzy nagłówek obrazu i alokuje miejsce na dane
IplImage *	cvCloneImage (const IplImage *image)
	tworzy głęboką kopią obrazu źródłowego
CvMat *	cvCreateMat (int rows, int cols, int type)
	tworzy nową macierz
void	cvReleaseMat (CvMat **mat)
	zwalnia nagłówek i dealokuje dane
CvMat *	cvGetRows (const CvArr *arr, CvMat *submat, int start_row, int end_row, int delta_row)
	zwraca wiersze z macierzy wejściowej
CvMat *	cvGetRow (const CvArr *arr, CvMat *submat, int row)
	zwraca jeden wiersz z macierzy
CvMat *	cvGetCols (const CvArr *arr, CvMat *submat, int start_col, int end_col)
	zwraca kolumny z macierzy wejściowej
CvMat *	cvGetCol (const CvArr *arr, CvMat *submat, int col)
	zwraca jedeną kolumnę z macierzy
CvSize	cvGetSize (const CvArr *arr)
	zwraca rozmiar tablicy
void	cvSetZero (CvArr *arr)
	zeruje wszystkie elementy tablicy
void	cvNot (const CvArr *src, CvArr *dst)
	dst(idx) = ~src(idx)

---

Opis szczegółowy

cxcore.h - podstawe struktury, operacje na tablicach, dynamiczne struktury, odczyt/zapis danych i obsługa błędów

Funkcje i struktury służące do operacji na tablicach, dynamicznych strukturach danych, odczytu i zapisu danych z dysku oraz funkcje związane z RTTI i obsługą błędów

---

Dokumentacja definicji

#define cvZero   cvSetZero

Zobacz również:

cvSetZero

Przykłady:

contours.c, demhist.c, drawing.c i watershed.cpp.

---

Dokumentacja funkcji

IplImage * cvCloneImage

(

const IplImage *

image

)

tworzy głęboką kopią obrazu źródłowego

Funkcja cvCloneImage tworzy pełną kopię obrazu, uwzględniając nagłówek, ROI i dane

Parametry:

image

orginalny obraz

Zwraca:

IplImage* wskaźnik do nowego obrazu

Przykłady:

demhist.c, drawing.c i watershed.cpp.

IplImage * cvCreateImage	(	CvSize	size,
		int	depth,
		int	channels
	)

tworzy nagłówek obrazu i alokuje miejsce na dane

Funkcja cvCreateImage tworzy nagłówek obrazu i alokuje miejce na dane. cvCreateImage faktycznie wywołuje sekwencję

 header = cvCreateImageHeader(size,depth,channels);
 cvCreateData(header);

Parametry:

	size	rozmiar obrazu
	depth	ilość bitów na kanał. Obsługiwane formaty to : IPL_DEPTH_8U - 8-bitowy integer bez znaku IPL_DEPTH_8S - 8-bitowy integer ze znakiem IPL_DEPTH_16U - 16-bitowy integer bez znaku IPL_DEPTH_16S - 16-bitowy integer ze znakiem IPL_DEPTH_32S - 32-bit integer ze znakiem IPL_DEPTH_32F - liczba zmiennoprzecinkowa pojedynczej precyzji IPL_DEPTH_64F - liczba zmiennoprzecinkowa podwójnej precyzji
	channels	ilość kanałów - 1,2,3 lub 4

Zwraca:

IplImage* wskaźnik do utworzonego obrazu

Przykłady:

contours.c, demhist.c, drawing.c, laplace.c i watershed.cpp.

CvMat * cvCreateMat	(	int	rows,
		int	cols,
		int	type
	)

tworzy nową macierz

Funkcja cvCreateMat alokuje miejsce na nagłówek macierzy i dane i zwraca wskaźnik do utworzonej macierzy. cvCreateMat jest skrótem do

 CvMat* mat = cvCreateMatHeader( rows, cols, type );
 cvCreateData( mat );

macierze są przechowywane wiersz za wierszem, wszytkie wiersze są wyrównane do 4 bajtów

Parametry:

	rows	ilość wierszy w macierzy
	cols	ilość kolumn w macierzy
	type	Typ elementów w macierzy. Zwykle jest podany w formie CV_<ilość_bitów>(S|U|F)C<ilość kanałów>, na przykład CV_8UC1 znaczy 8-bitowa jedno-kanałowa macierz liczb bez znaku, CV_32SC2 znaczy 32-bitowa dwu-kanałowa macierz liczb ze znakiem

Zwraca:

CvMat* wskaźnik do zaalokowanych danych

Przykłady:

watershed.cpp.

CvMat * cvGetCol	(	const CvArr *	arr,
		CvMat *	submat,
		int	col
	)

zwraca jedeną kolumnę z macierzy

Parametry:

	arr	macierz wejsciowa
	submat	wynikowa macierz
	col	indeks kolumny

Zwraca:

CvMat* wskażnik do nowej macierzy

CvMat * cvGetCols	(	const CvArr *	arr,
		CvMat *	submat,
		int	start_col,
		int	end_col
	)

zwraca kolumny z macierzy wejściowej

Parametry:

	arr	macierz wejsciowa
	submat	wynikowa macierz
	start_col	początkowa kolumna zakresu
	end_col	końcowa kolumna zakresu

Zwraca:

CvMat* wskażnik do nowej macierzy

CvMat * cvGetRow	(	const CvArr *	arr,
		CvMat *	submat,
		int	row
	)

zwraca jeden wiersz z macierzy

Parametry:

	arr	macierz wejsciowa
	submat	wynikowa macierz
	row	indeks wiersza

Zwraca:

CvMat* wskażnik do nowej macierzy

CvMat * cvGetRows	(	const CvArr *	arr,
		CvMat *	submat,
		int	start_row,
		int	end_row,
		int	delta_row
	)

zwraca wiersze z macierzy wejściowej

Parametry:

	arr	macierz wejsciowa
	submat	wynikowa macierz
	start_row	początkowy wiersz zakresu
	end_row	końcowy wiersz zakresu
	delta_row	domyślnie == 1

Zwraca:

CvMat* wskażnik do nowej macierzy

CvSize cvGetSize

(

const CvArr *

arr

)

zwraca rozmiar tablicy

Parametry:

arr

tablica

Zwraca:

CvSize rozmiar tablicy

Przykłady:

watershed.cpp.

void cvNot	(	const CvArr *	src,
		CvArr *	dst
	)

dst(idx) = ~src(idx)

Parametry:

	src	macierz wejściowa
	dst	macierz wynikowa, może być == wejściowej

void cvReleaseMat

(

CvMat **

mat

)

zwalnia nagłówek i dealokuje dane

Funkcja cvReleaseMat zwalnia pamięć zajętą przez macierz oraz elemety macierzy (do zwalniania danych używa zliczania referencji)

Przykłady:

watershed.cpp.

void cvSetZero

(

CvArr *

arr

)

zeruje wszystkie elementy tablicy

Funkcja cvSetZero jest wywoływane gdy użyto cvZero

Parametry:

arr

tablica do wyzerowania

---