Select Options.Dump View  to bring up the dialog box to the left.  From this dialog, you can modify dump view settings.

The foremost subsection in this dialog is the formatting section.  From here, you choose the dump format (UTD or XML) as well as several global settings that apply to both UTD and XML formats.

Both UTD and XML formats also have their own subsections, which control how individual structure members are sequenced in the dumped data.

There are two types of value information that dump view generates:  numbers and strings.  You can control the precise conditions under which BARfly dumps a number or a string.

• General Formatting
  • Include construct type declarator in dump:  In UTD, you can optionally specify a declarator ("struct," "class," "block," or "fileformatframework") where a child of an organized block must appear.  If this setting is checked, BARfly dumps this declarator automatically for UTD format.  This setting does not impact XML format.
  • Include unorganized block unit count in dump:  Both UTD and XML have mechanisms for specifying an optional unorganized block unit count explicitly.  If this setting is checked, BARfly dumps unorganized blocks with a specified unit count.
  • Keep substructure children on same line:  In complex sets of dumped data, there might be many nested structures.  If this setting is checked, the number of lines needed for complex nested structures is reduced (line breaks separating members are replaced by spaces).
  • Keep unorganized block children on same line:  Unorganized blocks can get fairly long, requiring many line breaks between individual units.  If this setting is checked, the number of lines needed for the dump is reduced (line breaks separating units are replaced by spaces).
  • Ignore 'textual' attribute when dumping text block:  By default, BARfly dumps text blocks as text characters in both UTD and XML formats.  Uncheck this setting to treat text blocks the same way as any other unorganized block, which has individual units displayed as numbers.
  • Ideal line width:  This value acts as a rough boundary for dumped data as it is being generated.  It is not a de-facto margin, as dumped data can easily contain solitary sequences of characters significantly larger than this width.  BARfly checks how many characters are on the line being generated, and if this value is exceeded, a line break is automatically appended.
• XML / UTD Member Sequencing
  • Assignment statements:  UTD and XML both support assignment statements.  BARfly dumps structure members using assignment statements if this setting is chosen.  For XML, you must choose between two different types of assignment statement:  XML tag "boundary" assignments, and XML attribute assignments.
  • Sequential members:  UTD and XML both support sequential member assignments.  BARfly dumps structure members in the order of declaration if the setting is chosen.  This option takes up less print than assignment statements, but it makes dumped data substantially harder to read.
• Numbers
  • Numerical base:  Choose between decimal, hexadecimal, octal, and binary.  You can provide a number in any base you want while editing values, but BARfly explicitly dumps values in this base by default.
  • Sign casting:  Two's complement integers can be treated as either signed or unsigned, depending on how they must be interpreted.  By default, BARfly uses the "unsigned" and "signed" type qualifiers for a variable to determine how to dump its value.  You can force BARfly to ignore such qualifiers in favor of just-signed or just-unsigned interpretation.
• Strings
  • Integer casts to short strings:  By default, BARfly dumps the types char, short, and long as integers.  You can change these settings to instead dump the contents of these types as short strings.  For example, a char value of 65 will instead dump as 'A,' and the little-endian short value of 23117 will instead dump as 'MZ.'
  • Short array casts to short strings:  By default, BARfly dumps two-byte character arrays and four-byte character arrays as short strings.  You can override these settings by clearing the appropriate check boxes.  If unchecked, such arrays are instead expanded to a bounded sequence of numbers.
  • Dump arrays of chars as strings:  If you want to dump larger arrays of characters as strings than just two-byte and four-byte varieties, set a minimum array size, in characters, that will dump as a string.  Larger arrays are instead expanded to a bounded sequence of numbers.

  See also: [Data file load settings] [Data file save settings] [Settings for loading and saving BAR implementation files]
[Node editing settings] [Tree control line info settings] [Subnode view settings]
[Dump view settings] [Text view settings] [Raw view settings]
[Memory and BAR_Services settings] [Message display settings] [Toggling tool windows]