Update documentation ( tutorials )

samples/cpp/tutorial_code/ImgTrans/CannyDetector_Demo.cpp

@@ -10,8 +10,7 @@
 
 using namespace cv;
 
-/// Global variables
-
+//![variables]
 Mat src, src_gray;
 Mat dst, detected_edges;
 
@@ -21,6 +20,7 @@ int const max_lowThreshold = 100;
 int ratio = 3;
 int kernel_size = 3;
 const char* window_name = "Edge Map";
+//![variables]
 
 /**
  * @function CannyThreshold
@@ -28,17 +28,28 @@ const char* window_name = "Edge Map";
  */
 static void CannyThreshold(int, void*)
 {
+    //![reduce_noise]
     /// Reduce noise with a kernel 3x3
     blur( src_gray, detected_edges, Size(3,3) );
+    //![reduce_noise]
 
+    //![canny]
     /// Canny detector
     Canny( detected_edges, detected_edges, lowThreshold, lowThreshold*ratio, kernel_size );
+    //![canny]
 
     /// Using Canny's output as a mask, we display our result
+    //![fill]
     dst = Scalar::all(0);
+    //![fill]
 
+    //![copyto]
     src.copyTo( dst, detected_edges);
+    //![copyto]
+
+    //![display]
     imshow( window_name, dst );
+    //![display]
 }
 
 
@@ -47,23 +58,30 @@ static void CannyThreshold(int, void*)
  */
 int main( int, char** argv )
 {
-  /// Load an image
-  src = imread( argv[1], IMREAD_COLOR );
+  //![load]
+  src = imread( argv[1], IMREAD_COLOR ); // Load an image
 
   if( src.empty() )
     { return -1; }
+  //![load]
 
+  //![create_mat]
   /// Create a matrix of the same type and size as src (for dst)
   dst.create( src.size(), src.type() );
+  //![create_mat]
 
-  /// Convert the image to grayscale
+  //![convert_to_gray]
   cvtColor( src, src_gray, COLOR_BGR2GRAY );
+  //![convert_to_gray]
 
-  /// Create a window
+  //![create_window]
   namedWindow( window_name, WINDOW_AUTOSIZE );
+  //![create_window]
 
+  //![create_trackbar]
   /// Create a Trackbar for user to enter threshold
   createTrackbar( "Min Threshold:", window_name, &lowThreshold, max_lowThreshold, CannyThreshold );
+  //![create_trackbar]
 
   /// Show the image
   CannyThreshold(0, 0);