GoWebScan API
 All Classes Files Functions Variables Typedefs Macros Modules Pages
GoWebScanVisionTileMsg.h
Go to the documentation of this file.
1 /**
2 * @file GoWebScanVisionTileMsg.h
3 * @brief Declares a GoWebScanVisionTileMsg object.
4 *
5 * @internal
6 * Copyright (C) 2017-2018 by LMI Technologies Inc.
7 * Licensed under the MIT License.
8 * Redistributed files must retain the above copyright notice.
9 */
10 #ifndef GO_SCANNER_VISION_TILE_MSG_H
11 #define GO_SCANNER_VISION_TILE_MSG_H
12 
15 
16 kBeginHeader()
17 
18 /**
19 * @class GoWebScanVisionTileMsg
20 * @extends GoWebScanPipeMsg
21 * @ingroup GoWebScanSdk-Messages
22 * @brief Represents a message containing a tile of X and Y resampled and demosaiced vision data.
23 * This message can be used to represent data from a single node in the system, data
24 * from a plane in the system (after merging resampled data from all nodes in a plane),
25 * or data from a detected board.
26 *
27 */
29 
30 /**
31 * Constructs a GoWebScanVisionTileMsg object.
32 *
33 * @public @memberof GoWebScanVisionTileMsg
34 * @param msg Receives the constructed GoWebScanVisionTileMsg object.
35 * @param pool Message pool of GoWebScanVisionTileMsg objects
36 * @param count Length of tile in Y-axis (pixels).
37 * @param width Length of tile in X-axis (pixels).
38 * @param allocator Memory allocator (or kNULL for default).
39 * @return Operation status.
40 */
41 GoWebScanFx(kStatus) GoWebScanVisionTileMsg_Construct(GoWebScanVisionTileMsg* msg, GoWebScanPipeMsgPool pool, kSize count, kSize width, kAlloc allocator);
42 
43 /**
44 * Destroys a GoWebScanVisionTileMsg object.
45 *
46 * @public @memberof GoWebScanVisionTileMsg
47 * @param msg GoWebScanVisionTileMsg object.
48 * @return Operation status.
49 */
50 GoWebScanFx(kStatus) GoWebScanVisionTileMsg_Destroy(GoWebScanVisionTileMsg msg);
51 
52 /**
53 * Resizes a GoWebScanVisionTileMsg object.
54 *
55 * @public @memberof GoWebScanVisionTileMsg
56 * @param msg GoWebScanVisionTileMsg object.
57 * @param count Length of tile in Y-axis (pixels).
58 * @param width Length of tile in X-axis (pixels).
59 * @return Operation status.
60 */
61 GoWebScanFx(kStatus) GoWebScanVisionTileMsg_Resize(GoWebScanVisionTileMsg msg, kSize count, kSize width);
62 
63 /**
64 * Gets the size, in bytes, of the message data buffer.
65 *
66 * @public @memberof GoWebScanVisionTileMsg
67 * @param msg GoWebScanVisionTileMsg object.
68 * @return Message data buffer size (bytes).
69 */
70 GoWebScanFx(kSize) GoWebScanVisionTileMsg_Size(GoWebScanVisionTileMsg msg);
71 
72 /**
73 * Gets length of the tile in the Y-axis (pixels).
74 *
75 * @public @memberof GoWebScanVisionTileMsg
76 * @param msg GoWebScanVisionTileMsg object.
77 * @return Message count.
78 */
79 GoWebScanFx(kSize) GoWebScanVisionTileMsg_Count(GoWebScanVisionTileMsg msg);
80 
81 /**
82 * Gets length of the tile in the X-axis (pixels).
83 *
84 * @public @memberof GoWebScanVisionTileMsg
85 * @param msg GoWebScanVisionTileMsg object.
86 * @return Message width.
87 */
88 GoWebScanFx(kSize) GoWebScanVisionTileMsg_Width(GoWebScanVisionTileMsg msg);
89 
90 /**
91 * Gets the inputs corresponding to each row of the tile.
92 *
93 * @public @memberof GoWebScanVisionTileMsg
94 * @param msg GoWebScanVisionTileMsg object.
95 * @return Array of inputs. Type k64s.
96 */
97 GoWebScanFx(kArray1) GoWebScanVisionTileMsg_Inputs(GoWebScanVisionTileMsg msg);
98 
99 /**
100 * Gets the input at a specifed row.
101 *
102 * @public @memberof GoWebScanVisionTileMsg
103 * @param msg GoWebScanVisionTileMsg object.
104 * @param rowIndex Row index.
105 * @return Input at specified row.
106 */
107 GoWebScanFx(k64s*) GoWebScanVisionTileMsg_InputsAt(GoWebScanVisionTileMsg msg, kSize rowIndex);
108 
109 /**
110 * Gets the tile data array.
111 *
112 * @public @memberof GoWebScanVisionTileMsg
113 * @param msg GoWebScanVisionTileMsg object.
114 * @return Message data array. Type kRgb.
115 */
116 GoWebScanFx(kArray2) GoWebScanVisionTileMsg_Data(GoWebScanVisionTileMsg msg);
117 
118 /**
119 * Gets a pointer to the start of a tile row.
120 *
121 * @public @memberof GoWebScanVisionTileMsg
122 * @param msg GoWebScanVisionTileMsg object.
123 * @param rowIndex Row index.
124 * @return Pointer to start of row.
125 */
126 GoWebScanFx(kRgb*) GoWebScanVisionTileMsg_DataAt(GoWebScanVisionTileMsg msg, kSize rowIndex);
127 
128 kEndHeader()
129 #include <GoWebScanSdk/GoWebScanVisionTileMsg.x.h>
130 
131 #endif
132 
kStatus GoWebScanVisionTileMsg_Resize(GoWebScanVisionTileMsg msg, kSize count, kSize width)
Resizes a GoWebScanVisionTileMsg object.
Declares the GoWebScanPipeMsg class.
Essential GoWebScan declarations.
kStatus GoWebScanVisionTileMsg_Construct(GoWebScanVisionTileMsg *msg, GoWebScanPipeMsgPool pool, kSize count, kSize width, kAlloc allocator)
Constructs a GoWebScanVisionTileMsg object.
kSize GoWebScanVisionTileMsg_Count(GoWebScanVisionTileMsg msg)
Gets length of the tile in the Y-axis (pixels).
kArray2 GoWebScanVisionTileMsg_Data(GoWebScanVisionTileMsg msg)
Gets the tile data array.
Represents a message containing a tile of X and Y resampled and demosaiced vision data...
kSize GoWebScanVisionTileMsg_Width(GoWebScanVisionTileMsg msg)
Gets length of the tile in the X-axis (pixels).
kArray1 GoWebScanVisionTileMsg_Inputs(GoWebScanVisionTileMsg msg)
Gets the inputs corresponding to each row of the tile.
kStatus GoWebScanVisionTileMsg_Destroy(GoWebScanVisionTileMsg msg)
Destroys a GoWebScanVisionTileMsg object.
kRgb * GoWebScanVisionTileMsg_DataAt(GoWebScanVisionTileMsg msg, kSize rowIndex)
Gets a pointer to the start of a tile row.
kSize GoWebScanVisionTileMsg_Size(GoWebScanVisionTileMsg msg)
Gets the size, in bytes, of the message data buffer.
Represents a pool of GoWebScanPipeMsg objects. The pool allocates GoWebScanPipeMsg objects with a def...
Base class for a msg that can be processed with a GoWebScanPipeTask and submitted to the GoWebScanPip...
k64s * GoWebScanVisionTileMsg_InputsAt(GoWebScanVisionTileMsg msg, kSize rowIndex)
Gets the input at a specifed row.