Skip to content
Permalink
master
Switch branches/tags
Go to file
 
 
Cannot retrieve contributors at this time

Changelog

All notable changes to Agar will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

  • Build system: Add CMake support.
  • A driver for the SDL 2.0 series.
  • A software framebuffer driver for X Windows.
  • Remote debugger agardb.
  • Interface builder to help the process of constructing static or fixed-resolution interfaces.
  • Add widget classes to the new Ada bindings in ada/gui/.
  • New COBOL bindings: GnuCOBOL and GuiCOBOL.
  • AG_Console: Handle ansi cursor and terminal operations. Clipboard integration.
  • AG_FontSelector: Display only those styles that are available for a given font (as opposed to a static list of styles).
  • AG_Menu: Implement focusability and keyboard navigation methods. Handle "font-changed" better under multi-window drivers.
  • AG_Notebook: Fix padding issues. Add disposition modes Bottom, Left & Right.
  • AG_Pixmap & AG_Fixed: Zoom operations.
  • AG_StyleEditor: Edition of stylesheet rules.
  • AG_StyleSheet: Gradients and border styles. New selector "E > F" (an F element child of an E element).
  • AG_Surface: Filters. Stencil operations.
  • AG_Text: Provide a way to map core font names to known system fonts so porters have the option of adding dependencies to existing font packages in order to reduce the size of agar packages.
  • AG_Textbox & AG_Editable: Extend SGR support. Syntax highlighting & rich-text editing methods.
  • AG_WidgetPrimitives: Dithering. Shadow effects.
  • AG_Widget: Provide a variation of the "zoom" feature to resize widgets individually.
  • AG_Widget: Threading optimizations. Cache the VISIBLE flag into an int so that culling / rendering and mouse-intersection tests can skip over invisible widgets without locking them.
  • AG_Window: MRU API to simplify the process of remembering geometries. New gravity methods for autoplacing.
  • cocoa: Cursor operations. Clipboard integration.
  • glx: Make drag-and-drop (sockets test) work correctly (possibly using AG_WindowMove()).
  • wgl: Clipboard integration. Live resize.
  • Fix Style Editor and GUI Debugger crashes which would occur when attempting to iterate over widgets (in keyrepeat mode).

[1.6.1] - 2021-

Added

  • AG_Radio: New HOMOGENOUS option to divide space equally between items. Thanks Stephen!
  • AG_Event: New macro AG_EVENT_DUMP to produce a listing of argv[] arguments on the console.
  • install-agartest.exe installer for agartest on Windows.
  • Provide copies of the OFL as separate files (OFL11.txt and LICENSE.ofl).
  • Install a copy of the generated Makefile.config as ${DATADIR}/agar.mk.
  • Install a copy of the generated configure.lua as ${DATADIR}/agar.lua.
  • Added DEBUG_MOUSE build option (debug delivery of mouse events to widgets).

Changed

  • Build system updates so configure scripts are smaller and no longer emit unnecessary defines such as foo_cflags.h for dependent libraries. Those definitions are always available from ${DATADIR}/agar.mk.
  • Don't install headers from disabled libraries.
  • AG_Widget: In AG_WidgetSensitive(), use the window pointer to avoid an unnecessary traversal of parent objects.
  • AG_Widget: Prevent delivery of redundant "widget-shown" or "widget-hidden" events if AG_WidgetShow() and AG_WidgetHide() are called multiple times.

Fixed

  • Fixed compilation problem with core/dir.c under NetBSD.
  • Fixed compilation problem with core/inline_byteswap.h and core/cpuinfo.c on powerpc64. Thanks Mark Linimon!
  • Fixed double <-> long conversion warnings in math/m_sparse*.
  • wgl: Fixed a bug in cursor handling. When showing a window initially, perform size allocation after having initialized the cursors so that the initial cursor-change areas are correctly established.
  • install-sdk.exe now installs include files in include\x86 or include\x64.
  • AG_Widget: Fixed non-delivery of mouse-button-down events to hidden and subsequently re-shown widgets (e.g., widgets under a Notebook). Thanks Walter!
  • AG_Widget: Deliver widget-hidden when detaching a widget from a visible window.
  • AG_Widget: In AG_WidgetSizeAlloc(), set the UNDERSIZE flag correctly on return in the case where size_allocate() is inherited from a parent class.

[1.6.0] - 2020-05-16

