Component: Console Writer (Indicators)
| Author | Matrix TSL |
| Version | 2.0 |
| Category | Indicators |
Console Writer component
A simple component to aid in creating and wiriting data to a console tab. Allows text to be coloured and automatically appended with a timestamp.
Version information
Library Version, Component Version, Date, Author, Info 4, 2.0, 02-07-24, BR, Added a load more functionality to the component related to cursor control
Detailed description
No detailed description exists yet for this component
Examples
A basic example using two circular knobs to simulate data e.g., temperature. Both xy chart and Console, log the data.
Macro reference
AddString
|
AddString |
| Adds text string to the end of the console window. | |
 - STRING
|
Data |
 - VOID
|
Return |
AddStringAtCursor
|
|
AddStringAtCursor |
| Adds text string to the current cursor position. | |
| - STRING
|
Data |
| - VOID
|
Return |
Clear
|
|
Clear |
| Clears the contents of the console tab. | |
| - VOID
|
Return |
ClearFromCursorToLineEnd
|
|
ClearFromCursorToLineEnd |
| Clears the contents of the current selected line from the cursor position to the end of the line. | |
| - VOID
|
Return |
ClearFromLineStartToCursor
|
|
ClearFromLineStartToCursor |
| Clears the contents of the current selected line from the start of the line to the cursor position. Sets the Column position to 0. | |
| - VOID
|
Return |
ClearLine
|
|
ClearLine |
| Clears all data from a specific line. Automatically sets the cursor to the start of the line. | |
 - LONG
|
Line |
| Line number, -1 for the last line. | |
| - VOID
|
Return |
ClearXCharsFromCursorPosition
|
|
ClearXCharsFromCursorPosition |
| Clears the specified number of characters starting from the cursor position. | |
 - UINT
|
CharacterCount |
| Number of characters to remove | |
| - VOID
|
Return |
CountLines
|
|
CountLines |
| Counts the number of lines in the console. | |
 - ULONG
|
Return |
GetTextLine
|
|
GetTextLine |
| Gets the string data from a specific line in the console. | |
| - LONG
|
Line |
| Line number, -1 for the last line. | |
| - STRING
|
Return |
SetColour
|
|
SetColour |
| Allows for full RGB colour selection | |
 - BYTE
|
R |
| Colour channel, Range: 0-255 | |
| - BYTE
|
G |
| Colour channel, Range: 0-255 | |
| - BYTE
|
B |
| Colour channel, Range: 0-255 | |
| - VOID
|
Return |
SetColourIdx
|
|
SetColourIdx |
| Sets the text colour from the properties selection of colours. | |
| - BYTE
|
Index |
| Range: 0-3 | |
| - VOID
|
Return |
SetCursorPosition
|
|
SetCursorPosition |
| Sets the position of the cursor | |
| - LONG
|
Column |
| Character position along the line, starting from 0 | |
| - LONG
|
Line |
| Line number, -1 for the last line. | |
| - VOID
|
Return |
SetTextLine
|
|
SetTextLine |
| Sets the string data from a specific line in the console. | |
| - LONG
|
Line |
| Line number, -1 for the last line. | |
| - STRING
|
Data |
| - VOID
|
Return |
ShowConsole
|
|
ShowConsole |
| Pops up the console window and shows the correct tab. | |
| - VOID
|
Return |
Property reference
|
Properties |
|
Console Name |
| Textual name of the console shown as the tab name at the top of the console window. | |
|
Colour 0 |
| Used to define a colour channel referenced by the SetColourIdx component macro call. | |
|
|
Colour 1 |
| Used to define a colour channel referenced by the SetColourIdx component macro call. | |
|
|
Colour 2 |
| Used to define a colour channel referenced by the SetColourIdx component macro call. | |
|
|
Colour 3 |
| Used to define a colour channel referenced by the SetColourIdx component macro call. | |
|
New Line After Data |
| Automatically append a newline character after any data has been written to the console using the AddString component macro. | |
|
|
Clear On Sim Start |
| Automatically clear the console tab when the simulation is started. | |
|
|
Add Timestamp |
| Automatically adds a timestamp to the console after a newline character has been received. | |
|
Timestamp |
|
Date Format |
| Specifies the format of the date string. No - "DD/MM/YY" Yes - "MM/DD/YY" | |
|
|
Time Separator |
| Characters that are used in between the time digits | |
|
|
Date Separator |
| Characters that are used in between the date digits | |
|
|
TimeStamp Separator |
| Characters that are used between the time and date strings when returning a full time stamp. | |
|
|
Override Colour |
| Overrides the current selected colour when writing the timestamp. | |
|
|
Timestamp Colour |
| Defines the colour of the time stamp text | |
Component Source Code
Please click here to download the component source project: FC_Comp_Source_ConsoleWriter.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_ConsoleWriter.fcfx