GoWebScanTracheidMergeTask.h

Go to the documentation of this file.

/**
* @file    GoWebScanTracheidMergeTask.h
* @brief   Declares a GoWebScanTracheidMergeTask object.
*
* @internal
* Copyright (C) 2017-2026 by LMI Technologies Inc.
* Licensed under the MIT License.
* Redistributed files must retain the above copyright notice.
*/

#ifndef GO_WEB_SCAN_TRACHEID_MERGE_TASK_H
#define GO_WEB_SCAN_TRACHEID_MERGE_TASK_H

#include <GoWebScanSdk/GoWebScanSdkDef.h>
#include <GoWebScanSdk/GoWebScanPipe.h>
#include <GoWebScanSdk/GoWebScanPipeTask.h>
#include <GoWebScanSdk/GoWebScanConfig.h>

/**
* @class   GoWebScanTracheidMergeTask
* @extends kObject
* @ingroup GoWebScanSdk-Control
* @brief   Represents a task for merging tracheid tiles along X-axis from the cameras in a top 
           or bottom group. Specifically, the task accepts a list of tracheid tiles that 
*          correspond to the same Y-position, and merges them into a single group-wide tile 
*          according to their respective source locations along the X-axis. Gaps and overlaps 
*          between adjacent tiles are processed according to configuration options.
*          The task accepts GoWebScanTileListMsg objects and produces GoWebScanTracheidTileMsg
*          objects. 
*          
*          Processing steps:
*          -# Clear the background of the output system tile.
*          -#  Add GoWebScanTileListMsg input tiles to the processing queue
*          -# Blend the overlap between tiles. Overlaps are processed by searching for the last
*              valid left element and first valid right element within the overlapping region
*              between two tiles. If overlap exists, the overlapping elements are blended by
*              weighted average. The angle requires special handling with respect to overlap 
*              blending because of the circular/continuous nature of angle measurements.
*          -# Fill gaps between tiles. Gaps are processed by searching for the last valid left
*              element and first valid right element within the gap search window. If these 
*              elements are closer than the gap threshold, any null elements in between are 
*              filled in (nearest neighbour). 
*/
typedef kObject GoWebScanTracheidMergeTask;

// Forward declaration
typedef kObject GoWebScanProcess;

/**
* Constructs a GoWebScanTracheidMergeTask object.
* 
* @public                      @memberof GoWebScanTracheidMergeTask
* @param   task                Receives the constructed GoWebScanTracheidMergeTask object.
* @param   process             Associated GoWebScanProcess object.
* @param   configGroup         Group configuration.
* @param   allocator           Memory allocator (or kNULL for default).
* @return                      Operation status.
*/
GoWebScanFx(kStatus) GoWebScanTracheidMergeTask_Construct(GoWebScanTracheidMergeTask* task, GoWebScanProcess process, GoWebScanConfigGroup configGroup, kAlloc allocator);

/**
* Sets the handler for receiving merged system tracheid tiles.
*
* @public           @memberof GoWebScanTracheidMergeTask
* @param  task      GoWebScanTracheidMergeTask object. 
* @param  send      Callback function
* @param  context   Receiver argument for callback.
* @return           Operation status.
*/
GoWebScanFx(kStatus) GoWebScanTracheidMergeTask_SetReceiver(GoWebScanTracheidMergeTask task, GoWebScanPipeSendFx send, kPointer context);

/**
* Adds a message to the processing queue. Dequeues a message at the end of the queue to submit
* to the pipe for scheduling if no other job is currently pending.
* 
* @public          @memberof GoWebScanTracheidMergeTask
* @param   task    GoWebScanTracheidMergeTask object.
* @param   msg     Tile list message to enqueue.
* @return          Operation status.
*/
GoWebScanFx(kStatus) GoWebScanTracheidMergeTask_Send(GoWebScanTracheidMergeTask task, GoWebScanPipeMsg msg);

#include <GoWebScanSdk/GoWebScanTracheidMergeTask.x.h>

#endif