Added

  • Integrated Style Editor tool. It allows a developer to inspect a live VFS of widgets, to pick elements, to add/edit style attributes and look at the results in real time.
  • Integrated GUI Debugger utility. Inspect a live VFS of widgets in real time. Available in Debug builds only.
  • AG_Button: New functions AG_ButtonGetState(), AG_ButtonSetState and atomic AG_ButtonToggle(). New option flag SET to force initial "state" to 1). New option flag RETURN_BUTTON to embed a "Return" button which raises "textbox-return" when pressed.
  • AG_Checkbox: Display a check mark (U+2713). Thanks Federico!
  • AG_Checkbox: New option flag INVERT.
  • AG_Config: New settings: "Tab Width", "Cursor Blink Rate", "Mouse Scroll Interval", "Enable GL_DEBUG_OUTPUT" and "NPOT (non power of two) textures".
  • AG_Console: Handle multiline entries. AG_ConsoleMsg() will now split multiline strings into multiple, grouped lines that are displayed in an indented style. Thanks Charles!
  • AG_Console: Introduce event sink-based file monitoring features. New functions AG_ConsoleOpenFile, AG_ConsoleOpenFD, AG_ConsoleOpenStream() and AG_ConsoleClose().
  • AG_Console: New function AG_ConsoleBinary() to produce data in canonical (hex + ASCII) format. New function AG_ConsoleMsgCatS() for appending to an existing entry.
  • AG_Console: New function AG_ConsoleExportBuffer() for exporting entire buffer contents. Added "Selected Lines Only" option in "Export to file". Added menu function "Clear All". Added image types under "Export to file" for exporting screenshots.
  • AG_DataSource: New fixed-length string encoding functions AG_CopyStringPadded(), AG_WriteStringPadded() and AG_SkipStringPadded().
  • AG_Driver: New operations: putPixel64(), putPixelRGB16(), drawTriangle(), drawPolygon(), drawPolygonSti32(), drawLineW(), drawLineW_Sti16(), getClipboardText() and setClipboardText().
  • AG_Editable & AG_Textbox: Implement basic support for ANSI SGR attributes.
  • AG_Editable & AG_Textbox: Added autocomplete feature. New functions AG_EditableAutocomplete() and AG_EditableCloseAutocomplete().
  • AG_Editable & AG_Textbox: New property "placeholder" to specify a text label to show whenever the buffer is empty. Thanks Federico for the suggestion!
  • AG_Editable & AG_Textbox: New options UPPERCASE and LOWERCASE.
  • AG_FileDlg: Added AG_FileDlgAddImageTypes().
  • AG_FileDlg: New COMPACT option. In this mode, the widget becomes a single-line ( Textbox & Button ). The Button triggers the FileDlg to instantiate a clone of itself in a new window. New constructors AG_FileDlgNewCompact() and AG_FileDlgNewCompactMRU().
  • AG_FileDlg: Added special syntaxes to AG_FileType item. "<-x>" tests whether a file is executable by the effective user. "<=FILENAME>" matches filenames exactly. "<=FILENAME/i>" performs case-insensitive matching.
  • AG_FileDlg: New functions AG_FileDlgGetDirectory(), AG_FileDlgGetFilename(), AG_FileDlgCopyDirectory(), AG_FileDlgCopyFilename() and AG_FileDlgCopyTypes().
  • AG_Graph: Add support for directed graphs. Edges now include distinct types UNDIRECTED and DIRECTED. Thanks Charles!
  • AG_HSVPal: New functions AG_HSVPalUpdateHue() and AG_HSVPalUpdateSV().
  • AG_Notebook: New functions AG_NotebookGetByID() and AG_NotebookSelectByID() for referencing tabs by integer ID.
  • AG_Object: New run-time object validity and class-membership tests. In Debug builds, passing an invalid object pointer to any Agar API call should now trigger "Illegal access" assertions. Additional tests are done when traversing linked lists in order to detect memory errors.
  • AG_Object: New functions AG_CreateClass() and AG_DestroyClass(). Provide an auto-allocated alternative to AG_RegisterClass() interface (which takes a pre-initialized argument). Added AG_ClassSetInit(), AG_ClassSetReset(), AG_ClassSetDestroy(), AG_ClassSetLoad(), AG_ClassSetSave() and AG_ClassSetEdit() for setting and overriding function pointers dynamically.
  • AG_Object: New property "archive-path". Deprecate AG_ObjectGetArchivePath() and AG_ObjectSetArchivePath().
  • AG_Pixmap: New function AG_PixmapGetSurface() to return a copy of surface at a given index.
  • AG_Radio: Handle multiline items. Implement key repeat.
  • AG_Radio: Implement horizontal layout. New function AG_RadioSetDisposition(). Thanks Federico!
  • AG_Separator: New function AG_SeparatorSetLength() to set a requisition when placing separators in containers of indeterminate size.
  • AG_Surface: Add support for 48- and 64-bit surfaces (under LARGE memory model).
  • AG_Surface: Add support for 1-bit (monochrome), 2-bit (4-color), and 4-bit (16 color) palettized modes. Cache PixelsPerByte in format field.
  • AG_Surface: Add support for Grayscale+Alpha modes (32-bit and 64-bit).
  • AG_Text: Add support for ANSI SGR attributes in AG_TextSize() and AG_TextRender(). Map the SGR Alternative Fonts to our core fonts.
  • AG_Text: New functions AG_TextFontPctFlags() and AG_CopyTextState().
  • AG_Timer: New functions AG_ExecTimer() & AG_DelTimers().
  • AG_Tlist: Implement per-item alternate colors and font flags. New functions AG_TlistSetColor() and AG_TlistSetFont() to style items individually.
  • AG_Widget: New function AG_SetStyleF().
  • AG_Widget: New events "font-changed" and "palette-changed". They are generated by the style compiler to signal whenever a widget's font or any entries in its palette (pal) have been changed.
  • AG_Widget: New functions AG_PushBlendingMode() & AG_PopBlendingMode().
  • AG_Window: New function AG_WindowMove() for moving windows more efficiently when no resize is required.
  • New color manipulation routines AG_ColorDarken(), AG_ColorLighten() and AG_ColorInterpolate().
  • New size hinting functions AG_PixmapSizeHint(), AG_BoxSizeHint(), AG_RadioSizeHint() and AG_FixedSizeHint(), for specifying explicit size requisitions in pixels.
  • New functions AG_ClipLine() for clipping lines to rectangular bounding boxes, AG_ClipLineCircle() for clipping lines to circular regions. New function AG_GetLineIntersection() for computing the intersection of two line segments. Thanks Charles!
  • New function AG_DrawArrowhead() for drawing arrowheads of arbitrary size and angle aligned to arbitrary vectors. New function AG_DrawArrowLine() for drawing lines with arrowheads. Thanks Charles!
  • New function AG_About() to generate a simple "About Agar" dialog with license text.
  • dummy: A new no-op driver which prints out calls and arguments to the console. In agartest, use the "-C" option to see the output (e.g., "agartest -C -d dummy").
  • glx: New driver option "xsync" to enable synchronous X events (e.g., "-d glx(xsync)"). This is useful when debugging issues involving any call into the X Window system.
  • New style attributes for colors. Primaries are "color", "background-color", "text-color", "line-color", "high-color", "low-color" and "selection-color". States are #unfocused, #disabled, #focused and #hover.
  • New style attributes "font-family", "font-size", "font-weight", "font-style" and "font-stretch".
  • New style attribute "padding". Allowed syntaxes are "padding: X" (set all paddings) and "padding: T R B L" (set Top, Right, Bottom & Left separately). For example, the padding of an AG_Button sets the space in pixels between the text label and the button's outer edges. The padding of an AG_Box sets the padding around the entire set of attached child widgets.
  • New style attribute "spacing". Allowed syntaxes are "spacing: X" (set both spacings) and "spacing: H V" (set horizontal and vertical spacings separately). In a vertical AG_Radio for example, H sets the horizontal space between the radio button and its label and V sets the vertical space in pixels between radio items. The spacing of an AG_Box sets the spacing between its child widgets.
  • New fonts. The distribution now includes a set of OFL 1.1 licensed core fonts in order to help improve cross-platform typography:
    • #0: Algue (not a RFN. Latin & graphical icons. Baked into ag_gui).
    • #1: Unialgue (not a RFN. Latin Extended, Arabic, Armenian, Canadian Aboriginal, Cyrillic, Devanagari, Georgian, Greek Extended, Gujarati, Gurmukhi, Hebrew, Lao, Lisu, Nko, Ogham, Tamil, Thai, Tibetan & Tifinagh).
    • #2: An unused slot.
    • #3: Computer Modern Unicode Sans (Latin Extended, Greek & Cyrillic).
    • #4: Computer Modern Unicode Serif (Latin Extended, Greek & Cyrillic).
    • #5: Computer Modern Unicode Typewriter (Latin Extended, Greek & Cyrillic).
    • #6: Bitstream Charter (Latin).
    • #7: Courier Prime (Latin).
    • #8: Source Han Sans (Latin, Chinese, Japanese & Korean).
    • #9: League Spartan (Latin).
    • #10: League Gothic (Latin).
    • #11: Unifraktur Maguntia (Latin).
  • Clipboard integration (currently implemented in glx). Added new AG_Driver operations getClipboardText() and setClipboardText().
  • Provide dlsym()mable copies of inline functions in lowercase form. For example, the symbol AG_LengthUTF8() is now guaranteed to have a dlsymmable copy called ag_length_utf8(). This helps avoid the need for glue code in language bindings. Thanks Brian and Federico!
  • Nullability: Introduce _Nullable and _Nonnull pointer annotations to help prevent programming mistakes and make prototypes more expressive.
  • Define special nullability annotations for thread types which require special handling since they may or may not be pointer types depending on the platform. Define _{Nullable,Nonnull,Null_unspecified}_{Mutex,Cond,Thread}.
  • New pointer-type-safe accessor macros for event handlers. Instead of using the generic pointer accessors AG_SELF(), AG_PTR() or AG_PTR_NAMED() to retrieve an object pointer from an event handler, one can now use the more specific AG_OBJECT_SELF(), AG_OBJECT_PTR() and AG_OBJECT_PTR_NAMED() macros. In a Debug build, such macros will perform a run-time validity and class-membership test. In a Release build, no tests are done. Class-specific accessor macros are also provided, for example AG_Button defines AG_BUTTON_SELF(), AG_BUTTON_PTR() and AG_BUTTON_PTR_NAMED().
  • New build option --enable-type-safety (implied by --enable-debug).
  • New build option --with-memory-model. SMALL targets 8-bit machines (for ag_micro only). MEDIUM has a smaller memory footprint and can handle up to 24-bit "True Color" surfaces (the default on non 64-bit hosts). The LARGE model adds support for 48-bit "Deep Color" surfaces (the default on 64-bit hosts). Either MEDIUM or LARGE will work on both 32-bit and 64-bit hosts (the choice comes down to performance tuning). Introduce AG_Size and AG_Offset types.
  • New build option --disable-widgets build with base framework, but without the standard widget library.
  • ag_core: Import rxi's type-safe dynamic arrays vec. Thanks Charles for the suggestion!
  • ag_core: Colorize debugging output. Added --disable-ansi-color build option.
  • ag_core: New AG_SetErrorS() function variant.
  • ag_math: New functions AG_Square(), AG_HaveQuadraticSolution(), AG_QuadraticPositive(), AG_QuadraticNegative() & AG_Distance(). Thanks Charles!
  • ag_math: New M_Bezier module for computing Bézier curves. Thanks Charles!
  • ag_net: Introduce AG_Web, a multiprocess HTTP/1.1 application server. It handles authentication, session/process management, push events and templates (not in default build, must use --enable-web).
  • ag_vg: Make VG an AG_Object class since we may wish to subclass it or set variables and events on it.
  • ag_vg: Introduce vgedit, a basic editor for VG object files. It is also a good demonstration of VG_View widget usage.

