AgIsoStack++
A control-function-focused implementation of the major ISOBUS and J1939 protocols
|
This object is used to format, display and change a numeric value based on a supplied integer value. More...
#include <isobus_virtual_terminal_objects.hpp>
Public Types | |
enum class | AttributeName : std::uint8_t { Type = 0 , Width = 1 , Height = 2 , BackgroundColour = 3 , FontAttributes = 4 , Options = 5 , VariableReference = 6 , MinValue = 7 , MaxValue = 8 , Offset = 9 , Scale = 10 , NumberOfDecimals = 11 , Format = 12 , Justification = 13 , Value = 14 , Options2 = 15 , NumberOfAttributes = 16 } |
Enumerates this object's attributes which are assigned an attribute ID. The Change Attribute command allows any writable attribute with an AID to be changed. More... | |
enum class | Options : std::uint8_t { Transparent = 0 , DisplayLeadingZeros = 1 , DisplayZeroAsBlank = 2 , Truncate = 3 } |
Options that can be applied to the input number. More... | |
enum class | Options2 : std::uint8_t { Enabled = 0 , RealTimeEditing = 1 } |
More options, for some reason they are different bytes. More... | |
enum class | HorizontalJustification : std::uint8_t { PositionLeft = 0 , PositionMiddle = 1 , PositionRight = 2 , Reserved = 3 } |
The allowable horizontal justification options. More... | |
enum class | VerticalJustification : std::uint8_t { PositionTop = 0 , PositionMiddle = 1 , PositionBottom = 2 , Reserved = 3 } |
The allowable vertical justification options. More... | |
Public Types inherited from isobus::VTObject | |
enum class | AttributeError : std::uint8_t { InvalidObjectID = 0 , InvalidAttributeID = 1 , InvalidValue = 2 , AnyOtherError = 4 } |
Enumerates the bit indices of the error fields that can be set when changing an attribute. More... | |
Public Member Functions | |
InputNumber ()=default | |
Constructor for an input number object. | |
~InputNumber () override=default | |
Virtual destructor for an input number object. | |
VirtualTerminalObjectType | get_object_type () const override |
Returns the VT object type of the underlying derived object. | |
std::uint32_t | get_minumum_object_length () const override |
Returns the minimum binary serialized length of the associated object. | |
bool | get_is_valid (const std::map< std::uint16_t, std::shared_ptr< VTObject > > &objectPool) const override |
Performs basic error checking on the object and returns if the object is valid. | |
bool | set_attribute (std::uint8_t attributeID, std::uint32_t rawAttributeData, const std::map< std::uint16_t, std::shared_ptr< VTObject > > &objectPool, AttributeError &returnedError) override |
Sets an attribute and optionally returns an error code in the last parameter. | |
bool | get_attribute (std::uint8_t attributeID, std::uint32_t &returnedAttributeData) const override |
Gets an attribute and returns the raw data in the last parameter. | |
HorizontalJustification | get_horizontal_justification () const |
Returns the horizontal justification setting of the input number. | |
VerticalJustification | get_vertical_justification () const |
Returns the vertical justification setting of the input number. | |
void | set_justification_bitfield (std::uint8_t newJustification) |
Sets the justification bitfield of the input number. | |
float | get_scale () const |
Returns the scale factor that is applied to the value of the input number. | |
void | set_scale (float newScale) |
Sets the scale factor that is applied to the value of the input number. | |
std::uint32_t | get_maximum_value () const |
Returns the maximum value for the input number. | |
void | set_maximum_value (std::uint32_t newMax) |
Sets the maximum value for the input number. | |
std::uint32_t | get_minimum_value () const |
Returns the minimum value for this input number. | |
void | set_minimum_value (std::uint32_t newMin) |
Sets the minimum value for the input number. | |
std::int32_t | get_offset () const |
Returns the offset that will be applied to the number's value when it is displayed. | |
void | set_offset (std::int32_t newOffset) |
Sets the offset that will be applied to the number's value when it is displayed. | |
std::uint8_t | get_number_of_decimals () const |
Returns the number of decimals to display when rendering this input number. | |
void | set_number_of_decimals (std::uint8_t numDecimals) |
Sets the number of decimals to display when rendering this number. | |
bool | get_format () const |
Returns if the format option is set for this input number. | |
void | set_format (bool newFormat) |
Sets the format option. | |
bool | get_option (Options option) const |
Returns the state of a single option in the object's option bitfield. | |
void | set_options (std::uint8_t newOptions) |
Sets the options bitfield for this object to a new value. | |
void | set_option (Options option, bool optionValue) |
Sets a single option in the options bitfield to the specified value. | |
bool | get_option2 (Options2 newOption) const |
Returns the state of a single option in the object's second option bitfield. | |
void | set_options2 (std::uint8_t newOptions) |
Sets the second options bitfield for this object to a new value. | |
void | set_option2 (Options2 option, bool newOption) |
Sets a single option in the second options bitfield to the specified value. | |
std::uint32_t | get_value () const |
Returns the value of the input number (only matters if there's no child number variable object). | |
void | set_value (std::uint32_t inputValue) |
Sets the value of the input number (only matters if there's no child number variable object). | |
std::uint16_t | get_font_attributes () const |
Returns the object ID of a font attributes object that defines the font attributes of the Input Number object. | |
void | set_font_attributes (std::uint16_t fontAttributesValue) |
Sets the object ID of a font attributes object that defines the font attributes of the Input Number object. Does no error checking on the type of the supplied object. | |
std::uint16_t | get_variable_reference () const |
Returns the object ID of a number variable object that contains the value of the Input Number object. | |
void | set_variable_reference (std::uint16_t variableReferenceValue) |
Sets the object ID of a number variable object that contains the value of the Input Number object. Does no error checking on the type of the supplied object. | |
Public Member Functions inherited from isobus::VTObject | |
VTObject ()=default | |
Constructor for a generic VT object. Sets up default values and the pointer to the member object pool. | |
virtual | ~VTObject ()=default |
Virtual destructor for a generic VT object. | |
std::uint16_t | get_id () const |
Returns the object ID of this VT object. | |
void | set_id (std::uint16_t value) |
Sets the object ID of this VT object. | |
std::uint16_t | get_width () const |
Returns the width of this object in px. | |
void | set_width (std::uint16_t value) |
Sets the width of this object in px. | |
std::uint16_t | get_height () const |
Returns the height of this object in px. | |
void | set_height (std::uint16_t value) |
Sets the height of this object in px. | |
std::uint8_t | get_background_color () const |
Returns the background color attribute of this object. | |
void | set_background_color (std::uint8_t value) |
Sets the background color attribute of this object. | |
std::uint16_t | get_number_children () const |
Returns the number of child objects within this object. | |
void | add_child (std::uint16_t objectID, std::int16_t relativeXLocation, std::int16_t relativeYLocation) |
Adds an object as a child to another object, which essentially creates a tree of object association. | |
std::uint16_t | get_child_id (std::uint16_t index) const |
Returns the ID of the child by index, if one was added previously. | |
std::int16_t | get_child_x (std::uint16_t index) const |
Returns the X offset of the child object associated with the specified index into the parent object. | |
std::int16_t | get_child_y (std::uint16_t index) const |
Returns the Y offset of the child object associated with the specified index into the parent object. | |
void | set_child_x (std::uint16_t index, std::int16_t xOffset) |
Sets the X offset of the child object associated with the specified index into the parent object. | |
void | set_child_y (std::uint16_t index, std::int16_t yOffset) |
Sets the Y offset of the child object associated with the specified index into the parent object. | |
bool | offset_all_children_with_id (std::uint16_t childObjectID, std::int8_t xOffset, std::int8_t yOffset) |
Offsets all child objects with the specified ID by the amount specified relative to its parent. | |
void | remove_child (std::uint16_t objectIDToRemove, std::int16_t relativeXLocation, std::int16_t relativeYLocation) |
Removes an object reference from another object. All fields must exactly match for the object to be removed. This is because objects can have multiple of the same child at different places, so we can't infer which one to remove without the exact position. | |
void | pop_child () |
Removes the last added child object. This is meant to be a faster way to deal with objects that only have a max of 1 child. | |
std::uint8_t | get_number_macros () const |
Returns the number of macros referenced by this object. | |
void | add_macro (MacroMetadata macroToAdd) |
Adds a macro to the list of macros referenced by this object. | |
MacroMetadata | get_macro (std::uint8_t index) const |
Returns the macro ID at the specified index. | |
Private Attributes | |
float | scale = 0.0f |
Scale to be applied to the input value and min/max values. | |
std::uint32_t | maximumValue = 0 |
Raw maximum value for the input. | |
std::uint32_t | minimumValue = 0 |
Raw minimum value for the input before scaling. | |
std::uint32_t | value = 0 |
The raw value of the object, used if no number variable child has been set. | |
std::int32_t | offset = 0 |
Offset to be applied to the input value and min/max values. | |
std::uint16_t | fontAttributes = NULL_OBJECT_ID |
Stores the object ID of a font attributes object that will be used to display this object. | |
std::uint16_t | variableReference = NULL_OBJECT_ID |
Stores the object ID of a number variable object that will be used in place of the value attribute if it is not NULL_OBJECT_ID. | |
std::uint8_t | numberOfDecimals = 0 |
Specifies number of decimals to display after the decimal point. | |
std::uint8_t | options = 0 |
Options byte 1. | |
std::uint8_t | options2 = 0 |
Options byte 2. | |
std::uint8_t | justificationBitfield = 0 |
Indicates how the number is positioned in the field defined by height and width. | |
bool | format = false |
0 = use fixed format decimal display (####.nn), 1 = use exponential format ([-]###.nnE[+/-]##) where n is set by the number of decimals | |
Static Private Attributes | |
static constexpr std::uint32_t | MIN_OBJECT_LENGTH = 38 |
The fewest bytes of IOP data that can represent this object. | |
Additional Inherited Members | |
Static Public Member Functions inherited from isobus::VTObject | |
static std::shared_ptr< VTObject > | get_object_by_id (std::uint16_t objectID, const std::map< std::uint16_t, std::shared_ptr< VTObject > > &objectPool) |
Returns a VT object from its member pool by ID, or the null id if it does not exist. | |
Protected Attributes inherited from isobus::VTObject | |
std::vector< ChildObjectData > | children |
List of child objects. | |
std::vector< MacroMetadata > | macros |
List of macros referenced by this object. | |
std::uint16_t | objectID = NULL_OBJECT_ID |
Object identifier. Shall be unique within the object pool. | |
std::uint16_t | width = 0 |
The width of the object. Not always applicable, but often used. | |
std::uint16_t | height = 0 |
The height of the object. Not always applicable, but often used. | |
std::uint8_t | backgroundColor = 0 |
The background color (from the VT colour table) | |
This object is used to format, display and change a numeric value based on a supplied integer value.
Displayed value = (value attribute + Offset) * Scaling Factor
Definition at line 1314 of file isobus_virtual_terminal_objects.hpp.
|
strong |
Enumerates this object's attributes which are assigned an attribute ID. The Change Attribute command allows any writable attribute with an AID to be changed.
Definition at line 1319 of file isobus_virtual_terminal_objects.hpp.
|
strong |
The allowable horizontal justification options.
Definition at line 1358 of file isobus_virtual_terminal_objects.hpp.
|
strong |
Options that can be applied to the input number.
Definition at line 1342 of file isobus_virtual_terminal_objects.hpp.
|
strong |
More options, for some reason they are different bytes.
Enumerator | |
---|---|
Enabled | If TRUE the object shall be enabled. |
RealTimeEditing | If TRUE the value shall be transmitted to the ECU as it is being changed. |
Definition at line 1351 of file isobus_virtual_terminal_objects.hpp.
|
strong |
The allowable vertical justification options.
Definition at line 1367 of file isobus_virtual_terminal_objects.hpp.
|
overridevirtual |
Gets an attribute and returns the raw data in the last parameter.
[in] | attributeID | The ID of the attribute to get |
[out] | returnedAttributeData | The raw data of the attribute, as decoded in little endian format with unused bytes/bits set to zero. You may need to cast this to the correct type. If this function returns false, this value is undefined. |
Implements isobus::VTObject.
Definition at line 2494 of file isobus_virtual_terminal_objects.cpp.
std::uint16_t isobus::InputNumber::get_font_attributes | ( | ) | const |
Returns the object ID of a font attributes object that defines the font attributes of the Input Number object.
Definition at line 2755 of file isobus_virtual_terminal_objects.cpp.
bool isobus::InputNumber::get_format | ( | ) | const |
Returns if the format option is set for this input number.
The format option determines if the value is shown in fixed decimal or exponential form. A value of true
means fixed decimal (####.nn), and false
means exponential ([−]###.nnE[+/−]##)
true
if the format option is set for this input number, otherwise false
Definition at line 2691 of file isobus_virtual_terminal_objects.cpp.
InputNumber::HorizontalJustification isobus::InputNumber::get_horizontal_justification | ( | ) | const |
Returns the horizontal justification setting of the input number.
Definition at line 2626 of file isobus_virtual_terminal_objects.cpp.
|
overridevirtual |
Performs basic error checking on the object and returns if the object is valid.
[in] | objectPool | The object pool to use when validating the object |
true
if the object passed basic error checks Implements isobus::VTObject.
Definition at line 2303 of file isobus_virtual_terminal_objects.cpp.
std::uint32_t isobus::InputNumber::get_maximum_value | ( | ) | const |
Returns the maximum value for the input number.
The VT shall not accept values higher than this for this input number's value
Definition at line 2651 of file isobus_virtual_terminal_objects.cpp.
std::uint32_t isobus::InputNumber::get_minimum_value | ( | ) | const |
Returns the minimum value for this input number.
The VT shall not accept values smaller than this value for this input number
Definition at line 2661 of file isobus_virtual_terminal_objects.cpp.
|
overridevirtual |
Returns the minimum binary serialized length of the associated object.
Implements isobus::VTObject.
Definition at line 2298 of file isobus_virtual_terminal_objects.cpp.
std::uint8_t isobus::InputNumber::get_number_of_decimals | ( | ) | const |
Returns the number of decimals to display when rendering this input number.
Definition at line 2681 of file isobus_virtual_terminal_objects.cpp.
|
overridevirtual |
Returns the VT object type of the underlying derived object.
Implements isobus::VTObject.
Definition at line 2293 of file isobus_virtual_terminal_objects.cpp.
std::int32_t isobus::InputNumber::get_offset | ( | ) | const |
Returns the offset that will be applied to the number's value when it is displayed.
Definition at line 2671 of file isobus_virtual_terminal_objects.cpp.
bool isobus::InputNumber::get_option | ( | Options | option | ) | const |
Returns the state of a single option in the object's option bitfield.
[in] | option | The option to check the value of in the object's option bitfield |
Definition at line 2701 of file isobus_virtual_terminal_objects.cpp.
bool isobus::InputNumber::get_option2 | ( | Options2 | newOption | ) | const |
Returns the state of a single option in the object's second option bitfield.
[in] | newOption | The option to check the value of in the object's second option bitfield |
Definition at line 2723 of file isobus_virtual_terminal_objects.cpp.
float isobus::InputNumber::get_scale | ( | ) | const |
Returns the scale factor that is applied to the value of the input number.
Definition at line 2641 of file isobus_virtual_terminal_objects.cpp.
std::uint32_t isobus::InputNumber::get_value | ( | ) | const |
Returns the value of the input number (only matters if there's no child number variable object).
Definition at line 2745 of file isobus_virtual_terminal_objects.cpp.
std::uint16_t isobus::InputNumber::get_variable_reference | ( | ) | const |
Returns the object ID of a number variable object that contains the value of the Input Number object.
Definition at line 2765 of file isobus_virtual_terminal_objects.cpp.
InputNumber::VerticalJustification isobus::InputNumber::get_vertical_justification | ( | ) | const |
Returns the vertical justification setting of the input number.
Definition at line 2631 of file isobus_virtual_terminal_objects.cpp.
|
overridevirtual |
Sets an attribute and optionally returns an error code in the last parameter.
[in] | attributeID | The ID of the attribute to change |
[in] | rawAttributeData | The raw data to change the attribute to, as decoded in little endian format with unused bytes/bits set to zero. |
[in] | objectPool | The object pool to use when validating the objects affected by setting this attribute |
[out] | returnedError | If this function returns false, this will be the error code. If the function returns true, this value is undefined. |
Implements isobus::VTObject.
Definition at line 2357 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_font_attributes | ( | std::uint16_t | fontAttributesValue | ) |
Sets the object ID of a font attributes object that defines the font attributes of the Input Number object. Does no error checking on the type of the supplied object.
[in] | fontAttributesValue | The object ID of a font attributes object that defines the font attributes of the Input Number object |
Definition at line 2760 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_format | ( | bool | newFormat | ) |
Sets the format option.
The format option determines if the value is shown in fixed decimal or exponential form. A value of true
means fixed decimal (####.nn), and false
means exponential ([−]###.nnE[+/−]##)
[in] | newFormat | The format value to set. true for fixed decimal, false for exponential. |
Definition at line 2696 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_justification_bitfield | ( | std::uint8_t | newJustification | ) |
Sets the justification bitfield of the input number.
[in] | newJustification | The justification bitfield to set |
Definition at line 2636 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_maximum_value | ( | std::uint32_t | newMax | ) |
Sets the maximum value for the input number.
The VT shall not accept values higher than this for this input number's value
[in] | newMax | The maximum value for the input number |
Definition at line 2656 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_minimum_value | ( | std::uint32_t | newMin | ) |
Sets the minimum value for the input number.
The VT shall not accept values smaller than this value for this input number
[in] | newMin | The minimum value to set for the input number |
Definition at line 2666 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_number_of_decimals | ( | std::uint8_t | numDecimals | ) |
Sets the number of decimals to display when rendering this number.
[in] | numDecimals | The number of decimals to display |
Definition at line 2686 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_offset | ( | std::int32_t | newOffset | ) |
Sets the offset that will be applied to the number's value when it is displayed.
[in] | newOffset | The new offset that will be applied to the number's value when it is displayed |
Definition at line 2676 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_option | ( | Options | option, |
bool | optionValue ) |
Sets a single option in the options bitfield to the specified value.
[in] | option | The option to set |
[in] | optionValue | The new value of the option bit |
Definition at line 2711 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_option2 | ( | Options2 | option, |
bool | newOption ) |
Sets a single option in the second options bitfield to the specified value.
[in] | option | The option to set |
[in] | newOption | The new value of the option bit |
Definition at line 2733 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_options | ( | std::uint8_t | newOptions | ) |
Sets the options bitfield for this object to a new value.
[in] | newOptions | The new value for the options bitfield |
Definition at line 2706 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_options2 | ( | std::uint8_t | newOptions | ) |
Sets the second options bitfield for this object to a new value.
[in] | newOptions | The new value for the second options bitfield |
Definition at line 2728 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_scale | ( | float | newScale | ) |
Sets the scale factor that is applied to the value of the input number.
[in] | newScale | The scale factor to set |
Definition at line 2646 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_value | ( | std::uint32_t | inputValue | ) |
Sets the value of the input number (only matters if there's no child number variable object).
[in] | inputValue | The value to set for the input number |
Definition at line 2750 of file isobus_virtual_terminal_objects.cpp.
void isobus::InputNumber::set_variable_reference | ( | std::uint16_t | variableReferenceValue | ) |
Sets the object ID of a number variable object that contains the value of the Input Number object. Does no error checking on the type of the supplied object.
[in] | variableReferenceValue | The object ID of a number variable object that contains the value of the Input Number object |
Definition at line 2770 of file isobus_virtual_terminal_objects.cpp.
|
private |
Stores the object ID of a font attributes object that will be used to display this object.
Definition at line 1542 of file isobus_virtual_terminal_objects.hpp.
|
private |
0 = use fixed format decimal display (####.nn), 1 = use exponential format ([-]###.nnE[+/-]##) where n is set by the number of decimals
Definition at line 1548 of file isobus_virtual_terminal_objects.hpp.
|
private |
Indicates how the number is positioned in the field defined by height and width.
Definition at line 1547 of file isobus_virtual_terminal_objects.hpp.
|
private |
Raw maximum value for the input.
Definition at line 1538 of file isobus_virtual_terminal_objects.hpp.
|
staticconstexprprivate |
The fewest bytes of IOP data that can represent this object.
Definition at line 1535 of file isobus_virtual_terminal_objects.hpp.
|
private |
Raw minimum value for the input before scaling.
Definition at line 1539 of file isobus_virtual_terminal_objects.hpp.
|
private |
Specifies number of decimals to display after the decimal point.
Definition at line 1544 of file isobus_virtual_terminal_objects.hpp.
|
private |
Offset to be applied to the input value and min/max values.
Definition at line 1541 of file isobus_virtual_terminal_objects.hpp.
|
private |
Options byte 1.
Definition at line 1545 of file isobus_virtual_terminal_objects.hpp.
|
private |
Options byte 2.
Definition at line 1546 of file isobus_virtual_terminal_objects.hpp.
|
private |
Scale to be applied to the input value and min/max values.
Definition at line 1537 of file isobus_virtual_terminal_objects.hpp.
|
private |
The raw value of the object, used if no number variable child has been set.
Definition at line 1540 of file isobus_virtual_terminal_objects.hpp.
|
private |
Stores the object ID of a number variable object that will be used in place of the value attribute if it is not NULL_OBJECT_ID.
Definition at line 1543 of file isobus_virtual_terminal_objects.hpp.