Move II420ColorConverter.h to /frameworks/native/include/media/editor
o related-to-bug: 6044894
Change-Id: Ib8f5406e32bd6c190d65e4a2e014f73e759d4415
diff --git a/include/media/editor/II420ColorConverter.h b/include/media/editor/II420ColorConverter.h
new file mode 100644
index 0000000..33af61f
--- /dev/null
+++ b/include/media/editor/II420ColorConverter.h
@@ -0,0 +1,126 @@
+/*
+ * Copyright (C) 2011 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef II420_COLOR_CONVERTER_H
+
+#define II420_COLOR_CONVERTER_H
+
+#include <stdint.h>
+#include <android/rect.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct II420ColorConverter {
+
+ /*
+ * getDecoderOutputFormat
+ * Returns the color format (OMX_COLOR_FORMATTYPE) of the decoder output.
+ * If it is I420 (OMX_COLOR_FormatYUV420Planar), no conversion is needed,
+ * and convertDecoderOutputToI420() can be a no-op.
+ */
+ int (*getDecoderOutputFormat)();
+
+ /*
+ * convertDecoderOutputToI420
+ * @Desc Converts from the decoder output format to I420 format.
+ * @note Caller (e.g. VideoEditor) owns the buffers
+ * @param decoderBits (IN) Pointer to the buffer contains decoder output
+ * @param decoderWidth (IN) Buffer width, as reported by the decoder
+ * metadata (kKeyWidth)
+ * @param decoderHeight (IN) Buffer height, as reported by the decoder
+ * metadata (kKeyHeight)
+ * @param decoderRect (IN) The rectangle of the actual frame, as
+ * reported by decoder metadata (kKeyCropRect)
+ * @param dstBits (OUT) Pointer to the output I420 buffer
+ * @return -1 Any error
+ * @return 0 No Error
+ */
+ int (*convertDecoderOutputToI420)(
+ void* decoderBits, int decoderWidth, int decoderHeight,
+ ARect decoderRect, void* dstBits);
+
+ /*
+ * getEncoderIntputFormat
+ * Returns the color format (OMX_COLOR_FORMATTYPE) of the encoder input.
+ * If it is I420 (OMX_COLOR_FormatYUV420Planar), no conversion is needed,
+ * and convertI420ToEncoderInput() and getEncoderInputBufferInfo() can
+ * be no-ops.
+ */
+ int (*getEncoderInputFormat)();
+
+ /* convertI420ToEncoderInput
+ * @Desc This function converts from I420 to the encoder input format
+ * @note Caller (e.g. VideoEditor) owns the buffers
+ * @param srcBits (IN) Pointer to the input I420 buffer
+ * @param srcWidth (IN) Width of the I420 frame
+ * @param srcHeight (IN) Height of the I420 frame
+ * @param encoderWidth (IN) Encoder buffer width, as calculated by
+ * getEncoderBufferInfo()
+ * @param encoderHeight (IN) Encoder buffer height, as calculated by
+ * getEncoderBufferInfo()
+ * @param encoderRect (IN) Rect coordinates of the actual frame inside
+ * the encoder buffer, as calculated by
+ * getEncoderBufferInfo().
+ * @param encoderBits (OUT) Pointer to the output buffer. The size of
+ * this buffer is calculated by
+ * getEncoderBufferInfo()
+ * @return -1 Any error
+ * @return 0 No Error
+ */
+ int (*convertI420ToEncoderInput)(
+ void* srcBits, int srcWidth, int srcHeight,
+ int encoderWidth, int encoderHeight, ARect encoderRect,
+ void* encoderBits);
+
+ /* getEncoderInputBufferInfo
+ * @Desc This function returns metadata for the encoder input buffer
+ * based on the actual I420 frame width and height.
+ * @note This API should be be used to obtain the necessary information
+ * before calling convertI420ToEncoderInput().
+ * VideoEditor knows only the width and height of the I420 buffer,
+ * but it also needs know the width, height, and size of the
+ * encoder input buffer. The encoder input buffer width and height
+ * are used to set the metadata for the encoder.
+ * @param srcWidth (IN) Width of the I420 frame
+ * @param srcHeight (IN) Height of the I420 frame
+ * @param encoderWidth (OUT) Encoder buffer width needed
+ * @param encoderHeight (OUT) Encoder buffer height needed
+ * @param encoderRect (OUT) Rect coordinates of the actual frame inside
+ * the encoder buffer
+ * @param encoderBufferSize (OUT) The size of the buffer that need to be
+ * allocated by the caller before invoking
+ * convertI420ToEncoderInput().
+ * @return -1 Any error
+ * @return 0 No Error
+ */
+ int (*getEncoderInputBufferInfo)(
+ int srcWidth, int srcHeight,
+ int* encoderWidth, int* encoderHeight,
+ ARect* encoderRect, int* encoderBufferSize);
+
+} II420ColorConverter;
+
+/* The only function that the shared library needs to expose: It fills the
+ function pointers in II420ColorConverter */
+void getI420ColorConverter(II420ColorConverter *converter);
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif // II420_COLOR_CONVERTER_H