CImage:TableToRow
The TableToRow method pastes (imbeds) a 1-dimensional array into a row of the CImage object. The length of the array determines the column extent of the imbedded row. The table is imbedded at the specified integer-valued (column, row) offsets. This method is similar to the Imbed method, except that it imbeds a 1-dimensional array rather than another CImage. The inverse operation, copying a CImage row to an array, uses the RowToTable method.
nResult = CImage:TableToRow( tbl, nColMin, nRowMin ) |
tbl is a 1-dimensional array to be imbedded as a row in the CImage.
nColMin and nRowMin are the integral (column, row) offsets to the corner where tbl is imbedded.
On success, this method returns nResult = 1.
On failure, nResult contains the following error codes:
-1: The array tbl is not valid.
-2: Not enough parameters were passed.
-3: Invalid CImage object.
-4: Internal error.
-5: The column coordinate is invalid.
-6: The row coordinate is invalid.
Suppose that a CImage I exists. The following script imbeds a row of values into the CImage. The imbedding corner is set to coordinates (100,250):
|
-- position the corner of tbl at these offsets in I |
|
-- create a table (this will be a 1-D table) |
|
-- assign the first value |
|
-- assign the second value |
-- complete the row... |
|
|
-- imbed tbl as a row at corner (100,250) |
|
-- an error occured |
CImage class, Imbed, RectToTable, arraytoimage, RowToTable, TableToRect, TableToCol
Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics,
Inc. All Rights Reserved.