Как эта функция opencv объясняется в C++

Question

Мне действительно нужно понять, как это работает в этой функции, в частности, возможно, во всех функциях тоже вообще из документов. вот из документов функции в opencv: и это только один из них.

int cv::createTrackbar (const String & trackbarname, const String & winname, int * value, int count, TrackbarCallback onChange = 0,void * userdata = 0)

и вот код, который кто-то написал, что работает:

createTrackbar("H_MIN", trackbarWindowName, &H_MIN, H_MAX, on_trackbar); createTrackbar("H_MAX", trackbarWindowName, &H_MAX, H_MAX, on_trackbar); createTrackbar("S_MIN", trackbarWindowName, &S_MIN, S_MAX, on_trackbar); createTrackbar("S_MAX", trackbarWindowName, &S_MAX, S_MAX, on_trackbar); createTrackbar("V_MIN", trackbarWindowName, &V_MIN, V_MAX, on_trackbar); createTrackbar("V_MAX", trackbarWindowName, &V_MAX, V_MAX, on_trackbar);

теперь мой вопрос:

1. есть 6 аргументов, почему этот парень пишет только 5 аргументов?
2. Документы говорят, что int сначала, почему createTrackbar не имеет int?
3. что это означает в &const String & trackbarname, я могу понять, что "H_MIN" является константной строкой, и это trackbarname, но что & значит, и почему бы не написать & также в этом коде?
4. такой же вопрос тоже в const String & winname, то есть & средний?
5. в третьих аргументах int * value, указатель значения на int и объявлен в глобальной переменной, почему так сложно писать? не можем ли мы просто написать int H_MIN = 0 (если я прав об этом), H_MAX = 256?
6. по четвертому аргументу int count, где именно этот код?
7. пятого аргумента, TrackbarCallback onChange = 0, я не понимаю, это
8. последний аргумент, void * userdata = 0 он написал функцию, называемую on_trackbar, которая только это: void on_trackbar(int, void*){} я не понимаю, это либо

жаль слишком много, чтобы спросить, я просто нужно действительно понять, как я буду писать функцию из документов правильно или обычай.

и вот весь код:

//objectTrackingTutorial.cpp 

//Written by Kyle Hounslow 2013 

//Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software") 
//, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, 
//and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 

//The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. 

//THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
//FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
//LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 
//IN THE SOFTWARE. 

#include <sstream> 
#include <string> 
#include <iostream> 
#include <opencv\highgui.h> 
#include <opencv\cv.h> 
#include <opencv2\opencv.hpp> 
#include <vector> 


