MPSCNNArithmetic(3)					 MetalPerformanceShaders.framework				       MPSCNNArithmetic(3)

NAME

       MPSCNNArithmetic

SYNOPSIS

       #import <MPSCNNMath.h>

       Inherits MPSCNNBinaryKernel.

       Inherited by MPSCNNAdd, MPSCNNDivide, MPSCNNMultiply, and MPSCNNSubtract.

   Instance Methods
       (nonnull instancetype) - initWithDevice:

   Properties
       float primaryScale
       float secondaryScale
       float bias
       NSUInteger primaryStrideInFeatureChannels
       NSUInteger secondaryStrideInFeatureChannels
       float minimumValue
       float maximumValue

   Additional Inherited Members
Detailed Description
       This depends on Metal.framework	The MPSCNNArithmetic filter takes two source images, a primary source image and a secondary source image,
       and outputs a single destination image. It applies an element-wise arithmetic operator to each pixel in a primary source image and a
       corresponding pixel in a secondary source image over a specified region.

       The supported arithmetic operators are the following:

       o Addition

       o Subtraction

       o Multiplication

       o Division

       This filter takes additional parameters: primaryScale, secondaryScale, and bias. The default value for primaryScale and secondaryScale is
       1.0f. The default value for bias is 0.0f. This filter applies primaryScale, secondaryScale, and bias to the primary source pixel (x) and
       secondary source pixel (y) in the following way:

       o Addition: result = ((primaryScale * x) + (secondaryScale * y)) + bias

       o Subtraction: result = ((primaryScale * x) - (secondaryScale * y)) + bias

       o Multiplicaton: result = ((primaryScale * x) * (secondaryScale * y)) + bias

       o Division: result = ((primaryScale * x) / (secondaryScale * y)) + bias

       To clamp the result of an arithmetic operation, where result = clamp(result, minimumValue, maximumValue), set the minimumValue and
       maximumValue appropriately. The default value of minimumValue is -FLT_MAX. The default value of maximumValue is FLT_MAX.

       This filter also takes the following additional parameters:

       o primaryStrideInPixelsX, primaryStrideInPixelsY, primaryStrideInFeatureChannels

       o secondaryStrideInPixelsX, secondaryStrideInPixelsY, secondaryStrideInFeatureChannels These parameters can be used to control broadcasting
	 for the data stored in the primary and secondary source images. For example, setting all strides for the primary source image to 0 will
	 result in the primarySource image being treated as a scalar value. The only supported values are 0 or 1. The default value of these
	 parameters is 1.

       The number of output feature channels remains the same as the number of input feature channels.

       You must use one of the sub-classes of MPSImageArithmetic.

Method Documentation
   - (nonnull instancetype) initWithDevice: (nonnull id< MTLDevice >) device
       Standard init with default properties per filter type

       Parameters:
	   device The device that the filter will be used on. May not be NULL.

       Returns:
	   A pointer to the newly initialized object. This will fail, returning nil if the device is not supported. Devices must be
	   MTLFeatureSet_iOS_GPUFamily2_v1 or later.

       Reimplemented from MPSCNNBinaryKernel.

       Reimplemented in MPSCNNAdd, MPSCNNSubtract, MPSCNNMultiply, and MPSCNNDivide.

Property Documentation
   - (float) bias [read],  [write],  [nonatomic],  [assign]
   - maximumValue [read],  [write],  [nonatomic],  [assign]
       maximumValue is used to clamp the result of an arithmetic operation: result = clamp(result, minimumValue, maximumValue). The default value
       of maximumValue is FLT_MAX.

   - minimumValue [read],  [write],  [nonatomic],  [assign]
       minimumValue is to clamp the result of an arithmetic operation: result = clamp(result, minimumValue, maximumValue). The default value of
       minimumValue is -FLT_MAX.

   - (float) primaryScale [read],  [write],  [nonatomic],  [assign]
   - (NSUInteger) primaryStrideInFeatureChannels [read],  [write],  [nonatomic],  [assign]
   - (float) secondaryScale [read],  [write],  [nonatomic],  [assign]
   - (NSUInteger) secondaryStrideInFeatureChannels [read],  [write],  [nonatomic],  [assign]
Author
       Generated automatically by Doxygen for MetalPerformanceShaders.framework from the source code.

Version MetalPerformanceShaders-100				  Thu Feb 8 2018					       MPSCNNArithmetic(3)