Removed

  • AG_Event: In AG_PostEvent(), remove the mandatory "sender" first argument. Sender objects can be passed instead as regular arguments.
  • AG_Event: Removed the ASYNC and PROPAGATE option flags. Both behaviors can be implemented more flexibly in the event handler routine itself.
  • AG_Event: Removed the child-attached and child-detached events.
  • AG_Object: Removed the AG_ObjectDep structure and linkage. Dependencies are now represented with less overhead using AG_Variables.
  • AG_Object: Removed the save_pfx and archivePath fields (replaced by the "archive-path" property).
  • AG_Object: Remove typed virtual functions. This improves performance and allows AG_Get*() functions to be declared pure in unthreaded builds.
  • AG_Widget: Removed the options NOSPACING and TABLE_EMBEDDABLE which are no longer relevant.

Changed

  • AG_Button: Renamed AG_ButtonInvertState() -> AG_ButtonSetInverted().
  • AG_Button, AG_Checkbox & AG_Textbox: Implement rendering of text labels internally to avoid the cost of embedding AG_Labels widgets.
  • AG_Color: Handle web keywords ("AliceBlue", "antiquewhite", etc). They can now be used in widget color attributes and stylesheets. Keywords are case-insensitive.
  • AG_Color: Handle shortened "#RGB" and "#RGBA" formats in AG_ColorFromString().
  • AG_Combo & AG_UCombo: Cache generated windows to improve response time under multi-window drivers.
  • AG_Console: Rendering optimizations. Avoid redundant blending in draw() by pre-caching lines against an opaque background.
  • AG_Config: New functions AG_ConfigFind(), AG_ConfigAddPath(), AG_ConfigDelPath() and AG_ConfigSetPath(). Replaces former colon-separated "load-path", "save-path", "font-path", and "tmp-path" attributes. Define standard path groups PATH_DATA, PATH_FONTS and PATH_TEMP.
  • AG_Editable & AG_Textbox: Improve keyboard handling. Use 4 independent keyrepeat timers for the direction keys.
  • AG_Editable & AG_Textbox: Improvements to the word-selection behavior (triggered by ALT or double-click followed by mouse motion).
  • AG_FontSelector: Include Agar core fonts and user fonts in the listing (scanning "font-path" for files with supported extensions). Add "pixel64" binding in Large mode. Embed a color picker to preview fonts in different colors. Add Upright Italic and width variants. Add an alternate sample phrase.
  • AG_FileDlg: Refresh automatically when directory contents change when running on platforms with support for filesystem notifications (using an event sink of type FSEVENT).
  • AG_Menu: Improve responsiveness of menu expansions. Draw a rectangular outline to avoid blending into the background.
  • AG_Notebook: Legibility and rendering fixes. Render a stripe in "selected-color" over the selected tab. Handle multiline text correctly in tab labels.
  • AG_Object: Make AG_Variables of type P_FLAG* mutable to INT and UINT* types. In AG_CompareVariables(), compare discrete STRING variables by string value as opposed to comparing by reference. The AG_GetVariableLocked() function was renamed AG_AccessVariable(). Dependencies are now represented more compactly as AG_Variables of type P_OBJECT and P_VARIABLE.
  • AG_Scrollbar: Enhance contrast when control bar is squished below a constant threshold. Adjust the size requisition based on the zoom level (as opposed to the font size). Added SMOOTH option to produce a progressive motion towards the target for clicks outside of the control bar (as opposed to jumping which is the default).
  • AG_StyleSheet: The stylesheet parser now handles C-style comments. Improved validation and error messages.
  • AG_Surface: Pack AG_PixelFormat in the AG_Surface structure itself (so format is no longer a pointer).
  • AG_Surface: Set the MAPPED bit on surfaces that have been mapped with AG_WidgetMapSurface(). Detect attempts at freeing surfaces without first unmapping them.
  • AG_Text: Inner-loop optimizations in AG_TextSize() and AG_TextRender() backends. Reorganized code to use jump tables and allow new types of font engines to be used. Safety improvements in the backend of AG_{Push,Pop}TextState().
  • AG_Text: Handle fractional (floating-point) font sizes. This affords the style engine greater precision whenever "font-size" is expressed in "%".
  • AG_Widget: Store GL state data in a separate auto-allocated structure AG_WidgetGL to reduce overhead in the non-USE_OPENGL case.
  • AG_WidgetPrimitives: Produce smoother transitions between edges and corners of 3D-style primitives such as AG_DrawBox() and AG_DrawBoxRounded().
  • Pass AG_Color and AG_Rect by reference in public APIs.
  • Use the const, pure, noreturn, malloc_like and warn_unused_result attributes when they are available. Introduce _Pure_Attribute_If_Unthreaded.
  • Optimize the case where a window contains no widgets that make use of text rendering and therefore require no push/popping of the text state. Cache the result under AG_WINDOW_USE_TEXT in parent window.
  • Improvements, fixes and optimizations in the sizing routines of widgets in general.
  • Moved AG_Net code from ag_core to a separate library called ag_net. This prevents network-call-related security warnings on some platforms and packaging systems from affecting programs which do not use network calls.
  • glx: Obtain initial keyboard repeat delay and interval settings from XKB. Fallback to legacy XF86MISC if XKB is not available.
  • sdlfb & sdlgl: Handle "width" and "height" parameters in % (relative to available desktop space). Added "!bgPopup" option to disable background popup menu. Handle "R/G/B" format in "bgColor" parameter.
  • sdlfb & sdlgl: Allow windows (including minimized window icons) to move past view boundaries.
  • Build system updates. Fix endianness test for mingw and darwin hosts. It is no longer necessary to pass --byte-order when cross-compiling to mingw. The build system now handles Windows DLL files as regular binaries. We no longer use libtool. Added auto-generation of pkg-config .pc modules.
  • New build options --without-inline to disable inlining entirely and --without-inline-* to disable selectively.
  • Manual page improvements (clarity, wording, examples).
  • New Ada bindings (in ada/). Updated bindings are variable-thickness and offer the ability to implement new Agar object classes in pure Ada.
  • Mat's Perl bindings (in p5-Agar/) have been updated. Fixed bootstrapping code to work with recent perls.
  • ag_core: The "posix" module of AG_User uses getpwent() which may incur some startup overhead for applications under some platforms. Introduce a new module getenv, which avoids the call and obtains the information instead from the $USER, $[E]UID, $HOME and $TMPDIR environment variables. It is now the default unless AG_POSIX_USERS is passed to AG_InitCore().
  • ag_core: Compile cleanly on small C compilers such as cc65 and sdcc.
  • ag_core: Make AG_GetVariable() a non-variadic function. This may cause some new compiler warnings which can be avoided by casting the argument to (void *).