using namespace cv; 
using namespace std; 
//initial min and max HSV filter values. 
//these will be changed using trackbars 
int H_MIN = 0; 
int H_MAX = 256; 
int S_MIN = 0; 
int S_MAX = 256; 
int V_MIN = 0; 
int V_MAX = 256; 
//default capture width and height 
const int FRAME_WIDTH = 640; 
const int FRAME_HEIGHT = 480; 
//max number of objects to be detected in frame 
const int MAX_NUM_OBJECTS = 50; 
//minimum and maximum object area 
const int MIN_OBJECT_AREA = 20 * 20; 
const int MAX_OBJECT_AREA = FRAME_HEIGHT*FRAME_WIDTH/1.5; 
//names that will appear at the top of each window 
const string windowName = "Original Image"; 
const string windowName1 = "HSV Image"; 
const string windowName2 = "Thresholded Image"; 
const string windowName3 = "After Morphological Operations"; 
const string trackbarWindowName = "Trackbars"; 
void on_trackbar(int, void*) 
{//This function gets called whenever a 
    // trackbar position is changed 





} 
string intToString(int number){ 


    std::stringstream ss; 
    ss << number; 
    return ss.str(); 
} 
void createTrackbars(){ 
    //create window for trackbars 


    namedWindow(trackbarWindowName, 0); 
    //create memory to store trackbar name on window 
    char TrackbarName[50]; 
    sprintf_s(TrackbarName, "H_MIN", H_MIN); 
    sprintf_s(TrackbarName, "H_MAX", H_MAX); 
    sprintf_s(TrackbarName, "S_MIN", S_MIN); 
    sprintf_s(TrackbarName, "S_MAX", S_MAX); 
    sprintf_s(TrackbarName, "V_MIN", V_MIN); 
    sprintf_s(TrackbarName, "V_MAX", V_MAX); 
    //create trackbars and insert them into window 
    //3 parameters are: the address of the variable that is changing when the trackbar is moved(eg.H_LOW), 
    //the max value the trackbar can move (eg. H_HIGH), 
    //and the function that is called whenever the trackbar is moved(eg. on_trackbar) 
    //         ----> ---->  ---->  
    createTrackbar("H_MIN", trackbarWindowName, &H_MIN, H_MAX, on_trackbar); 
    createTrackbar("H_MAX", trackbarWindowName, &H_MAX, H_MAX, on_trackbar); 
    createTrackbar("S_MIN", trackbarWindowName, &S_MIN, S_MAX, on_trackbar); 
    createTrackbar("S_MAX", trackbarWindowName, &S_MAX, S_MAX, on_trackbar); 
    createTrackbar("V_MIN", trackbarWindowName, &V_MIN, V_MAX, on_trackbar); 
    createTrackbar("V_MAX", trackbarWindowName, &V_MAX, V_MAX, on_trackbar); 

} 
void drawObject(int x, int y, Mat &frame){ 

    //use some of the openCV drawing functions to draw crosshairs 
    //on your tracked image! 

    //UPDATE:JUNE 18TH, 2013 
    //added 'if' and 'else' statements to prevent 
    //memory errors from writing off the screen (ie. (-25,-25) is not within the window!) 

    circle(frame, Point(x, y), 20, Scalar(0, 255, 0), 2); 
    if (y - 25>0) 
     line(frame, Point(x, y), Point(x, y - 25), Scalar(0, 255, 0), 2); 
    else line(frame, Point(x, y), Point(x, 0), Scalar(0, 255, 0), 2); 
    if (y + 25<FRAME_HEIGHT) 
     line(frame, Point(x, y), Point(x, y + 25), Scalar(0, 255, 0), 2); 
    else line(frame, Point(x, y), Point(x, FRAME_HEIGHT), Scalar(0, 255, 0), 2); 
    if (x - 25>0) 
     line(frame, Point(x, y), Point(x - 25, y), Scalar(0, 255, 0), 2); 
    else line(frame, Point(x, y), Point(0, y), Scalar(0, 255, 0), 2); 
    if (x + 25<FRAME_WIDTH) 
     line(frame, Point(x, y), Point(x + 25, y), Scalar(0, 255, 0), 2); 
    else line(frame, Point(x, y), Point(FRAME_WIDTH, y), Scalar(0, 255, 0), 2); 

    putText(frame, intToString(x) + "," + intToString(y), Point(x, y + 30), 1, 1, Scalar(0, 255, 0), 2); 

} 
void morphOps(Mat &thresh){ 

    //create structuring element that will be used to "dilate" and "erode" image. 
    //the element chosen here is a 3px by 3px rectangle 

    Mat erodeElement = getStructuringElement(MORPH_RECT, Size(3, 3)); 
    //dilate with larger element so make sure object is nicely visible 
    Mat dilateElement = getStructuringElement(MORPH_RECT, Size(8, 8)); 

    erode(thresh, thresh, erodeElement); 
    erode(thresh, thresh, erodeElement); 


    dilate(thresh, thresh, dilateElement); 
    dilate(thresh, thresh, dilateElement); 



} 
void trackFilteredObject(int &x, int &y, Mat threshold, Mat &cameraFeed){ 

    Mat temp; 
    threshold.copyTo(temp); 
    //these two vectors needed for output of findContours 
    vector< vector<Point> > contours; 
    vector<Vec4i> hierarchy; 
    //find contours of filtered image using openCV findContours function 
    findContours(temp, contours, hierarchy, CV_RETR_CCOMP, CV_CHAIN_APPROX_SIMPLE); 
    //use moments method to find our filtered object 
    double refArea = 0; 
    bool objectFound = false; 
    if (hierarchy.size() > 0) { 
     int numObjects = hierarchy.size(); 
     //if number of objects greater than MAX_NUM_OBJECTS we have a noisy filter 
     if (numObjects<10){ 
      for (int index = 0; index >= 0; index = hierarchy[index][0]) { 

       Moments moment = moments((cv::Mat)contours[index]); 
       double area = moment.m00; 

       //if the area is less than 20 px by 20px then it is probably just noise 
       //if the area is the same as the 3/2 of the image size, probably just a bad filter 
       //we only want the object with the largest area so we safe a reference area each 
       //iteration and compare it to the area in the next iteration. 
       if (area>400 && area<FRAME_HEIGHT*FRAME_WIDTH/1.5 && area>refArea){ 
        printf("%f \n", area); 
        x = moment.m10/area; 
        y = moment.m01/area; 
        objectFound = true; 
        refArea = area; 
       } 
       else objectFound = false; 


      } 
      //let user know you found an object 
      if (objectFound == true){ 
       putText(cameraFeed, "Tracking Object", Point(0, 50), 2, 1, Scalar(0, 255, 0), 2); 
       //draw object location on screen 
       drawObject(x, y, cameraFeed); 
      } 

     } 
     else putText(cameraFeed, "TOO MUCH NOISE! ADJUST FILTER", Point(0, 50), 1, 2, Scalar(0, 0, 255), 2); 
    } 
} 
int main(int argc, char* argv[]) 
{ 
    //some boolean variables for different functionality within this 
    //program 
    bool trackObjects = true; 
    bool useMorphOps = true; 
    //Matrix to store each frame of the webcam feed 
    Mat cameraFeed; 
    //matrix storage for HSV image 
    Mat HSV; 
    //matrix storage for binary threshold image 
    Mat threshold; 
    //x and y values for the location of the object 
    int x = 0, y = 0; 
    //create slider bars for HSV filtering 
    createTrackbars(); 
    //video capture object to acquire webcam feed 
    VideoCapture capture; 
    //open capture object at location zero (default location for webcam) 
    capture.open(0); 
    //set height and width of capture frame 
    capture.set(CV_CAP_PROP_FRAME_WIDTH, FRAME_WIDTH); 
    capture.set(CV_CAP_PROP_FRAME_HEIGHT, FRAME_HEIGHT); 
    //start an infinite loop where webcam feed is copied to cameraFeed matrix 
    //all of our operations will be performed within this loop 
    while (1){ 
     //store image to matrix 
     capture.read(cameraFeed); 
     //convert frame from BGR to HSV colorspace 
     cvtColor(cameraFeed, HSV, COLOR_BGR2HSV); 
     //filter HSV image between values and store filtered image to 
     //threshold matrix 
     inRange(HSV, Scalar(H_MIN, S_MIN, V_MIN), Scalar(H_MAX, S_MAX, V_MAX), threshold); 
     //perform morphological operations on thresholded image to eliminate noise 
     //and emphasize the filtered object(s) 
     if (useMorphOps) 
      morphOps(threshold); 
     //pass in thresholded frame to our object tracking function 
     //this function will return the x and y coordinates of the 
     //filtered object 
     if (trackObjects) 
      trackFilteredObject(x, y, threshold, cameraFeed); 

     //show frames 
     imshow(windowName2, threshold); 
     imshow(windowName, cameraFeed); 
     imshow(windowName1, HSV); 


     //delay 30ms so that screen can refresh. 
     //image will not appear without this waitKey() command 
     waitKey(30); 
    } 

    return 0; 
} 

