Output Query

Loads and manages the outputs of a single query. Each OutputQuery represents a single group of outputs

ctor OutputQuery ( string settingsXML )
string GetXmlString ( )
  • OutputQuery ( string settingsXML )

Creates a new query, based on the passed in XML String.

  • GetXmlString ( )

Returns the current XML String with any modifications made, such as PREVIOUSSELECTIONLOCK

Output Query Settings

The Query is entirely defined by it’s settings file. Here is what the full file looks like, and each part is explained in detail further below.

<?xml version="1.0" encoding="utf-16"?>
<Query
        Name="DefaultQuery">
        <Settings>
                <RepeatSelection
                        Enabled="True">
                        <RepeatSelectionWeight>3.0</RepeatSelectionWeight>
                        <PreviousValuesTracked>2</PreviousValuesTracked>
                        <DiminishingWeight>True</DiminishingWeight>
                </RepeatSelection>
                <GroupBinding
                        Enabled="False">
                        <AllowDuplicates>False</AllowDuplicates>
                        <GroupRepeatMultiplier>2.0</GroupRepeatMultiplier>
                </GroupBinding>
                <SelectionLock
                        Enabled="False">
                        <Lock>OutputName2</Lock>
                </SelectionLock>
        </Settings>
        <Output>
                <Name>OutputName1</Name>
                <Skill>
                        <Name>Parry</Name>
                        <Value>0.5145</Value>
                        <Weight>1.0</Weight>
                </Skill>
                <Skill>
                        <Name>Dodge</Name>
                        <Value>0.1521</Value>
                        <Weight>1.0</Weight>
                </Skill>
        </Output>
        <Output>
                <Name>OutputName2</Name>
                <Skill>
                        <Name>Parry</Name>
                        <Value>0.5145</Value>
                        <Weight>1.0</Weight>
                </Skill>
                <Skill>
                        <Name>Dodge</Name>
                        <Value>0.1521</Value>
                        <Weight>1.0</Weight>
                </Skill>
        </Output>
</Query>

Outputs

Each output’s name corrisponds to a string that the query can potentially return. Each output has a list of skill values that are defined as such

Skill

  • Name: The case-sensitive name of the skill in the Profile
  • Value: The estimated amount of that skill this output is associated with
  • Weight: How much weight this skill has to the overall output evaluation. A skill with a weight of 2.5 would be added to the average 2 and a half times (and increase the total count by 2.5 instead of just 1)

Repeat Selection

If enabled, causes the Query to keep track of previously output values and it will try to prevent them from happening again.

  • Previous Selection Weight

If a selection has already been selected, causes it’s challenge delta (how far from your desired challenge number it is) to be multiplied by this much.

For example, if you have two outputs that evaluate to 0.1 and 0.2, and a repeat selection weight of 3, the 0.2 would be chosen instead of the 0.1 if it was in the list of previous selected values.

  • Prevous Values Tracked

How many selections will need to be made before one will be no longer tracked.

  • Diminishing Weight

if true, causes the older selections in the list to be modified by less than the newer ones.

Given previous selections 1 2 and 3 and a previous selection weight of 9.0, this setting would cause 1’s weight to be 3.0, 2’s weight to be 6.0, and 3’s weight to be 9.0

Group Binding

If enabled, this query will be treated as a Group Query. This means that it is setup for each output to be a single part of a whole, such as individual enemies in an encounter.

  • Allow Duplicates

If true, allows the query to select more than one of the same output in a single evaluation.

  • Group Repeat Multiplier

If allow duplicates is enabled, the challenge delta of a group (how far from your desired challenge rating it is) will be multiplied by this number for every extra duplicate.

For exaxmple, a group containing 1, 1, and 2 would be multiplied by the repeat multiplier once.

Selection Lock

If true, this query will remember the previous returns and never allow them to be repeated. This can be useful for things such as choosing the next level to go to without wanting the same one twice. These will be saved into the profile

<SelectionLock
        Enabled="False">
</SelectionLock>