2.1 alpha 9 (2616)

 - Fixed: Regression: after updating investigators to use the
 pluralizer system, an investigator's starting clues are pluralized
 incorrectly when they start on an unstable location.
 - Fixed: Minor corrections/updates to the About dialog text.
 - Fixed: invisible preferences under Shoggoth theme.
 - Fixed: menu accelerators may fail to work because the
 enable/disable state may be out of date. A common case is opening a
 new code editor but finding that, say, Ctrl+S doesn't work until it
 is activated using the menu item at least once.
 - Fixed: possible NPE in CatalogID.compareDates when opening a
 catalogue with a missing id entry.
 - Fixed: renamed project files should be re-selected.
 - Fixed: when a folder is renamed, open editors of files that are
 children of the folder should have their save location updated to
 match the new parent folder.
 - Fixed: after jumping to a location in a code editor which has not
 previously been displayed, the starting state for some lines may be
 incorrect if they depend on the state of a previous line and the
 previous line has not been displayed. The most common case is that a
 multiline comment is not shown as a comment until the first line of
 the comment has appeared in the window.
 - Fixed: missing image results are cached, but installing a missing
 core could make the image available later.
 - Fixed: due to conflicting key names, New | Automation Script shows
 as New | Blank Script.
 - Fixed: Regression: Case Book Editor: double clicking on {#labels}
 in the preview view no longer searches for the label.
 - Fixed: Case Book Editor: after a successful search, event tree
 should scroll to ensure match is visible.
 - Fixed: Unable to create a deck/board after choosing to hide Arkham
 Horror components.

 - Incorporated the latest updates to the fr/fr_CA localizations by
 Marc Bélanger.
 - Incorporated es game text updates for BGotW by M.A.G. Espinosa.
 - Added StrangeEonsEditor[] getEditorsShowingFile( File f ) to
 StrangeEonsApplication. This has been implemented for a while, but I
 missed adding it to the interface.
 - Added a constructor for code editors that automatically chooses
 initial settings based on a content type:
       arkham.CodeEditor( File file, int codeType ) throws IOException
   (where codeType is one of the type values defined in CodeEditor:
   currently one of TYPE_PLAIN, TYPE_JAVASCRIPT, TYPE_JAVA,
   TYPE_PROPERTIES, TYPE_SETTINGS, TYPE_HTML, TYPE_UTF8,
   TYPE_CLASS_MAP, TYPE_SILHOUETTES, TYPE_TILES, TYPE_CSS).
- Added syntax highlighting for regular expression literals to
JavaScript tokenizer.
- Added CodeEditor.Navigator implementation for property/setting
files.
- Added CodeEditor.Navigator implementation for JavaScript files. It
isn't very good because it uses regular expressions instead of a
lexer, but it is better than nothing when editing large scripts.
- Added CodeEditor.Navigator implementation for HTML files.
- Added support for icons to CodeEditor.Navigator and a set of
standard icons (but custom icons can be used as well).
- Minor usability improvements to automatic update system.
- Added a preview panel to the file chooser for game components
similar to the one for image files, and improved preview panel look
and feel.
- CodeEditors implement the ScriptEditor interface (see below),
allowing you to add new editing commands and modify editor content.
- Added the ability to register "games" and to associate an expansion
with a particular game. The private setting "game" on a component is
used to store the code of the game the component belongs to, if
applicable and known. The built-in components have all been upgraded
so that they are associated with Arkham Horror (code AH), with the
exception of the Marker/Token component, DIY components, and decks,
which are not associated with any game by default. The relevant
GameData method signatures are:
	public static void registerGame( String code, String gameName )
	public static String[] getRegisteredGames()
	public static String getGameName( String code )
	public static void setGameForExpansion( String expansionCode,
	        String gameCode )
	public static String getGameForExpansion( String expansionCode )
The NX (base game/no expansion) and XX (generic custom expansion)
codes are not associated with any game. The other built-in expansions
are associated with Arkham Horror.
- The Edit | Expansion Symbol menu makes use of registered game
information to decide which expansions are applicable. The following
rules are used:
    1. If an expansion is not associated with a game, then it is
    always available.
    2. If the current game component is not associated with a game by
    having its "game" private setting set, then all registered
    expansions will be available.
    3. If the game component is associated with a game, then
    expansions that are not associated with the same game are not
    available (except for those covered by Rule #1).
This only affects the expansions available from the menu. If desired,
any expansion desired can be manually set on a card by patching the
appropriate private setting.
    NOTE: If you have written a plug-in for a game other than Arkham
    Horror, and for some reason you do not wish to use the standard
    expansion icon system, it is still recommended that you register
    your game and associate new components with that game. This will
    prevent the standard Arkham Horror expansion icons from being
    shown as available for components created with your plug-in. See
    the Talisman DIY example for an example of how to do this (just
    leave out the lines that register expansion icons).
- Added The Lurker at the Threshold as a new selectable Arkham Horror
expansion, but it currently uses the default custom symbol.
- Updated the case book editor layout to work better with the Nimbus
look and feel. (TRANSLATORS: Several "cbe-*" strings were changed as a
result.)
- Updated the deck editor layout to work better with the Nimbus look
and feel.

Plug-in Authoring Kit

 - The Talisman DIY example has been updated to include code that
 registers Talisman as a game, marks the expansions that it registers
 as Talisman-specific, and sets the game for the cards it creates to
 Talisman.
 - A new DIY example has been added that demonstrates how to achieve
 some drawing effects, such as layer opacity, rotation, applying
 textures to an image, and using various filters. At a high level, the
 example defines several useful functions that can be copied and
 pasted into your own code. The lower-level code invoked by those
 functions demonstrates how to set up and use composites,
 convolutions, temporary images, affine transforms, and some of the
 image filters that are built into Strange Eons.



2.1 alpha 8 (2607)


Web Site News

 Strange Eons now has a permanent home at <http://cgjennings.ca/eons>.
 The old SFU address will redirect to the new site and should continue
 to work for the next several months, but if you link to the site it
 would be a good idea to update your URLs now.

 The new site has made the plug-in catalogue system possible, and I
 expect there will be lots of other interesting things ahead. In the
 meantime, I've updated several tutorials to work in the new project
 system and add demo videos, and added a few new entries to Miriam's
 collection.

Mailing List News

 The latest version of SE supports automatic update checks (disabled
 by default). When a new version appears, the same release notes that
 are published to the list will also be available through the update
 system. I will send a mailing out for at least the next couple of
 updates to ensure that the kinks get worked out of the automatic
 processes. After that, I'll have to evaluate whether there is still
 enough interest in the list to use both channels.



 - Fixed: Create in Project may be disabled when using project's New |
 Game Component option.
 - Fixed: Edit | Clear no longer resets a component's file name to
 unsaved as this makes it much more difficult to work with newly added
 components in a project.
 - Fixed: when a project folder changes during synchronization, it
 will reexpand itself in the project view if it was expanded before
 the synch began; this means that, for example, when you rename a file
 in a folder the folder doesn't close (collpase).
 - Fixed: Autoupdate has been fixed. A bug in file name composition
 prevented the plug-in installer from creating .autoupdate files.
 (These are used when a bundle file is in use and can't be
 overwritten; .autoupdate files are automatically installed on the
 next run of the application.)
 - Fixed: documentation for PluginContext.compareMicroversions,
 which had the return values reversed. Basically, it returns a value
 that "points towards" the newest version.
 - Fixed: a newly created project should be added immediately to the
 recent file menu.
 - Fixed: first two entries in expansion symbol menu not disabled when
 appropriate.
 - Fixed: for some reason the insert chars dialog never had an initial
 position set so it always appeared at (0,0).
 - Fixed: missing bitmask in invert filter could produce funky effects
 in automatically inversed expansion symbols.

 - If all of the plug-ins in a bundle are uninstalled, then the plug-
 in bundle will be deleted. This usually can't be done while the JVM
 is running because the bundle is integrated into the classpath, so it
 is done on the next run.
 - Plug-in bundles now support both a Zip and a new solid BZip2
 archive format. The BZip2 bundles are a solid BZip2 stream of the
 uncompressed Zip archive of the bundle contents (along with some
 magic numbers at the start). BZip2 bundles are typically
 significantly smaller than the compressed Zip equivalent, but BZip2
 compression is much slower. Remember that any bundle that you
 distribute in this format effectively requires SE 2.1 alpha 8 or
 newer to use, so don't use this bundle format if you want your plug-
 in to work on older versions of SE. The easy way to create a BZip2
 bundle interactively is to install the Catalogue Tools plug-in,
 create a project that includes your plug-in, use the "Make Bundle"
 action, and then right click on the bundle and choose the "Wrap
 BZip2" action.
 - Plug-in Catalogues: Supports automated installation of versioned
 plug-in bundles over a network connection.
 - A set of core libraries has been split off from the main
 application and made into .selibrary bundles. They contain mainly
 image resources used by different sets of component types. These are
 downloaded "just in time" when the relevant component is created.
 This will reduce the download size of the application on future
 updates as core libraries will only need to be updated rarely. This
 is another small step towards making SE "game neutral". It is
 unlikely that SE will ever be completely Arkham-free, but at least
 players of other games don't have to download all of the AH card
 graphics over and over with every update.
 - Plug-in Root Editor: Catalogue ID editing support; note that
 setting an ID here does not update catalogues that refer to the plug-
 in.
 - The $-notation for scripts has been extended. If you start a
 variable name with a double $, then instead of getting the value of
 the key as a string you will get a "live setting" object. This object
 has properties that match the public static parsing methods of the
 Settings class that will return the setting value in that form. For
 example: $$my_key_name.region, $$my_key_name.colour, etc. $$
 variables cannot be assigned to (trying results in an
 UnsupportedOperationException being thrown). Currently you cannot
 assign values using, e.g., $$my_key_name.integer = x, although this
 may change in the future. In addition to the parsing methods in
 Settings, there is also .value and .string (the value as a string),
 .boolean (the value as a boolean, equivalent to .yesNo), .key (return
 the key name as a string), and .settings (return the Settings
 instance used by this live setting). The value used by a live setting
 for parsing is not cached; it always uses the current value of the
 underlying setting.
 - Added "setexpansionsymbol" task action; open files have their
 symbol set in place (essentially, the same as the edit menu). Closed
 files are opened, updated, and saved. The advantage over the edit
 menu item is that the project action applies to all selected .eon
 files in the project view.
 - The names of arkham.project.TaskAction.appliesTo( Member[] ) and
  arkham.project.TaskAction.perform( Member[] ) have been changed to
  arkham.project.TaskAction.appliesToSelection( Member[] ) and
  arkham.project.TaskAction.performOnSelection( Member[] ),
  respectively. This makes it possible to unambiguously subclass
  TaskAction from script code.
 - Added a cut action to project views.
 - Changed: the signature of StrangeEonsApplication.exitApplication()
 was changed to StrangeEonsApplication.exitApplication( boolean
 restart ), where passing true will attempt to restart the application
 automatically after exit. In theory compiled plug-ins that call this
 method will need to be recompiled against the new interface, but I am
 fairly certain that nobody has ever written a compiled plug-in that
 actually calls this.
 - Added StrangeEonsApplication.suggestRestart( String message ); if
 message is null, a default message is displayed.
 - Added a simple API for adding menu items to the application menu
 bar. Under this API, each menu has a standard location where new
 custom items are inserted. (Note: extending the Window menu is not
 supported by this API; use StrangeEonsApplication.trackWindow(Window,
 boolean) for that. For more extensive control over the menus, see the
 uiutils script library. Example code:

	// Add items to each supported menu
    var AppMenu = arkham.StrangeEonsApplication.AppMenu;
    var menus = [
        AppMenu.FILE, AppMenu.EDIT, AppMenu.VIEW, AppMenu.MARKUP,
        AppMenu.TOOLBOX, AppMenu.HELP
    ];

    function createItem( menu, i ) {
        var item = new swing.JMenuItem( menu + " " + i );
        Eons.addMenuItem( menu, item );
        item.addActionListener( function() {
            println( "Activated " + menu + " " + i );
            Eons.removeMenuItem( menu, item );
        });
    }

    for( var m=0; m<menus.length; ++m ) {
        var menu = menus[m];
        for( var i=0; i<2; ++i ) {
            createItem( menus[m], i );
        }
    }


Plug-ins

 - Added Snapshot plug-in to make it easier to create captures of the
 SE window for web tutorials.
 - Added Catalogue Tools plug-in that adds a new task type (Catalogue)
 and several project actions for managing catalogues. This plug-in
 will be released through the catalogue system shortly.


2.1 alpha 7 (2592)

 - Fixed: Find menu item is enabled when no files are open.
 - Fixed: Some supported file types don't work from recent file menu
 or drag and drop.
 - Fixed: Removed placeholder blank item from tab strip menu when no
 project is open.
 - Fixed: Code Editor should check for Unicode Byte Order Mark on
 read.
 - Fixed: Comment/Uncomment commands not enabled at correct time.
 - Fixed: regular expression error underline might not cleared if
 pattern replaced with empty string
 - Fixed: Regression: Script console: race condition/incorrect insert
 position cause images and components to appear at wrong location in
 console.
 - Fixed: MakeDeck: should synchronize task folder after building the
 deck.
 - Fixed: Plug-in Root Editor, ProjectUtils.copyFolder( File, File ),
 ProjectUtils.copyFile( File, File ), Compile All should ignore hidden
 files/folders.
 - Fixed: "open" task action; for file types set to run a custom
 command (none by default), command tokenizer munges backslashes, can
 miss last token
 - Fixed: New plug-in task type: selecting "injected" does not change
 the plug-in bundle extension.
 - Fixed: choosing Save on tab strip doesn't always save the file.
 - Fixed: can rename a project file to a name that only changes the
 case of some letters on case-insensitive file systems.
 - Fixed: File | Save All fails for support editors.
 - Fixed: addlocale should be applicable to plug-in installation
 notes.
 - Fixed: addlocale should list base language locales in UI locale
 list.
 - Fixed: German, Italian, and Polish locales did not have accelerator
 for File | Save.


 - Dragging and dropping an image file over a deck page adds it to the
 page as a custom tile.
 - Added "Find in Project" command to project view; performs
 multithreaded search of text files and game components in project.
 - Added "testbundle" task action. This will let you test plug-in
 bundles by running a separate copy of SE that will load the bundle.
 The following changes apply to a test run of SE:
     - The icon used for windows and the task bar has a golden tint.
     - A special golden theme is used for the UI (if themes are
     enabled). If the test bundle is a theme, it will load the
     bundle's theme instead.
     - The application window has a special title that includes the
     text "PLUG-IN TEST".
     - Window size/location preferences in the test app do not
     overwrite the preferences for the main app, but are stored and
     recalled in its own "test mode" window settings.
     - No project is automatically opened after the test app starts.
     - Images are not preloaded in a background thread, regardless of
     settings.
     - You are not warned to save files before closing the test
     window.
 This action can be applied either to a bundle or to a plug-in task;
 if applied to a task, it will first try to compile all (if the task
 contains Java source files), then build the plug-in bundle, then test
 the bundle.
 - Added "browse" task action for viewing HTML files in system
 browser.
 - Added basic support for CSS file editing.
 - Added task action to change the default icon of a task, and several
 sample icons. Use Task.registerCustomIcon( String resourceFile ) to
 add your own user-choosable icons. (These are different from a
 NewTaskType's standard icon resource; these are intended to be
 selected by the user in order to designate personally meaningful
 information.)
 - Added "comparetextfiles" action that displays a diff (the editing
 difference) between two selected text files.
 - Added a newaction that creates a plug-in root (eons-plugin) file in
 a plug-in task folder if a root does not already exist.
 - Make bundle action prompts for name if the bundle-name key is
 missing.
 - Added StrangeEonsEditor.hasUnsavedChanges().
 - Added find as supported operation for deck and case book editors.
 - Organized the strings for the project system and removed the
 "Experimental" label.
 - Improved ThreadedMetadataSource efficiency.
 - In the rename dialog for projects, clicking on the existing
 extension allows you to change it.
 - Added "new" task action items for basic plug-in scripts.
 - The meaning of accelerator key Ctrl+Shift+S (or Command+Shift+S)
 has been changed from Save As to Save All (Ctrl+Shift+G for Spanish
 locale).

Plug-in Authoring Kit

The plug-in kit has been reorganized and converted into a Project
folder. You can open it from SE with File | Open Project, then use
task actions to explore the content. For example, you can right-click
on an example's task folder and choose "Make Bundle" to pack it up as
a plug-in bundle, or you can right-click on a demo script and choose
run to try it out. You can try out a plug-in by right-clicking on the
task or bundle and choosing "Test Plug-in...".

A new demo was added to the DIY section on creating localized DIY
components that adapt automatically to the game and UI language.
Localized plug-ins can be translated without modifying the plug-in
source code.

A few basic demos have been added to the projects section which
demonstrate how to enumerate the currently available set of actions
and how to add a new kind of task.

In addition, several minor updates and bug fixes have been made to the
demo code in the kit.

Scripting Libraries

uibindings:
Adding binding classes for ItemCombo, LocationCombo, GateCombo
(instances of these can be obtained through
PluginContext.createInterfaceComponent()). The binding classes for
ItemCombo and LocationCombo currently have no way to hadle items with
no symbol. This includes other world locations with area 2. The
following code can be used to filter these out of a combo box:

    importClass( resources.GameData );

    var model = itemOrLocationCombo.model;
    for( var i = model.size - 1; i >= 0; --i ) {
        var loc = model.getElementAt( i );
        if( !loc || !GameData.getSymbolFromLocation( loc ) ) {
            model.removeElementAt( i );
        }
    }


2.1 alpha 6 (2578)

 - Fixed: Regression: wait cursor no longer appears on some platforms.
 - Fixed: InsertCharsDialog should have a cell grid under Nimbus L&F.
 - Fixed: InsertCharsDialog missing 0xfff0 row.
 - Fixed: InsertCharsDialog: should clear Unicode name label if no
 name available.
 - Fixed: factory.js library: CSVRecordReader adds spurious field
 after quote-escaped field.
 - Fixed: factory.js library: f() function in inline table cell
 scripts is not available because name is aliased.
 - Fixed: factory.js library: setBaseFile() sets wrong variable name.
 - Fixed: Windows: if closed from task bar while minimized and there
 are unsaved files, the verification dialog opens in the upper-left
 corner (the app window is now restored before checking the files).
 - Fixed: When printing a case book, if some sections were missing
 (e.g. timeline but no vignettes) then the section specific settings
 (such as number of columns) were taken from the wrong section (bug in
 FormatPrint).
 - Fixed: Item design assistant: Tome Special Effect page has wrong
 caption.
 - Fixed: French translation missing ellipses from UI strings.
 - Fixed: Properties for a project file do not update correctly when
 the file is saved.
 - Fixed: common.js library: printing a Java array causes an error.
 - Fixed: common.js library: print(null) should print "null" instead
 of empty string; print(undefined) should be distinct from print().
 - Fixed: project view rename dialog should reject illegal names.
 - Fixed: Documentation task should set custom front matter on new
 case book doc file.
 - Fixed: code editor: menu accelerators don't work when code editor
 has focus (processKeyEvent does not call super for unconsumed
 events).
 - Fixed: rename dialog should allow (but do nothing for) no-op
 renames.
 - Fixed: sample automation script: parent.children in forAll returns
 undefined.
 - Fixed: Component Viewer plug-in: strings not localized
 - Fixed: Component Viewer plug-in: if viewing an object that has a
 getName() method but which is not a game component, it might legally
 return null which leads to a NPE
 - Fixed: Component Viewer plug-in: prints type but not value of Enums
 - Fixed: New Plug-in Task: injected plug-in scripts do not have
 getPluginType() function appended.
 - Fixed: Importing data from a card on the Investigator/Create New
 Item dialog throws a NPE if the card has metadata.
 - Fixed: Some bugs when deciding whether to allow a drag/drop in the
 project tree.

 - Projects: Plug-in tasks: added several script and setting templates
 to the "new" task action.
 - Projects: added "addlocale" task action; right-click on a
 localization (.properties) file to quickly add files for additional
 locales.
 - Projects: added "compile", "compileall" task actions that can
 compile Java source files (must have JDK installed).
 - Projects: added "convertimage" task action that can
 convert/recompress an image to the standard SE formats (png, jpg,
 jp2).
 - Projects: added "Game Component" as an option to the "new" task
 action
 - Projects: added Task Group task type, which can have other tasks as
 children
 - Projects: added "drawregions" action to image files in a project.
 Allows you to define regions by drawing boxes on the target image.
 Interacts with CodeEditor: if you select a region in the code editor
 then choose Draw Regions... in a project, the selection in the code
 editor is updated as the region box is drawn.
 - Added ca.cgjennings.apps.arkham.SupportEditor to serve as a base
 class for editors of project support files (other than game
 components). SupportEditor implements StrangeEonsEditor and provides
 a framework to simplify common operations (saving, exporting,
 printing, etc.). Support editors are typically activated by applying
 the Open task action to an applicable file in the project view (for
 example, by double clicking on it). In order to minimize
 incompatibilities with existing plug-ins, SupportEditor is a subclass
 (rather than a superclass) of regular game component editors.
 (SupportEditor.getGameComponent() returns null).
 - Added the support editor ca.cgjennings.apps.arkham.CodeEditor for
 editing various text files, with syntax highlighting when
 appropriate.
 - Code editor: when using relevant tokenizer, languages that use
 braces for indenting will auto indent when a line is ended with "{"
 and auto unindent when a line is started with "}"
 - Added working example table to Factory task type.
 - ImageWriter: writes image DPI metadata when exporting JPEG images
 (previously only wrote this for PNGs).
 - common.js library: added String.prototype.startsWith(),
 String.prototype.endsWith()
 - Factory task: creates a working example table and portrait images.
 - InsertCharsDialog: show missing characters in fallback font, as
 disabled cells.
 - InsertCharsDialog: improved keyboard navigation of table; cursor
 keys navigate between rows and wrap at top/bottom of table,
 space/enter adds to insertion string, delete/backspace removes last
 character from insertion string
 - InsertCharsDialog: added glyph outline view
 - InsertCharsDialog: updated Unicode name table
 - Added typeface viewer to Project system (based on
 InsertCharsDialog).
 - Cleanup of the Project API in anticipation of making it public
 - The metadata associated with a project member has been split into
 its own class (MetadataSource). You may register new sources to
 handle particular file types and extend or customize their metadata,
 including their icon in the project tree and the file properties that
 appear on the Properties tab. To obtain metadata for a project
 member, call its getMetadataSource() method.
 - Game component metadata parser scans the file for a metadata
 signature before attempting to extract, so older component files that
 lack the data don't need to be instantiated just to try (and fail) to
 fetch metadata.
 - Added styles to case books that allow different backdrop images for
 each section and the first page of the book.
 - Case book style editor now uses colour selection dialog to edit
 colours, uses single click to initiate all editing for consistency.
 - Simplified adding plug-ins from the plug-in manager. To access
 previously available advanced options, such as directly adding a
 class on the class path, hold Shift when pressing the add (+) button.
 - Updated the look of the item design assistant for consistency.
 - Added context menu to editor tab strip. To customize the context
 menu for a SupportEditor, override
 StrangeEonsEditor.getTabStripPopupMenu()
 - Changed standard extension for class maps, tile sets, and
 silhouette sets from .txt to .classmap, .tiles, and .silhouettes
 (respectively). The old .txt extension still works, but using the new
 extensions allows more type-specific support in projects.
 - KeyStrokeCellEditor (edits shortcut keys for plug-ins): added
 support for AltGraph modifier and localized key descriptions.
 - New Plug-in Task: for activated plug-ins, added standard functions
 run(), isShowing(), hide() to skeleton code


2.1 alpha 5 (556)

 - Fixed: Regression: MarkupRenderer cannot make the height of any
 line in a paragraph shorter than the tallest line in the paragraph so
 far. (This bug was a side effect of the changes made to support
 PageShapes.)
 - Fixed: Project: tasks may not be removed from the view after
 deleting them with the delete action.
 - Fixed: Deck editor, Print setup dialog: when adding a custom paper
 type, if a type is deleted (so nothing is selected in the list) then
 the set of custom paper types is not updated.

 - Added Documentation task type and several blank document types
 (eon, txt, rtf, html, odt).
 - Root (eons-plugin) editor: added support for compiled plug-ins.
 - Root editor: does rudimentary checks on script files and greys out
 icon if a script does not appear to be a plug-in script.
 - The "Default Expansion" menu is not available by default. This was
 originally provided as a temporary measure to make it easier to
 upgrade existing
 cards. If you still require it, set the key "show-default-expansion-
 option" to "yes".
 - Added AH Expansion Board task type.


2.1 alpha 4 (555)

 - Fixed: Deck editor: double-click on card list tab throws a
 CastClassException
 - Fixed: Regression: printing a case book produces blank pages
 - Added editor for plug-in root files (eons-plugin).
 - Automatically generated inverse images for expansion symbols are
 now created by inverting a desaturated version of the original, which
 looks better when the original image is full colour.
 - Case books may use relative paths in their <image> tags. If a case
 book has been saved, these paths will be evaluated relative to the
 folder that the case book is stored in. For example, <image
 "book.png"> would look for book.png in the same folder that the case
 book has been saved in.
 - The project system has been made visible by default (i.e. the
 experimental feature key does not need to be set for it to appear):

   The project system is assists with the management and development
   of large projects. Within a project, you divide your work up into
   tasks. Tasks come in different varieties, and each kind of task
   provides special support for a different kind of activity.

   For example, the Deck of Cards task provides a command that will
   automatically lay out a deck from the cards it contains.

   The project system is still under development. Many features are
   still incomplete or missing. Some of these features are basic, like
   adding new components to a task (but you can Save As or copy/paste
   an existing component). That said, it is far enough along that it
   can be useful.

   Here are some of the features that are at least partly in place:

   Case Book Task: keeps a case book together with images or other
   content that it may use.

   Deck of Cards Task: keeps a set of cards together. As mentioned
   above, this task includes a command to build a deck automatically.

   Component Factory Task: generates a set of components by reading
   attributes from a CSV file. (This is a plain text file that can be
   edited with most spreadsheets.) Like the Deck of Cards task, the
   resulting components can be made into a deck automatically.

   New Plug-in Task: Create a scripted plug-in. An editor for eons-
   plugin files is available. Other text files are not yet supported.
   The task provides a command to build the plug-in bundle (.seplugin
   or .seext file) for you.

   Import Plug-in Task: Similar to the New Plug-in Task, but instead
   of starting from scratch it unpacks an existing plug-in bundle in
   the task folder.

   Project export: The entire project can be packed up as a .zip file
   for sharing, archiving, or collaborative work.

   As you might expect, the project system is extensible. You can add
   new kinds of tasks, and define new actions that can be applied to
   project elements. As the system is still under development, the
   details of this are not yet available. The "projects" folder of the
   plug-in authoring kit does provide an overview, however.


Plug-in Updates
---------------

 - Case book player (version 2): supports relative paths to images
 (see above).
 - Fixed: Case book player failed to start if the timeline was empty
 - Variable Health Investigators (version 2): uses a PageShape to wrap
 text around the portrait area.



2.1 alpha 3 (542)

 - Major updates to the French localization, courtesy of Damien
 Riegel.
 - Minor updates to the Spanish localization (adds Kingsport
 translation).

Scripting Library Updates
-------------------------
 - factory: now in alpha release. This library automates the
 construction of cards. For example, you can build a deck of cards by
 reading attributes from a speadsheet. Eventually there will be a more
 user-friendly layer of support for this through the Project system;
 in the meantime you can use this library directly.
 - tints: now in alpha release. This library supports image tinting,
 particularly in DIY components.
 - uilayout: after adding a tab to an editor window that isn't
 showing, resize the tab/preview divider to fit the new tab.
 - uicontrols, uibindings: added HSBPanel control and binding support
 to accompany the new tints library.

Bug Fixes
---------
 - Fixed: Investigator Editor: if an ability has the same title as a
 built-in ability, its description is overwritten when the
 investigator is opened from a file.
 - Fixed: Regression: Case Book Editor: timeline replaced by "left
 button".
 - Fixed: Sheet Viewer: sheet might remain locked if an exception is
 thrown during painting.

Plug-in Authoring Kit
---------------------
 - Added tinting example to diy/example3.
 - Minor fixes.



2.1 alpha 2 (540)

 - Enabled alignment parameter for <image> mark-up tags. Alignment is
 given after width and height (if any) and can be any of "top",
 "bottom", "baseline", "center", or "hanging". The last three
 alignments may be followed by a vertical offset measurement; see the
 tag table Web page for details. (This feature has existed for a year
 or so, but was mistakenly never enabled in public builds.)
 - File|Print for game components: allows creation/selection of custom
 paper sizes.
 - Tint/colour selectors have an eye dropper tool (drag to select any
 colour on screen).
 - Tint/colour selectors accept Web-style #RRGGBB or #RGB hexadecimal
 colour values.
 - Switched from Multiple Document Interface-style to tab-style
 interface. Set the key "use-mdi-style-interface" to "yes" if you want
 the old version. Note that if you use the native look and feel on OS
 X, you will always get the old MDI interface. This is a workaround
 for limitations and bugs in the Aqua/Quaqua L&Fs.
 - Code Editor: updates platform's selection manager when selection
 changes (for platforms like Linux that have both a clipboard and a
 text selection).
 - Code Editor: middle click to paste; if the platform has a selection
 manager, that text will be used instead of the text from the system
 clipboard.
 - PluginContext: added methods to allow sharing arbitrary script
 objects between independent scripts:
       public void setNamedObject( String name, Object object );
       public Object getNamedObject( String name );
       public boolean isNameDefined( String name );
       public void removeNamedObject( String name );
 - Pluralizer integration: for some time SE has included a
 pluralization system for languages with pluralization rules other
 than those of English. Although support as present, plural strings
 did not actually *use* it. This version finally rectifies this. See
 "Pluralizer Notes", below, for more information.
 - Windows: the .exe launcher now reads JVM options from the file
 "strange-eons.l4j.ini". Expert users can edit this file to tune JVM
 performance. (For OS X, you can do this by editing the .app's
 .plist.)
 - Windows and OS X: both launchers now disable class file
 verification to increase performance (particularaly start-up time).
 This was added experimentally to the Windows launcher in 537, but is
 now standard.
 - OS X: Updated quaqua to v6 and included 32- and 64-bit JNI
 libraries.
 - OS X: the workaround to avoid a default Nimbus-based L&F (from
 2.00.7/504) has been removed. There are a number of issues with the
 Aqua/Quaqua L&F (Cursor issues in deck editor [see below], no custom
 tab component means no close button on tabs, can't rename deck pages
 by double-clicking tab title, ...). Rather than try to find
 workarounds for all of these issues, it seems more productive to work
 around the biggest problem with using Nimbus on OS X (see next item).
 If you feel strongly about it, you can still get the Aqua L&F by
 requesting the native (Tcho Tcho) theme in Preferences.
 - OS X: if the key use-osx-menu-delegates is yes (which is the
 default), SE will try to create a system menu bar even when not using
 the Aqua L&F by borrowing Aqua's UI delegates.

Bug Fixes
---------
 - Partially Fixed: OS X: handles in deck editor can now be dragged
 (to resize text boxes, move line endpoints, etc.; however, the
 correct drag cursor only appears on the first page of a new deck (not
 one opened from a file).
 - Fixed: OS X 10.6 application launch issues.
 - Fixed: Windows installer: option to create a copy of SE resources
 creates an empty folder instead (attempt to run resource tool fails
 due to change in thread preconditions in ResourceKit.initialize()).
 - Fixed: When experimental key not set, remove experimental menu
 items instead of hiding since visibility ignored on OS X.
 - Fixed: File|Print for game components updates list when custom
 paper sizes are created/deleted.
 - Fixed: Tip Window: explicitly set black, opaque background on
 title/close button to ensure black background under OS X/Quaqua.
 - Fixed: Code Editor: obeys platform-specific popup trigger (right
 button up on OS X).
 - Fixed: closeable tab pane: can only drag tabs by dragging the edges
 of the tab, not the label; the custom tab component now translates
 and forwards mouse events to the enclosing tabbed pane.
 - Fixed: double-clicking on background colour swatch on text box
 style dialog throws NPE instead of opening colour dialog
 - Fixed: various issues related to "close all tabs"/"close all tabs
 but" commands in deck editor.
 - Fixed: Windows: proxy splash window no longer appears in task bar.



Experimental Feature Progress
-----------------------------
 - Projects now listed in recent file menu.
 - Open project is closed at shutdown.
 - Basic project-handling methods added to StrangeEonsApplication:
     public Project getOpenProject();
     public boolean openProject( File projectFolder );
     public void closeProject();
 - Menu-building infrastructure for project views.
 - Some actions are registered and available to test the view: Delete
 (any project member), Export (whole project).
 - support for built-in and resized/colourized file system icons in
 view
 - factory.js library development started
 - Tip Window: shares Robots to improve performance on platforms where
 creating a Robot is expensive.
 - Specialized demo window added to demo lib for tips.

Plug-in Authoring Kit
---------------------
 - updated the SE Text Resource Editor as described above
 - updated JavaDocs to reflect changes to PluginContext

Plug-ins
--------
 - New Tweak SE plug-in allows you to edit various esoteric settings
 that could previously only be set with difficulty, e.g. with calls to
 Patch.

Web Site
--------
 - The "Customization" page has been updated to be more useful and to
 focus on doing things "the Strange Eons 2 way" (extension plug-ins
 instead of custom resource folders).
 - The "Allies into Enemies" tutorial has been rewritten to do things
 the Strange Eons 2 way without using custom resources as an
 intermediate step.
 - The "Creating a DIY Component" tutorial has been edited for clarity
 and style.

Pluralizer Notes
----------------
Pluralization uses a naming convention to differentiate the key name
used for strings. The original naming convention was only meant to
support English, French, Spanish, Italian, and German. As a result, it
assumes only a "singular" and "plural" form. The singular form is just
the key name: either XXX (UI strings) or XXX-text (game language
strings). The plural form is is XXX-pl or XXX-pl-text (respectively).
To support languages with additional plural forms, this is extended by
appending a number (2, 3, 4, ...) to the -pl. For example: ally-text,
ally-pl-text, ally-pl2-text.

Currently, there is a "default" pluralizer (which works for English
and several other languages) and the following language-specific
pluralizers:

  Default (en, bg, de, es, it):
     base-key        : for 1
     base-key-pl     : for everything else

  Czech (cs):
     base-key        : for 1
     base-key-pl     : for 2-4
     base-key-pl2    : for everything else

  French (fr):
     base-key        : for 0-1
     base-key-pl     : for everything else

  Polish (pl):
     base-key        : for 1
     base-key-pl     : ends in 2-4, but does not end in 12-14
     base-key-pl2    : for everything else

  Russian (ru)
     base-key        : ends in 1, but does not end in 11
     base-key-pl     : ends in 2-4, but does not end in 12-14
     base-key-pl2    : for everything else

Although some pluralizers support the use of additional plural forms
(-pl2 keys), translations do not currently *include* such keys. To
prevent this from breaking the application, strings that are missing a
-pl2 will use the -pl instead. This means that an incorrect plural
will sometimes be produced, but the same (incorrect) plural would also
have been produced by previous versions of SE.

The application has been modified to make use of a pluralization
engine for the following keys (let me know if I missed any):

       [card-text.txt]
       clue-token-text, common-item-text, unique-item-text, exhibit-
       item-text, spell-text, ally-text, special-text, skill-text,
       monster-trophy-text, gate-trophy-text, footnote3-text

       [shared.txt]
       iw-l-tome-move-point, iw-l-tome-san-point, iw-l-tome-draw-spell
       (plural defined but not currently used)

       [eons-text.properties]
       in-exp-list

To use pluralizers in your own plug-in, get the correct pluralizer
with PluginContext.getUIPluralizer() or
PluginContext.getGamePluralizer(). You can generate a plural directly
by calling pluralize( int number, String[] forms ). More often, you
will create a plural using either "-text" settings keys or the UI text
resources:

    pl.pluralize( int number, String gameBaseKeyWithout_DashText_,
            Settings settings );
    pl.pluralize( int number, String uiBaseKey );



2.1 alpha 1 (537)
 - Deck Editor: added support for curved movement lines.
 - Deck Editor: switched to a new shadow rendering algorithm (required
 to support curves). The new algorithm is slower (but results are
 cached) and consumes significantly more memory. On the plus side, it
 can accurately generate shadows for any shape, and it correctly
 handles shadows for different line end caps. For straight lines, the
 old algorithm is used when editing at low/medium rendering quality.
 - Deck Editor: when searching component lists, matching items are
 highlighted.
 - Deck Editor: editing tools (text box, custom tile, line, etc.) have
 been moved to their own tab as their number continues to grow.
 - Investigator Editor: reorganized inventory shopping controls.
 - Locations (for Expansion Boards): when adding special text, the
 size of the box can grow to different sizes to fit the content.
 - Mark-up engine: <size> now produces relative sizes if a percent
 sign is added to its parameter, e.g.: <size 80%> sets the size to 80%
 of the current size (15pt to 12pt, 10pt to 8pt, etc.)
 - New Component Dialog: the size of category banner images has
 changed from 117x292 to 117x362. (Besides allowing more room in the
 dialog for custom categories, there is another reason for the change
 that may become apparent as 2.1 progresses.)
 - UI Grid Library: (used by some DIY components) This has been
 integrated into the main application. There is no longer a need to
 install it.
 - Initial app window is no longer maximized on very large displays
 (more than 1600 pixels wide or 1280 pixels high), even if start-
 maximized is explicitly true.
 - Window position and size of various common windows (app,
 quickscript, console, new component dialog, others) are now
 serialized (remembered between sessions). Settings provides some
 methods to add this to your own plug-in windows.
 - A previewer has been added to the image file chooser.
 - Shaped mark-up text: using a PageShape object, the left and right
 margins can be adjusted dynamically as the pen moves down the page to
 make mark-up text conform to a shape. This can be used to flow text
 around other card elements. Note that in the interest of drawing
 speed, the algorithm estimates the height of the current line based
 on the height of the previous line, and therefore it could
 potentially flow the text suboptimally in some cases. The file page-
 shape-demo.js in the JavaScript folder of the plug-in authoring kit
 provides extensive example code, not to mention being fun to play
 with. DIY Example 2 (Talisman) also has example PageShape code.
 - On platforms that include the concept of a system tray (Windows,
 most *nix systems), the script debugger will create an icon on the
 tray when started instead of adding a component to the top of the SE
 application window.
 - Smoother scaling of preview icons (in the various tile lists) for
 tiles in deck editor.
 - Added method PluginContext.getSettings() to provide access to a
 plug-in's private settings through a Settings instance.
 - The fold-up (tuck) box tool in the deck editor has new sizing
 helpers for standard card sizes from games other than AH. The sizing
 helpers have been renamed to match the names used by FFG for their
 line of card sleeves. In additon, the sizing helpers can now create
 boxes for sleeved cards of various thicknesses. If that isn't
 enough...
 - The framework for adding sizing helpers to fold-up boxes has been
 made public. The interface
 ca.cgjennings.apps.arkham.deck.item.TuckBox.BoxSizer represents a
 sizing function that takes a number of components to fit in the box
 and returns an array of mm box dimensions in width, depth, height
 order.
   public static interface BoxSizer {
     // return [w,d,h] in mm for "count" cards using sleeves whose
     // plastic is micronSleeveThickness micrometres thick
     public double[] size( int count, double micronSleeveThickness );
     // returns true if this component can be stored in card sleeves
     public boolean allowSleeves();
   }
 The sizer's toString() method should return an appropriate name for
 the sizer. The TuckBox class also provides two helper classes for
 common sizing techniques: SimpleDepthwiseSizer creates boxes with a
 fixed width and height and a depth that depends upon the number of
 components the box holds:
    public SimpleDepthwiseSizer( String name, double width,
        double height, double depthPerCard, double depthPadding,
        int minCards, boolean allowSleeves )
  Likewise, SimpleWidthwiseSizer creates boxes with a fixed width and
  depth and varying height:
    public SimpleHeightwiseSizer( String name, double width,
        double depth, double heightPerCard, double heightPadding,
        int minCards, boolean allowSleeves )
  (Both of these classes use a default algotithm to adjust the size
  for card sleeves, if they are allowed and requested.) To add a new
  sizing helper call:
    ca.cgjennings.apps.arkham.deck.item.TuckBox.addBoxSizer(
        BoxSizer sizer )
  To get an array of the installed sizers call getBoxSizers().

  Example:
  Here is some script code that adds a new sizer for a hypothetical
  square 2" by 2" (50.8mm by 50.8mm) card type. (The ideal place to
  add new custom sizers is in an extension plug-in.)
      // -----------------
      importClass( arkham.deck.item.TuckBox );

      var hypoSquareSizer = new TuckBox.SimpleDepthwiseSizer(
          "Square Hypothetical",
          // we give the actual card size (in mm, 2"*25.4)
          // the sizer pads the width and height so the fit is not too
          snug
          50.8, 50.8,
          5,          // calculated depth will be padded by 5mm
          12/30,      // a stack of 30 unsleeved cards requires 12mm
          15          // assume a minimum of 15 cards when computing
          depth
                      // (minimum box depth is 5mm + 15 cards *
                      12mm/30
                      //  cards = 11mm)
      );

      TuckBox.addBoxSizer( hypoSquareSizer );
      // -----------------

Bug Fixes
---------

 - Fixed: Mythos: Activity At should come before Clue Appears At if
 both appear on the same card.
 - Fixed: Deck editor: fixed a bug in the print/export system that
 could cause certain very large PageItems to be clipped incorrectly.
 - Fixed: Changed memory estimation algorithm to avoid memory warning
 when run under 64-bit JVM 1.6.0u16.
 - Fixed: Preferences: when using the Shoggoth theme, the controls in
 the Plug-in Scripts section are invisible.
 - Fixed: mark-up box could throw a NPE when drawing text under a
 certain rare combination of factors.
 - Fixed: Mythos editor: Added "Streets" to some street locations from
 expansion boards (Central Hill Streets, Harborside Streets, Church
 Green Streets, Factory District Streets); this matches what was done
 for the main board and the relevant Mythos cards. Left "Streets" off
 of locations that are streets by AH rules but which would appear odd
 if described as such ("Blasted Heath Streets"). The closest I could
 find to an official example for these was a card that mentioned
 "South Shore streets" (sic---note use of lower case) in its
 instruction text.
 - Fixed: dispose() on console window did not call super
 implementation.
 - Fixed: Monster counts for Formless Spawn and Nightgaunt missing
 Kingsport data.
 - Fixed: Investigator Editor: removed the following validation
 messages, because these features have now been used on official
 cards:
     "Although the editor provides this option, no official
     investigator has X. Their cost is unofficial."
 where X might be one of "extra skill points", "extra health points",
 or "random monster trophies". In addition, having starting monster
 toughness was made a cool thing (this is a fix).
 - Fixed: Investigator Editor: the following abilities were added to
 the list of those for which SE will suggest buying more starting
 clues: $OCCULTLORE, $PEDAGOGY, $CONNECTIONS, $GUARDIANOFTHEVEIL,
 $KNOWLEDGEISPOWER, $QUICKWITTED.
 - Fixed: Investigator Editor: the following abilities had minor text
 corrections (missing gender tags): $ABLESEAMAN, $ABNORMALFOCUS,
 $HERO, $QUICKWITTED, $SCHOOLOFHARDKNOCKS.
 - Fixed: Skill Check Table plug-in: first row ([d]=1) should be
 highlighted when dialog opens to indicate what the initial graph
 illustrates.

Scripting Libraries
-------------------

  - Added BSD-style license to script library source files.
  - uibindings: Added a default binding class for source code editors
  created with codeArea().
  - uilayout: Removed check for UI Grid library.
  - markup: Added documentation for PageShape and friends.
  - uiutils: Fixed: can find/print names for menus beyond the top
  level.
  - Audited docs to include ".prototype." in signature when
  appropriate. This may be confusing for those new to JavaScript,
  because ".prototype" is not used when calling such functions.
  However, the decision was made in the interest of accuracy and
  because a way was needed to distinguish amongst "static" functions
  (added as a property of an object), "prototype" functions (methods
  which are inherited by an object through its prototype), "member"
  functions (functions which are added to an object instance in its
  constructor, which are therefore provided by every object created
  with the constructor yet not inherited), and methods of Java
  objects.

MakeDocs tool
-------------

  - Fixed: "Contents" link becomes part of argument definition if an
  argument section is active at the end of the file.
  - REMOVED: temporary measure of autoinserting .prototype. for non-
  static functions.


Plug-in Authoring Kit
---------------------

  - Added JavaScript/page-shape-demo.js to demonstrate the new mark-up
  text shaping features.
  - Removed some card types from Talisman DIY example that were very
  similar to other example types. The Talisman plug-in at Talisman
  Island is now the "real" plug-in, so we don't need to keep material
  that doesn't add anything to the example. (This reduces the kit size
  by about 1MB.)
  - Added PageShape code to Talisman DIY example.

Windows Installer
-----------------
 - Removed option to DL and install UI Grid library since it isn't
 needed anymore.


2.00.9 (519)
 - Added a source-level debugger for scripts. This is a replacement
 and significant enhancement over the "Basic Debugger" plug-in. That
 plug-in will now be ignored if it is installed. The new debugger is
 built-in and does not require that any plug-ins be installed. To use
 it, open the Preferences dialog and choose Enable Source-level
 Debugger. A guide is available on the SE Web site from Miriam's
 basement:
 <http://cgjennings.ca/eons/tutorial/debugger.html>
 - REMOVED: classes that supported the old "Basic Debugger" plug-in,
 including DebugServiceProvider, DebugServiceRegistry, and
 DebugContext.
 - Added rudimentary syntax checking to the Quickscript dialog.
 - print/println in common script library will print the contents of
 native Java arrays as a list, just as is done for JavaScript Arrays.
 - Added the following to StrangeEonsApplication (see JavaDoc in the
 plug-in authoring kit for details):
      public void insertMarkup( String markup )
      public void insertMarkupTags( String prefix, String suffix )
      public JComponent getMarkupTarget()
      public void addMarkupTargetListener( MarkupTargetListener mtl )
      public void removeMarkupTargetListener( MarkupTargetListener mtl
      )
      public static interface MarkupTargetListener {
          public void markupTargetChanged( JComponent target );
      }
 The mark-up target is the JTextComponent that receives the commands
 in the "Mark-up" menu. These methods allow you to track the mark-up
 target as it changes and to insert text into it.
 - Added the following DIY properties (which can be set in create();
 see script lib docs for details):
      DIY.deckSnappingHint
      DIY.portraitBackgroundFilled
      DIY.transparentFaces
      DIY.variableSizedFaces
      DIY.portraitScaleUsesMinimum
      DIY.portraitClipping
 Most of these features were previously experimental and could only be
 set using the advancedFlags field. DIY.deckSnappingHint is new. It
 allows more control over how a DIY behaves in a deck. For example, it
 is now possible to create regular components that behave like tiles.
 This is useful for creating expansion board components for a game
 like Talisman, which has more traditional "spaces" arranged in a grid
 compared to the free-floating locations in Arkham Horror.
 - MakeDocs performs syntax highlighting on examples in <pre> blocks,
 builds a table of contents, uses a style sheet, plus other features
 and bug fixes. See docs/SpecialTopics/makedocs.html in the plug-in
 authoring kit for details.
 - The Quickscript plug-in implements an interface,
 ca.cgjennings.apps.arkham.plugins.ScriptEditor, which allows plug-ins
 to read, modify and/or run the current script and add new keyboard
 actions. Summary of the methods:
    public void ensureVisible();
    public String[] getCommandNames();
    public int getDocumentLength();
    public int getLineOfOffset( int offset );
    public int getColumnOfOffset( int offset );
    public int getOffsetOfLine( int line );
    public int getOffsetOfLineEnd( int line );
    public String getSelectedText();
    public void setSelectedText( String text );
    public int getSelectionStart();
    public int getSelectionEnd();
    public void select( int startOffset, int endOffset );
    public void selectAll();
    public String getText();
    public void setText( String text );
    public void perform( String command );
    public void perform( String command, String parameter );
    public void performAll( String... commands );
    public void run( boolean debugIfAvailable );
    public boolean isRunSupported();
    public void setKeyBinding( String keyStroke, EditAction action );
    public void removeKeyBinding( String keyStroke );
    public interface EditAction {
        public void perform( ScriptEditor ed );
    }
  These additions have two goals:
      (1) Supporting "meta plug-ins" (plug-ins that create other plug-
      ins or DIY scripts).
      (2) Allowing you to extend the editor with your own editing
      commands.
  You can get the current Quickscript plug-in instance (if it is
  running) from the StrangeEonsApplication instance. For example:
      var ed = Eons.getLoadedPluginByName( "Quickscript" );
      if( !ed ) error( "Quickscript is not active" );
      println( ed.actionNames );
      ed.performAction( "select-all" );
  The equivalent code to obtain a script editor instance from the SE
  Text Resource editor (requires v.4 of the editor integration plug-
  in) is as follows:
      var ed = null;
      var plugin = Eons.getLoadedPluginByName( "SE Resource Editor" );
      if( plugin ) {
          ed = plugin.call( "getScriptEditor", [] );
      }
      if( !ed ) {
          error( "Editor integration plug-in is missing or wrong \
              version" );
      }
      // "ed" is the SE Text Resource Editor's ScriptEditor interface
  For more information, see the following in the plug-in authoring
  kit:
      - Quickscript JavaDoc
      - docs/SpecialTopics/QandA.html (example code)
      - JavaScript/makedocs-previewer.js (example code)

Scenario Helper Plug-in
 - updated to recognize white monster movement type
 - Fixed: If started with no scenario open, filtering is not correctly
 initialized.

Windows Installer:
 - removed option to download Basic Debugger plug-in
 - removed duplicate entry for Show Regions plug-in
 - corrected some old file sizes for downloaded content
 - added Script Library Documentation Browser to common developer
 plug-ins
 - added Ex Libris, Format Deck for Paper, Make Board Background, and
 Investigatrix theme to common user plug-ins

Plug-in Authoring Kit 2.8.2
 - edited and updated some script library documentation, reprocessing
 the sources with the new version of MakeDocs
 - linked help pages to a common CSS (except JavaDocs and JavaScript
 docs generated with MakeDocs, both of which have their own)
 - SE Text Resource Editor provides an implementation of the
 ScriptEditor interface (see above), copy selection as styled HTML,
 code styling tool, rounding out of text transformation commands.



2.00.8 (509)
 - Fixed: Personal Story cards: when drawing the investigator name,
 called draw instead of drawAsSingleLine. (Long names would result in
 a red box instead of shrinking the text.)
 - Fixed: Personal Story cards: can't complete export because second
 card is given the same file name ("duplicate entries").
 - Fixed: Personal Story cards: using standard print option, the
 fourth card face is not printed.
 - Fixed: OS X: various file chooser irregularities (e.g., file
 choosers that should support multiple selection did not, file
 choosers would be labelled as "Save" type even though they were
 "Open" type).
 - Fixed: OS X: case book editor does not fit on standard Mac Book
 display (1280x800).
 - OS X: added icons for plug-in files and added matching document
 type to plist.
 - Added the boolean key paper-is-pseudo-X to the paper settings; this
 is used to indicate that the size represents a possible design size
 and not a genuine physical paper size. When set, it prevents the
 paper size from being listed in "normal" print option dialogs, like
 File | Print from a card editor.
 - Added Region, Region2D, and Colour static classes to
 resources.Settings; when requesting a region or colour from Settings,
 one of these subclasses is returned. They are identical to the
 superclass class except that they offer a String constructor (which
 takes a setting value) and they override toString() to return a
 setting value. This gets around the assignment problem mentioned in
 the notes for 2.00.7, allowing one to write:

         var r = new Region( $some-region );
         r.add( 0, 0 );
         $modified-region = r;

  These classes are available in the global scope from scripts.
 - Added Settings.getUser() to obtain the user scope; this is the same
 as getShared() when getting but when setting it writes to user
 settings, which persist between runs of the application.

Plug-in Authoring Kit 2.8
 - Rewrote the main readme file to be more task-oriented; the previous
 version had been nearly the same since SE1.80, when compiled plug-ins
 that were listed in a Toolbox menu were the only possibility.
 - Minor updates to several other documentation files.
 - Moved config-subpixel.js to JavaScript examples folder and deleted
 "tools/scripts".
 - Added readme to explain purpose of files in "graphics templates".
 - Merged in updated Talisman example (DIY example 2).
 - SE Text Resource Editor changes:
     - Added: Translation Editor tool simplifies editing of
     translations; it auto-detects the location of the English file
     and shows a list of all the keys, highlighting those that still
     need translating.
     - Updated the class map template to include instructions for
     launching DIY components and for setting a different category
     banner.
     - Fixed: JavaScript tokenizer fails to continue a string on the
     next line when the line ends with "\".
     - Fixed: Ctrl+Plus only increases text size if using numeric
     keypad, not if using +/= key.
     - Fixed: Regression: tab pane labels are not selectable.
     - Added: DIY script template.
     - Added: Swap Cut command (Ctrl/Command+Shift+X): the selection
     and the clipboard text are swapped.
     - Added: Revert command restores file to last saved version.

Other:
 Updated Bestiary plug-in to support Weapon Immunity ability and Being
 of Ib's n/a awareness. Also added a Sum column for total copies in
 all
 expansions.



2.00.7 (504)
 - Fixed: Regression: exception while reading in older "miscellaneous
 small" cards.
 - Fixed: DIY: possible ConcurrentModificationException in
 DIY.upgradeOldPropertyNames().
 - Fixed: default L&F on OS X for JRE 1.6.0_10+ should be Aqua
 - You may create a new scope within an existing resources.Settings
 instance with:
         new Settings( parentSettings ).
 - You may now add a PropertyChangeListener to a Settings object to be
 informed of setting changes. Adding a listener to a given object only
 informs you of changes initiated at that object's scope (typically,
 through that instance's set() or reset() methods). If you need to
 watch a setting which might be changed at a higher scope (for
 example, if you are watching a component's private settings but the
 setting might also be changed at the top-level scope), follow the
 scope chain with getParent() and add your listener at each level.
 Note that listeners are not serialized to save files with their
 Settings object. (So, for example, if your DIY relies on a listener,
 it should add it in both the create() and onRead() functions.)
 - Added static methods to resources.Settings to parse setting values.
 The intent is to allow script writers to use one consistent syntax
 for settings ($ notation). Previously one would write:

         // print value of "a-setting"
         println( $A_Setting );
         // print the Rectangle object parsed from "some-region"
         println( Settings.getRegion( "some" );

         Whereas now one could write:

         // print value of "a-setting"
         println( $A_Setting );
         // print the Rectangle object parsed from "some-region"
         println( Settings.region( $some-region );

     Note that from scripts one can already read numeric settings
     transparently due to JavaScript's type coercion:

         // this will print 10
         $x = "5";
         println( 2 * $x );

     Writing such settings is currently semi-transparent. SE will
     ensure that whatever you assign is converted into a String before
     putting it in the Settings, but it might not always be the String
     you expect. [But wait, there's more to come in 2.00.8.]
 - Updated the documentation for resources.Settings.
 - Updated the library for the temporary sample case book to the most
 recent version.
 - OS X: updated quaqua library.
 - Fixed: OS X: quaqua not finding native code library.



2.00.6 (500)
 - Personal Story Editor: added.
 - Investigator Editor: added "Special" as a kind of location when the
 user creates a custom home (e.g. "Random*").
  - Investigator Editor: added button to create a partially filled-in
  personal story to the Story So Far tab.
 - Mythos cards: Added unstable Innsmouth location portraits.
 - Location cards: Added Innsmouth card backs, tints, neighbourhood
 data.
 - Added Innsmouth Horror monsters and monster count data.
 - Moved monster ability glosses to main application (from Bestiary
 plug-in), added IH abilities, reformatted and added gloss to similar
 monster table in Monster Editor.
 - Monster Editor: added 0 as a possible toughness (should be listed
 as an em dash in the combo box but currently isn't).
 - Updated and expanded built-in Reference Map plug-in (added
 Innsmouth board, added special location ability glosses,
 reorganized).
 - Deck Editor: using the turn and mirror commands with more than one
 object selected now rotates the entire selection together as a unit.
 - Deck Editor: pages may be renamed. Pages begin with the usual
 "automatic" name (Page 1, Page 2, etc., where the numbering is
 updated when the page is dragged into a new order); double-click the
 name in the tab to edit it.
 - Deck Editor: Selected objects can be grouped into a unit
 (Ctrl/Command + G). The members of the group are then selected and
 modified together. To break a group up into individual cards again,
 use Ctrl/Command + U. These groups are completely different from
 "numbered groups" below. (Numbered groups are just a way to memorize
 and recall a selection.)
 - Deck Editor: Custom tiles can be resized. Note that they always
 retain the same aspect ratio (as if you were holding down Shift while
 resizing a text box).
 - Deck Editor: Custom tiles have a Style dialog. The only style
 property they currently have is Opacity.
 - Deck Editor: Ctrl (or Command) + R reselects the previous selection
 from the last time the selection was cleared (e.g., if you click on
 the page, Ctrl+R will reselect the selection you just had).
 - Deck Editor: Ctrl (or Command) + I inverts the selection (switches
 selected and unselected items).
 - Deck Editor: added numbered selection groups: Ctrl (or Command) +
 <number> sets group <number> to the current selection; pressing
 <number> selects the cards in that group (where <number> is a number
 key from 1 to 0).
 - Deck Editor: Alt + Arrow Key pans the view instead of moving the
 selection.
 - Deck Editor: added new page button to page tabs with this plus the
 previous addition of closable tabs, the separate Add/Remove buttons
 are not needed and have been removed.
 - Deck Editor: added proper handling of mouse drags that leave the
 page view window.
 - Deck Editor: line and text box style changes are applied to all
 compatible selected objects (e.g., if a line style is edited, all
 selected lines will receive the style change)
 - Deck Editor: pasted selections are now centered under the pointer
 (if the pointer is over the view) or centered within the view
 (otherwise); an exception is that if you paste cards to a different
 page than the one they were copied from, they are always pasted to
 their original positions (this makes it easy to duplicate whole
 pages)
 - Deck Editor: while resizing a text box, dragging a line, or
 rotating an arrow (or other RotatableItem), hold Shift to constrain
 the operation: resizing maintains aspect ratio, angles are restricted
 to a multiple of 45 degrees.
 - Deck Editor: when getting the image for a custom tile and the
 original image file can't be found (it was moved/deleted, or this is
 a different computer), SE will look for a file with the same name in
 the same folder as the deck file. (It has always done this for the
 .eon files used by cards in the deck.) Still, the most reliable way
 to distribute decks that require images like this is to create an
 extension that adds the image as a new tile.
 - Added deck editor help to Help menu.
 - Added the function offerToHideArkhamHorror() to the extension
 library: call this in your extension if it adds non-AH card types: it
 presents a dialog (once) that allows the user to hide the AH
 components if they don't play AH (this is done by substituting a
 "minimal" class map for the usual one).
 - Added a Source Code tab to LibUtils.help() (and as a result, to the
 Scripting Library Documentation plug-in).
 - The thread that precaches images in the background now caches
 images from extensions; futhermore, if the minimal class map is in
 use, it ONLY precaches images from extensions.
 - Added GameData.addPaperType( String name, double widthInPoints,
 double heightInPoints, double marginInPoints, double gridInPoints )
 which allows extensions to easily add new paper sizes to the deck
 editor. The intent is to allow you to add paper sizes appropriate for
 an expansion board for your (non-AH) game.
 - Added PA4 as a standard paper type for decks; this is a useful size
 if you wish to share your deck because it is the largest area that
 will fit on both A4 and North American "Letter" paper. (If laying out
 the deck for double-sided printing, it is important to center the
 printed output when printing a PA4 layout to A4/Letter paper. For
 example, from Adobe PDF use the "Auto rotate and center" print
 option. Or, to convert a deck from PA4 to A4/Letter, choose the
 desired paper size (A4 or Letter), then right click over each page
 and choose Center Page Content. [This could make a simple but useful
 nice plug-in.])
 - Paper size names are now localized similarly to class map entries
 by prefixing the name with a '@'; existing localized paper names have
 been updated accordingly.
 - Added two functions to resources.Settings to make it easier to
 diagnose issues with settings:
        public void traceSetting( String key )
        public static void traceSetting( Settings scope, String key )
   (scope may be null, in which case it is Settings.getShared())
 - Fixed: repeater buttons (like the portrait adjustment arrows) send
 the wrong modifiers once every time the modifiers change
 - Fixed: Investigator Editor: can't decrease monster trophies.
 - Fixed: argument order irregularities in the definition of
 testDIYScript().
 - Fixed: Deck Editor: RotatableTiles (such as movement arrows) are
 turned in the wrong direction by the rotate clockwise/counter-
 clockwise commands.
 - Fixed: Deck Editor: Esc key cancels drag selection box (previously
 it would cancel other dragging actions, such as resizing or moving a
 selection, but not this)
 - Fixed: Deck Editor: arkham.deck.items.Line objects sometimes
 reported an incorrect bounding rectangle, which (for example) made
 drag-selecting over areas containing lines unpredictable.
 - Fixed: Regression: Deck Editor: the search field did not work
 correctly because some experimental code was accidentally left in the
 release.
 - Fixed: threads Script Library: fixed Thread.invokeLater() and
 Thread.invokeAndWait() having spurious "task" parameter that hides
 the real value of task from the parent scope.
 - Fixed: various scripting library documentation errors.
 - Fixed: OS X: Updated the JavaApplicationStub in the app bundle to
 work with the recently released Java update (1.6.0_13).




2.00.5 (484)
 - added Innsmouth Horror home locations
 - added "Player's Choice" as a possible investigator home, with
 footnote
 - added Innsmouth Horror special abilities
 - added "Bank Loan" as a selectable Special item for investigators
 - added gate trophies and monster trophies as possible Random
 Possessions
 - added trim() to JavaScript's String prototype (removes whitespace
 from string ends)
 - added <width n>...</width> tag, which allows selecting a font
 width; possible values are a float (0.5 <= n < 10) or one of:
 "regular", "semicondensed", "semiextended", "condensed", "extended"
 - fixed: DIY attribute lock not set when read from file (meaning that
 after reading from file, you could modify an attribute that is only
 supposed to be edited in create()) [You are ALLOWED to do this in
 onRead() as it may be needed to upgrade an old version, but not after
 onRead() returns.]
 - improved handling of uncaught script exceptions; you are now more
 likely to be able to get a simple script stack track than a big giant
 trip through the JS engine's call stack---note that for those cases
 where the full stack trace is useful, it is always printed to stderr,
 and can optionally be printed to the console, too (see Prefs dialog)
 - added partial Czech translation
 - Added $ notation for accessing settings from scripts:
   This will require a bit of explanation, but I think it is going to
   make plug-in scripts and especially DIY cards a lot easier to read.
   I have added a new notation for accessing Strange Eons settings:
   you can use the setting name like any regular JavaScript variable
   by starting the variable name with a $. E.g.:

   println( $stamina_text_region );
   $speed_text = "QUICKNESS";

Note 1: Where a "-" appears in the setting key name you must use a
"_", as "-" is not legal in JavaScript identifiers.

Note 2: Settings can only be strings, so if you assign another type of
object to a setting variable, it will be converted to a string
representation automatically using the object's toString() method.

Note 3: By default the settings used are the shared global settings,
except that DIY scripts will use the DIY component's private settings.
This means that instead of:

diy.settings.set( "x-strength", "6" );

You can do:

$x_strength = "6";

Since with this notation it is awkward to start everything with "x_",
I suggest that you $UseCamelCaseAndStartWithACapitalLetter for your
property names, as this will also avoid conflicts with the standard SE
settings. To facilitate backwards compatibility, I have added a method
to help you convert extensions to this format. The following onRead
code will make your DIY check for any private settings that start with
"x-" and rename them to use the format shown above (e.g., x-star-power
becomes StarPower).

function onRead( diy, ois ) {
    diy.upgradeOldPropertyNames();
}

So just make the above your onRead function and use the $NewNotation
and everything will just work.




2.00.4 (481)
 - Miscellaneous Small cards finally have an option to draw a separate
 portrait on the back side
 - added documentation to markup scripting library
 - updates to Polish translation
 - white monster border colour (IH)
 - added "Weapon Immunity" ability to monsters and Ancient Ones (IH)
 - added support for justified mark-up text; enable by setting the
 LAYOUT_JUSTIFY flag in the mark-up box's alignment
 - added option to justify text boxes in the deck editor
 - added case style settings to justify case book sections: default is
 that intro and timeline are justified, other sections are not
 - made case book printing cancelable




2.00.3 (477)
 - updated Polish translation
 - added fix for editable combo boxes in uibindings (after entering
 nonstandard value, then updating control from setting, it did not
 pick up the custom value)
 - added date-activated IH themed splash to celebrate release of IH




2.00.2 (476)
 - added new portrait clipping and scaling options as DIY advanced
 option flags (see Talisman DIY example's character card for use)
 - when reporting an exception thrown during an extension
 initialization, check if it is an InvocationTargetException and if so
 use the underlying cause for the stderr stack trace




2.00.1 (474)
 - class maps now allow custom category banners (use ; between
 category icon and banner image)
 - fixed regression with setting DIY's portrait key to null not
 removing portrait tab
 - added compareMicroversions( String, String ) to PluginContext to
 make it easier to do precise version checking
 - added option to perform full stack trace during script error
 reporting
 - fixed detection of ui-grid library in uilayout.js library
 - added a minimum non-zero advance to text lines in mark-up renderer
 to prevent badly coded fonts from having overlapping lines




2.00 (467) [changes since 2.00 beta 5 (411)]
 - added Abnormal Focus (with painting support in InvestigatorFront),
 Able Seaman, Killer Instincts abilities from IH
 - added IH as a standard selectable expansion
 - updated case book library
 - ClasspathInstaller maintains a list of discovered plug-in files
       public static File[] getDynamicallyAddedJarFiles()
 - updated JavaScript tokenizer (code editor) for JS 1.7
 - updated built-in Component Viewer plug-in to show actual types;
 GameObject interface is essentially obsolete with support for script-
 based plug-ins
 - added ExtendedPluginFeatures (EPF) interface to support
 accelerators, icons, availability polling for plug-ins
 - added fallback EPF implementation for old classes and scripts; will
 return accelerator based on standard plug-in setting key, icon based
 on class/script name; see EPF JavaDoc in plug-in kit
 - added icons and accelerator key column and accelerator ket table
 cell editor to plug-in manager dialog based on default EPF behaviour
 - added subclass() to common.js library
 - added registry of available JS libraries
      ca.cgjennings.apps.arkham.plugins.LibraryRegistry;
   updated libutils.js library to support registry
 - during ResourceKit initialization, some Swing objects could be
 created outside of EDT
 - added support for Themes using other than Nimbus L&F
 - added FieldPopulationListener to editors
 - added alpha ui libraries; thread library (JS)
 - added alpha DIY component type (ca.cgjennings.apps.arkham.diy.DIY,
 DIYEditor, DIYSheet)
 - switched JS engine to private copy of Rhino 1.7 (neutralizes
 problems due to inconsistencies from different versions of JS under
 SUN/Apple JREs); updated JS libraries (especially common) to work
 with new engine
 - context menu sorts card lists in deck editor
 - during editor save, warn before overwriting file if the component
 name has changed since the last save (prevents accidental erasure
 when basing one card off another and user fails to use Spin Off)
 - changed how mark-up renderer handles one-word texts; now rendered
 with drawAsSingleLine() even if user calls draw() so that card titles
 of one long word will shrink the word instead of breaking the line
 within the word
 - ExportManager now clones components and creates a new set of sheets
 when exporting insteading of using the editor's sheets; in theory
 this will fix a bug with blank cards being exported under OS X
 - added partial Bulgarian translation
 - removed 3rd party window state transition library (too many
 problems for OS X); wrote simple replacement
 - give component creation scripts a PluginContext
 - fixed gate symbols for some monsters (see bug list)
 - GameData: first part of a location file can be empty if a skip
 token line ("BLANK") is added
 - expose populateFieldsFromComponent() in StrangeEonsEditor
 - added EditorLink ClasspathInstaller.createEditorLink( File jarFile
 ) and
   public static class ClasspathInstaller.EditorLink {
      public Object runScript( String code, int modifiers );
   }
   to enable integration of SE Text Editor via plug-in.
 - added size() method to Settings (the number of settings defined at
 that scope)
 - PluginContext.createEditor should return an editor instance, not a
 boolean
 - enumerate/active plug-ins from StrangeEonsApplication (Eons)
 - added public Object call( String name, Object[] args ) to script
 plug-ins; this allows you to call a function defined in one plug-in
 from another plug-in by looking up the target plug-in instance (see
 StrangeEonsApplication)
 - fixed thread issue on Export
 - integrated extra support for Case Book Player plug-in into CB
 editor
 - fixed column position in Quickscript to account for tabs properly
 - added Difficulty Card editor, Black Goat Cult editor, Special
 Location editor
 - fixed case book refactoring engine bug (lazy label matching)
 - added <script>, <eval> tags to mark-up renderer; <action> to case
 book library
 - added Cyrillic characters to fonts
 - fixed variables-sized card face/marker trimming (trimmed extra row
 & column)
 - collator returned by ResourceKit.getCollator should ignore mark-up
 tags
 - added style editor to case books to expose CasebookStyle settings;
 added support for background images to case book rendering
 - added fold-up box editor to decks
 - script code compilation and optimization
 - optional script parser warnings

END OF TEXT