Answer 1

В порядке:

1) Последний аргумент, пользовательские данные, по умолчанию настроен, что видно по = 0 в сигнатуре функции. Это означает, что если вы не укажете значение для аргумента, оно будет установлено на значение по умолчанию 0.

2) createTrackbar имеет тип возврата int, однако вы не обращаете внимания на эти данные, не устанавливая createTrackbar к переменной, что хорошо в вашем случае.

3) & показывает пропуск по ссылке. Это означает, что переменная, которую вы передаете, может быть изменена во время функции. См. here для получения дополнительной информации об этом.

4) То же, что и выше

5) Это не должно быть глобальным обязательно. Что здесь происходит, так это то, что вы передаете адрес памяти целого числа в функцию. Это позволит функции де-ссылки на то, что находится на этом адресе памяти. Если вы не знакомы с тем, как c и C++ имеют дело с указателями/ссылкой/памятью, вам следует рассмотреть некоторые исследования по этому вопросу, поскольку это очень интегральная концепция программирования c. Хорошим местом для начала является here. Что касается этой переменной, то, по сути, это адрес переменной, с которой вы можете ссылаться на эти обновления с положением ползунка, так что вам не нужно каждый раз вызывать функцию ползунка, если вы только захватываете значение из ползунка.

6) Count - максимальное положение на ползунке. Это ясно из документации.

7) Этот метод обмена является обратным вызовом функции, которая может выполняться всякий раз, когда изменяется положение трекбара. По умолчанию используется значение 0, а это означает, что если вы не укажете функцию, которая будет вызываться при перемещении трекпада, то никакая функция не будет вызвана. Если вы просто пытаетесь получить значение трекбара, посмотрите, что я написал для точки 5, и вместо этого используйте аргумент value.

8) Это не аргумент userdata. Компилятор может видеть, что on_trackbar фактически является аргументом для onchange из-за его типа. Таким образом, он фактически дефолтовал userdata на 0 и имеет функцию, когда трекбар перемещается. Для получения дополнительной информации об этом вам следует прочитать о полиморфизме времени компилятора в c. Большой пост об этом here

Похоже, у вас еще нет четкой ручки на ваших C и C++. Я бы рекомендовал работать через книгу на C или C++, так как есть некоторые действительно мощные вещи, которые вы можете сделать с некоторыми из концепций, о которых вы говорили. Удачи!