[App] Eschaton 0.7.2 - Beta

Utilities designed primarily for Halo PC.
Post Reply
User avatar
Altimit01




Connoisseur Snitch! Literarian 500

Posts: 947
Joined: Sun Jun 04, 2006 12:10 pm

[App] Eschaton 0.7.2 - Beta

Post by Altimit01 »

Update: 0.7 Release

Click for larger image
Image

A big thanks to all of my beta testers. You've been an invaluable resource in tracking down bugs and errors, especially on the windows and linux versions.

Read Me:
Eschaton 0.7.2

©2008 Altimit01

Contents:
1.0 Preferences
1.1 General Preferences
1.2 Plugins Preferences
2.0 Interface
2.1 Windows
2.2 Open, Open and Expand, Expand
2.3 Extract, Recursively Extract
2.4 Find Tag
3.0 Meta Editing Features
3.1 Bitmasks
3.2 Colors
3.3 Enumerations
3.4 Floating Point Numbers
3.5 Indexes
3.6 Integers
3.7 Strings
3.8 Tag References
4.0 Special Tag Editing Controls
4.1 Bitm: Bitmaps
4.2 Mod2: Models
4.3 Scnr: Scenario
4.4 Snd!: Sounds
4.5 Ustr: Unicode Strings
5.0 Reference Swapper
6.0 Rebuilding
6.1 Internalization

1.0 Preferences
The preferences information is stored in the Data folder in preferences.xml. There are two tabs that cover different settings for Eschaton. When a major change in the preferences is applied, the maps folders will all collapse so as not to have left over UI elements from a previous preference setting. When the apply button is pressed the current preferences will be saved and the window will close. Closing the window without applying will not save those preferences.

1.1 General Preferences
The general preferences cover the main editing features of Eschaton. The meta folders option determines whether to organize the tags of a map by class or by name. If organized by class then like tags such as vehicles will be in one folder together. If organized by name then tags related to each other will be in the same folders. Organize by name splits tags by their name path so a tag called "levels\test\bloodgulch" would be in the test folder in the levels folder and be named bloodgulch.class where class is the tag class of that tag.

Explicit bitmap is an option that has Eschaton designate one bitmaps.map file to be used for all editing. Otherwise, Eschaton will check in the folder a target map is in for bitmaps.map and if there isn't one will ask to be directed towards one.

The meta editor style determines the main editing interface of Eschaton. Scrolling controls array the different editing controls on a scrollable surface so everything is visible at once. If the order controls by offset box is checked then those controls will appear in the order they are in the tag. With the box unchecked those controls will appear in the order they are in the plugin. Classic controls uses a split window with a hierarchical listbox for navigating what to edit on the left and the related editing control to the right.

1.2 Plugin Preferences
The most notable feature of the plugin preferences is the folder access order option. Every folder full of plugins in the plugins folder should appear in this list. Drag the folders into the order which you want Eschaton to search for plugins. When editing a meta, Eschaton will search through each plugin folder in order trying to find a plugin that applies to that meta. Since plugin folders can have both Entity style and HMT style plugins in them, it is necessary to specify which plugin to use if both are encountered when searching for an appropriate plugin. The show hidden feature for Entity style plugins enables hidden features that might not be properly documented or understood.

2.0 Interface
By default Eschaton should open with one window. The maps folder refers to map files that have been opened using the open and expand option. The maps (read/write only) folder contains the maps and tags that can be edited normally. The extracted tags folder contains information on tags that have been extracted for the purposes of rebuilding.

2.1 Windows
Each window is a self contained editing environment. Maps and tags expanded and extracted are tied to the window that was involved in those processes. It's possible to remove maps from the window by selecting the close map option from the file menu. This will free up space in memory and for windows users who can only access a file once it makes it possible to open and expand a map that's already open.

2.2 Open, Open and Expand
Open is the command that should be used for normal editing. It loads information about a map into memory and makes it possible to meta edit. Open and Expand loads all of the map data into memory and will take some time. Meta editing is not currently supported for expanded maps. The purpose of expanded maps are for rebuilding. Normally opened maps have in their information control the option to expand them.

2.3 Extract, Recursively Extract
The extract and recursively extract options take all the data for the target tag and load them into memory. This allows them to be imported into expanded maps. The recursive option recursively extracts all dependent tags related to the original so that all necessary files will be present when imported.

2.4 Find Tag
The tag search option uses a linear string search through tag classes and tag names trying to find any tags that match the input string. It works for all maps in all windows. There is an option to search for all terms, otherwise it will add results that satisfy any term. Double clicking on a result closes the search window and opens the target tag. The search only covers tags in maps.

3.0 Meta Editing Features
This section covers the basic editing features of Eschaton. Above the editing features, is the option to load a new plugin without having to alter preferences. Keep in mind this does not save what plugin was in use and changing to a new tag will load the default plugin for your preferences.

3.1 Bitmasks
Bitmasks contain multiple binary options. Checking a box enables the listed option and unchecking a box disables the option. The map is edited as soon as a box is checked or unchecked.

3.2 Colors
Colors are data structures that describe color information. Colors may or may not have an associated alpha channel that can be edited. Edits made via sliders, or color picker options are applied immediately.

