Difference between revisions of "API Scope"
From Flowcode Help
Jump to navigationJump to search (XML import of API auto-gen) |
|||
| (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
Contents
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