Fixed

  • AG_Console: Fixed memory leaks. Handle empty lines more efficiently.
  • AG_DSO: In OSX Lion (10.7) and later, prefer dlopen() over dyld() method.
  • AG_HSVPal: Fixed rendering issues. Scale the different features better under different sizes. Avoid overdraw in the transparency preview. If displaying an RGB or HSV text label, select a sensible text color based on HSV parameters. Short-circuit the cases where s or v are close to 0 (according to AG_SATURATION_EPSILON and AG_VALUE_EPSILON).
  • AG_Menu: Fixed collapse behavior when closing hierarchies of opened menus. Fixed incorrect alignment of submenus in some circumstances. Fix modal behavior of menu expansions in multi-window drivers.
  • AG_Label: In POLLED mode, obtain better size requisitions by processing the format string earlier in size_request(). This prevents the need for manual size hinting in common cases.
  • AG_Surface: Fix the PNG loader and exporter. PNG files with 16-bit per channel are now supported. Handle indexed-mode images correctly.
  • AG_Text: Fix a rendering problem with certain fonts where glyphs would blend incorrectly with the previously rendered glyphs.
  • AG_Tlist: Make AG_TlistSort() thread-safe.
  • AG_Tlist: When right-clicking, select the target item before triggering popup menus.
  • glx: If the initial glXChooseVisual() attempt fails, fallback to an 8-bit depth.
  • glx: Use XGrabPointer() to handle windows with MODAL flag. Thanks Charles!
  • Fixed some pixel off-by-one errors in widget primitives.
  • Fixed an unwanted side effect when passing an argument of NULL or agWindowFocused to AG_WindowFocus(). It would cause any previous focus request to be cancelled. It is now a proper no-op.
  • Thread-safety and efficiency improvements. Removed many unnecessary lock operations.
  • Fixed 32-bit MSYS build (include missing header file). Thanks Varialus!
  • ag_core: It is now safe for Event Sink routines to call AG_DelEventSink() on themselves.
  • ag_core: It is now safe for an Event Epilogue routine to call AG_DelEventEpilogue() on itself. Thanks Walter!

