/** * @file llbottomtray.h * @brief LLBottomTray class header file * * $LicenseInfo:firstyear=2009&license=viewergpl$ * * Copyright (c) 2009, Linden Research, Inc. * * Second Life Viewer Source Code * The source code in this file ("Source Code") is provided by Linden Lab * to you under the terms of the GNU General Public License, version 2.0 * ("GPL"), unless you have obtained a separate licensing agreement * ("Other License"), formally executed by you and Linden Lab. Terms of * the GPL can be found in doc/GPL-license.txt in this distribution, or * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2 * * There are special exceptions to the terms and conditions of the GPL as * it is applied to this Source Code. View the full text of the exception * in the file doc/FLOSS-exception.txt in this software distribution, or * online at * http://secondlifegrid.net/programs/open_source/licensing/flossexception * * By copying, modifying or distributing this software, you acknowledge * that you have read and understood your obligations described above, * and agree to abide by those obligations. * * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY, * COMPLETENESS OR PERFORMANCE. * $/LicenseInfo$ */ #ifndef LL_LLBOTTOMPANEL_H #define LL_LLBOTTOMPANEL_H #include "llmenugl.h" #include "llpanel.h" #include "llimview.h" #include "llcombobox.h" class LLChicletPanel; class LLLineEditor; class LLLayoutStack; class LLNotificationChiclet; class LLSpeakButton; class LLNearbyChatBar; class LLIMChiclet; class LLBottomTrayLite; // Build time optimization, generate once in .cpp file #ifndef LLBOTTOMTRAY_CPP extern template class LLBottomTray* LLSingleton<class LLBottomTray>::getInstance(); #endif class LLBottomTray : public LLSingleton<LLBottomTray> , public LLPanel , public LLIMSessionObserver , public LLVoiceClientStatusObserver { LOG_CLASS(LLBottomTray); friend class LLSingleton<LLBottomTray>; friend class LLBottomTrayLite; public: ~LLBottomTray(); BOOL postBuild(); LLChicletPanel* getChicletPanel() {return mChicletPanel;} LLNearbyChatBar* getNearbyChatBar(); void onCommitGesture(LLUICtrl* ctrl); // LLIMSessionObserver observe triggers virtual void sessionAdded(const LLUUID& session_id, const std::string& name, const LLUUID& other_participant_id); virtual void sessionRemoved(const LLUUID& session_id); void sessionIDUpdated(const LLUUID& old_session_id, const LLUUID& new_session_id); S32 getTotalUnreadIMCount(); virtual void reshape(S32 width, S32 height, BOOL called_from_parent); virtual void setVisible(BOOL visible); /*virtual*/ S32 notifyParent(const LLSD& info); // Implements LLVoiceClientStatusObserver::onChange() to enable the speak // button when voice is available /*virtual*/ void onChange(EStatusType status, const std::string &channelURI, bool proximal); void showBottomTrayContextMenu(S32 x, S32 y, MASK mask); void showGestureButton(BOOL visible); void showMoveButton(BOOL visible); void showCameraButton(BOOL visible); void showSnapshotButton(BOOL visible); void toggleMovementControls(); void toggleCameraControls(); void onMouselookModeIn(); void onMouselookModeOut(); /** * Creates IM Chiclet based on session type (IM chat or Group chat) */ LLIMChiclet* createIMChiclet(const LLUUID& session_id); private: typedef enum e_resize_status_type { RS_NORESIZE = 0x0000 , RS_CHICLET_PANEL = 0x0001 , RS_CHATBAR_INPUT = 0x0002 , RS_BUTTON_SNAPSHOT = 0x0004 , RS_BUTTON_CAMERA = 0x0008 , RS_BUTTON_MOVEMENT = 0x0010 , RS_BUTTON_GESTURES = 0x0020 , RS_BUTTON_SPEAK = 0x0040 , RS_IM_WELL = 0x0080 , RS_NOTIFICATION_WELL = 0x0100 , RS_BUTTON_BUILD = 0x0200 , RS_BUTTON_SEARCH = 0x0400 , RS_BUTTON_WORLD_MAP = 0x0800 , RS_BUTTON_MINI_MAP = 0x1000 , RS_BUTTON_SIDEBAR = 0x2000 /* Once new button that can be hidden on resize is added don't forget to update related places: - RS_BUTTONS_CAN_BE_HIDDEN enum value below. - initResizeStateContainers(): mStateProcessedObjectMap and mButtonsProcessOrder */ /** * Specifies buttons which can be hidden when bottom tray is shrunk. * They are: Gestures, Movement (Move), Camera (View), Snapshot * new: Build, Search, Map, World Map, Mini-Map. */ , RS_BUTTONS_CAN_BE_HIDDEN = RS_BUTTON_SNAPSHOT | RS_BUTTON_CAMERA | RS_BUTTON_MOVEMENT | RS_BUTTON_GESTURES | RS_BUTTON_BUILD | RS_BUTTON_SEARCH | RS_BUTTON_WORLD_MAP | RS_BUTTON_MINI_MAP | RS_BUTTON_SIDEBAR }EResizeState; /** * Updates child controls size and visibility when it is necessary to reduce total width. * * Process order: * - reduce chiclet panel to its minimal width; * - reduce chatbar to its minimal width; * - reduce visible buttons from right to left to their minimal width; * - hide visible buttons from right to left; * When button is hidden chatbar extended to fill released space if it is necessary. * * @param[in] delta_width - value by which bottom tray should be shrunk. It is a negative value. * @return positive value which bottom tray can not process when it reaches its minimal width. * Zero if there was enough space to process delta_width. */ S32 processWidthDecreased(S32 delta_width); /** * Updates child controls size and visibility when it is necessary to extend total width. * * Process order: * - show invisible buttons should be shown from left to right if possible; * - extend visible buttons from left to right to their default width; * - extend chatbar to its maximal width; * - extend chiclet panel to all available space; * When chatbar & chiclet panels are wider then their minimal width they can be reduced to allow * a button gets visible in case if passed delta_width is not enough (chatbar first). * * @param[in] delta_width - value by which bottom tray should be extended. It is a positive value. */ void processWidthIncreased(S32 delta_width); /** helper function to log debug messages */ void log(LLView* panel, const std::string& descr); /** * Tries to show hidden by resize buttons using available width. * * Gets buttons visible if there is enough space. Reduces available_width in this case. * * @params[in, out] available_width - reference to available width to be used to show buttons. * @see processShowButton() */ void processShowButtons(S32& available_width); /** * Tries to show panel with specified button using available width. * * Shows button specified by type if there is enough space. Reduces available_width in this case. * * @params[in] shown_object_type - type of button to be shown. * @params[in, out] available_width - reference to available width to be used to show button. * * @return true if button can be shown, false otherwise */ bool processShowButton(EResizeState shown_object_type, S32& available_width); /** * Hides visible panels with all buttons that may be hidden by resize if it is necessary. * * When button gets hidden some space is released in bottom tray. * This space is taken into account for several consecutive calls for several buttons. * * @params[in, out] required_width - reference to required width to be released. This is a negative value. * Its absolute value is decreased by shown panel width. * @params[in, out] buttons_freed_width - reference to value released over required one. * If panel's width is more than required difference is added to buttons_freed_width. * @see processHideButton() */ void processHideButtons(S32& required_width, S32& buttons_freed_width); /** * Hides panel with specified button if it is visible. * * When button gets hidden some space is released in bottom tray. * This space is taken into account for several consecutive calls for several buttons. * * @params[in] processed_object_type - type of button to be hide. * @params[in, out] required_width - reference to required width to be released. This is a negative value. * Its absolute value is decreased by panel width. * @params[in, out] buttons_freed_width - reference to value released over required one. * If panel's width is more than required difference is added to buttons_freed_width. */ void processHideButton(EResizeState processed_object_type, S32& required_width, S32& buttons_freed_width); /** * Shrinks shown buttons to reduce total taken space. * * Shrinks buttons that may be shrunk smoothly first. Then shrinks Speak button. * * @param[in, out] required_width - reference to width value which should be released when buttons are shrunk. It is a negative value. * It is increased on the value processed by buttons. * @params[in, out] buttons_freed_width - reference to value released over required one. * If width of panel with Speak button is more than required that difference is added * to buttons_freed_width. * This is because Speak button shrinks discretely unlike other buttons which are changed smoothly. */ void processShrinkButtons(S32& required_width, S32& buttons_freed_width); /** * Shrinks panel with specified button if it is visible. * * @params[in] processed_object_type - type of button to be shrunk. * @param[in, out] required_width - reference to width value which should be released when button is shrunk. It is a negative value. * It is increased on the value released by the button. */ void processShrinkButton(EResizeState processed_object_type, S32& required_width); /** * Extends shown buttons to increase total taken space. * * Extends buttons that may be extended smoothly first. Then extends Speak button. * * @param[in, out] available_width - reference to width value which buttons can use to be extended. * It is a positive value. It is decreased on the value processed by buttons. */ void processExtendButtons(S32& available_width); /** * Extends shown button to increase total taken space. * * @params[in] processed_object_type - type of button to be extended. * @param[in, out] available_width - reference to width value which button can use to be extended. * It is a positive value. It is decreased on the value processed by buttons. */ void processExtendButton(EResizeState processed_object_type, S32& available_width); /** * Determines if specified by type object can be shown. It should be hidden by shrink before. * * Processes buttons a such way to show buttons in constant order: * - Gestures, Move, View, Snapshot */ bool canButtonBeShown(EResizeState processed_object_type) const; /** * Initializes all containers stored data related to children resize state. * * @see mStateProcessedObjectMap * @see mObjectDefaultWidthMap * @see mButtonsProcessOrder */ void initResizeStateContainers(); /** * Initializes buttons' visibility depend on stored Control Settings. */ void initButtonsVisibility(); /** * Initializes listeners of Control Settings to toggle appropriate buttons' visibility. * * @see toggleShowButton() */ void setButtonsControlsAndListeners(); /** * Toggles visibility of specified button depend on passed value. * * @param button_type - type of button to be toggled * @param new_visibility - new visibility of the button * * @see setButtonsControlsAndListeners() */ static bool toggleShowButton(EResizeState button_type, const LLSD& new_visibility); /** * Sets passed visibility to object specified by resize type. */ void setTrayButtonVisible(EResizeState shown_object_type, bool visible); /** * Sets passed visibility to object specified by resize type if it is possible. * * If it is impossible to show required button due to there is no enough room in bottom tray * it will no be shown. Is called via context menu commands. * In this case Alert Dialog will be shown to notify user about that. * * Method also stores resize state to be processed while future bottom tray extending: * - if hidden while resizing button should be hidden it will not be shown while extending; * - if hidden via context menu button should be shown but there is no enough room for now * it will be shown while extending. */ void setTrayButtonVisibleIfPossible(EResizeState shown_object_type, bool visible, bool raise_notification = true); /** * Sets passed visibility to required button and fit widths of shown * buttons(notice that method can shrink widths to * allocate needed room in bottom tray). * Returns true if visibility of required button was set. */ bool setVisibleAndFitWidths(EResizeState object_type, bool visible); /** * Shows/hides panel with specified well button (IM or Notification) * * @param[in] object_type - type of well button to be processed. * Must be one of RS_IM_WELL or RS_NOTIFICATION_WELL. * @param[in] visible - flag specified whether button should be shown or hidden. */ void showWellButton(EResizeState object_type, bool visible); /** * Handles a customization of chatbar width. * * When chatbar gets wider layout stack will reduce chiclet panel (it is auto-resizable) * But once chiclet panel reaches its minimal width Stack will force to reduce buttons width. * including Speak button. The similar behavior is when chatbar gets narrowly. * This methods force resize behavior to resize buttons properly in these cases. */ void processChatbarCustomization(S32 new_width); MASK mResizeState; typedef std::map<EResizeState, LLPanel*> state_object_map_t; state_object_map_t mStateProcessedObjectMap; typedef std::map<EResizeState, S32> state_object_width_map_t; state_object_width_map_t mObjectDefaultWidthMap; typedef std::vector<EResizeState> resize_state_vec_t; /** * Contains order in which child buttons should be processed in show/hide, extend/shrink methods. */ resize_state_vec_t mButtonsProcessOrder; protected: LLBottomTray(const LLSD& key = LLSD()); static void* createNearbyChatBar(void* userdata); void updateContextMenu(S32 x, S32 y, MASK mask); void onContextMenuItemClicked(const LLSD& userdata); bool onContextMenuItemEnabled(const LLSD& userdata); LLChicletPanel* mChicletPanel; LLPanel* mSpeakPanel; LLSpeakButton* mSpeakBtn; LLNearbyChatBar* mNearbyChatBar; LLLayoutStack* mToolbarStack; LLMenuGL* mBottomTrayContextMenu; LLPanel* mMovementPanel; LLPanel* mCamPanel; LLPanel* mSnapshotPanel; LLPanel* mGesturePanel; LLButton* mCamButton; LLButton* mMovementButton; LLBottomTrayLite* mBottomTrayLite; bool mIsInLiteMode; }; #endif // LL_LLBOTTOMPANEL_H