Read Me

ArcXtra is a set of extensions to ESRI ArcGIS Desktop 9.3 software that add functionality that enhances productivity and usability:
Part of the functinality needs to configured in the ArcXtra Configuration files (.axc) located in the installation directory.
These configuraion files are xml files that are loaded when ArcMap is launched. Any changes in the axc files will recognised
only after restarting ArcMap.

1) ArcXtra Focus:
This extension aims at finding a feature in a layer by its key attributes. The toolbar consists of 2 ComboBoxes and a Command Button.
The ComboBoxes are populated from the ArcXtraFocus.axc file. First ComboBox is a alist of Layers that one may want to Focus on a feture from them.
The 2nd ComboBox list different sets of Attributes to query on for the selected layer in the 1st ComboBox. Afte choosing the the in ComboBoxes the
set of paramaters one wants, cliking the Focus Command Button will launce a windows popualated with optinal Field values comboboxes and differet modes of Focusing
operations. Choosing from top down values in the comboboxes and then clicking the small arrow buton next to collects tha values of the specific attributes you chose
and the lst one focuses on the feature. Changing the modes at the bottom will chabge the beahviour of the Focusing.

2) ArcXtra Geomtery:
Easily create polygonal geomtery graphics from features and other graphics. The toolbar consists of the following operations:
2.1) Create Shape - This command will collect all poygonal geomteries from selected graphics and selected features in all the layers in the current
DataFrame into a new polygonal graphics.
2.2) Drop Ms and Zs - Still in Beta.
2.3) Delete all Graphics - Deletes all graphics in the current DatatFrame.
2.4) Clear Selection - Clears all the selection from all layers in current DataFrame.
2.5) Set Symbology = Will open the Symbology panel to choose a different symbology for
the resulting graphics created by the Create Shape Command (see 2.1).

3) ArcXtra Layout:
Creation of predefined layouts. The Layout are defined in the ArcXtraLayout.axc file. In the axc files one defines different sets of layouts
by dividing the pages into frames and adding different layout elements into each frames. Each element has a set of properties one can set.
Most of the elements: frame borders, titles (text elements), images (logo elements from JPG, BMp GIF etc.), scale text and so on, will
be recreated each time a layout is generted. The OverviewMap elemnt will look for an addiotional DataFrame other the current one, and will
use it as a Overview map. If there are more the two DataFrames the Last DataFrame will be used for as the OverviewMap. The Legend element will
look for a precreated Legend and just resize and reposition it (sadly this sometimes has the unfortunate side result of messing with the symbol
patch size in the Legend). In Multi-DataFrame layouts the DataFrames will be used by thier order in Table of Contents. A more advanced set of
elements are "Action Elements" that can be used to "Select by Attribute", "Focus", "Select By Location" and "Generate Report table from selection" and
"Clear Selction". These action can enable creation of workflow layouts that get addiotional input from the user and create moer specialized layouts.
This extension also adds a coordinate grid for each DataFrame. This Grid is called "ArcXtra Grid" and it is updated automatically to suitable step
values for the current extent. This grid cannot be deleted, but one can turn it off by uncecking it's visibilty in the Grid tab of the DataFrame
Properties dailog box.
The Toolbar has the following operations:
3.1) Layout Combobox - A list of layouts as defined in the axc files. There's an thumbnail representaion of the layout created from the axc file
for each layout.
3.2) Create Layout - Clicking this command button will first open the Page Setup dialog box. After that is will prompt the user for Text Elements
while genrating the layout.
3.3) Validate Layout - This command will check to see if the Layout is within printable bounds.
3.4) Rezise layout from SnapGuides - This command will turn on SnapGuides that correspond to frames of the currents layout. Moving the SnapGuides
and recreating the layout with the Create Layout command (3.2) will move the frames according to the new postion of the SnapGuide. Cliking this
again will turn of this option the Create Layout command will retun to the default setting defined in the axc file.
3.5) Round Scale - This will roundf the scale upwrds to the closest "nice" scale value.
3.6) Increase Scale Value - This will zoom out by "nice" scale values;
3.7) Decrease Scale Value - This will zoom in by aproximatly have and then round the scale up to "nice" scale.
3.8) Toggle Grid Lines Visibilty - This will toggle on or off the grid lines for the automatic ArcXtra Grid. On turning on it will prompt for
the grid line symbol.
3.9) Refresh Legends - Toggles autmatics resize and reposiotion of Legend Elements on extent changes (that is pan, zoom and scale changes operaions)
after the layout is generated.
3.10) Sync DataFrames - Toggle syncing of DataFrames extents in Multi-DataFrames layout (including DataFrames used as OverViews). After clicking it
will prompt the user for a sync factor. while on the other dataframe will sync thier extents enlarged by the times the facor chosen with the main
ataframe's enxtent chnges (that is pan, zoom and scale changes operaions)