[1.5.0] - 2016-03-25

Added

Removed

Changed

  • Manual pages have been updated. Added example code and images for its web and printable versions.
  • Build system updates. The agar-config scripts are now auto-generated.
  • AG_Combo: Pin popup menus to parent window. Set WM_COMBO hint such that popup menus integrate properly with window managers in multi-window mode.
  • AG_Config: Save GUI parameters such as keyboard and mouse timings to a configuration file. Define global GUI variables (agKbdDelay, etc.) in ag_gui library. The agConfig is no longer auto-loaded by AG_InitCore() so user code (and ag_gui) now have an opportunity to set up variable bindings before the configuration object is loaded.
  • AG_Console: Improve scrolling and selection behavior. Make autoscrolling the default.
  • AG_Console: The AG_ConsoleAppendLine() function may now fail and return NULL.
  • AG_Console: Add AG_ConsoleMsgEdit() for updating an existing line. The agartest benchmark function is a good demonstration of the feature.
  • AG_DriverMw: Create a windowless "root" driver instance, so we can handle resources such as X server connections more efficiently.
  • AG_Label: Polled labels are now implemented using generic AG_PrintfP() function of AG_String.
  • AG_Notebook: Display tab labels using embedded AG_Label widgets.
  • AG_Object: In AG_ObjectFind(), handle pathnames terminating in "/" correctly.
  • AG_Pane: Clean up division/expansion code, replace confusing options with AG_PaneResizeAction().
  • AG_Scrollbar: Handle clicks outside of control bar by seeking progressively.
  • AG_Surface: Enforce alignment against a 4-byte boundary.
  • AG_Surface: Honor source X-offset. Thanks pi31415!
  • AG_Text: The AG_TextRender() call may now fail and return NULL.
  • AG_Text: Expire entries in the text cache more efficiently.
  • glx: Specify an EWMH-compliant window type. Set up Motif functions / decorations / input hints.
  • Moved common clipping and texture management code of OpenGL drivers to gui/drv_gl_common.c.
  • AG_InitCore() now allows a NULL progname argument.