3.3 Enumerations
Also called Enums and IDs, these integer data types have special meanings related to each integer value. Simply choose the desired option from the drop down menu and the map will updated with the correct value automatically.

3.4 Floating Point Numbers
Called Floats, Singles and Doubles, these data structures store decimal numbers. When editing, it is necessary to press enter in the edit field for the map to be updated.

3.5 Indexes
These are special integer data types that reference instances (chunks) of other reflexives. Changes are made as soon as an option is chosen from the drop down menu.

3.6 Integers
Basic integer values. When editing, it is necessary to press enter in the edit field for the map to be updated.

3.7 Strings
Strings are data structures for characters. The add null button adds a null character to the editing. In order to apply the edit press enter in the edit field.

3.8 Tag References
Known as dependencies and loneIDs, these data types reference other tags that the target tag relies upon. Changes are made automatically upon changing the dependent tag but not the dependent tag class.

4.0 Special Tag Editing Controls
This covers editing controls specific to certain tags.

4.1 Bitm: Bitmaps
The bitmap control has options for viewing, exporting and importing bitmaps. Bitmap tags can have multiple images within them. Cubemaps have six different faces. Each image will have mipmaps of different resolutions. For volume textures there are different layer images in differing amounts for each mip level. Load preview loads the image and if available the associated alpha mask. The extract and inject functions write directdraw surface (.dds) files and have the option to write bitmap data as new bitmaps in the bitmaps.map file. Export and import allow for exporting to any image file type but is otherwise the same without the option to inject as new bitmap data.

4.2 Mod2: Models
The model control allows for viewing of models, submodels, bones and attachment points. It is read only.

4.3 Scnr: Scenario
The scenario editor allows for editing of spawn points. Most maps won't be visible by default but sufficient zooming out (right along scroll bar) of the Z-axis will put the map into view. It is necessary to load the map data by pressing the load button. Editing of coordinates is performed through the object interface.

4.4 Snd!: Sounds
Sounds are organized into pitch ranges and permutations. For each pitch range there is the option to export a single permutation and all permutations. Ogg vorbis files need to use the vorbis codec which can be gotten from http://vorbis.com/.

4.5 Ustr: Unicode Strings
Unicode strings are used by the game for displaying messages. Select the message from the list on top and edit it in the edit field below. As with other interfaces it is necessary to press enter to apply changes.

5.0 Reference Swapper
This control lists all dependent tags for the target tag. Selecting a dependent tag updates the editing control on the bottom. It's possible to change the tag class and the tag name to a new dependent. Changes are applied after pressing the swap button. Double clicking a dependent tag opens that tag as the new target tag.

6.0 Rebuilding
The rebuild process is very straight forward. Open and expand the target map. Extract or recursively extract tags that are to be imported. In the rebuild control for the expanded map select the tags to be added from the listbox using the check boxes. By checking the do not import duplicates box, duplicate tags will not be imported. If the box is unchecked then duplicate tags will have a "+" appended to the end of their name. The rebuild button compiles the map and saves it as a new file.

6.1 Internalization
On expanded maps, it is possible to internalize bitmap and sound tags. Switch to the data internalize tab and select which tags to internalize. It is necessary to compile a new map using the rebuild button.
Additionally there are youtube tutorials/overviews:
Basic Editing
Advanced Editing
Bitmap Editing
Rebuilding

Downloads:
Filefront: Folder
Mediafire: Folder
Windows versions will have "win" in their names, Mac versions will not have any extra words. Linux versions will have "nix" in their names and will be released as soon as it's confirmed that there are no errors.

Edit: Updated to 0.7.1
Edit: Updated to 0.7.2

Updates as of 0.7.2
fixes:
Rebuilding: raw data rebuild order has been fixed so that it conforms to Halo map file standards. This fixes compatibility with conure's bitmap internalizer.
Reference swapper: for references with tag classes that have no tags in the map, will not default to using the scnr tag.
Search function: bug in the code did not properly search unless "all terms" was enabled. Has since been fixed so that searching for multiple terms that do not have to include all search terms is possible.
Classic controls, color picker: fixed so that the selected color is actually applied.

new features:
Plugin selection: have the option in the meta editor to change which plugin to use.
Tag importing: updated interface allows selection of tags to import by use of check boxes for more control.
Data internalization: bitmap and sound internalization has been added to expanded maps. It is necessary to compile a map with the rebuild button as expanded maps do not exist except in program memory.
Macs only, now accepts file drops of halo map files for editing.

known bugs:
Windows (possibly Linux): selecting a scnr tag and then another tag will lead to an error. Currently working on fixing this problem.
Attachments
Eschaton 0.7.2 nix.zip
Linux version
(3.48 MiB) Downloaded 17 times
Eschaton 0.7.2 win.zip
Windows version
(4.04 MiB) Downloaded 563 times
Eschaton 0.7.2.zip
Mac OS X version
(7.89 MiB) Downloaded 331 times
Last edited by Altimit01 on Wed Dec 24, 2008 4:05 pm, edited 33 times in total.
Image
Download Eschaton: Halomods | Filefront | Mediafire
User avatar
Ice Link





