Docs: reworked Changelog, comments.

Author: ocornut

docs/CHANGELOG.txt

@@ -396,7 +396,7 @@ IMPLEMENTING SUPPORT for ImGuiBackendFlags_RendererHasTextures:
  When you are not sure about an old symbol or function name, try using the Search/Find function of your IDE to look for comments or references in all imgui files.
  You can read releases logs https://github.com/ocornut/imgui/releases for more details.
 
-   2026/06/XX (1.XXXX) - merged ImDrawListFlags into ImDrawFlags. obsoleted ImDrawListFlags (which were rarely used directly):
+   2026/07/XX (1.93.0) - merged ImDrawListFlags into ImDrawFlags. obsoleted ImDrawListFlags (which were rarely used directly):
                           - ImDrawListFlags_AntiAliasedLines        -> ImDrawFlags_AALines,
                           - ImDrawListFlags_AntiAliasedFill         -> ImDrawFlags_AAFill,
                           - ImDrawListFlags_AllowVtxOffset          -> ImDrawFlags_UseVtxOffset,

imgui.cpp

@@ -3453,7 +3453,7 @@ enum ImDrawFlags_
     ImDrawFlags_SquareCap               = 1 << 11,  // OK   --     // PathStroke(), AddPolyline(): use square cap line ends.
 
     // About Stroke Ends:
-    // - Rendering is optimized for fast pixel-perfect UI, so line ends are not anti-aliased by default. It cheaper (we can emit less vertices).
+    // - Rendering is optimized for fast pixel-perfect UI, so line ends are not anti-aliased by default. It's cheaper (we can emit less vertices).
     // - For more free-form drawings, light graphs and markers, or when using thick strokes: you can turn them on using the ImDrawFlags_AALineEnds flag.
     // - See 'Demo->Examples->Custom Rendering' to interactively toy with those flags.
     // - 'OK*' indicates using this at the AddXXX() call site is unlikely: it would only makes sense if (1) the option is disabled in style/scope and (2) you want to forcefully enable it for a single primitives. Possible but unlikely! Only supported for functions taking flags inputs.
@@ -3465,12 +3465,12 @@ enum ImDrawFlags_
     //ImDrawFlags_NoAALineEnds          = 1 << 16,  // OK   --     // Disable anti-aliasing ends for a given primitive.
 
     // About Stroke Position:
-    // - Read https://github.com/ocornut/imgui/wiki/Draw-List
+    // - Read https://github.com/ocornut/imgui/wiki/Draw-List (this guide includes a precise list of differences between 1.92.9 and 1.93.0)
     // - Read https://github.com/ocornut/imgui/wiki/Pixel-Perfect-Rendering
     // Stroke Position relative to shape outline -- // Prim/Scope?
     ImDrawFlags_StrokeInside            = 1 << 17,  // OK   --     // Draw stroke inside of the shape outline (default for closed shapes and AddLineH, AddLineV functions)
     ImDrawFlags_StrokeCenter            = 2 << 17,  // OK   --     // Draw stroke at the center of the shape outline (default for paths, bezier, and AddLine functions)
-    ImDrawFlags_StrokeCenterBiased      = 3 << 17,  // OK   --     // Draw stroke at the center of the shape outline, so that half thickness rounded down will be outside, and rest inside the shape outline. Useful for axis-aligned shapes: AddLineH, AddLineV, AddRect. Does not animate well!
+    ImDrawFlags_StrokeCenterBiased      = 3 << 17,  // OK   --     // Draw stroke at the center of the shape outline, so that half thickness rounded down will be outside, and the rest inside the shape outline. Useful for axis-aligned shapes: AddLineH, AddLineV, AddRect. Does not animate well!
     ImDrawFlags_StrokeOutside           = 4 << 17,  // OK   --     // Draw stroke outside of the shape outline
     ImDrawFlags_StrokeLegacy            = 7 << 17,  // OK   OK(0)  // Use legacy positioning + enable MiterOnly + disable AALineEnds. Must be all bits set.
 
@@ -3484,8 +3484,8 @@ enum ImDrawFlags_
     ImDrawFlags_RoundCornersMask_       = ImDrawFlags_RoundCornersAll | ImDrawFlags_RoundCornersNone, // [Internal]
     ImDrawFlags_AllowInPushScope_       = ImDrawFlags_AAFill | ImDrawFlags_AALines | ImDrawFlags_AALineEnds | ImDrawFlags_StrokeLegacy | ImDrawFlags_TextNoPixelSnap | ImDrawFlags_UseTexForRoundCorners | ImDrawFlags_UseVtxOffset | ImDrawFlags_RoundCornersMask_, // [Internal] Values allowed in PushDrawFlag() scope.
     ImDrawFlags_AllowInFrameScope_      = ImDrawFlags_AllowInPushScope_ | ImDrawFlags_AllowTexForRoundCorners_,
-    ImDrawFlags_StrokeMask_             = 0x07 << 17,              // [Internal] 
-    ImDrawFlags_InvalidMask_            = ~0x7FFFFFF0,             // [Internal] == 0x8000000F. Reserved to detect misuses. 
+    ImDrawFlags_StrokeMask_             = 0x07 << 17,              // [Internal]
+    ImDrawFlags_InvalidMask_            = ~0x7FFFFFF0,             // [Internal] == 0x8000000F. Reserved to detect misuses.
 };
 
 // Draw command list