Fixed

  • AG_Editable & AG_Textbox: In WORDWRAP mode, handle additional types of Unicode space in addition to ASCII space.
  • AG_FileDlg: Removed an unnecessary refresh that would occur when the widget was shown initially. Fixed cosmetic problems.
  • AG_Menu: Fix modal behavior of AG_MenuExpand()-generated popup windows.
  • AG_Notebook: Fix memory leak that would affect container widgets on detach.
  • AG_Surface: Fixed handling of top-down encoded images in AG_SurfaceFromBMP().
  • AG_Table: Don't compare cells across columns when restoring selection state in AG_TableBegin() / AG_TableEnd().
  • AG_Text: Fix a thread-safety problem with AG_TextTmsg().
  • AG_Window: Make AG_WindowShow() and AG_WindowHide() thread-safe under all drivers. Use queues.
  • AG_Window: In single-window mode, auto-tile the minimized window icons correctly.
  • glx: If Xinerama extension is available, have GetDisplaySize() query Xinerama and return the dimensions of the first screen only.
  • wgl: Rewrite keyboard handling code. Honor the AG_WINDOW_KEEPABOVE option.
  • ag_math: When compiling the ag_math library with SSE, ignore the configure-specified precision and force M_Vector[34], M_Matrix44 and M_Color to be single-precision.
  • Prevent binary structure differences when compiling --enable-threads vs --disable-threads and --enable-debug vs. --disable-debug. Thanks reinoud!
  • Make the conversion of native surfaces to OpenGL textures more efficient.
  • Fix MacOS X build where _USE_SDL_FRAMEWORK is set.

[1.4.1] - 2011-03-20

Added

Removed

  • Removed debug option --enable-lockdebug.

Changed

  • Build system updates: Upgrade to BSDBuild 2.8. Note: stale generated agar-config/ and agar-foo-config/ directories from previous builds must be removed before running ./configure.
  • Merged debug options --enable-classdebug and --enable-eventdebug into a single --enable-objdebug.
  • Many updates to the manual pages.
  • wgl: Terminate the application by breaking out of the event loop as opposed to calling exit().
  • wgl: Raise the "window-gainfocus" event whenever a window is focused for the first time on creation.

Fixed

  • AG_Surface: Fixed crash in AG_SurfaceFromSDL(). Thanks trapdoor!
  • AG_Textbox: Fixed crash bug with STATIC option.
  • AG_Timeout: Fix deadlock condition with when timers are scheduled in reverse order. Thanks Jakob Reschke!
  • Fixed incorrect UTF-8 conversion of 3-byte sequences. Thanks Jerry Huang!
  • Fixed coordinates offset for popup menus under single-window drivers.
  • Fixed compilation problems under --disable-legacy.
  • AG_DriverSDLFB & AG_DriverSDLGL: Add required SDL_LockSurface() calls.
  • Don't use the [gettimeofday()] interface on cygwin.
  • Fixed compilation problems under MinGW / MSYS. Thanks Joergen!

[1.4.0] - 2010-04-16

Added

Changed

  • AG_Textbox: Embed an AG_Label.
  • AG_Widget: Cursor changes are no longer done by immediate calls in widget code. Instead, widgets now must register Cursor Change Areas through the new AG_Cursor interface.
  • AG_Widget: Renamed events "window-mousemotion" -> "mouse-motion", "window-mousebuttonup" -> "mouse-button-up" and "window-mousebuttondown" -> "mouse-button-down".
  • AG_InitGraphics(): New function to initialize the ag_gui library. Deprecate the AG_InitVideo() interface. The legacy interface still works, but will select only among single-window drivers.
  • It is now possible to build Agar without SDL (effectively disabling sdl drivers) using --without-sdl.
  • The AG_ViewDetach() function is now deprecated. Agar windows should be attached with AG_ObjectAttach() (this is done internally) and detached with AG_ObjectDetach().
  • VG_View: Use the new Widget Actions framework.

Fixed

  • AG_Variable: Fix incorrect handling of dynamically-allocated strings.
  • Fixed inefficiencies in AG_LookupClass().
  • Don't export our integer types Uint8, Sint8, Uint16, etc. Unwind their definitions when closing headers unless _USE_AGAR_TYPES is defined.
  • Fixed memory leaks on AG_Destroy(). Added test code under demos/reinit/.

[1.3.4] - 2009-08-30

Added

Removed

  • Removed build option --disable-utf8.
  • Removed SDL dependencies in non-driver-specific ag_gui code.

