[UPD] : update docs

[RFR] : Refactor

Author: aiekick

ImGuiFileDialog.cpp

@@ -793,7 +793,7 @@ bool IGFD::Utils::ImSplitter(bool split_vertically, float thickness, float* size
     ImRect bb;
     bb.Min = window->DC.CursorPos + (split_vertically ? ImVec2(*size1, 0.0f) : ImVec2(0.0f, *size1));
     bb.Max = bb.Min + CalcItemSize(split_vertically ? ImVec2(thickness, splitter_long_axis_size) : ImVec2(splitter_long_axis_size, thickness), 0.0f, 0.0f);
-    return SplitterBehavior(bb, id, split_vertically ? ImGuiAxis_X : ImGuiAxis_Y, size1, size2, min_size1, min_size2, 1.0f);
+    return SplitterBehavior(bb, id, split_vertically ? ImGuiAxis_X : ImGuiAxis_Y, size1, size2, min_size1, min_size2, 1.0f, 0.0, ImGui::GetColorU32(ImGuiCol_FrameBg));
 }
 
 // Convert a wide Unicode string to an UTF8 string
@@ -3786,7 +3786,6 @@ void IGFD::FileDialog::m_DrawContent() {
 #ifdef USE_PLACES_FEATURE
     if (!(m_FileDialogInternal.getDialogConfig().flags & ImGuiFileDialogFlags_DisablePlaceMode)) {
         if (m_PlacesPaneShown) {
-            // size.x -= m_PlaceWidth;
             float otherWidth = size.x - m_PlacesPaneWidth;
             ImGui::PushID("##splitterplaces");
             IGFD::Utils::ImSplitter(true, 4.0f, &m_PlacesPaneWidth, &otherWidth, 10.0f, 10.0f + m_FileDialogInternal.getDialogConfig().sidePaneWidth, size.y);
@@ -4090,8 +4089,7 @@ void IGFD::FileDialog::m_DrawFileListView(ImVec2 vSize) {
 #endif  // USE_CUSTOM_SORTING_ICON
         ;
     auto listViewID = ImGui::GetID("##FileDialog_fileTable");
-    if (ImGui::BeginTableEx("##FileDialog_fileTable", listViewID, 4, flags, vSize, 0.0f))  //-V112
-    {
+    if (ImGui::BeginTableEx("##FileDialog_fileTable", listViewID, 4, flags, vSize, 0.0f)) { 
         ImGui::TableSetupScrollFreeze(0, 1);  // Make header always visible
         ImGui::TableSetupColumn(fdi.headerFileName.c_str(), ImGuiTableColumnFlags_WidthStretch | (defaultSortOrderFilename ? ImGuiTableColumnFlags_PreferSortAscending : ImGuiTableColumnFlags_PreferSortDescending), -1, 0);
         ImGui::TableSetupColumn(fdi.headerFileType.c_str(),

ImGuiFileDialog.h

@@ -125,28 +125,27 @@ included in the Lib_Only branch for your convenience.
     - 0 => Infinite
     - 1 => One file (default)
     - n => n files
-- Compatible with MacOs, Linux, Windows
-    - Windows version can list drives
+- Compatible with MacOs, Linux, Windows, Emscripten, Android
 - Supports modal or standard dialog types
 - Select files or directories
 - Filter groups and custom filter names
 - can ignore filter Case for file searching
 - Keyboard navigation (arrows, backspace, enter)
 - Exploring by entering characters (case insensitive)
-- Directory place
+- Custom places (bookmarks, system devices, whatever you want)
 - Directory manual entry (right click on any path element)
 - Optional 'Confirm to Overwrite" dialog if file exists
 - Thumbnails Display (agnostic way for compatibility with any backend, sucessfully tested with OpenGl and Vulkan)
 - The dialog can be embedded in another user frame than the standard or modal dialog
 - Can tune validation buttons (placements, widths, inversion)
 - Can quick select a parrallel directory of a path, in the path composer (when you clikc on a / you have a popup)
-- regex support for filters, collection of filters and filestyle (the regex is recognized when between (( and )) in a
-filter)
+- regex support for filters, collection of filters and filestyle (the regex is recognized when between (( and )) in a filter)
 - multi layer extentions like : .a.b.c .json.cpp .vcxproj.filters etc..
-- advanced behavior regarding asterisk based filter. like : .* .*.* .vcx.* .*.filters .vcs*.filt.* etc.. (internally
-regex is used)
-- result modes GetFilePathName, GetFileName and GetSelection (overwrite file ext, keep file, add ext if no user ext
-exist)
+- advanced behavior regarding asterisk based filter. like : .* .*.* .vcx.* .*.filters .vcs*.filt.* etc.. (internally regex is used)
+- result modes GetFilePathName, GetFileName and GetSelection (overwrite file ext, keep file, add ext if no user ext exist)
+- you can use your own FileSystem Api
+    - by default Api Dirent and std::filesystem are defined
+    - you can override GetDrieveList for specify by ex on android other fs, like local and SDCards
 
 ################################################################
 ## Filter format
@@ -1079,15 +1078,19 @@ the DemoApp branch with the "quick access" paths of win10
 You must add a group first, then add a place to it :
 
 ```cpp
-// you must add a group first, specifu display order, and say if the user can add or remove palce like (bookmarks)
-ImGuiFileDialog::Instance()->AddPlacesGroup(group_name, display_order, can_be_user_edited);
+// you must add a group first, specifu display order, and say :
+// if the user can add or remove palce like (bookmarks)
+// if the group is opened by default
+ImGuiFileDialog::Instance()->AddPlacesGroup(group_name, display_order, can_be_user_edited, opened_by_default);
 // then you must get the group
 auto places_ptr = ImGuiFileDialog::Instance()->GetPlacesGroupPtr(group_name);
 if (places_ptr != nullptr) {
     // then add a place to the group
     // you msut specify the place name, the palce path, say if the palce can be serialized, and sepcify the style
     // for the moment the style support only the icon, can be extended if user needed in futur
     places_ptr->AddPlace(place_name, place_path, can_be_saved, style);
+    // you can also add a separator
+    places_ptr->AddPlaceSeparator(separator_thickness);
 }
 ```
 
@@ -1101,8 +1104,6 @@ Load => ImGuiFileDialog::Instance()->DeserializePlaces(placesString);
 Save => std::string placesString = ImGuiFileDialog::Instance()->SerializePlaces();
 ```
 
-(please see DemoApp branch for details)
-
 ################################################################
 ## How to Integrate ImGuiFileDialog in your project
 ################################################################

README.md

@@ -67,15 +67,14 @@ Android Requirements : Api 21 mini
 	- 0 => Infinite
 	- 1 => One file (default)
 	- n => n files
-- Compatible with MacOs, Linux, Windows, Emscripten
-	- Windows version can list drives
+- Compatible with MacOs, Linux, Windows, Emscripten, Android
 - Supports modal or standard dialog types
 - Select files or directories
 - Filter groups and custom filter names
 - can ignore filter Case for file searching
 - Keyboard navigation (arrows, backspace, enter)
 - Exploring by entering characters (case insensitive)
-- Custom places (bookmarks, devices, whatever you want)
+- Custom places (bookmarks, system devices, whatever you want)
 - Directory manual entry (right click on any path element)
 - Optional 'Confirm to Overwrite" dialog if file exists
 - Thumbnails Display (agnostic way for compatibility with any backend, sucessfully tested with OpenGl and Vulkan)
@@ -520,15 +519,19 @@ the DemoApp branch with the "quick access" paths of win10
 You must add a group first, then add a place to it :
 
 ```cpp
-// you must add a group first, specifu display order, and say if the user can add or remove palce like (bookmarks)
-ImGuiFileDialog::Instance()->AddPlacesGroup(group_name, display_order, can_be_user_edited);
+// you must add a group first, specifu display order, and say : 
+// if the user can add or remove palce like (bookmarks)
+// if the group is opened by default
+ImGuiFileDialog::Instance()->AddPlacesGroup(group_name, display_order, can_be_user_edited, opened_by_default);
 // then you must get the group
 auto places_ptr = ImGuiFileDialog::Instance()->GetPlacesGroupPtr(group_name);
 if (places_ptr != nullptr) {
 	// then add a place to the group
 	// you msut specify the place name, the palce path, say if the palce can be serialized, and sepcify the style
 	// for the moment the style support only the icon, can be extended if user needed in futur
-	places_ptr->AddPlace(place_name, place_path, can_be_saved, style);     
+	places_ptr->AddPlace(place_name, place_path, can_be_saved, style);
+	// you can also add a separator
+	places_ptr->AddPlaceSeparator(separator_thickness); 
 }
 ```