ZMVideoSDKAnnotationHelper.h 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. #import <Foundation/Foundation.h>
  2. #import "ZMVideoSDKUserHelper.h"
  3. NS_ASSUME_NONNULL_BEGIN
  4. /**
  5. @brief Annotate helper interface.
  6. */
  7. @interface ZMVideoSDKAnnotationHelper : NSObject
  8. /**
  9. * @brief Whether annotation was disabled or not by the share owner.
  10. * @return YES indicates the annotations is disabled, otherwise NO.
  11. */
  12. - (BOOL)isSenderDisableAnnotation;
  13. /**
  14. * @brief Starts annotation.
  15. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  16. */
  17. - (ZMVideoSDKErrors)startAnnotation;
  18. /**
  19. * @brief Stops annotation.
  20. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  21. */
  22. - (ZMVideoSDKErrors)stopAnnotation;
  23. /**
  24. * @brief Set the annotation tool color.
  25. * @param toolColor The specified color
  26. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  27. */
  28. - (ZMVideoSDKErrors)setToolColor:(NSColor* _Nonnull)toolColor;
  29. /**
  30. * @brief Gets the annotation tool color.
  31. * @param toolColor The current tool color.
  32. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  33. */
  34. - (ZMVideoSDKErrors)getToolColor:(NSColor* _Nullable * _Nonnull)toolColor;
  35. /**
  36. * @brief Sets the annotation tool type.
  37. * @param toolType The specified annotation tool type. For more information, see {@link ZMVideoSDKAnnotationToolType}.
  38. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  39. * @warning The tool type ZMVideoSDKAnnotationToolType_Picker and ZMVideoSDKAnnotationToolType_SpotLight are not support for viewer.
  40. */
  41. - (ZMVideoSDKErrors)setToolType:(ZMVideoSDKAnnotationToolType)toolType;
  42. /**
  43. * @brief Gets the annotation tool type.
  44. * @param toolType The current tool type. For more information, see {@link ZMVideoSDKAnnotationToolType}.
  45. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  46. */
  47. - (ZMVideoSDKErrors)getToolType:(ZMVideoSDKAnnotationToolType*)toolType;
  48. /**
  49. * @brief Sets the annotation tool width.
  50. * @param width The specify annotation tool width.
  51. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  52. */
  53. - (ZMVideoSDKErrors)setToolWidth:(long)width;
  54. /**
  55. * @brief Gets the annotation tool width.
  56. * @param width The line width of annotations.
  57. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  58. */
  59. - (ZMVideoSDKErrors)getToolWidth:(long*)width;
  60. /**
  61. * @brief Undoes one annotation content step.
  62. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  63. */
  64. - (ZMVideoSDKErrors)undo;
  65. /**
  66. * @brief Redoes one annotation content step.
  67. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  68. */
  69. - (ZMVideoSDKErrors)redo;
  70. /**
  71. * @brief Clears the annotation content.
  72. * @param type The specified clear type.
  73. * @return If the function succeeds, it will return ZMVideoSDKErrors_Success.
  74. */
  75. - (ZMVideoSDKErrors)clear:(ZMVideoSDKAnnotationClearType)type;
  76. @end
  77. NS_ASSUME_NONNULL_END