Posts: 357
Joined: Fri Nov 04, 2005 1:53 pm
Location: In front of my mac modding
Contact:

Post by Ice Link »

it actually does stuff i love u
btw how do you use it?
Image
Thanks to Jsk for my sig
User avatar
Alchemist666





Posts: 811
Joined: Sat Jan 14, 2006 6:25 am
Location: On a bulldog adventureing around halo! Posts:666

Post by Alchemist666 »

I <3you
Image
Armaggedon Mod Team|Pirates!|Universal HaloMods Rules
Halo_addict wrote:O_O Youre cooler than bob!!(and not an jerk!!)I need not say it...YOU are the new bob
User avatar
shadowkhas




Snitch! Socialist

Posts: 5423
Joined: Wed Jun 23, 2004 8:00 am
Location: Salt Lake City, Utah

Post by shadowkhas »

Looks nice. I assume that the empty space might be for future stuff? (Bitmap, sounds mb?)

Nice to see that someone who knows how to program stuff has taken their time to help people out. :) Good job.
(7:15:27 PM) Xenon7: I BRUK THE FIRST PAGE OMGOMGOMG RONALD REGAN
User avatar
Lambda





Posts: 365
Joined: Sun Sep 17, 2006 3:37 pm
Location: California

Post by Lambda »

wow, the things seen in this demo are extremely promising,the beginnings of a tag editor, I like the User Interface, and extra space for any future add-ons, you make me extremely happy. gj and thx
Image
softer on the eyes now
Guest





Posts: 17
Joined: Sun Jan 07, 2007 8:52 am

Post by Guest »

idk y i cant get this app to work, when i edit the tags and load the map the map appears blurred and i cant play it
Last edited by on Mon Feb 12, 2007 7:37 pm, edited 1 time in total.
Image

gamertag: boreddude13
cloud4058





Posts: 51
Joined: Sat Mar 12, 2005 8:32 am
Contact:

Post by cloud4058 »

I can explain why this is this is the same app. dont know why it doesnt work though.
User avatar
Ice Link





Posts: 357
Joined: Fri Nov 04, 2005 1:53 pm
Location: In front of my mac modding
Contact:

Post by Ice Link »

WTF are you talking about it works fine
Image
Thanks to Jsk for my sig
User avatar
WarHampster





Posts: 206
Joined: Thu Aug 03, 2006 5:22 am
Location: In a place.
Contact:

Post by WarHampster »

shweet
JOIN THE WARHAMPSTER MAC MOD TEAM: http://warhampster.editboard.com/ We have 81 users and counting!!!
Macsforever wrote:WHMT (Great site, keep it up Sam!)
blue_vistea





Posts: 75
Joined: Sat Jun 17, 2006 9:15 pm

Post by blue_vistea »

Awsome. This is coming along nicely. I cant wait to see the final version.
halomacmodder





Posts: 159
Joined: Thu Sep 07, 2006 3:16 pm

Post by halomacmodder »

If you dont have the full version of realbasic then you can pm me the code and ill compile it :D
User avatar
Jsk1610





Posts: 939
Joined: Sat May 27, 2006 1:23 pm
Location: Seoul/NJ

Post by Jsk1610 »

cool. can't wait til you can change clip sizes for weapons :D also i was a tester lol.
Image
User avatar
Altimit01




Connoisseur Snitch! Literarian 500

Posts: 947
Joined: Sun Jun 04, 2006 12:10 pm

Post by Altimit01 »

dang it. I knew I forgot someone. /edit
Image
Download Eschaton: Halomods | Filefront | Mediafire
User avatar
Ice Link





Posts: 357
Joined: Fri Nov 04, 2005 1:53 pm
Location: In front of my mac modding
Contact:

Post by Ice Link »

:D
compile compile!
Image
Thanks to Jsk for my sig
User avatar
Lambda





Posts: 365
Joined: Sun Sep 17, 2006 3:37 pm
Location: California

Post by Lambda »

>_< i was a tester too idc if U add me on too the list though
Image
softer on the eyes now
Christian910





Posts: 1
Joined: Tue Feb 13, 2007 2:24 pm

mod

Post by Christian910 »

nice! i've been waiting so long for something like this! i can't seem to find the dowload hyperlink though,
-Christian
User avatar
Jsk1610





Posts: 939
Joined: Sat May 27, 2006 1:23 pm
Location: Seoul/NJ

Post by Jsk1610 »

*cough*under the picture.
Image
Guest





Posts: 17
Joined: Sun Jan 07, 2007 8:52 am

Post by Guest »

lol
Image

gamertag: boreddude13
cloud4058





Posts: 51
Joined: Sat Mar 12, 2005 8:32 am
Contact:

Post by cloud4058 »

Well weve come up with a name I hope yall like it it's Eschaton. or the "Eschaton project" whatever...
User avatar
Ice Link





Posts: 357
Joined: Fri Nov 04, 2005 1:53 pm
Location: In front of my mac modding
Contact:

Post by Ice Link »

is it just a cool name or does it mean somthing?
Image
Thanks to Jsk for my sig
Post Reply