Merge pull request #26524 from MurtazaSaherwala:DocumentationUpdation

Updated trackbar callback function and improved documentation #26524

This Fixes #26467

Description:
This pull request improve the OpenCV documentation regarding the Trackbar functionality. The current documentation does not provide clear guidance on certain aspects, such as handling the value pointer deprecation and utilizing callback arguments in C. This update addresses those gaps and provides an updated example for better clarity.

Changes:
Updated Documentation:

Clarified the usage of the value pointer and explained how to pass an initial value, since the value pointer is deprecated.
Added more detailed explanations about callback arguments in C, ensuring that users understand how to access and use them in Trackbar callbacks.
Added a note on how to properly handle initial value passing without relying on the deprecated value pointer.
Updated Tutorial Example:

Renamed and used callback function parameters to make them more understandable.
Included a demonstration on how to utilize userdata in the callback function.
Additional Notes:

Removed reliance on the value pointer for updating trackbar values. Users are now encouraged to use other mechanisms as per the current implementation to avoid the runtime warning.

### Pull Request Readiness Checklist

See details at https://github.com/opencv/opencv/wiki/How_to_contribute#making-a-good-pull-request

- [x] I agree to contribute to the project under Apache 2 License.
- [x] To the best of my knowledge, the proposed patch is not based on a code under GPL or another license that is incompatible with OpenCV
- [x] The PR is proposed to the proper branch
- [x] There is a reference to the original bug report and related work
- [x] There is accuracy test, performance test and test data in opencv_extra repository, if applicable
      Patch to opencv_extra has the same branch name.
- [] The feature is well documented and sample code can be built with the project CMake

samples/cpp/tutorial_code/HighGUI/AddingImagesTrackbar.cpp

@@ -27,12 +27,12 @@ Mat dst;
  * @function on_trackbar
  * @brief Callback for trackbar
  */
-static void on_trackbar( int, void* )
-{
-   alpha = (double) alpha_slider/alpha_slider_max ;
-   beta = ( 1.0 - alpha );
-   addWeighted( src1, alpha, src2, beta, 0.0, dst);
-   imshow( "Linear Blend", dst );
+static void on_trackbar(int pos, void* userdata) {
+    (void) userdata;
+    alpha = (double)pos / alpha_slider_max;
+    beta = (1.0 - alpha);
+    addWeighted(src1, alpha, src2, beta, 0.0, dst);
+    imshow("Linear Blend", dst);
 }
 //![on_trackbar]
 
@@ -40,34 +40,35 @@ static void on_trackbar( int, void* )
  * @function main
  * @brief Main function
  */
-int main( void )
+int main(void)
 {
-   //![load]
-   /// Read images ( both have to be of the same size and type )
-   src1 = imread( samples::findFile("LinuxLogo.jpg") );
-   src2 = imread( samples::findFile("WindowsLogo.jpg") );
-   //![load]
+    //![load]
+    /// Read images (both must be of the same size and type)
+    src1 = imread(samples::findFile("LinuxLogo.jpg"));
+    src2 = imread(samples::findFile("WindowsLogo.jpg"));
+    //![load]
 
-   if( src1.empty() ) { cout << "Error loading src1 \n"; return -1; }
-   if( src2.empty() ) { cout << "Error loading src2 \n"; return -1; }
+    if (src1.empty()) { cout << "Error loading src1 \n"; return -1; }
+    if (src2.empty()) { cout << "Error loading src2 \n"; return -1; }
 
-   /// Initialize values
-   alpha_slider = 0;
+    // Initialize trackbar value
+    alpha_slider = 0;
 
-   //![window]
-   namedWindow("Linear Blend", WINDOW_AUTOSIZE); // Create Window
-   //![window]
+    //![window]
+    namedWindow("Linear Blend", WINDOW_AUTOSIZE); //Create Window
+    //![window]
 
-   //![create_trackbar]
-   char TrackbarName[50];
-   snprintf( TrackbarName, sizeof(TrackbarName), "Alpha x %d", alpha_slider_max );
-   createTrackbar( TrackbarName, "Linear Blend", &alpha_slider, alpha_slider_max, on_trackbar );
-   //![create_trackbar]
+    //![create_trackbar]
+    char TrackbarName[50];
+    snprintf(TrackbarName, sizeof(TrackbarName), "Alpha x %d", alpha_slider_max);
+    // Example userdata: Pass a pointer to an integer as userdata
+    createTrackbar(TrackbarName, "Linear Blend", &alpha_slider, alpha_slider_max, on_trackbar);
+    //![create_trackbar]
 
-   /// Show some stuff
-   on_trackbar( alpha_slider, 0 );
+    /// Show initial result
+    on_trackbar(alpha_slider, nullptr);
 
-   /// Wait until user press some key
-   waitKey(0);
-   return 0;
+    /// Wait for user input
+    waitKey(0);
+    return 0;
 }