@spec clear(Evision.CascadeClassifier.t()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

Clears the algorithm state

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Python prototype (for reference only):

clear() -> None

@spec convert(Evision.CascadeClassifier.t(), [
  {number(), number(), number(), number()}
]) ::
  Evision.Mat.t() | {:error, String.t()}

Converts objects array from internal representation to standard vector.

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

• objects: [Rect].

  Resulting array.

Return

• gpu_objects: Evision.Mat.t().

  Objects array in internal representation.

Python prototype (for reference only):

convert(objects[, gpu_objects]) -> gpu_objects

@spec convert(
  Evision.CascadeClassifier.t(),
  [{number(), number(), number(), number()}],
  [{atom(), term()}, ...] | nil
) :: Evision.Mat.t() | {:error, String.t()}

Converts objects array from internal representation to standard vector.

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

• objects: [Rect].

  Resulting array.

Return

• gpu_objects: Evision.Mat.t().

  Objects array in internal representation.

Python prototype (for reference only):

convert(objects[, gpu_objects]) -> gpu_objects

@spec create(binary()) :: t() | {:error, String.t()}

Loads the classifier from a file. Cascade type is detected automatically by constructor parameter.

Positional Arguments

• filename: String.

  Name of the file from which the classifier is loaded. Only the old haar classifier (trained by the haar training application) and NVIDIA's nvbin are supported for HAAR and only new type of OpenCV XML cascade supported for LBP. The working haar models can be found at opencv_folder/data/haarcascades_cuda/

Return

• retval: Evision.CUDA.CascadeClassifier.t()

Python prototype (for reference only):

create(filename) -> retval

@spec detectMultiScale(Evision.CascadeClassifier.t(), Evision.Mat.maybe_mat_in()) ::
  Evision.Mat.t() | {:error, String.t()}

@spec detectMultiScale(Evision.CascadeClassifier.t(), Evision.CUDA.GpuMat.t()) ::
  Evision.CUDA.GpuMat.t() | {:error, String.t()}

Variant 1:

Detects objects of different sizes in the input image.

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

• image: Evision.Mat.t().

  Matrix of type CV_8U containing an image where objects should be detected.

Keyword Arguments

• stream: Evision.CUDA.Stream.t().

  CUDA stream.

Return

• objects: Evision.Mat.t().

  Buffer to store detected objects (rectangles).

To get final array of detected objects use CascadeClassifier::convert method.

Ptr<cuda::CascadeClassifier> cascade_gpu = cuda::CascadeClassifier::create(...);
Mat image_cpu = imread(...)
GpuMat image_gpu(image_cpu);
GpuMat objbuf;
cascade_gpu->detectMultiScale(image_gpu, objbuf);
std::vector<Rect> faces;
cascade_gpu->convert(objbuf, faces);
for(int i = 0; i < detections_num; ++i)
cv::rectangle(image_cpu, faces[i], Scalar(255));
imshow("Faces", image_cpu);

@sa CascadeClassifier::detectMultiScale

Python prototype (for reference only):

detectMultiScale(image[, objects[, stream]]) -> objects

Variant 2:

Detects objects of different sizes in the input image.

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

• image: Evision.CUDA.GpuMat.t().

  Matrix of type CV_8U containing an image where objects should be detected.

Keyword Arguments

• stream: Evision.CUDA.Stream.t().

  CUDA stream.

Return

• objects: Evision.CUDA.GpuMat.t().

  Buffer to store detected objects (rectangles).

To get final array of detected objects use CascadeClassifier::convert method.

Ptr<cuda::CascadeClassifier> cascade_gpu = cuda::CascadeClassifier::create(...);
Mat image_cpu = imread(...)
GpuMat image_gpu(image_cpu);
GpuMat objbuf;
cascade_gpu->detectMultiScale(image_gpu, objbuf);
std::vector<Rect> faces;
cascade_gpu->convert(objbuf, faces);
for(int i = 0; i < detections_num; ++i)
cv::rectangle(image_cpu, faces[i], Scalar(255));
imshow("Faces", image_cpu);

@sa CascadeClassifier::detectMultiScale

Python prototype (for reference only):

detectMultiScale(image[, objects[, stream]]) -> objects

@spec detectMultiScale(
  Evision.CascadeClassifier.t(),
  Evision.Mat.maybe_mat_in(),
  [{atom(), term()}, ...] | nil
) :: Evision.Mat.t() | {:error, String.t()}

@spec detectMultiScale(
  Evision.CascadeClassifier.t(),
  Evision.CUDA.GpuMat.t(),
  [{atom(), term()}, ...] | nil
) :: Evision.CUDA.GpuMat.t() | {:error, String.t()}

Variant 1:

Detects objects of different sizes in the input image.

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

• image: Evision.Mat.t().

  Matrix of type CV_8U containing an image where objects should be detected.

Keyword Arguments

• stream: Evision.CUDA.Stream.t().

  CUDA stream.

Return

• objects: Evision.Mat.t().

  Buffer to store detected objects (rectangles).

To get final array of detected objects use CascadeClassifier::convert method.

Ptr<cuda::CascadeClassifier> cascade_gpu = cuda::CascadeClassifier::create(...);
Mat image_cpu = imread(...)
GpuMat image_gpu(image_cpu);
GpuMat objbuf;
cascade_gpu->detectMultiScale(image_gpu, objbuf);
std::vector<Rect> faces;
cascade_gpu->convert(objbuf, faces);
for(int i = 0; i < detections_num; ++i)
cv::rectangle(image_cpu, faces[i], Scalar(255));
imshow("Faces", image_cpu);

@sa CascadeClassifier::detectMultiScale

Python prototype (for reference only):

detectMultiScale(image[, objects[, stream]]) -> objects

Variant 2:

Detects objects of different sizes in the input image.

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

• image: Evision.CUDA.GpuMat.t().

  Matrix of type CV_8U containing an image where objects should be detected.

Keyword Arguments

• stream: Evision.CUDA.Stream.t().

  CUDA stream.

Return

• objects: Evision.CUDA.GpuMat.t().

  Buffer to store detected objects (rectangles).

To get final array of detected objects use CascadeClassifier::convert method.

Ptr<cuda::CascadeClassifier> cascade_gpu = cuda::CascadeClassifier::create(...);
Mat image_cpu = imread(...)
GpuMat image_gpu(image_cpu);
GpuMat objbuf;
cascade_gpu->detectMultiScale(image_gpu, objbuf);
std::vector<Rect> faces;
cascade_gpu->convert(objbuf, faces);
for(int i = 0; i < detections_num; ++i)
cv::rectangle(image_cpu, faces[i], Scalar(255));
imshow("Faces", image_cpu);

@sa CascadeClassifier::detectMultiScale

Python prototype (for reference only):

detectMultiScale(image[, objects[, stream]]) -> objects

@spec empty(Evision.CascadeClassifier.t()) :: boolean() | {:error, String.t()}

Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: bool

Python prototype (for reference only):

empty() -> retval

@spec getClassifierSize(Evision.CascadeClassifier.t()) ::
  {number(), number()} | {:error, String.t()}

getClassifierSize

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: Size

Python prototype (for reference only):

getClassifierSize() -> retval

@spec getDefaultName(Evision.CascadeClassifier.t()) :: binary() | {:error, String.t()}

getDefaultName

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: String

Returns the algorithm string identifier. This string is used as top level xml/yml node tag when the object is saved to a file or string.

Python prototype (for reference only):

getDefaultName() -> retval

@spec getFindLargestObject(Evision.CascadeClassifier.t()) ::
  boolean() | {:error, String.t()}

getFindLargestObject

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: bool

Python prototype (for reference only):

getFindLargestObject() -> retval

@spec getMaxNumObjects(Evision.CascadeClassifier.t()) ::
  integer() | {:error, String.t()}

getMaxNumObjects

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: int

Python prototype (for reference only):

getMaxNumObjects() -> retval

@spec getMaxObjectSize(Evision.CascadeClassifier.t()) ::
  {number(), number()} | {:error, String.t()}

getMaxObjectSize

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: Size

Python prototype (for reference only):

getMaxObjectSize() -> retval

@spec getMinNeighbors(Evision.CascadeClassifier.t()) ::
  integer() | {:error, String.t()}

getMinNeighbors

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: int

Python prototype (for reference only):

getMinNeighbors() -> retval

@spec getMinObjectSize(Evision.CascadeClassifier.t()) ::
  {number(), number()} | {:error, String.t()}

getMinObjectSize

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: Size

Python prototype (for reference only):

getMinObjectSize() -> retval

@spec getScaleFactor(Evision.CascadeClassifier.t()) :: number() | {:error, String.t()}

getScaleFactor

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()

Return

• retval: double

Python prototype (for reference only):

getScaleFactor() -> retval

@spec read(Evision.CascadeClassifier.t(), Evision.FileNode.t()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

Reads algorithm parameters from a file storage

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• fn_: Evision.FileNode.t()

Python prototype (for reference only):

read(fn_) -> None

@spec save(Evision.CascadeClassifier.t(), binary()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

save

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• filename: String

Saves the algorithm to a file. In order to make this method work, the derived class must implement Algorithm::write(FileStorage& fs).

Python prototype (for reference only):

save(filename) -> None

@spec setFindLargestObject(Evision.CascadeClassifier.t(), boolean()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

setFindLargestObject

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• findLargestObject: bool

Python prototype (for reference only):

setFindLargestObject(findLargestObject) -> None

@spec setMaxNumObjects(Evision.CascadeClassifier.t(), integer()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

setMaxNumObjects

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• maxNumObjects: int

Python prototype (for reference only):

setMaxNumObjects(maxNumObjects) -> None

@spec setMaxObjectSize(
  Evision.CascadeClassifier.t(),
  {number(), number()}
) :: Evision.CascadeClassifier.t() | {:error, String.t()}

setMaxObjectSize

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• maxObjectSize: Size

Has overloading in C++

Python prototype (for reference only):

setMaxObjectSize(maxObjectSize) -> None

@spec setMinNeighbors(Evision.CascadeClassifier.t(), integer()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

setMinNeighbors

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• minNeighbors: int

Python prototype (for reference only):

setMinNeighbors(minNeighbors) -> None

@spec setMinObjectSize(
  Evision.CascadeClassifier.t(),
  {number(), number()}
) :: Evision.CascadeClassifier.t() | {:error, String.t()}

setMinObjectSize

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• minSize: Size

Python prototype (for reference only):

setMinObjectSize(minSize) -> None

@spec setScaleFactor(Evision.CascadeClassifier.t(), number()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

setScaleFactor

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• scaleFactor: double

Python prototype (for reference only):

setScaleFactor(scaleFactor) -> None

@spec write(Evision.CascadeClassifier.t(), Evision.FileStorage.t()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

Stores algorithm parameters in a file storage

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• fs: Evision.FileStorage.t()

Python prototype (for reference only):

write(fs) -> None

@spec write(Evision.CascadeClassifier.t(), Evision.FileStorage.t(), binary()) ::
  Evision.CascadeClassifier.t() | {:error, String.t()}

write

Positional Arguments

• self: Evision.CUDA.CascadeClassifier.t()
• fs: Evision.FileStorage.t()
• name: String

Has overloading in C++

Python prototype (for reference only):

write(fs, name) -> None