TL:DR;

• This is a maintenance release with a handful of fixes.
• Raspberry Pi 4 (python 3.7) is now supported.

Version 1.0 availability as of now:

Changelog

Fixes

• fix (mvItemRegistry): color map render order to fix #1335
• fix (themes): fixed enabled/disabled theme setting issues
• fix (mvTable): fixed tooltips not working in table #1255
• fix (mvCollapsingHeader): fixed default_open #1327
• fix (mvNodeLink): fixed node link theme bleeding #1269
• fix (mvItemRegistry): temp. fix for delayed search not cleaning up
• fix: fixed themes not binding to node attributes #1320 (#1329)
• fixed show_item_registry() not rendering widgets #1321

misc

• removed unused keywords from a few items
• reduced Linux wheel sizes from 80mb to ~3mb (thanks mindv0rtex)

News

Well folks, this has been a long 17 months but we are finally here. Please at a minimum read the changelog and checkout the Gallery at the end of this release! Also checkout the Founding Sponsors and Retiring Tiers Announcement. You have until the end of day October 14th to be included! If you should be included but were not, please let us know (check the about menu).

Version 1.0 availability as of now:

Raspberry Pi 4 will be available in a few days.

What to expect?

API & 0.8 Migration

The API is slightly more explicit, but migration effort should be minimal.

Deprecation

We will no longer break your code! We will use deprecation moving forward.

What can we break/change going forward?

1. Things in the experimental module.
2. Debug tools.

Bugs

Although this release should have the least number of bugs to date, there may be a few regression bugs as many of the underlying systems have been refactored entirely since 0.8 and we do not yet have meaningful regression tests setup. The primary focus for this release was stabilizing the API which we have now done. The current issues need to be reevaluated for this release.

Maintenance Releases

There will most likely be frequent maintenance releases over the next weeks.

Documentation & Tutorials

The docs are being worked on everyday and will continue to be worked on and expanded. There are a few edge features and details that have not been fully documented. We will also be starting back the YouTube tutorial series!

Previous Versions

We will maintain v0.6.415 and v0.8.64. If you have another version as part of a project's requirements, update or vendor the wheel because we will be removing the rest of the wheels to free space for pypi.

Future

1.0 is just the beginning. There is still a lot of work to be done and a lot of exciting stuff coming down the pipeline. We will have to be more careful moving forward but that will not stop the momentum!

Integration

We plan on looking at integration with other libraries (i.e. pygame). Not to mention the 3D engine we are working on.

Platforms

We still want to bring in mobile (and maybe web eventually).

Contributors

We are continuing to cleanup and document the backend to facilitate a more contributor-friendly codebase. As you all know, the wiki is now going to be the contributor documentation.

Change Log

Breaking Changes

• user must create Dear_PyGui context with create_context() before calling any DPG commands
• changed dragPayload drag_data is submitted to the targets drag_callback rather than drop_callback
• moved logger and themes to DearPyGui_Ext
• table rows now required
• removed bind_item_disabled_theme(...)
• removed bind_item_type_disabled_theme(...)
• removed bind_item_type_theme(...)
• user must create, setup, show viewport before starting dpg:
  • "create_viewport()->setup_dearpygui()->show_viewport()->start_dearpygui()"
• add_theme_color(...) and add_theme_style(...) must known belong to a theme_component

New

• module: added experimental (not in use yet)
• item: added add_table_cell(...)
• item: added add_spacer(...)
• item: added add_theme_component(...)
• command: added get_major_version(...)
• command: added get_minor_version(...)
• command: added toggle_viewport_fullscreen(...)
• command: added show_item_debug(...)
• command: added bind_theme(...)
• command: added highlight_table_column(...)
• command: added unhighlight_table_column(...)
• command: added set_table_row_color(...)
• command: added unset_table_row_color(...)
• command: added highlight_table_cell(...)
• command: added unhighlight_table_cell(...)
• command: added highlight_table_row(...)
• command: added unhighlight_table_row(...)
• command: added is_table_column_highlighted(...)
• command: added is_table_row_highlighted(...)
• command: added is_table_cell_highlighted(...)
• command: added context manager for add_plot_axis(...)
• command: added configure_app(...)
• command: added get_app_configuration(...)
• command: added add_item_set(...)
• command: added add_template_registry(...)
• command: added bind_template_registry(...)
• keyword: added drag_callback, drop_callback, payload_type to add_image(...)
• keyword: added drag_callback, drop_callback, payload_type to add_text(...)
• keyword: added drop_data to drag_payload(...)
• keyword: added xoffset to group(...)
• keyword: added id to popup(...)
• keyword: added clipper to add_table(...)
• added deprecation system
• callbacks will now send alias through the sender argument if alias is used.
• columns can now be programmatically hidden
• table "value" is now a string, which acts as a filter using the row filter keys
• texture id can be updated with configure_item(...) for texture based widgets

