API Scope: Difference between revisions
Appearance
XML import of API auto-gen |
No edit summary |
||
| (19 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<sidebar>API Contents</sidebar> | |||
==Scope== | Data scope additions | ||
__TOC__ | |||
==Functions provided for this class== | |||
{| | |||
|- | |||
|width="35%"|[[API Scope.AddGroup|AddGroup]] | |||
|Adds a group to the scope to which streams may be added | |||
|- | |||
|width="35%"|[[API Scope.AddStream|AddStream]] | |||
|Adds a stream to the given group suitable for inputs and operations | |||
|- | |||
|width="35%"|[[API Scope.AddBuffer|AddBuffer]] | |||
|Adds a fixed-view stream to the given group suitable for inputs and operations | |||
|- | |||
|width="35%"|[[API Scope.Rename|Rename]] | |||
|Renames the given scope group, stream or buffer | |||
|- | |||
|width="35%"|[[API Scope.AddPort|AddPort]] | |||
|Adds an input to the stream from a port | |||
|- | |||
|width="35%"|[[API Scope.AddAnalog|AddAnalog]] | |||
|Adds an input to the stream from an analog channel | |||
|- | |||
|width="35%"|[[API Scope.AddCustom|AddCustom]] | |||
|Adds an input to the stream from a custom injection | |||
|- | |||
|width="35%"|[[API Scope.AddOp|AddOp]] | |||
|Adds an operation to act on the inputs of the stream | |||
|- | |||
|width="35%"|[[API Scope.ClearOps|ClearOps]] | |||
|Clears all inputs and operations from the given stream | |||
|- | |||
|width="35%"|[[API Scope.SetBuffer|SetBuffer]] | |||
|Sets the contents of a snapshot stream | |||
|- | |||
|width="35%"|[[API Scope.SetCustom|SetCustom]] | |||
|Sets one of 32 custom analog values for the group | |||
|- | |||
|width="35%"|[[API Scope.GetSnapshot|GetSnapshot]] | |||
|Gets a block of the output stream with each input sample operated on, returns number of samples read | |||
|- | |||
|width="35%"|[[API_Scope.GetOutputBlock|GetOutputBlock]] | |||
|Gets a block of the output stream | |||
|- | |||
|width="35%"|[[API Scope.FindOutput|FindOutput]] | |||
|Searches back through the output history for a value, returns offset of found sample from TimeUS, 0 if not found | |||
|- | |||
|width="35%"|[[API Scope.FindBaud|FindBaud]] | |||
|Attempts to calculate the baud given a series of transitions for the stream, returns calculated baud | |||
|- | |||
|width="35%"|[[API Scope.AddOverlay|AddOverlay]] | |||
|Adds a packet overlay to the stream at a given offset from the current time | |||
|- | |||
|width="35%"|[[API Scope.AddOverlays|AddOverlays]] | |||
|Adds overlay packets to the stream by decoding the stream contents | |||
|- | |||
|width="35%"|[[API Scope.ClearOverlays|ClearOverlays]] | |||
|Clears existing overlay packets from the stream | |||
|- | |||
|width="35%"|[[API Scope.ClearAllOverlays|ClearAllOverlays]] | |||
|Clears all existing overlay packets from the stream | |||
|} | |||
==Constants provided for this class== | |||
{| class="wikitable" width="85%" | |||
|+ Used by [[API Scope.AddOp|AddOp]]() | |||
|- | |||
!width="10%"|Type | |||
!width="20%"|Name | |||
!width="20%"|Value | |||
!width="60%"|Description | |||
|- | |||
|LONG | |||
|Op_Bound | |||
|1 | |||
|Bound the current value to the expected range of the input | |||
|- | |||
|LONG | |||
|Op_Scale | |||
|2 | |||
|Divide the current value to the expected range of the input | |||
|- | |||
|LONG | |||
|Op_Xor | |||
|3 | |||
|Exclusive-or with the provided integer argument | |||
|- | |||
|LONG | |||
|Op_AndNot | |||
|4 | |||
|Clear the bits in the provided integer argument | |||
|- | |||
|LONG | |||
|Op_And | |||
|5 | |||
|Isolate only the bits in the provided integer argument | |||
|- | |||
|LONG | |||
|Op_Orr | |||
|6 | |||
|Set the bits in the provided integer argument | |||
|- | |||
|LONG | |||
|Op_Not | |||
|7 | |||
|Invert (ones-compliment) the current input | |||
|- | |||
|LONG | |||
|Op_Add | |||
|8 | |||
|Add the argument to the current input | |||
|- | |||
|LONG | |||
|Op_Sub | |||
|9 | |||
|Subtract the argument from the current input | |||
|- | |||
|LONG | |||
|Op_Mul | |||
|10 | |||
|Multiply the argument by the current input | |||
|- | |||
|LONG | |||
|Op_Div | |||
|11 | |||
|Divide the current input by the argument | |||
|- | |||
|LONG | |||
|Op_Pow | |||
|12 | |||
|Raise the input to the power of the argument | |||
|- | |||
|LONG | |||
|Op_Neg | |||
|13 | |||
|Negate (twos compliment) the current input | |||
|- | |||
|LONG | |||
|Op_Recip | |||
|14 | |||
|Perform the reciprocal on the current input | |||
|- | |||
|LONG | |||
|Op_Sqrt | |||
|15 | |||
|Perform a square root on the current input | |||
|- | |||
|LONG | |||
|Op_Ln | |||
|16 | |||
|Perform a natural logarithm on the current input | |||
|- | |||
|LONG | |||
|Op_Ln2 | |||
|17 | |||
|Perform a base-2 logarithm on the current input | |||
|- | |||
|LONG | |||
|Op_Cos | |||
|18 | |||
|Convert the input to its cosine value (input is in radians) | |||
|- | |||
|LONG | |||
|Op_Sin | |||
|19 | |||
|Convert the input to its sine value (input is in radians) | |||
|- | |||
|LONG | |||
|Op_Tan | |||
|20 | |||
|Convert the input to its tangent value (input is in radians) | |||
|- | |||
|LONG | |||
|Op_Int | |||
|21 | |||
|Convert the input from a float to an integer (using the floor function) | |||
|} | |||
{| class="wikitable" width="85%" | |||
|+ Used by [[API Scope.FindOutput|FindOutput]]() | |||
|- | |||
!width="10%"|Type | |||
!width="20%"|Name | |||
!width="20%"|Value | |||
!width="60%"|Description | |||
|- | |||
|LONG | |||
|Find_Lower | |||
|1 | |||
|Match a search when output is lower than the target value | |||
|- | |||
|LONG | |||
|Find_Equal | |||
|2 | |||
|Match a search when output is equal to the target value | |||
|- | |||
|LONG | |||
|Find_Higher | |||
|4 | |||
|Match a search when output is greater than the target value | |||
|- | |||
|LONG | |||
|Find_LowHigh | |||
|8 | |||
|Match a search when output goes lower to higher than the target | |||
|- | |||
|LONG | |||
|Find_HighLow | |||
|16 | |||
|Match a search when output goes higher to lower than the target | |||
|} | |||
{| class="wikitable" width="85%" | |||
{| class="wikitable" |+width=" | |+ Used by [[API Scope.AddOverlays|AddOverlays]]() | ||
| | |- | ||
|- | !width="10%"|Type | ||
| | !width="20%"|Name | ||
| | !width="20%"|Value | ||
| | !width="60%"|Description | ||
|- | |- | ||
|LONG | |||
|- | |Overlay_LSBF | ||
| | |1 | ||
| | |Flags least-significant bit first, else most-significant bit first | ||
| | |- | ||
|LONG | |||
| | |Overlay_Invert | ||
|2 | |||
|Flags to invert the bits in a packet before calculating the packet value | |||
|} | |} | ||
=== | |||
==Examples== | |||
''<span style="color:red;">No additional examples</span>'' | |||
==See also== | |||
''<span style="color:red;">No additional information</span>'' | |||
Latest revision as of 11:04, 1 September 2014
<sidebar>API Contents</sidebar> Data scope additions
Functions provided for this class
| AddGroup | Adds a group to the scope to which streams may be added |
| AddStream | Adds a stream to the given group suitable for inputs and operations |
| AddBuffer | Adds a fixed-view stream to the given group suitable for inputs and operations |
| Rename | Renames the given scope group, stream or buffer |
| AddPort | Adds an input to the stream from a port |
| AddAnalog | Adds an input to the stream from an analog channel |
| AddCustom | Adds an input to the stream from a custom injection |
| AddOp | Adds an operation to act on the inputs of the stream |
| ClearOps | Clears all inputs and operations from the given stream |
| SetBuffer | Sets the contents of a snapshot stream |
| SetCustom | Sets one of 32 custom analog values for the group |
| GetSnapshot | Gets a block of the output stream with each input sample operated on, returns number of samples read |
| GetOutputBlock | Gets a block of the output stream |
| FindOutput | Searches back through the output history for a value, returns offset of found sample from TimeUS, 0 if not found |
| FindBaud | Attempts to calculate the baud given a series of transitions for the stream, returns calculated baud |
| AddOverlay | Adds a packet overlay to the stream at a given offset from the current time |
| AddOverlays | Adds overlay packets to the stream by decoding the stream contents |
| ClearOverlays | Clears existing overlay packets from the stream |
| ClearAllOverlays | Clears all existing overlay packets from the stream |
Constants provided for this class
| Type | Name | Value | Description |
|---|---|---|---|
| LONG | Op_Bound | 1 | Bound the current value to the expected range of the input |
| LONG | Op_Scale | 2 | Divide the current value to the expected range of the input |
| LONG | Op_Xor | 3 | Exclusive-or with the provided integer argument |
| LONG | Op_AndNot | 4 | Clear the bits in the provided integer argument |
| LONG | Op_And | 5 | Isolate only the bits in the provided integer argument |
| LONG | Op_Orr | 6 | Set the bits in the provided integer argument |
| LONG | Op_Not | 7 | Invert (ones-compliment) the current input |
| LONG | Op_Add | 8 | Add the argument to the current input |
| LONG | Op_Sub | 9 | Subtract the argument from the current input |
| LONG | Op_Mul | 10 | Multiply the argument by the current input |
| LONG | Op_Div | 11 | Divide the current input by the argument |
| LONG | Op_Pow | 12 | Raise the input to the power of the argument |
| LONG | Op_Neg | 13 | Negate (twos compliment) the current input |
| LONG | Op_Recip | 14 | Perform the reciprocal on the current input |
| LONG | Op_Sqrt | 15 | Perform a square root on the current input |
| LONG | Op_Ln | 16 | Perform a natural logarithm on the current input |
| LONG | Op_Ln2 | 17 | Perform a base-2 logarithm on the current input |
| LONG | Op_Cos | 18 | Convert the input to its cosine value (input is in radians) |
| LONG | Op_Sin | 19 | Convert the input to its sine value (input is in radians) |
| LONG | Op_Tan | 20 | Convert the input to its tangent value (input is in radians) |
| LONG | Op_Int | 21 | Convert the input from a float to an integer (using the floor function) |
| Type | Name | Value | Description |
|---|---|---|---|
| LONG | Find_Lower | 1 | Match a search when output is lower than the target value |
| LONG | Find_Equal | 2 | Match a search when output is equal to the target value |
| LONG | Find_Higher | 4 | Match a search when output is greater than the target value |
| LONG | Find_LowHigh | 8 | Match a search when output goes lower to higher than the target |
| LONG | Find_HighLow | 16 | Match a search when output goes higher to lower than the target |
| Type | Name | Value | Description |
|---|---|---|---|
| LONG | Overlay_LSBF | 1 | Flags least-significant bit first, else most-significant bit first |
| LONG | Overlay_Invert | 2 | Flags to invert the bits in a packet before calculating the packet value |
Examples
No additional examples
See also
No additional information