GoWebScanVisionTileMsg.h

Go to the documentation of this file.

/**
* @file    GoWebScanVisionTileMsg.h
* @brief   Declares a GoWebScanVisionTileMsg 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_SCANNER_VISION_TILE_MSG_H
#define GO_SCANNER_VISION_TILE_MSG_H

#include <GoWebScanSdk/GoWebScanSdkDef.h>
#include <GoWebScanSdk/GoWebScanPipeMsg.h>

/**
* @class   GoWebScanVisionTileMsg
* @extends GoWebScanPipeMsg
* @ingroup GoWebScanSdk-Messages
* @brief   Represents a message containing a tile of X and Y resampled and demosaiced vision data. 
*          This message can be used to represent data from a single node in the system, data
*          from a plane in the system (after merging resampled data from all nodes in a plane),
*          or data from a detected board.
*         
*/
typedef GoWebScanPipeMsg GoWebScanVisionTileMsg;

/**
* Constructs a GoWebScanVisionTileMsg object.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               Receives the constructed GoWebScanVisionTileMsg object. 
* @param  pool              Message pool of GoWebScanVisionTileMsg objects
* @param  count             Length of tile in Y-axis (pixels).
* @param  width             Length of tile in X-axis (pixels).
* @param  allocator         Memory allocator (or kNULL for default). 
* @return                   Operation status.
*/
GoWebScanFx(kStatus) GoWebScanVisionTileMsg_Construct(GoWebScanVisionTileMsg* msg, GoWebScanPipeMsgPool pool, kSize count, kSize width, kAlloc allocator);

/**
* Destroys a GoWebScanVisionTileMsg object.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @return                   Operation status.
*/
GoWebScanFx(kStatus) GoWebScanVisionTileMsg_Destroy(GoWebScanVisionTileMsg msg);

/**
* Resizes a GoWebScanVisionTileMsg object.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @param  count             Length of tile in Y-axis (pixels).
* @param  width             Length of tile in X-axis (pixels).
* @return                   Operation status.
*/
GoWebScanFx(kStatus) GoWebScanVisionTileMsg_Resize(GoWebScanVisionTileMsg msg, kSize count, kSize width);

/**
* Gets the size, in bytes, of the message data buffer.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @return                   Message data buffer size (bytes).
*/
GoWebScanFx(kSize) GoWebScanVisionTileMsg_Size(GoWebScanVisionTileMsg msg);

/**
* Gets length of the tile in the Y-axis (pixels).
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @return                   Message count.
*/
GoWebScanFx(kSize) GoWebScanVisionTileMsg_Count(GoWebScanVisionTileMsg msg);

/**
* Gets length of the tile in the X-axis (pixels).
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @return                   Message width.
*/
GoWebScanFx(kSize) GoWebScanVisionTileMsg_Width(GoWebScanVisionTileMsg msg);

/**
* Gets the inputs corresponding to each row of the tile.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @return                   Array of inputs. Type k64s.
*/
GoWebScanFx(kArray1) GoWebScanVisionTileMsg_Inputs(GoWebScanVisionTileMsg msg);

/**
* Gets the input at a specified row.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @param  rowIndex          Row index.
* @return                   Input at specified row.
*/
GoWebScanFx(k64s*) GoWebScanVisionTileMsg_InputsAt(GoWebScanVisionTileMsg msg, kSize rowIndex);

/**
* Gets the tile data array.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @return                   Message data array. Type kRgb.
*/
GoWebScanFx(kArray2) GoWebScanVisionTileMsg_Data(GoWebScanVisionTileMsg msg);

/**
* Gets a pointer to the start of a tile row.
*
* @public                   @memberof GoWebScanVisionTileMsg
* @param  msg               GoWebScanVisionTileMsg object. 
* @param  rowIndex          Row index.
* @return                   Pointer to start of row.
*/
GoWebScanFx(kRgb*) GoWebScanVisionTileMsg_DataAt(GoWebScanVisionTileMsg msg, kSize rowIndex);

#include <GoWebScanSdk/GoWebScanVisionTileMsg.x.h>

#endif