4) ArcXtra Query:
Using the ArcXtraQuery.axc file one can add predefined SQL queries that return a html formated result to a dockable window.
IMPORTANT NOTE - This extension only communicates with Microsoft SQL Server at this stage.
The Toolbar has the following operations:
4.1) Query List - Choose the query you wish to use.
4.2) Execute Query - Clicking this tool and then Clicking on the map will try to find a value from the map and use it in the SQL Query defined in
the axc file.
4.3) Show/Hide WebBrowser - Toggle the WebBroser docable window. This window will display the query's results.


5) ArcXtra Statistics:
This extension is for sampling and calculating statistics on the Layers in the active DataFrame. It will create polygonal sample areas
and calclaute sums for all the visible numeric fields in the visible layers of features in the sample areas. The fields aliases are used
in the sample report. For each row in the report there an totals sum coloumns summing all the fields, Clearly this column has meaing only when
the fields chosen for the report are of similiar meaning.
The Toolbar has the following operations:
5.1) Sample Count - set the samples in the sample set.
5.2) Sample Radius / Buffer Distance - Depending on the tool used and type of geomtery will be a radius or buffer distance while creating the
sample polyogns.
5.3) Interactive Sample - Clicking on the map will create circular polygons interactivly according to the count set in Sample Count (5.1).
If "Sample Radius" > 0 (5.2) it will be used as the Circle radius, if it is 0 then each circle will need two clicks to define it, 1st for the
center and the 2nd for the Radius.
5.4) Create Sample from Selected Graphics - Will create a polygonal sample from the selected graphics. If its polyogn it just use it. If it's
a line or point it create a buffer polygon using the "Sample Buffer Size" (5.2).
5.5) Create Sample from slected Features - Will create a sample from selected geomtries in all layers (visible or not,  so take care). It will
create sample polygons in a similar way to (5.4).
5.6) Samples - This accumaltes all the sample sets in the currewnt session. One can delete a sample set using the Delte key on the keyboard.
Using Control-Delete will delete all the samples.
5.7) Calculate sample and open report - this will recalucaulte the sample chosen in (5.6). if graphics were moved and or the sampled layers
attribute data was changed, then these changes will be taken into account.
5.8) Export Sample Set into FeatureClass - Not yet Implementd... Sorry :-).
5.9) Set Graphics symbology - You can change the sample graphics symbology using this command.
5.10) Delete All Graphics - Will delete all graphics objects in the current DataFrame.
5.11) Show/HIde WebBrower - Toggle visiblity of the report window.

6) ArcXtra Toc:
This extension adds functionality to the layers Table of Contents. It has no Toolbar. It add a new "Properties" tab and many new commands on the
Context Menu (i.e. Right-Click) of the nodes of the tree in the Display Tab (i.e. the main layers list).
It adds the follwing operations:
6.1) Properties Tab - A new tab in the Table of Contents. It consists of a ComboBox at top the chooses the specific layer property one wants to
get info about. The properties are as follwos: Defintion Queries, Labels, Layer Scale Limits, MapTips, Scale Symbols, Transparency. After choosing
a property, then the checkmark will tell you if the property is set or not. If set the hovering on the layer will give a baloon tip detail of the
property if appicable.
6.2) DataFrame or GroupLayer Context Menu has the following new commands:
6.2.1) Turn All Child Layers On - This will turn on recursivley all the layers under the current node clicked.
6.2.2) Turn All Child Layers Off - This will turn off  recursivley all the layers under the current node clicked.
6.3) Layer context menu:
6.3.1) Turn On Layer and Group - Will Turn on the visibilty of the layer and all parent group layers. This will make sure the layer is visible.
take care that if there are more layer in the same group/s and they are visible then they will be visible too.
6.3.2) Turn On only this layer in Group - This will turn on a layer in turn off all ther layer in its group.
6.3.3) Symbology Presets - Predefined alternate symbologys. This are defined in the ArcXtraToc.axc file.
6.4) Feature Layer context menu:
6.4.1) Use Defintion Query - Toggle on/off the Defintion Query if defined.
6.4.2) Symbology Filter By Extent - This toggles a filter by extent for the symbology. Symbology vlues not present in the current extent wil be
filtered out. Changing the extent will automatically update the symbology. Take care as this may slow ArcMap, as the selection needed for this
filter may be "heavy".
6.4.3) Symbology Sort - If a layer is symbolized using catergories this will sort the values in the correct way for the underlying string, numeric
or date values of the attribute. It will ignore domain values.


7) ArcXtra Web:
This is an experimental extension that displays the results of a Web query in a WebBroser dockable window inside ArcMap. It is different from
Hotlink functionality of ArcMap. Hotlink uses attribute to query a web url. This extension gets the decimal degrees coordiante of the mouse
click and uses that. If one passes decimal degrees coordiantes to google maps one gets a map of that area. If one has other sites that use
coordinates in a query then they can be added using the ArcXtraWeb.axc file.