| 1 | /** |
| 2 | * @section LICENSE |
| 3 | * |
| 4 | * PickleLauncher |
| 5 | * Copyright (C) 2010-2011 Scott Smith |
| 6 | * |
| 7 | * This program is free software: you can redistribute it and/or modify |
| 8 | * it under the terms of the GNU General Public License as published by |
| 9 | * the Free Software Foundation, either version 3 of the License, or |
| 10 | * (at your option) any later version. |
| 11 | * |
| 12 | * This program is distributed in the hope that it will be useful, |
| 13 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 15 | * GNU General Public License for more details. |
| 16 | * |
| 17 | * You should have received a copy of the GNU General Public License |
| 18 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
| 19 | * |
| 20 | * @section LOCATION |
| 21 | */ |
| 22 | |
| 23 | #ifndef CSELECTOR_H |
| 24 | #define CSELECTOR_H |
| 25 | |
| 26 | #include "version.h" |
| 27 | #include "cbase.h" |
| 28 | #include "cconfig.h" |
| 29 | #include "cprofile.h" |
| 30 | #include "csystem.h" |
| 31 | |
| 32 | using namespace std; |
| 33 | |
| 34 | #define ARG_RESETGUI "--resetgui" /** Flag to reset GUI settings based on the current resolution. */ |
| 35 | #define ARG_CONFIG "--config" /** Flag to override the config file. */ |
| 36 | #define DEF_CONFIG "config.txt" /** Default config filename. */ |
| 37 | #define ARG_PROFILE "--profile" /** Flag to override the profile file. */ |
| 38 | #define DEF_PROFILE "profile.txt" /** Default profile filename. */ |
| 39 | #define ARG_ZIPLIST "--ziplist" /** Flag to override the ziplist file. */ |
| 40 | #define DEF_ZIPLIST "ziplist.txt" /** Default ziplist filename. */ |
| 41 | |
| 42 | #define ENTRY_ARROW "-> " /** Ascii fallback for the entry arrow selector. */ |
| 43 | #define BUTTON_LABEL_ONE_UP "<" /** Ascii text fallback for the one up button label. */ |
| 44 | #define BUTTON_LABEL_ONE_DOWN ">" /** Ascii text fallback for the one down button label. */ |
| 45 | #define BUTTON_LABEL_PAGE_UP "<<" /** Ascii text fallback for the page up button label. */ |
| 46 | #define BUTTON_LABEL_PAGE_DOWN ">>" /** Ascii text fallback for the page down button label. */ |
| 47 | #define BUTTON_LABEL_DIR_UP "U" /** Ascii text fallback for the directory up button label. */ |
| 48 | #define BUTTON_LABEL_DIR_DOWN "D" /** Ascii text fallback for the directory down button label. */ |
| 49 | #define BUTTON_LABEL_ZIP_MODE "Z" /** Ascii text fallback for the zip mode label. */ |
| 50 | #define BUTTON_LABEL_CONFIG "Def. Plugins" /** Ascii text fallback for the options button label. */ |
| 51 | #define BUTTON_LABEL_EDIT "ROM Plugins" /** Ascii text fallback for the edit item button label. */ |
| 52 | #define BUTTON_LABEL_SET_ONE "Set" /** Ascii text fallback for the set button label. */ |
| 53 | #define BUTTON_LABEL_SET_ALL "Default" /** Ascii text fallback for the default button label. */ |
| 54 | #define BUTTON_LABEL_BACK "Back" /** Ascii text fallback for the back button label. */ |
| 55 | #define BUTTON_LABEL_SELECT "Select" /** Ascii text fallback for the select button label. */ |
| 56 | #define BUTTON_LABEL_QUIT "Quit" /** Ascii text fallback for the quit button label. */ |
| 57 | |
| 58 | #define EMPTY_DIR_LABEL "<no files detected in dir>" /** Ascii text for display if no files or dirs are detected. */ |
| 59 | #define EMPTY_ZIP_LABEL "<no files detected in zip>" /** Ascii text for display if no files in a zip are detected. */ |
| 60 | |
| 61 | #define EVENT_LOOPS_ON 0 /** Value set to loops to indentify an active event. */ |
| 62 | #define EVENT_LOOPS_OFF 0x7F /** Value set to loops to indentify an inactive event. */ |
| 63 | #define EVENT_LOOPS 10 /** Number of loops an event must be active to be detected to be on. */ |
| 64 | #define IsEventOn(x) ((EventPressCount.at(x) <= EVENT_LOOPS_ON) ? true : false) /** Determines if an event is active. */ |
| 65 | #define IsEventOff(x) ((EventPressCount.at(x) == EVENT_LOOPS_OFF) ? true : false) /** Determines if an event is inactive. */ |
| 66 | |
| 67 | #define MS_PER_SEC 1000 /** Milliseconds in 1 Second. */ |
| 68 | #define FRAMES_PER_SEC 60 /** Frames in 1 Second. */ |
| 69 | #define FRAME_SKIP_RATIO 4 /** Maximum frames skip ratio, draw 1 frame for every X number of skipped frames. */ |
| 70 | |
| 71 | #define FREE_IMAGE(X) if (X != NULL) { SDL_FreeSurface(X); X = NULL; } /** Macro for checking and releasing pointers to pixel data. */ |
| 72 | |
| 73 | /** @brief Modes of the launcher. |
| 74 | */ |
| 75 | enum MODES_T { |
| 76 | MODE_SELECT_ENTRY=0, /** Main mode for selecting an file to run. */ |
| 77 | MODE_SELECT_ARGUMENT, /** Select an argument or command belonging to an entry. */ |
| 78 | MODE_SELECT_VALUE, /** Select an value belonging to an argument. */ |
| 79 | MODE_SELECT_OPTION, /** Select a Def. Plugin type */ |
| 80 | MODE_SELECT_PLUGIN, /** Selct one Def. Plugin */ |
| 81 | MODE_ROM_OPTION, |
| 82 | MODE_ROM_PLUGIN, |
| 83 | MODE_TOTAL /** Number of modes. */ |
| 84 | }; |
| 85 | |
| 86 | /** @brief List positions for the current item and first and last items. |
| 87 | */ |
| 88 | struct item_pos_t { |
| 89 | item_pos_t() : first(0), last(0), absolute(0), relative(0), total(0) {}; |
| 90 | int16_t first; /** Index of the first item on the display list. */ |
| 91 | int16_t last; /** Index of the last item on the display list. */ |
| 92 | int16_t absolute; /** Absolute index of the currently selected item in the display list. */ |
| 93 | int16_t relative; /** Relative index of the currently selected item in the display list. */ |
| 94 | int16_t total; /** Total number of items. */ |
| 95 | }; |
| 96 | |
| 97 | /** @brief The font, color, text for a item in the display list |
| 98 | */ |
| 99 | struct listtext_t { |
| 100 | listtext_t() : font(0), color(0), text("") {}; |
| 101 | int8_t font; /** Index of the selected font size for the text. */ |
| 102 | int8_t color; /** Index of the color for the text. */ |
| 103 | string text; /** Text for an item for the display list. */ |
| 104 | }; |
| 105 | |
| 106 | /** @brief This class controls resources, logic for gui, interaction with the user. |
| 107 | */ |
| 108 | class CSelector : public CBase |
| 109 | { |
| 110 | public: |
| 111 | /** Constructor. */ |
| 112 | CSelector(); |
| 113 | /** Destructor. */ |
| 114 | virtual ~CSelector(); |
| 115 | |
| 116 | /** @brief Run the main loop of the application. |
| 117 | * @param argc : number of arguments. |
| 118 | * @param argv : arguments passed to the application. |
| 119 | * @return 0 if passed 1 if failed. |
| 120 | */ |
| 121 | int8_t Run( int argc, char** argv ); |
| 122 | |
| 123 | private: |
| 124 | /** @brief Parse and handle arguments sent to the application. |
| 125 | * @param argc : number of arguments. |
| 126 | * @param argv : arguments passed to the application. |
| 127 | */ |
| 128 | void ProcessArguments ( int32_t argc, char** argv ); |
| 129 | |
| 130 | /** @brief Open system interfaces and load configuration information. |
| 131 | * @return 0 if passed 1 if failed. |
| 132 | */ |
| 133 | int8_t OpenResources ( void ); |
| 134 | |
| 135 | /** @brief Close system interfaces and save configuration information. |
| 136 | * @param result : result of the application, do not save config files if an error occurs. |
| 137 | * @return 0 if passed 1 if failed. |
| 138 | */ |
| 139 | void CloseResources ( int8_t result ); |
| 140 | |
| 141 | /** @brief Main loop of the application, polls input, runs current mode, and freshes the screen. |
| 142 | * @return -1 for no selection otherwise the entry selection number. |
| 143 | */ |
| 144 | int16_t DisplayScreen ( void ); |
| 145 | |
| 146 | /** @brief Check which screen rects a rect overlaps. The marked screen rects will only be updated for the screen. |
| 147 | */ |
| 148 | void UpdateRect ( int16_t x, int16_t y, int16_t w, int16_t h ); |
| 149 | |
| 150 | /** @brief Handles logic for measuring and counting frame drawing to the screen. |
| 151 | */ |
| 152 | void UpdateScreen ( void ); |
| 153 | |
| 154 | /** @brief Determines the mode to run based on user input events. |
| 155 | */ |
| 156 | void SelectMode ( void ); |
| 157 | |
| 158 | /** @brief Mode to display list of input files. |
| 159 | * @return 0 if passed 1 if failed. |
| 160 | */ |
| 161 | int8_t DisplaySelector ( void ); |
| 162 | |
| 163 | /** @brief Loads the preview image if any exists. |
| 164 | */ |
| 165 | void LoadPreview ( const string& name ); |
| 166 | |
| 167 | /** @brief Moves the current path one directory level up. |
| 168 | */ |
| 169 | void DirectoryUp ( void ); |
| 170 | |
| 171 | /** @brief Moves the current path one directory level down. |
| 172 | */ |
| 173 | void DirectoryDown ( void ); |
| 174 | |
| 175 | /** @brief Moves the current path out of a zip file. |
| 176 | */ |
| 177 | void ZipUp ( void ); |
| 178 | |
| 179 | /** @brief Moves the current path into a zip file. |
| 180 | */ |
| 181 | void ZipDown ( void ); |
| 182 | |
| 183 | /** @brief Load the display list with text labels and font info. |
| 184 | */ |
| 185 | void PopulateList ( void ); |
| 186 | |
| 187 | /** @brief Load the display with items with entries. |
| 188 | */ |
| 189 | void PopModeEntry ( void ); |
| 190 | |
| 191 | /** @brief Load the display with items with entry arguments. |
| 192 | */ |
| 193 | void PopModeArgument ( void ); |
| 194 | |
| 195 | /** @brief Load the display list with items with argument values. |
| 196 | */ |
| 197 | void PopModeValue ( void ); |
| 198 | |
| 199 | /** @brief Load the display list with items with type of plugin. |
| 200 | */ |
| 201 | void PopModeOption ( void ); |
| 202 | |
| 203 | void PopModeRomOption ( void ); |
| 204 | |
| 205 | /** @brief Load the display list with items with Plugin detail for 1 type. |
| 206 | */ |
| 207 | void PopModePlugin ( void ); |
| 208 | |
| 209 | void PopModeRomPlugin ( void ); |
| 210 | |
| 211 | /** @brief Will redetect items for the current mode. |
| 212 | */ |
| 213 | void RescanItems ( void ); |
| 214 | |
| 215 | /** @brief Draws the names for the items in the display list for the current mode. |
| 216 | * @return 0 if passed 1 if failed. |
| 217 | */ |
| 218 | int8_t DrawNames ( SDL_Rect& location ); |
| 219 | |
| 220 | /** @brief Calculates the indices of the entries that should be displayed based on the current selection |
| 221 | * @param pos : reference to the position selections in the current list of entries |
| 222 | */ |
| 223 | void SelectionLimits ( item_pos_t& pos ); |
| 224 | |
| 225 | /** @brief Will either fill the screen with a color or blit a specified image to the screen |
| 226 | */ |
| 227 | void DrawBackground ( void ); |
| 228 | |
| 229 | /** @brief Configures the buttons to be displayed on the screen for the current mode |
| 230 | * @return 0 if passed 1 if failed |
| 231 | */ |
| 232 | int8_t ConfigureButtons ( void ); |
| 233 | |
| 234 | /** @brief Draws the buttons to the screen, in either fill color mode or bitmap's |
| 235 | * @param location : rect contains the starting coordinates for the buttons |
| 236 | */ |
| 237 | int8_t DrawButtons ( SDL_Rect& location ); |
| 238 | |
| 239 | /** @brief Draw a button to the screen |
| 240 | * @param button : the button to draw (index is defined in EVENT_T) |
| 241 | * @param font : the font used for render |
| 242 | * @param location : the coordinates and dimensions of the button |
| 243 | * @return 0 if passed 1 if failed |
| 244 | */ |
| 245 | int8_t DrawButton ( uint8_t button, TTF_Font* font, SDL_Rect& location ); |
| 246 | |
| 247 | /** @brief Draws text labels to the screen, like title and author info |
| 248 | * @param location : contains the starting coordinates for the text |
| 249 | * @return 0 if passed 1 if failed |
| 250 | */ |
| 251 | int8_t DrawText ( SDL_Rect& location ); |
| 252 | |
| 253 | /** @brief Creates a command script to run the target application |
| 254 | * @param selection : the entry selection to use for input to the target application |
| 255 | * @return 0 if passed 1 if failed |
| 256 | */ |
| 257 | int8_t RunExec ( uint16_t selection ); |
| 258 | |
| 259 | /** @brief Collect all input events from the user |
| 260 | * @return 0 if passed 1 if failed |
| 261 | */ |
| 262 | int8_t PollInputs ( void ); |
| 263 | |
| 264 | CSelector(const CSelector &); |
| 265 | CSelector & operator=(const CSelector&); |
| 266 | |
| 267 | bool Redraw; |
| 268 | bool SkipFrame; |
| 269 | bool Rescan; /**< Set to cause the current directory to be rescaned. */ |
| 270 | bool RefreshList; /**< Set to cause the current display list to be populated. */ |
| 271 | bool SetOneEntryValue; /**< Set value for the current entry to the selected value. */ |
| 272 | bool SetAllEntryValue; /**< Set default for all entries to the selected value. */ |
| 273 | bool TextScrollDir; /**< Determines the direction of the horizontal scroll, left or right. */ |
| 274 | bool ExtractAllFiles; /**< True if all files should be extracted from a zip, if false only the selected file is. */ |
| 275 | |
| 276 | bool DrawState_Title; |
| 277 | bool DrawState_About; |
| 278 | bool DrawState_Filter; |
| 279 | bool DrawState_FilePath; |
| 280 | bool DrawState_Index; |
| 281 | bool DrawState_ZipMode; |
| 282 | bool DrawState_Preview; |
| 283 | bool DrawState_ButtonL; |
| 284 | bool DrawState_ButtonR; |
| 285 | |
| 286 | uint8_t Mode; /**< The current mode of the application. */ |
| 287 | uint8_t LastSelectedEntry; /**< Stores the index of the last seclected entry so scrolling can be restarted. */ |
| 288 | uint16_t TextScrollOffset; /**< Number of pixels to offset the entry text surface when it will blit to the screen. */ |
| 289 | uint16_t CurScrollSpeed; /**< Current number of loops used to decide when to offset the entry text scroll effect. */ |
| 290 | uint16_t CurScrollPause; /**< Current number of loops used to decide when to pause the entry text scroll effect. */ |
| 291 | uint16_t ListNameHeight; |
| 292 | int16_t FramesDrawn; /**< Counter for the number frames drawn to the screen. */ |
| 293 | int16_t FramesSkipped; /**< Counter for the number frames not drawn to the screen. */ |
| 294 | int16_t FramesSleep; |
| 295 | #if defined(DEBUG) |
| 296 | int16_t FPSDrawn; /**< Number frames drawn to the screen per second. */ |
| 297 | int16_t FPSSkip; /**< Number frames not drawn to the screen per second. */ |
| 298 | int16_t FPSSleep; |
| 299 | int32_t FrameCountTime; /**< Tick count from measureing FPS. */ |
| 300 | int16_t LoopTimeAverage; /**< Average loop time. */ |
| 301 | #endif |
| 302 | int32_t FrameEndTime; /**< Tick count at the end of the frame. */ |
| 303 | int32_t FrameStartTime; /**< Tick count at the start of the frame. */ |
| 304 | int16_t FrameDelay; /**< Tick duration of the frame. */ |
| 305 | SDL_Rect Mouse; /**< Stores the absolute position of the mouse pointer. */ |
| 306 | SDL_Joystick* Joystick; /**< SDL surface reference to the first joystick device. */ |
| 307 | SDL_Surface* Screen; /**< SDL surface reference to the screen. */ |
| 308 | SDL_Surface* ImageBackground; /**< SDL surface reference to the background pixel data (optional). */ |
| 309 | SDL_Surface* ImagePointer; /**< SDL surface reference to the pointer pixel data (optional). */ |
| 310 | SDL_Surface* ImageSelectPointer; /**< SDL surface reference to the list select pointer pixel data (optional). */ |
| 311 | SDL_Surface* ImagePreview; /**< SDL surface reference to the preview pixel data. */ |
| 312 | SDL_Surface* ImageTitle; /**< SDL surface reference to the title text pixel data. */ |
| 313 | SDL_Surface* ImageAbout; /**< SDL surface reference to the about text pixel data. */ |
| 314 | SDL_Surface* ImageFilePath; /**< SDL surface reference to the about text pixel data. */ |
| 315 | SDL_Surface* ImageFilter; /**< SDL surface reference to the about text pixel data. */ |
| 316 | SDL_Surface* ImageIndex; /**< SDL surface reference to the about text pixel data. */ |
| 317 | SDL_Surface* ImageZipMode; /**< SDL surface reference to the about text pixel data. */ |
| 318 | #if defined(DEBUG) |
| 319 | SDL_Surface* ImageDebug; /**< SDL surface reference to the about text pixel data. */ |
| 320 | #endif |
| 321 | vector<SDL_Surface*> ImageButtons; /**< SDL surface references to the button's pixel data (optional). */ |
| 322 | vector<TTF_Font*> Fonts; /**< SDL-TTF references to the rendered font in different size. */ |
| 323 | CConfig Config; /**< The configuration data. */ |
| 324 | CProfile Profile; /**< The extension and entries data. */ |
| 325 | CSystem System; /**< System specific controls and methods. */ |
| 326 | string ConfigPath; /**< Contains the file path to the config.txt. */ |
| 327 | string ProfilePath; /**< Contains the file path to the profile.txt. */ |
| 328 | string ZipListPath; /**< Contains the path and name of the files that have been unzipped. */ |
| 329 | vector<bool> EventReleased; /**< Collection of the states if a release event was detected. */ |
| 330 | vector<int8_t> EventPressCount; /**< Collection of the loop counts for when an event can act again. */ |
| 331 | vector<uint8_t> ButtonModesLeft; /**< Collection of the state of the buttons on the left side. */ |
| 332 | vector<uint8_t> ButtonModesRight; /**< Collection of the state of the buttons on the right side. */ |
| 333 | vector<item_pos_t> DisplayList; /**< Collection of the positions and limits of list selection for each mode. */ |
| 334 | vector<string> LabelButtons; /**< Collection of text labels for the buttons. */ |
| 335 | vector<listtext_t> ListNames; /**< Collection of text and font information for the entry currently displayed. */ |
| 336 | vector<listitem_t> ItemsEntry; /**< Collection of directories and filenames detected in the current path. */ |
| 337 | vector<listoption_t> ItemsArgument; /**< Collection of options for an entry or config. */ |
| 338 | vector<listitem_t> ItemsDefPlugin; /**< Collection of Plugin for selected plugin type. */ |
| 339 | uint8_t WhichPlugin; /**< Wich Plugin is selected */ |
| 340 | vector<listoption_t> ItemsRomOption; /**< Collection of options for an entry or config. */ |
| 341 | vector<listitem_t> ItemsRomPlugin; /**< Collection of Plugin for selected plugin type. */ |
| 342 | uint8_t WhichRomPlugin; /**< Wich Plugin is selected */ |
| 343 | vector<string> ItemsValue; /**< Collection of values for an option. */ |
| 344 | vector<SDL_Rect> RectEntries; /**< Collection of position rects for the displayed entries. */ |
| 345 | vector<SDL_Rect> RectButtonsLeft; /**< Collection of position rects for the displayed buttons on left. */ |
| 346 | vector<SDL_Rect> RectButtonsRight; /**< Collection of position rects for the displayed buttons on right. */ |
| 347 | vector<SDL_Rect> ScreenRectsDirty; /**< Collection of rects for the areas of the screen that will be updated. */ |
| 348 | }; |
| 349 | |
| 350 | #endif // CSELECTOR_H |