Changed

  • AG_GLView: Save and restore GL_TRANSFORM_BIT implicitely.
  • AG_Timer: Replace AG_ScheduleTimeout() (now deprecated) by new AG_AddTimeout() and AG_ReplaceTimeout() API.
  • AG_Treetbl: Updated version of John Blitch's original AG_Tableview.
  • AG_Widget: Cache a pointer to the parent window. Make routines such as AG_WindowUpdate() more efficient.
  • AG_Widget: Allow AG_WindowFocus() to fail.
  • AG_Widget: New function AG_WidgetUpdate(). Allow widget code to request widget and window redraw asynchronously. This helps avoiding expensive searches in common cases. Use of AG_WindowUpdate() within widget code is now deprecated.
  • AG_Widget: New function AG_WidgetSurface() to render GUI widgets to a software surface.
  • VG: The library can now be built without ag_gui. This is useful for command-line tools that must process VG object files.
  • Updates to the manual pages.
  • VG_Text: Implement Variable substitution within the text element.

Fixed

  • AG_Console: Fixed scrolling behavior.
  • AG_Label: Fixed clipping when partially occluded.
  • AG_Menu: Fixed rendering problems and cosmetic issues.
  • AG_Pane: Fixed multiple issues. Fixed the case where AG_PaneMoveDivider() was called before the window is first shown. Fixed incorrect documentation of the DIV flag. Handle zero-size correctly.
  • AG_Table: Fixed a bug in the initialization and cleanup of cells containing embedded widgets. Improved handling of out of memory conditions.
  • AG_Text: Fixed a font engine bug which prevented further reinitialization of Agar after finalization. Thanks Naiina!
  • AG_Timer: Avoid unnecessary list traversals when scheduling timeouts.
  • AG_Widget: Fixed incorrect parsing of <N>px specifications in AG_WidgetParseSizeSpec().
  • AG_Window: Handle the case where an event handler of a MODAL window creates another modal window. We now keep a separate stack of modal windows.
  • AG_Window: Fixed behavior problems with the focus cycling (tab key) algorithm that could not handle certain container configurations.
  • AG_Window: Fixed cosmetic problems with decorative window frames and resize controls.
  • VG: Fixed incorrect rendering of VG_Polygon.
  • Handle the loss of GL context (which can occur on some platforms following a window resize) by backing mapped surface textures to software and then restoring them afterwards. It would be nice to be able to test whether this fix is needed or not, as it may impact the performance of window resize operations in multi-window systems.
  • Improve handling of out-of-memory conditions.

[1.3.3] - 2008-10-30

Added

Changed

  • AG_Widget: AG_WidgetDraw() no longer recurses over the child widgets. This allows container widgets the ability to control clipping as well as to tweak the appearance and to define order of rendering of their child widgets.
  • AG_Window: Make the widths in pixels of side and bottom window borders configurable (applicable to single-window modes only).
  • AG_Widget: Improvements to clipping and culling. Clipping is now done according to the intersection of a stack of clipping rectangles. The former CLIPPING option flag has been replaced by AG_PushClipRect() & AG_PopClipRect().
  • Don't create application data directories by default unless AG_CREATE_DATADIR is passed to AG_InitCore().
  • Fixes and improvements to the manual pages. Added EXAMPLE sections. Describe conventions in AG_Intro AG_Threads.

Fixed

  • AG_Table: Fixed problems related to sizing, rendering and event delivery of embedded widgets. Thanks sacrebleu!
  • Fixed a build problem with AltiVec under MacOS X 10.4.
  • Fixed behavior and appearance of widgets when sizing down to small sizes.

[1.3.2] - 2008-03-02

Added

Changed

  • AG_Editable: New low-level text edition widget. It implements the functionality formerly in AG_Textbox. Textbox now works as a proxy which adds a text label, padding and scrollbars in multiline mode.
  • AG_Widget: In GL mode, maintain the stack of saved clipping planes in the Widget structure itself so we don't need to worry or make any assumptions about GL-implementation-specific limits.

