The Tor Browser / file revision

 /*

  * 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