oValue Object

Main Index

Object List

Description
Operation
Properties

Examples
Related
Version History & Bug list

Description:

The oValue Object manages values so that they can be used in a Virtual Circuit.

The following table lists the size and availability of the oValue Object.

	Object	Size	Description	A1	A2	B1	B2	C1
	oValue		A linkable Object used for virtual circuits.	x	x	x	x	x

Operation:

The oValue Object communicates with its parent object in order to store and retrieve data. For instance, the oByte Object uses this object so that a Virtual Circuit can read and write the 8-Bit value that the oByte Object stores. Likewise, the oWord Object does exactly the same thing but with a 16-bit value.

Various methods such as Dec, Inc, Clear LShift, etc, provide common methods for the parents objects as well.

Note that the oValue Object does not store any values itself. It is just a common "point-to" object created so that Virtual Circuits can point to objects that have different magnitudes in value.

Properties:

The following table lists the properties of the oValue Object:

Property
Description

Value

The routine that retrieves and stores the parent object's numeric value.

Object Class: oProperty Value Range:

Data Type: Numeric Default Value: 0

Address

Returns a pointer to the address of the oCounter Object instance.

Object Class: oAddress Value Range: 0 - 127

Data Type: Pointer (Read Only) Default Value: Address of Object

Methods:

The following table lists the Methods of the oValue Object:

Methods	Description
Clear	Clears the Value to 0.
Dec	Decrements the Value by 1.
Inc	Increments the Value by 1.
Invert	Inverts the bits in the Value.
LShift	Shifts the bits in the Value left.
RShift	Shifts the bits in the Value Right.
Set	Sets the Value so that all the bits are 1.

Example:

The following examples use the oValue Object.

Visual Basic Syntax

C and Java Syntax

' This program demonstrates
' some of the methods of
' the oValue object.

Dim T As New oTone

Sub main()
  T.IOLine = 21
  T.Operate.TurnOn
  Do
    T.Value = 60
    ooPIC.Delay = 300
    T.Value.LShift
    ooPIC.Delay = 300
    T.Value.RShift
    ooPIC.Delay = 300
    T.Value.Clear
    ooPIC.Delay = 300
  Loop
End Sub

// This program demonstrates
// some of the methods of
// the oValue object.

oTone T = New oTone;

Void main(Void){
  T.IOLine = 21;
  T.Operate.TurnOn;
  Do{
    T.Value = 60;
    ooPIC.Delay = 300;
    T.Value.LShift;
    ooPIC.Delay = 300;
    T.Value.RShift;
    ooPIC.Delay = 300;
    T.Value.Clear;
    ooPIC.Delay = 300;
  } While (1);
}

Basic Syntax

' This program demonstrates
' some of the methods of
' the oValue object.

Dim T As New oTone(21,0,cvOn)

Do
  T.Value = 60
  ooPIC.Delay = 300
  T.Value.LShift
  ooPIC.Delay = 300
  T.Value.RShift
  ooPIC.Delay = 300
  T.Value.Clear
  ooPIC.Delay = 300
Loop

Related Items:

The following table lists objects that use the oValue Object.

Object	Description	A1	A2	B1	B2	C1
oA2D10	Measures the level of the voltage on an input line with an 10-bit result.				x	x
oA2D8	Measures the level of the voltage on an input line with an 8-bit result.	x	x	x	x	x
oA2DX	Measures the level of the voltage on an input line and detects when it is below a threshold.			x	x	x
oBit	An Object that manages a value with a range of 1 to 0.	x	x	x	x	x
oBuffer	An Object that manages a variable size data-buffer/string variable.	x	x	x	x	x
oBumper4	Reads a 4-contact bumper.			x	x	x
oBumper8	Reads an 8-contact bumper.				x	x
oByte	An Object that manages a value with a range of 0 to 255.	x	x	x	x	x
oChar	An Object that manages a value with a range of -128 to -127.			x	x	x
oCompare	Compares an Object's Value to set points.			x	x	x
oCompassDN	Reads a Dinsmore 1490 Compass.			x	x	x
oCompassVX	Reads a Vector V2X Compass.			x	x	x
oCounter2H	An Object that counts the number of high-speed cycles on a hardware specific pin.			x	x	x
oDCMotor	Controls a DC motor that is driven by an LMD18200 H-Bridge driver.			x	x	x
oDCMotor2	Controls a DC motor that is driven by an L293 H-Bridge driver.				x	x
oDIO16	Provides a 16 line digital I/O.	x	x	x	x	x
oDIO4	Provides a 4 line digital I/O.	x	x	x	x	x
oDIO8	Provides an 8 line digital I/O.	x	x	x	x	x
oDistance	An Object that manages a URCP distance value.			x	x	x