@@ -3672,7 +3672,7 @@ struct ImDrawList
     IMGUI_API void  _AddRectTinyRounding(const ImVec2& p_min, const ImVec2& p_max, ImU32 col, float rounding, float thickness, ImDrawFlags flags);
     IMGUI_API void  _SelectLineTexture(float screen_thickness, ImVec2* out_uv0, ImVec2* out_uv1, float* out_fringe, ImDrawFlags flags);
     IMGUI_API float _CalculateCenterBiasedOffset(float thickness);
-    IMGUI_API void  _AddPolyline(const ImVec2* points, int num_points, ImU32 col, float thickness, ImDrawFlags flags, float max_inner_thickness);
+    IMGUI_API void  _AddPolyline(const ImVec2* points, int num_points, ImU32 col, float thickness, ImDrawFlags flags, float max_inner_offset);
 };
 
 // All draw data to render a Dear ImGui frame
@@ -3889,7 +3889,7 @@ enum ImFontAtlasFlags_
     ImFontAtlasFlags_None               = 0,
     ImFontAtlasFlags_NoPowerOfTwoHeight = 1 << 0,   // Don't round the height to next power of two
     ImFontAtlasFlags_NoMouseCursors     = 1 << 1,   // Don't build software mouse cursors into the atlas (save a little texture memory)
-    ImFontAtlasFlags_NoBakedLines       = 1 << 2,   // [OBSOLETE] Don't build line textures into the atlas (save a little texture memory). SINCE 1.93.0 THIS PREVENT ANTI-ALIASED STROKES FROM WORKING AND WILL DISABLE AA.
+    ImFontAtlasFlags_NoBakedLines       = 1 << 2,   // Don't build anti-aliased line textures into the atlas (save a little texture memory). SINCE 1.93.0 THIS PREVENTS ANTI-ALIASED LINES FROM WORKING AND WILL DISABLE THEM.
     ImFontAtlasFlags_NoBakedRoundCorners= 1 << 3,   // Don't build round corners into the atlas.
 };
 
@@ -4556,7 +4556,7 @@ enum ImDrawListFlags_
     ImDrawListFlags_None                    = ImDrawFlags_None,
     ImDrawListFlags_AntiAliasedFill         = ImDrawFlags_AAFill,
     ImDrawListFlags_AntiAliasedLines        = ImDrawFlags_AALines,
-    ImDrawListFlags_AntiAliasedLinesUseTex  = 0, // Only apply to StrokeLegacy mode!
+    ImDrawListFlags_AntiAliasedLinesUseTex  = ImDrawFlags_AALines, // No effect, anti-aliased rendering always uses textures from 1.93+
     ImDrawListFlags_AllowVtxOffset          = ImDrawFlags_UseVtxOffset,
     ImDrawListFlags_TextNoPixelSnap         = ImDrawFlags_TextNoPixelSnap,
 };

imgui.h

@@ -10474,8 +10474,7 @@ static void ShowExampleAppCustomRendering(bool* p_open)
             ImGui::CheckboxFlags("AALineEnds", &prim_other_flags, ImDrawFlags_AALineEnds); ImGui::SameLine();
             ImGui::CheckboxFlags("MiterOnly", &prim_other_flags, ImDrawFlags_MiterOnly); ImGui::SameLine();
             ImGui::CheckboxFlags("SquareCap", &prim_other_flags, ImDrawFlags_SquareCap);
-            //ImGui::CheckboxFlags("UseTexForRoundCorners", &prim_other_flags, ImDrawFlags_UseTexForRoundCorners); ImGui::SameLine();
-            //ImGui::CheckboxFlags("UseTexForStrokeLegacy", &prim_other_flags, ImDrawFlags_UseTexForStrokeLegacy);
+            //ImGui::CheckboxFlags("UseTexForRoundCorners", &prim_other_flags, ImDrawFlags_UseTexForRoundCorners);
 
             static ImDrawFlags scope_flags = draw_list->Flags & ImDrawFlags_AllowInPushScope_; // First init copy current state.
             ImGui::SeparatorText("Current ImDrawList flags (e.g. PushDrawFlag function)");
@@ -10484,8 +10483,7 @@ static void ShowExampleAppCustomRendering(bool* p_open)
             ImGui::CheckboxFlags("AALines", &scope_flags, ImDrawFlags_AALines); ImGui::SameLine();
             ImGui::CheckboxFlags("AALineEnds", &scope_flags, ImDrawFlags_AALineEnds); ImGui::SameLine();
             ImGui::CheckboxFlags("StrokeLegacy", &scope_flags, ImDrawFlags_StrokeLegacy);
-            //ImGui::CheckboxFlags("UseTexForRoundCorners", &scope_flags, ImDrawFlags_UseTexForRoundCorners); ImGui::SameLine();
-            //ImGui::CheckboxFlags("UseTexForStrokeLegacy", &scope_flags, ImDrawFlags_UseTexForStrokeLegacy);
+            //ImGui::CheckboxFlags("UseTexForRoundCorners", &scope_flags, ImDrawFlags_UseTexForRoundCorners);
             ImGui::PopID();
             ImGui::Spacing();
 
