GoWebScanTracheidTileMsg.h

Go to the documentation of this file.

/**
* @file    GoWebScanTracheidTileMsg.h
* @brief   Declares a GoWebScanTracheidTileMsg 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_TRACHEID_TILE_MSG_H
#define GO_SCANNER_TRACHEID_TILE_MSG_H

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

/**
* @class   GoWebScanTracheidTileMsg
* @extends GoWebScanPipeMsg
* @ingroup GoWebScanSdk-Messages
* @brief   Represents a message containing a tile of X and Y resampled tracheid angle, scatter, 
*          and area 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 GoWebScanTracheidTileMsg;

/**
* Constructs a GoWebScanTracheidTileMsg object.
*
* @public                   @memberof GoWebScanTracheidTileMsg
* @param  msg               Receives the constructed GoWebScanTracheidTileMsg object. 
* @param  pool              Message pool of GoWebScanTracheidTileMsg 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) GoWebScanTracheidTileMsg_Construct(GoWebScanTracheidTileMsg* msg, GoWebScanPipeMsgPool pool, kSize count, kSize width, kAlloc allocator);

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

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

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

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

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

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

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

/**
* Gets the tile data array.
*
* @public                   @memberof GoWebScanTracheidTileMsg
* @param  msg               GoWebScanTracheidTileMsg object. 
* @return                   Message data array. Type GoWebScanTracheidValue.
*/
GoWebScanFx(kArray3) GoWebScanTracheidTileMsg_Data(GoWebScanTracheidTileMsg msg);

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

#include <GoWebScanSdk/GoWebScanTracheidTileMsg.x.h>

#endif