TES4Gecko Sharpened Help

[Jimi diGriz]

This is a short (perhaps not so short) walk-through to demonstrate the features of TES4Gecko Sharpened.

Basic Navigation

To view the plugin, launch the application and click on the View button on the splash screen.

TES4Gecko Sharpened will automatically locate your Oblivion installation if you have installed the game from CD or from Steam.  

If you have used another installation method such as GOG please let me know as I don't have an example of that type of installation to test.

After you click on View you should see a list of plugin files.

Click on Oblivion.esm.  You should see the plugin details from the file header at the bottom of the screen:

Click on the Open button to open the plugin.  This will take several seconds.  You can also double-click on the file in the list to open.

You should see Oblivion.esm listed in a tree on the left of the screen.

Expand Oblivion.esm by clicking on the triangular arrow to the left of the name.

Expand Landscape Textures (LTEX).

Click on CHTerrainGrass01.  You should see the details of the record in the right pane:

Contrast this with what the Construction Set shows:

You will note that the names of the Grasses in the Landscape Texture details show up looking like hyperlinks.  You can click on them to navigate to the related record:

Clicking the Backwards button at the top left will navigate back to the Landscape Texture.

One of the goals of TES4Gecko Sharpened is to provide a consistent presentation of the different record types.

At present there are eight record types that have been at least partially "decoded" to show the detail attributes contained:

• Enchantments (ENCH)
• Grass (GRAS)
• Landscape Textures (LTEX)
• Magic Effects (MGEF)
• Regions (REGN)
• Sound (SOUN)
• Weather (WTHR)
• Worldspaces (WLRD)

If you view other record types in TES4Gecko Sharpened you will see the field structures in a fashion similar to that shown by the old Gecko.

Advanced Search

TES4Gecko Sharpened includes a basic search mechanism that supports looking for records by Form ID or Editor ID. 

If you enter Form ID 00043de5 and click on the search button, you will be shown the DementiaDarkSand01Grass record:

The tool also supports a more sophisticated search that allows searching for records with certain attribute values.

Click on the Advanced Search button  to the right of the basic area.

This will open the Advanced Search window where you can specify your search criteria.

The Object type selection provides a list of record types that have been decoded so far (see above).  Select Grass from this list.

Select Bound Radius from the Property list.  The next drop-down shows a list of operators.  Since Bound Radius is a number, operators appropriate to numbers will appear.  Select Greater Than and put the value 80 in the last box:

Click on the Search button at the bottom of the window.  Note that the Search results at the bottom of the window shows 47/108.  This means that of the 108 Grass records in the plugin, only 47 of them have a Bound Radius greater than 80.  These Grass records will appear in the tree in the main window.

You may wish to know which Landscape Textures make reference to these Grass records.

Click the Clear button at the bottom of the Advanced Search window.  This clears the current search allowing all records to be viewed in the main window.

Select Landscape Texture from the Object type list.

Select Grasses from the Property list.  You may recall that the Grasses property of the Landscape Texture record has a list of Grass records that you can navigate to.

Select References from the operator list.  Since the Landscape Texture Grasses property can only reference Grass records this object type is selected automatically.  The next Property list is indented to show that it "belongs" to the Grass object type referenced above.

The new Property list shows properties for Grass records.  Select Bound Radius and specify that you want values greater than 80.

Click the Search button at the bottom of the window.  The Search results now show 58/229, which indicates that it found 58 Landscape Texture records of the possible 229 that have references to Grass records with Bound Radius greater than 80.

Note that the search results show Landscape Texture records that have at least one reference to a Grass record with a Bound Radius greater than 80.  They could also reference Grass records with a smaller Bound Radius.

Export Search Results

Now that you can see 58 Landscape Texture records that match your search, you can export the list to a file.

Click on the Export Results button  in the main window.

This will open another window that allows you to specify the report structure.

The top of the window shows the object properties to include in the report.  By default the Editor Id for the found Landscape Texture records is shown.

In the drop-down list below the Name (Editor Id) property select Material Type.  This adds the Material Type to the report.

Next, select Grasses.  Notice that since the Grasses property refers to a list of Grass records a new section is added to allow you to include Grass properties in the report.  Select Name (Editor Id) and Bound Radius in this section to add them to the report.

Upon close inspection you will see that the Name (Editor Id) for the Landscape Texture records now contains duplicate values.  This is because these records reference more than one Grass record.  To make this clearer, select the Suppress Repeats checkbox for those properties in the report control area.  You should now be able to see the breaks for Landscape Texture records.

The Export button at the bottom of the window will allow you to save the report to a file.  You have the option of using commas, tabs, or vertical bars to separate the columns, allowing for import into a spreadsheet.

This shows the basic capabilities so far.

As you explore you will no doubt discover bugs and important features missing.  We are hoping to get some feedback on the overall approach and an idea of what to do next.