Output Messages Window: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
No edit summary
No edit summary
Line 1: Line 1:
Currently, ParaView's Output Window for messages from its internal code are text only,
The ParaView Output Window shows errors, warnings or debug messages coming from VTK, Qt or ParaView libraries.
presenting the whole information that may be useful to a developer.
 
Currently these messages are text only, presenting the whole information that may be useful to a developer.
The current output window has several drawbacks:  
The current output window has several drawbacks:  


* A message always contains the whole information, making it hard for users that do not need that to extract the relevant parts.
* A message always contains the whole information sent from a library, making it hard for users to extract the relevant parts.
* If messages are reported several times from the application, they are printed several times in the output window.
* If a message is reported several times, it is printed several times cluttering the output window.
* The user cannot filter out messages of a certain type.
* The user cannot filter out messages.


As an example we show the output window after an nonexistent variable is typed in the  
As an example we show the output window after an nonexistent variable is typed in the  
Line 13: Line 14:


We plan to redesign the Output Window to address these issues as follows.
We plan to redesign the Output Window to address these issues as follows.
By default, we only show actual message. We do not show the location of the error or the address.
By default, we only show the actual message. We do not show the location of the error or the address.
If a message is reported several times, a count is shown reporting how many times the message was repeated.
If a message is reported several times, a count is shown reporting how many times the message was repeated.
Note that the count is incremented only identical messages that come one after another.
Note that the count is incremented only for similar messages that come one after another.


In the next image, '''Type''' represents the type of message (Error, Warning or Debug (Info) - these would be shown using icons), '''Count''' shows how many
In the next image, '''Type''' represents the type of message (Error, Warning or Debug (Info) - these would be shown using icons), '''Count''' shows how many
Line 29: Line 30:
A user can filter messages in two ways: by message type or by message text.
A user can filter messages in two ways: by message type or by message text.


A user can filter the list by message type by clicking on the '''Filter All''' drop down menu. Choosing one message type will show in the table all messages of that type and higher. So choosing Warning shows Warnings and Errors but does not show Debug messages. The '''Clear''' button clears all messages from the Output Window.
A user can filter the list by message type by clicking on the '''Filter All''' drop down menu. Choosing one message type will show in the table all messages of that type and higher. So choosing Warning shows Warnings and Errors but does not show Debug messages.  


A user can filter the list by message text by right-click on the message that he wants to be hidden and choosing '''Filter'''.
A user can filter the list by message text by right-click on the message that he wants to be hidden and choosing '''Filter'''.
Line 35: Line 36:


The hidden message will not be shown in the list. If the user want the message back in the list he can select it from the '''Show Filtered''' list. The '''Show Filtered''' button has a different icon if it has
The hidden message will not be shown in the list. If the user want the message back in the list he can select it from the '''Show Filtered''' list. The '''Show Filtered''' button has a different icon if it has
items in its list or it it hasn't.
items in its list or not


[[File:show-filtered.jpg]]
[[File:show-filtered.jpg]]
The '''Clear''' button clears all messages from the Output Window.

Revision as of 16:36, 19 January 2015

The ParaView Output Window shows errors, warnings or debug messages coming from VTK, Qt or ParaView libraries.

Currently these messages are text only, presenting the whole information that may be useful to a developer. The current output window has several drawbacks:

  • A message always contains the whole information sent from a library, making it hard for users to extract the relevant parts.
  • If a message is reported several times, it is printed several times cluttering the output window.
  • The user cannot filter out messages.

As an example we show the output window after an nonexistent variable is typed in the Calculator window.

Output-window-original.jpg

We plan to redesign the Output Window to address these issues as follows. By default, we only show the actual message. We do not show the location of the error or the address. If a message is reported several times, a count is shown reporting how many times the message was repeated. Note that the count is incremented only for similar messages that come one after another.

In the next image, Type represents the type of message (Error, Warning or Debug (Info) - these would be shown using icons), Count shows how many times a message was repeated, Details column will be shown using an icon: > for short message and V for long message. Note that the table header is shown for illustration purposes, it will not be part of the final table.

Output-window-short.jpg

If a user clicks on a message, the row will expand and the whole information will be shown.

Output-window-long.jpg

A user can filter messages in two ways: by message type or by message text.

A user can filter the list by message type by clicking on the Filter All drop down menu. Choosing one message type will show in the table all messages of that type and higher. So choosing Warning shows Warnings and Errors but does not show Debug messages.

A user can filter the list by message text by right-click on the message that he wants to be hidden and choosing Filter. Filter-message.jpg

The hidden message will not be shown in the list. If the user want the message back in the list he can select it from the Show Filtered list. The Show Filtered button has a different icon if it has items in its list or not

Show-filtered.jpg

The Clear button clears all messages from the Output Window.