/* * Copyright (c) 2011-2012, Code Aurora Forum. All rights reserved. * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following * disclaimer in the documentation and/or other materials provided * with the distribution. * * Neither the name of Code Aurora Forum, Inc. nor the names of its * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef INCLUDE_LIBQCOM_UI #define INCLUDE_LIBQCOM_UI #include #include #include #include #include #include #include #include "../libgralloc/gralloc_priv.h" using namespace android; using android::sp; using android::GraphicBuffer; #define HWC_BYPASS_INDEX_MASK 0x00000030 /* * Qcom specific Native Window perform operations */ enum { NATIVE_WINDOW_SET_BUFFERS_SIZE = 0x10000000, NATIVE_WINDOW_UPDATE_BUFFERS_GEOMETRY = 0x20000000, NATIVE_WINDOW_SET_S3D_FORMAT = 0x40000000, }; // Enum containing the supported composition types enum { COMPOSITION_TYPE_GPU = 0, COMPOSITION_TYPE_MDP = 0x1, COMPOSITION_TYPE_C2D = 0x2, COMPOSITION_TYPE_CPU = 0x4, COMPOSITION_TYPE_DYN = 0x8 }; /* * Layer Attributes */ enum eLayerAttrib { LAYER_UPDATE_STATUS, LAYER_ASYNCHRONOUS_STATUS, }; /* * Layer Flags */ enum { LAYER_UPDATING = 1<<0, LAYER_ASYNCHRONOUS = 1<<1, }; /* * Layer Transformation - refers to Layer::setGeometry() */ #define SHIFT_SRC_TRANSFORM 4 #define SRC_TRANSFORM_MASK 0x00F0 #define FINAL_TRANSFORM_MASK 0x000F /* * Flags set by the layer and sent to HWC */ enum { HWC_LAYER_NOT_UPDATING = 0x00000002, HWC_LAYER_ASYNCHRONOUS = 0x00000004, HWC_USE_ORIGINAL_RESOLUTION = 0x10000000, HWC_DO_NOT_USE_OVERLAY = 0x20000000, HWC_COMP_BYPASS = 0x40000000, HWC_USE_EXT_ONLY = 0x80000000, //Layer displayed on external only HWC_USE_EXT_BLOCK = 0x01000000, //Layer displayed on external only HWC_BYPASS_RESERVE_0 = 0x00000010, HWC_BYPASS_RESERVE_1 = 0x00000020, }; enum HWCCompositionType { HWC_USE_GPU = HWC_FRAMEBUFFER, // This layer is to be handled by Surfaceflinger HWC_USE_OVERLAY = HWC_OVERLAY, // This layer is to be handled by the overlay HWC_USE_COPYBIT // This layer is to be handled by copybit }; enum external_display_type { EXT_TYPE_NONE, EXT_TYPE_HDMI, EXT_TYPE_WIFI }; /* Events to the Display HAL perform function As of now used for external display related such as connect, disconnect, orientation, video started etc., */ enum { EVENT_EXTERNAL_DISPLAY, // External display on/off Event EVENT_VIDEO_OVERLAY, // Video Overlay start/stop Event EVENT_ORIENTATION_CHANGE, // Orientation Change Event EVENT_OVERLAY_STATE_CHANGE, // Overlay State Change Event EVENT_OPEN_SECURE_START, // Start of secure session setup config by stagefright EVENT_OPEN_SECURE_END, // End of secure session setup config by stagefright EVENT_CLOSE_SECURE_START, // Start of secure session teardown config EVENT_CLOSE_SECURE_END, // End of secure session teardown config EVENT_RESET_POSTBUFFER, // Reset post framebuffer mutex EVENT_WAIT_POSTBUFFER, // Wait until post framebuffer returns EVENT_FORCE_COMPOSITION, // On/Off event for avoiding skip composition }; // Video information sent to framebuffer HAl // used for handling UI mirroring. enum { VIDEO_OVERLAY_ENDED = 0, VIDEO_2D_OVERLAY_STARTED, VIDEO_3D_OVERLAY_STARTED }; /* * Structure to hold the buffer geometry */ struct qBufGeometry { int width; int height; int format; void set(int w, int h, int f) { width = w; height = h; format = f; } }; class QCBaseLayer { // int mS3DFormat; int32_t mComposeS3DFormat; public: QCBaseLayer() { mComposeS3DFormat = 0; } enum { // S3D formats eS3D_SIDE_BY_SIDE = 0x10000, eS3D_TOP_BOTTOM = 0x20000 }; /* virtual status_t setStereoscopic3DFormat(int format) { mS3DFormat = format; return 0; } virtual int getStereoscopic3DFormat() const { return mS3DFormat; } */ void setS3DComposeFormat (int32_t hints) { if (hints & HWC_HINT_DRAW_S3D_SIDE_BY_SIDE) mComposeS3DFormat = eS3D_SIDE_BY_SIDE; else if (hints & HWC_HINT_DRAW_S3D_TOP_BOTTOM) mComposeS3DFormat = eS3D_TOP_BOTTOM; else mComposeS3DFormat = 0; } int32_t needsS3DCompose () const { return mComposeS3DFormat; } }; /* * Function to check if the allocated buffer is of the correct size. * Reallocate the buffer with the correct size, if the size doesn't * match * * @param: handle of the allocated buffer * @param: requested size for the buffer * @param: usage flags * * return 0 on success */ int checkBuffer(native_handle_t *buffer_handle, int size, int usage); /* * Checks if the format is supported by the GPU. * * @param: format to check * * @return true if the format is supported by the GPU. */ bool isGPUSupportedFormat(int format); /* * Checks if the format is natively supported by the GPU. * For now, we use this function to check only if CHECK_FOR_EXTERNAL_FORMAT * is set. * * @param: format to check * * @return true if the format is supported by the GPU. */ #ifdef CHECK_FOR_EXTERNAL_FORMAT bool isGPUSupportedFormatInHW(int format); #endif /* * Adreno is not optimized for GL_TEXTURE_EXTERNAL_OES * texure target. DO NOT choose TEXTURE_EXTERNAL_OES * target for RGB formats. * * Based on the pixel format, decide the texture target. * * @param : pixel format to check * * @return : GL_TEXTURE_2D for RGB formats, and * GL_TEXTURE_EXTERNAL_OES for YUV formats. * */ #ifdef DECIDE_TEXTURE_TARGET int decideTextureTarget (const int pixel_format); #endif /* * Gets the number of arguments required for this operation. * * @param: operation whose argument count is required. * * @return -EINVAL if the operation is invalid. */ int getNumberOfArgsForOperation(int operation); /* * Checks if memory needs to be reallocated for this buffer. * * @param: Geometry of the current buffer. * @param: Required Geometry. * @param: Geometry of the updated buffer. * * @return True if a memory reallocation is required. */ bool needNewBuffer(const qBufGeometry currentGeometry, const qBufGeometry requiredGeometry, const qBufGeometry updatedGeometry); /* * Update the geometry of this buffer without reallocation. * * @param: buffer whose geometry needs to be updated. * @param: Updated buffer geometry */ int updateBufferGeometry(sp buffer, const qBufGeometry bufGeometry); /* * Update the S3D format of this buffer. * * @param: buffer whosei S3D format needs to be updated. * @param: Updated buffer S3D format */ int updateBufferS3DFormat(sp buffer, const int s3dFormat); /* * Updates the flags for the layer * * @param: Attribute * @param: Identifies if the attribute was enabled or disabled. * @param: current Layer flags. * * @return: Flags for the layer */ int updateLayerQcomFlags(eLayerAttrib attribute, bool enable, int& currentFlags); /* * Gets the per frame HWC flags for this layer. * * @param: current hwcl flags * @param: current layerFlags * * @return: the per frame flags. */ int getPerFrameFlags(int hwclFlags, int layerFlags); /* * Checks if FB is updated by this composition type * * @param: composition type * @return: true if FB is updated, false if not */ bool isUpdatingFB(HWCCompositionType compositionType); /* * Get the current composition Type * * @return the compositon Type */ int getCompositionType(); /* * Clear region implementation for C2D/MDP versions. * * @param: region to be cleared * @param: EGL Display * @param: EGL Surface * * @return 0 on success */ int qcomuiClearRegion(Region region, EGLDisplay dpy, EGLSurface sur); /* * Handles the externalDisplay event * HDMI has highest priority compared to WifiDisplay * Based on the current and the new display event, decides the * external display to be enabled * * @param: newEvent - new external event * @param: currEvent - currently enabled external event * @return: external display to be enabled * */ external_display_type handleEventHDMI(external_display_type disp, int value, external_display_type currDispType); /* * Checks if layers need to be dumped based on system property "debug.sf.dump" * for raw dumps and "debug.sf.dump.png" for png dumps. * * For example, to dump 25 frames in raw format, do, * adb shell setprop debug.sf.dump 25 * Layers are dumped in a time-stamped location: /data/sfdump*. * * To dump 10 frames in png format, do, * adb shell setprop debug.sf.dump.png 10 * To dump another 25 or so frames in raw format, do, * adb shell setprop debug.sf.dump 26 * * To turn off logcat logging of layer-info, set both properties to 0, * adb shell setprop debug.sf.dump.png 0 * adb shell setprop debug.sf.dump 0 * * @return: true if layers need to be dumped (or logcat-ed). */ bool needToDumpLayers(); /* * Dumps a layer's info into logcat and its buffer into raw/png files. * * @param: moduleCompositionType - Composition type set in hwcomposer module. * @param: listFlags - Flags used in hwcomposer's list. * @param: layerIndex - Index of layer being dumped. * @param: hwLayers - Address of hwc_layer_t to log and dump. * */ void dumpLayer(int moduleCompositionType, int listFlags, size_t layerIndex, hwc_layer_t hwLayers[]); #endif // INCLUDE_LIBQCOM_UI