Deprecated

• item: removed table_next_column
• removed viewport keyword arg from setup_dearpygui(...)
• removed viewport keyword arg from show_viewport(...)
• keyword: removed drag_callback from add_menu_item(...)
• keyword: removed drag_callback from add_colormap_scale(...)
• keyword: removed drag_callback from add_colormap_slider(...)
• keyword: removed default_font keyword arg from add_font(...), use bind_font(...) now
• keyword: removed default_theme keyword arg from add_theme(...), use bind_theme(...) now
• keyword: renamed id keyword to tag
• command: cleanup_dearpygui(...) is deprecated. Use destroy_context(...)
• command: staging_container(...) is deprecated. Use stage(...)
• command: enable_docking(...) is deprecated. Use configure_app(docking=True, docking_space=dock_space)
• command: get_dearpygui_version() is deprecated. Use get_app_configuration()['version'].
• command: init_file(...) is deprecated. Use configure_app(init_file=file).
• command: load_init_file is deprecated. Use configure_app(init_file=file, load_init_file=True).
• command: is_viewport_created(...) is deprecated. Use is_viewport_ok().
• command: setup_viewport(...) is deprecated. Use create_viewport()->setup_dearpygui()->show_viewport().
• command: set_item_theme(...) is deprecated. Use bind_item_theme().
• command: set_item_type_disabled_theme(...) is deprecated. Use bind_item_type_disabled_theme().
• command: set_item_theme(...) is deprecated. Use bind_item_theme().
• command: set_item_type_theme(...) is deprecated. Use bind_item_type_theme().
• command: set_item_font(...) is deprecated. Use bind_item_font().
• command: add_activated_handler(...) is deprecated. Use add_activated_handler().
• command: add_active_handler(...) is deprecated. Use add_item_active_handler().
• command: add_clicked_handler(...) is deprecated. Use add_item_clicked_handler().
• command: add_deactivated_after_edit_handler(...) is deprecated. Use add_item_deactivated_after_edit_handler().
• command: add_deactivated_handler(...) is deprecated. Use add_item_deactivated_handler().
• command: add_edited_handler(...) is deprecated. Use add_item_edited_handler().
• command: add_focus_handler(...) is deprecated. Use add_item_focus_handler().
• command: add_hover_handler(...) is deprecated. Use add_item_hover_handler().
• command: add_resize_handler(...) is deprecated. Use add_item_resize_handler().
• command: add_toggled_open_handler(...) is deprecated. Use add_item_toggled_open_handler().
• command: add_visible_handler(...) is deprecated. Use add_item_visible_handler().
• command: set_colormap(...) is deprecated. Use bind_colormap().
• command: reset_default_theme(...) is deprecated. Use bind_theme(mvAll).
• command: set_staging_mode(...) is deprecated. No longer needed.
• command: add_spacing(...) is deprecated. Use 'add_spacer(...)`
• command: add_dummy(...) is deprecated. Use 'add_spacer(...)`
• command: add_child(...) is deprecated. Use 'add_child_window(...)`
• command: add_same_line(...) is deprecated. Use add_group(horizontal=True)

Fixes

• fixed get_item_configuration(...) memory leak #1179
• fixed issue to allow source to be alias #1181
• fixed window info not registering as container #1188
• fixed min/max clamping issue with input widgets #1229
• fixed using aliases for set/get value
• fixed issue with get_selected_nodes(...) #1263
• fixed listbox default value empty #1219
• fixed ellipse thickness keyword not working #1213
• fixed return type hints for callbacks #1208
• fixed modal xpos creep #1171
• fixed plot context/configuration sync issues
• fixed plot axis context/configuration sync issues
• fixed plot legend context/configuration sync issues
• fixed toggled_open_handler triggering for closed #1280

Thank you!

Dear PyGui development is currently funded by a handful of gracious sponsors and we would like to thank them tremendously. We wouldn't be here with out you guys.

Thank you for supporting us.

If you or your company uses Dear PyGui, please consider supporting us! We need it now more than ever.

Gallery

