[Doc] fix invalid document
authorJaeyun <jy1210.jung@samsung.com>
Fri, 12 Jun 2020 09:18:50 +0000 (18:18 +0900)
committerwooksong <wook16.song@samsung.com>
Fri, 12 Jun 2020 10:50:22 +0000 (19:50 +0900)
typo correction and fix document for converter sub-plugin api.

Signed-off-by: Jaeyun <jy1210.jung@samsung.com>
gst/nnstreamer/include/nnstreamer_plugin_api_converter.h
gst/nnstreamer/include/tensor_typedef.h

index b752066..ff42db9 100644 (file)
@@ -1,5 +1,5 @@
 /**
- * NNStreamer API for Tensor_Decoder Sub-Plugins
+ * NNStreamer API for Tensor_Converter Sub-Plugins
  * Copyright (C) 2019 MyungJoo Ham <myungjoo.ham@samsung.com>
  *
  * This library is free software; you can redistribute it and/or
@@ -42,33 +42,36 @@ typedef struct _NNStreamerExternalConverter
 {
   const char *name;
 
-/** 1. chain func, data handling. */
+  /* 1. chain func, data handling. */
   GstBuffer *(*convert) (GstBuffer * in_buf, gsize * frame_size,
       guint * frames_in, GstTensorsConfig * config);
-/** Convert the given input stream to tensor/tensors stream.
-  * @param[in] buf The input stream buffer
-  * @param[out] frame_size The size of each frame (output buffer)
-  * @param[out] frames_in The number of frames in the given input buffer.
-  * @param[out] config tensors config structure to be filled
-  * @retval Return input buffer(in_buf) if the data is to be kept untouched.
-  * @retval Return a new GstBuf if the data is to be modified.
-  */
+  /**< Convert the given input stream to tensor/tensors stream.
+   *
+   * @param[in] buf The input stream buffer
+   * @param[out] frame_size The size of each frame (output buffer)
+   * @param[out] frames_in The number of frames in the given input buffer.
+   * @param[out] config tensors config structure to be filled
+   * @retval Return input buffer(in_buf) if the data is to be kept untouched.
+   * @retval Return a new GstBuf if the data is to be modified.
+   */
 
-/** 2. get_out_config (type conf, input(media) to output(tensor)) */
+  /* 2. get_out_config (type conf, input(media) to output(tensor)) */
   gboolean (*get_out_config) (const GstCaps * in_caps,
     GstTensorsConfig * config);
-/** Set the tensor config structure from the given stream frame
-  * @param[in] in_caps The input (original/media data) stream's metadata
-  * @param[out] config The output (tensor/tensors) metadata
-  * @retval Return True if get caps successfully, FALSE if not.
-  */
+  /**< Set the tensor config structure from the given stream frame.
+   *
+   * @param[in] in_caps The input (original/media data) stream's metadata
+   * @param[out] config The output (tensor/tensors) metadata
+   * @retval Return True if get caps successfully, FALSE if not.
+   */
 
-/** 3. query_caps (tpye conf, output(tensor) to input(media)) */
+  /* 3. query_caps (type conf, output(tensor) to input(media)) */
   GstCaps *(*query_caps) (const GstTensorsConfig * config);
-/** Filters (narrows down) the GstCap (st) with the given config.
-  * @param[in] config The config of output tensor/tensors
-  * @retval Return subplugin caps (if config is NULL, return default caps)
-  */
+  /**< Filters (narrows down) the GstCap (st) with the given config.
+   *
+   * @param[in] config The config of output tensor/tensors
+   * @retval Return subplugin caps (if config is NULL, return default caps)
+   */
 } NNStreamerExternalConverter;
 
 /**
index 44d55b8..5ad7b32 100644 (file)
@@ -52,7 +52,7 @@
 #define GST_TENSOR_TYPE_ALL "{ float32, float64, int64, uint64, int32, uint32, int16, uint16, int8, uint8 }"
 
 /**
- * @brief Default static capibility for other/tensor
+ * @brief Default static capability for other/tensor
  */
 #define GST_TENSOR_CAP_DEFAULT \
     "other/tensor, " \
@@ -65,7 +65,7 @@
      */
 
 /**
- * @brief Default static capibility for other/tensors
+ * @brief Default static capability for other/tensors
  */
 #define GST_TENSORS_CAP_DEFAULT \
     "other/tensors, " \
@@ -80,7 +80,7 @@
      */
 
 /**
- * @brief Default static capibility for Protocol Buffers
+ * @brief Default static capability for Protocol Buffers
  * protobuf converter will convert this capability to other/tensor(s)
  * @todo Move this definition to proper header file
  */
@@ -88,7 +88,7 @@
     "other/protobuf-tensor, " \
     "framerate = " GST_TENSOR_RATE_RANGE
 /**
- * @brief Default static capibility for flatbuffers
+ * @brief Default static capability for flatbuffers
  * Flatbuf converter will convert this capability to other/tensor(s)
  * @todo Move this definition to proper header file
  */