@@ -10508,7 +10506,7 @@ static void ShowExampleAppCustomRendering(bool* p_open)
             for (int side = 0; side < 4; side++)
             {
                 float t = (float)ImGui::GetTime() * 0.1f + side * pi * 0.5f;
-                rotating_square[side] = { (float)cosf(t) * half_sz, (float)sin(t) * half_sz };
+                rotating_square[side] = { (float)cosf(t) * half_sz, (float)sinf(t) * half_sz };
             }
 
             float x = start_pos.x;

imgui_demo.cpp

@@ -4840,7 +4840,7 @@ static void ImFontAtlasBuildUpdateTexDataBasic(ImFontAtlas* atlas)
 
 static int InitCornerGeometry(float cx, float cy, float rounding, float circle_segment_max_error, ImVec2* line_normals, float* line_distances)
 {
-    // This tries to quite faithfully replication how we render the corners using tessellation.
+    // This tries to quite faithfully replicate how we render the corners using tessellation.
     // Older code sampled a circle SDF directly, but it had clearly visible discrepancy between the baked corners
     // and tessellated corners due to circle_segment_max_error.
 
@@ -5089,9 +5089,9 @@ static void ImFontAtlasBuildUpdateTexDataLines(ImFontAtlas* atlas)
     }
 
     {
-        // Calculate super sampled lin textures for smaller line widths to make transition between sizes smoother.
+        // Calculate super sampled line textures for smaller line widths to make transition between sizes smoother.
 
-        // Calc ramp used for all the textures.
+        // Calculate ramp used for all the textures.
         ImU8 ramp[IM_DRAWLIST_TEX_LINES_SAMPLE_COUNT];
         for (int n = 0; n < IM_DRAWLIST_TEX_LINES_SAMPLE_COUNT; n++)
             ramp[n] = (ImU8)(((float)n / IM_DRAWLIST_TEX_LINES_SAMPLE_COUNT) * 255.0f);
@@ -5108,7 +5108,7 @@ static void ImFontAtlasBuildUpdateTexDataLines(ImFontAtlas* atlas)
             // To super 2x sample that signal, we end up with following texture:
             // [  0  |  .5 |  1  |  .5 |  0  ]
             //    :.......................:
-            // One might think that there should be 2 opaque pixels the the middle section, but no singe we're super sampling the triangle signal.
+            // One might think that there should be 2 opaque pixels in the middle section, but no since we're super sampling the triangle signal.
             const int line_width = 1 + n;
             IM_ASSERT(IM_DRAWLIST_TEX_LINES_SAMPLE_COUNT + line_width + IM_DRAWLIST_TEX_LINES_SAMPLE_COUNT <= r.w && y < r.h); // Make sure we're inside the texture bounds before we start writing pixels
 

imgui_draw.cpp

@@ -515,7 +515,7 @@ inline float  ImSign(float x)            { return (x < 0.0f) ? -1.0f : (x > 0.0f
 inline double ImSign(double x)           { return (x < 0.0) ? -1.0 : (x > 0.0) ? 1.0 : 0.0; }
 #ifdef IMGUI_ENABLE_SSE
 inline float  ImRsqrt(float x)           { return _mm_cvtss_f32(_mm_rsqrt_ss(_mm_set_ss(x))); }
-// Converge to more precise solution using single step of Newton-Raphson method, repeating increase precision
+// Converge to more precise solution using single step of Newton-Raphson method, repeating increases precision
 inline float  ImRsqrtPrecise(float x)    { const float r = _mm_cvtss_f32(_mm_rsqrt_ss(_mm_set_ss(x))); return r * (1.5f - x * 0.5f * r * r); }
 #else
 inline float  ImRsqrt(float x)           { return 1.0f / sqrtf(x); }
@@ -922,7 +922,7 @@ IMGUI_API ImGuiStoragePair* ImLowerBound(ImGuiStoragePair* in_begin, ImGuiStorag
 #define IM_DRAWLIST_ARCFAST_SAMPLE_MAX              IM_DRAWLIST_ARCFAST_TABLE_SIZE // Sample index _PathArcToFastEx() for 360 angle.
 
 #ifndef IM_DRAWLIST_TEX_LINES_WIDTH_MAX
-#define IM_DRAWLIST_TEX_LINES_WIDTH_MAX             (32)    // The maximum line width to bake anti-aliased textures for. Build atlas with ImFontAtlasFlags_NoBakedLines to disable baking.
+#define IM_DRAWLIST_TEX_LINES_WIDTH_MAX             (32)    // The maximum line width to bake anti-aliased textures for.
 #endif
 #ifndef IM_DRAWLIST_TEX_LINES_DETAILED_WIDTH
 #define IM_DRAWLIST_TEX_LINES_DETAILED_WIDTH        (4)     // Calculate detailed textures for width [1..IM_DRAWLIST_TEX_LINES_DETAILED_WIDTH]