![image](https://user-images.githubusercontent.com/39973752/1370126...

News

• You can now use a string in place of an ID (similar to 0.6)! See here. This is optional but prevents users from needing to manage the UUID's manually!
• We are sticking with the names Dear PyGui and Dear Py3D!

Breaking Changes

• pmin & pmax were backwards in draw_rectangle(...). You need to reverse them. Related to #1163
• add_colormap_scale(...) keyword colormap now corresponds to mvColorMap widget

New

• feature: id can now be a string, but must be unique!
• command: added get_item_alias(...)
• command: added set_item_alias(...)
• command: added add_alias(...)
• command: added remove_alias(...)
• command: added does_alias_exist(...)
• command: added get_alias_id(...)
• command: added get_aliases(...)
• command: added get_item_registry_configuration(...)
• command: added configure_item_registry(...)
• widget: added add_colormap(...) #1069
• widget: added add_colormap_registry(...) #1069
• widget: added add_colormap_button(...)
• widget: added add_colormap_slider(...)
• command: added sample_colormap(...)
• command: added get_colormap_color(...)
• keyword: added mulicolor to draw_rectangle(...)
• keyword: added color_upper_left to draw_rectangle(...)
• keyword: added color_upper_right to draw_rectangle(...)
• keyword: added color_bottom_left to draw_rectangle(...)
• keyword: added color_bottom_right to draw_rectangle(...)
• constant: added mvPlotColormap_Twilight
• constant: added mvPlotColormap_RdBu
• constant: added mvPlotColormap_BrBG
• constant: added mvPlotColormap_PiYG
• constant: added mvPlotColormap_Spectral
• constant: added mvPlotColormap_Greys
• set_value(...) now works for theme_color #1136
• set_value(...) now works for theme_style #1136
• added use_internal_label keyword to all widgets, related to #1135

Fixes

• fixed setting default theme values
• fixed infinite on_close callbackss #1149
• fixed get_item_configuration(...) for window max_size
• fixed histogram misspelling issue related to #1132
• fixed adding font ranges over 0x10000 #1092
• fixed viewport issue for windows #1126

Other

• added colormap section to demo under "widgets"
• simplied drawing API demo

News

With version 0.7 just a few weeks away, we expect this to be the last 0.6 release. We will begin focusing solely on 0.7.

Version 0.7 will contain the final breaking changes and once all the obvious bugs and issues are addressed, it will be tagged 1.0! Be aware that 0.7 will contain the largest amount of updates, features, and breaking changes of any release thus far (and by far), however we believe once users begin to work with the improvements, they will agree it is for the best.

You will also notice @Pcothren and I have been less active in the discord server and github discussions but this is due solely to our focus being on 0.7's release.

In the following weeks, you will see the wiki beginning to split between 0.6/0.7 sections. We will also begin posting a running change log on the wiki so users can prepare for the upcoming changes.

If you have questions about any of the changes, please contact us.

Updates

• vcruntime140_1.dll: now included, addressing #563 and others
• tab_bar: "set_value" can now programmatically set the active tab #729

Fixes

• add_series: fixed axis 1 not being reset when plotting to different axes #744
• add_input_*: fixed multiple ran callback when using min/max values
• nodes: memory bad read/write related to deleting nodes
• add_input_int3 | add_input_float3 callback isn't working anymore #800
• fixed mac cpu unbound usage when window is covered
• Setting add_label_text color causes label text to change showing the hidden label name #803
• Adding textures at runtime did not work for linux #687
• Texture updates on MacOS cause crash #743

Changes

• Data Storage: now thread safe
• set_value: now thread safe
• get_value: now thread safe

New Commands

• Tab Button: Added add_tab_button command

New Keywords

• tab: Added no_reorder keyword
• tab: Added leading keyword
• tab: Added trailing keyword
• tab: Added no_tooltip keyword

Fixes

• tabbar: fixed tabbar callback
• drawing: fixed "originy" issue #309
• table: fixed spacing issue #297

VERSION 0.3.7 (9/14/2020)

Updates:

• ImPlot: upgraded to commit 4f0a09f

New Commands:

• Widgets: Added add_image_button command
• Plots: Added add_pie_chart command
• Plots: Added add_pie_chart_data command
• Plots: Added clear_pie_chart_data command
• Plots: Added add_stem_series command

Fixes:

• Threadpool: Fixed issue with threads freezing

VERSION 0.2.0 (9/5/2020)

New Features:

• Context Managers: You can now import dearpygui.wrappers to use context
  manager versions of all containers

Changes:

• Widgets: All "add_widget" commands now return true on successful
  adding or false.

Breaking Changes:

• Container Widgets: Replaced all end_* commands with a single end() command

VERSION 0.1.3 (9/4/2020)

• Label Text: Quick fix to label_text setting