MediaPipeTasksVision Framework Reference

    MPPMask

      @interface 
 MPPMask 
 : 
 NSObject 
 < 
 NSCopying 
 >

    The wrapper class for MediaPipe segmentation masks.

    Masks are stored as UInt8 * or float * objects. Every mask has an underlying type which can be accessed using dataType . You can access the mask as any other type using the appropriate properties. For example, if the underlying type is uInt8 , in addition to accessing the mask using uint8Data , you can access float32Data to get the 32 bit float data (with values ranging from 0.0 to 1.0). The first time you access the data as a type different from the underlying type, an expensive type conversion is performed. Subsequent accesses return a pointer to the memory location for the same type converted array. As type conversions can be expensive, it is recommended to limit the accesses to data of types different from the underlying type.

    Masks that are returned from a MediaPipe Tasks are owned by by the underlying C++ Task. If you need to extend the lifetime of these objects, you can invoke the copy() method.

    • The width of the mask.

      Declaration

      Objective-C

        @property 
 ( 
 nonatomic 
 , 
 readonly 
 ) 
 NSInteger 
 width 
 ;

    • The height of the mask.

      Declaration

      Objective-C

        @property 
 ( 
 nonatomic 
 , 
 readonly 
 ) 
 NSInteger 
 height 
 ;

    • The data type of the mask.

      Declaration

      Objective-C

        @property 
 ( 
 nonatomic 
 , 
 readonly 
 ) 
  MPPMaskDataType 
 
 dataType 
 ;

    • The pointer to the memory location where the underlying mask as a single channel UInt8 array is stored. Uint8 values use the full value range and range from 0 to 255.

      Declaration

      Objective-C

        @property 
 ( 
 nonatomic 
 , 
 readonly 
 ) 
 const 
 UInt8 
 * 
 _Nonnull 
 uint8Data 
 ;

    • The pointer to the memory location where the underlying mask as a single channel float 32 array is stored. Float values range from 0.0 to 1.0.

      Declaration

      Objective-C

        @property 
 ( 
 nonatomic 
 , 
 readonly 
 ) 
 const 
 float 
 * 
 _Nonnull 
 float32Data 
 ;

    • Initializes an Mask object of type uInt8 with the given UInt8* data, width and height.

      If shouldCopy is set to true , the newly created Mask stores a reference to a deep copied uint8Data . Since deep copies are expensive, it is recommended to not set shouldCopy unless the Mask must outlive the passed in uint8Data .

      Declaration

      Objective-C

        - 
 ( 
 nullable 
 instancetype 
 ) 
 initWithUInt8Data 
 :( 
 nonnull 
 const 
 UInt8 
 * 
 ) 
 uint8Data 
 width 
 :( 
 NSInteger 
 ) 
 width 
 height 
 :( 
 NSInteger 
 ) 
 height 
 shouldCopy 
 :( 
 BOOL 
 ) 
 shouldCopy 
 ;

      Parameters

      uint8Data

      A pointer to the memory location of the UInt8 data array.
      width

      The width of the mask.
      height

      The height of the mask.
      shouldCopy

      The height of the mask.

      Return Value

      A new Mask instance with the given UInt8* data, width and height.

    • Initializes an Mask object of type float32 with the given float* data, width and height.

      If shouldCopy is set to true , the newly created Mask stores a reference to a deep copied float32Data . Since deep copies are expensive, it is recommended to not set shouldCopy unless the Mask must outlive the passed in float32Data .

      Declaration

      Objective-C

        - 
 ( 
 nullable 
 instancetype 
 ) 
 initWithFloat32Data 
 :( 
 nonnull 
 const 
 float 
 * 
 ) 
 float32Data 
 width 
 :( 
 NSInteger 
 ) 
 width 
 height 
 :( 
 NSInteger 
 ) 
 height 
 shouldCopy 
 :( 
 BOOL 
 ) 
 shouldCopy 
 ;

      Parameters

      float32Data

      A pointer to the memory location of the float data array.
      width

      The width of the mask.
      height

      The height of the mask.

      Return Value

      A new Mask instance with the given float* data, width and height.

    • Unavailable.

      Declaration

      Objective-C

        - 
 ( 
 nonnull 
 instancetype 
 ) 
 init 
 ;

    • Undocumented

      Declaration

      Objective-C

        + 
 ( 
 instancetype 
 ) 
 new 
 NS_UNAVAILABLE 
 ;
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: