Difference between revisions of "API Scope.AddOp"

From Flowcode Help
Jump to navigationJump to search
(XML import)
(XML import)
Line 15: Line 15:
 
[[Variable types|ULONG]] ''FuncOp''
 
[[Variable types|ULONG]] ''FuncOp''
 
:An operation to perform on the input
 
:An operation to perform on the input
''Typical values for this parameter:''
+
:''Typical values for this parameter:''
{| class="wikitable" width="75%"
+
::{| class="wikitable" width="65%"
 
|-
 
|-
! width="20%" |Type
 
 
! width="30%" |Name
 
! width="30%" |Name
! width="50%" |Description
+
! width="55%" |Description
 
|-
 
|-
|LONG
 
 
|Op_Bound
 
|Op_Bound
 
|Bound the current value to the expected range of the input
 
|Bound the current value to the expected range of the input
 
|-
 
|-
|LONG
 
 
|Op_Scale
 
|Op_Scale
 
|Divide the current value to the expected range of the input
 
|Divide the current value to the expected range of the input
 
|-
 
|-
|LONG
 
 
|Op_Xor
 
|Op_Xor
 
|Exclusive-or with the provided integer argument
 
|Exclusive-or with the provided integer argument
 
|-
 
|-
|LONG
 
 
|Op_AndNot
 
|Op_AndNot
 
|Clear the bits in the provided integer argument
 
|Clear the bits in the provided integer argument
 
|-
 
|-
|LONG
 
 
|Op_And
 
|Op_And
 
|Isolate only the bits in the provided integer argument
 
|Isolate only the bits in the provided integer argument
 
|-
 
|-
|LONG
 
 
|Op_Orr
 
|Op_Orr
 
|Set the bits in the provided integer argument
 
|Set the bits in the provided integer argument
 
|-
 
|-
|LONG
 
 
|Op_Not
 
|Op_Not
 
|Invert (ones-compliment) the current input
 
|Invert (ones-compliment) the current input
 
|-
 
|-
|LONG
 
 
|Op_Add
 
|Op_Add
 
|Add the argument to the current input
 
|Add the argument to the current input
 
|-
 
|-
|LONG
 
 
|Op_Sub
 
|Op_Sub
 
|Subtract the argument from the current input
 
|Subtract the argument from the current input
 
|-
 
|-
|LONG
 
 
|Op_Mul
 
|Op_Mul
 
|Multiply the argument by the current input
 
|Multiply the argument by the current input
 
|-
 
|-
|LONG
 
 
|Op_Div
 
|Op_Div
 
|Divide the current input by the argument
 
|Divide the current input by the argument
 
|-
 
|-
|LONG
 
 
|Op_Pow
 
|Op_Pow
 
|Raise the input to the power of the argument
 
|Raise the input to the power of the argument
 
|-
 
|-
|LONG
 
 
|Op_Neg
 
|Op_Neg
 
|Negate (twos compliment) the current input
 
|Negate (twos compliment) the current input
 
|-
 
|-
|LONG
 
 
|Op_Recip
 
|Op_Recip
 
|Perform the reciprocal on the current input
 
|Perform the reciprocal on the current input
 
|-
 
|-
|LONG
 
 
|Op_Sqrt
 
|Op_Sqrt
 
|Perform a square root on the current input
 
|Perform a square root on the current input
 
|-
 
|-
|LONG
 
 
|Op_Ln
 
|Op_Ln
 
|Perform a natural logarithm on the current input
 
|Perform a natural logarithm on the current input
 
|-
 
|-
|LONG
 
 
|Op_Ln2
 
|Op_Ln2
 
|Perform a base-2 logarithm on the current input
 
|Perform a base-2 logarithm on the current input
 
|-
 
|-
|LONG
 
 
|Op_Cos
 
|Op_Cos
 
|Convert the input to its cosine value (input is in radians)
 
|Convert the input to its cosine value (input is in radians)
 
|-
 
|-
|LONG
 
 
|Op_Sin
 
|Op_Sin
 
|Convert the input to its sine value (input is in radians)
 
|Convert the input to its sine value (input is in radians)
 
|-
 
|-
|LONG
 
 
|Op_Tan
 
|Op_Tan
 
|Convert the input to its tangent value (input is in radians)
 
|Convert the input to its tangent value (input is in radians)
 
|-
 
|-
|LONG
 
 
|Op_Int
 
|Op_Int
 
|Convert the input from a float to an integer (using the floor function)
 
|Convert the input from a float to an integer (using the floor function)
Line 115: Line 93:
 
[[Variable types|BOOL]]
 
[[Variable types|BOOL]]
  
''<span style="color:red;">No additional information</span>''
+
Returns true if the operation is a success, else false
  
  

Revision as of 21:29, 12 May 2013

<sidebar>API contents</sidebar> Adds an operation to act on the inputs of the stream

Class hierarchy

Scope

AddOp

Parameters

HANDLE StreamH

A handle to a previously created datascope stream

ULONG FuncOp

An operation to perform on the input
Typical values for this parameter:
Name Description
Op_Bound Bound the current value to the expected range of the input
Op_Scale Divide the current value to the expected range of the input
Op_Xor Exclusive-or with the provided integer argument
Op_AndNot Clear the bits in the provided integer argument
Op_And Isolate only the bits in the provided integer argument
Op_Orr Set the bits in the provided integer argument
Op_Not Invert (ones-compliment) the current input
Op_Add Add the argument to the current input
Op_Sub Subtract the argument from the current input
Op_Mul Multiply the argument by the current input
Op_Div Divide the current input by the argument
Op_Pow Raise the input to the power of the argument
Op_Neg Negate (twos compliment) the current input
Op_Recip Perform the reciprocal on the current input
Op_Sqrt Perform a square root on the current input
Op_Ln Perform a natural logarithm on the current input
Op_Ln2 Perform a base-2 logarithm on the current input
Op_Cos Convert the input to its cosine value (input is in radians)
Op_Sin Convert the input to its sine value (input is in radians)
Op_Tan Convert the input to its tangent value (input is in radians)
Op_Int Convert the input from a float to an integer (using the floor function)

FLOAT Arg

An optional argument that may be used by the FuncOp
The default value for this parameter is: 0


Return value

BOOL

Returns true if the operation is a success, else false


Detailed description

No additional information


Examples

Calling in a calculation

  • Declare a variable 'result' of type BOOL
  • Add to a calculation icon:
    result = ::Scope.AddOp(streamh, ::Scope.Op_Bound, arg)

No additional information