Fixed

  • AG_Table: Fixed behavior of scrolling when using a mouse wheel. Fixed issues with keyboard navigation.
  • AG_Text: Fixed multiline text rendering in AG_TextRender(). Thanks Renato Aguiar!
  • AG_Textbox: Fixed problems with multiline text edition.
  • AG_Titlebar: Fix a bug in the truncation of the caption label.
  • AG_Tlist: Fixed issues with keyboard navigation.
  • AG_Widget: It is now safe to call AG_WidgetMapSurface() from any context or thread. Under GL drivers, use queueing such that the underlying texture upload will be deferred until rendering context.
  • Cosmetic fixes in the default theme. Fixed clipping plane off-by-ones in GL mode.
  • Fixed compilation problems related to numerical limits on some platforms.
  • Fixed compilation problem under MacOS X 10.5.
  • Fixed multiple thread-safety problems. It is now safe to combine multiple threads and OpenGL drivers. The big VFS lock has been removed (AG_LockVFS() now acquires the lock of the VFS root of its argument.
  • Fixed the build option --enable-nls. Updated French translation.

[1.3.1] - 2007-12-03

Fixed

  • Fixed compilation issues when compiling under C++.

[1.3.0] - 2007-11-29

Added

  • AG_Button & AG_Checkbox: New "flags" binding, for controlling bits in an integer based on a given bitmask.
  • AG_Config: New settings "tmp-path" (temporary directory path) and "initial-run" (program runs for the first time).
  • AG_CPUInfo: New interface to obtain information about architecture extensions. New function AG_GetCPUInfo().
  • AG_DataSource: New extensible API to replace the former AG_Netbuf.
  • AG_File: New functions AG_GetSystemTempDir() & AG_FileDelete().
  • AG_FileDlg: New functions AG_FileDlgCheckReadAccess() & AG_FileDlgCheckWriteAccess() for overriding the default behavior of "OK" and "Cancel" buttons.
  • AG_FileDlg: New function AG_FileDlgSetDirectoryMRU(). Sets the initial directory according to the given persistent MRU parameter.
  • AG_Label: New option NOMINSIZE to display a truncated "..." if the text is partially hidden. Used in AG_Titlebar.
  • AG_Numerical: New numerical edition widget which can handle both integer and floating-point bindings. Intended as a replacement for both AG_FSpinbutton and AG_Spinbutton.
  • AG_Object: New function AG_RegisterClass() to simplify the class-registration process.
  • AG_Object: New functions AG_ObjectGetArchivePath() & AG_ObjectSetArchivePath().
  • AG_Object: Simpler inheritance mechanics. The object system now implicitely invokes object operations (such as init() and destroy()) of all parent classes in addition to the current class.
  • AG_Object: Version checking in AG_ObjectLoad(). The version of serialized objects is now compared against that of the registered class. The load() operation now accepts an optional AG_Version argument so version differences can be handled programmatically.
  • AG_Object: AG_ObjectDestroy() now free()s automatically objects that do not have the STATIC flag set.
  • AG_Object: New functions AG_ObjectLoadGenericFromFile & AG_ObjectLoadGenericFromFile for loading only the metadata or only the data part of a serialized Agar object.
  • AG_Object: New option NAME_ONATTACH to atomically assign new objects a unique name on attach. New function AG_ObjectGenName.
  • AG_ProgressBar: New widget which binds to an integer value and range.
  • AG_Radio: Add support for hotkeys.
  • AG_Socket & AG_Icon: New widgets for implementing drag-and-droppable icons. See the demo under demos/sockets/.
  • AG_Style: New API for style attributes. New function AG_SetStyle().
  • AG_Text: Add support for built-in fonts (fonts bundled into the ag_gui library). This is useful for Windows and other platforms where relying on files is inconvenient.
  • AG_Text: Use a stackable states to handle rendering attributes such as fonts, colors and justification.
  • AG_Text: Handle multiline text in AG_TextRender(). Added configuration setting "Text Antialiasing".
  • AG_Text: New canned dialog AG_TextWarning(). Make it ignorable (include a "Don't show again" checkbox).
  • AG_Widget: New functions AG_WidgetEnable() & AG_WidgetDisable() to control the active state of widgets. New AG_WidgetBlitSurfaceGL() routine for blitting to transformed coordinates in GL mode.
  • AG_Widget: Introduce distinct size_request() and size_allocate() operations. size_request() is expected to return a preferred initial geometry that the widget would like. The parent container widget invokes size_allocate() to let the child widget know the size it was allocated.
  • MAP: New object class MAP_Actor.
  • RG: Implemented transform chains and caching of transformed items. Added static tile / animation mapping tables, so that external objects can rely on names not changing as items are added or removed.
  • [agarpaint]: New pixel and animation editor based on the RG framework. It provides a "header export" mode which we can use for icons. Introduce new icon sets, which were all done in agarpaint.
  • [agarrcsd]: New daemon which implements the server-side of a basic revision control system for serialized AG_Objects (needs --enable-network).
  • New demos and tests.
  • Added "Project files" for various IDEs. They are auto-generated by the build system using premake and distributed in the source .zip.
  • Added "STRUCTURE DATA" sections to manual pages so we can document public members. Thanks Julien Clement!

Removed

  • Removed the undocumented AG_HPane and AG_VPane interfaces, both replaced by AG_Pane.
  • Removed all remaining graphics-related code from ag_core library.
  • Removed ".den" files such as "core-icons.den". Icon resources are now baked in the ag_gui library so programs don't need to load any files on startup.

Changed

  • Upgrade build system to latest BSDBuild (formerly csoft-mk).
  • AG_Menu: Store items in a single tree (as opposed to separate trees). Improved handling of dynamic items and boolean states.
  • AG_Object: Renamed AG_ObjectOps -> AG_ObjectClass.
  • AG_Object: AG_ObjectChanged() call now performs an exact binary comparison (as opposed to comparing checksums).
  • AG_Table: Enforce a minimum column width when resizing columns.
  • AG_Text: Garbage collect entries in the glyph cache using a timestamp method.
  • AG_Window: Allow more than one MODAL window at a time.
  • Merged the former ag_compat library into ag_core.
  • Moved the "Object Manager", monitor and utilities from ag_gui to a separate library called ag_dev.
  • In the manual, avoid the generic void * when referring to Agar objects and refer to the type of the base class instead.

Fixed

  • AG_FileDlg: On select platforms use stat() to determine the accessibility of a file instead of open() which may cause problems with large directories. Thanks KOC!
  • MAP: Fix a crash bug when resizing node attribute grids.
  • RG_Tileview: Fix improper alpha-blending of controls under GL modes.
  • In single-window modes, allow windows to move outside of the view area. Thanks Phip!
  • Fixed compilation problem if defines such as HAVE_STDLIB_H have been set by some header.
  • Fixed some off-by-one differences in the way primitives are handled in GL vs. framebuffer modes.
  • Fixed compilation under Visual Studio 2005.
  • Thread-safety fixes in GL mode. Carefully avoid texture operations outside of rendering context.
  • Unwind definitions from Agar header files cleanly.
  • Make the build process portable on platforms without symbolic links (such as MSYS).