
                 MAPPA HARNICA TOOLKIT
                          2.0
               Copyright 2001, 2002 CHMP


SYSTEM REQUIREMENTS:

You will need to have Campaign Cartographer 2 v6.038+
installed on your computer.  Check your current version by
launching CC2, clicking the Help drop-down menu and selecting
"About CC2...".  If you are running an earlier version of CC2
v6 you can download a free upgrade from Profantasy Software’s
website at: http://www.profantasy.com.  If you are running v5,
you will need to purchase the version 6 upgrade CD from
Profantasy in order to use this toolkit.

Additionally, your CC2 directory must contain the latest
version of the cc2web.DLL file.  This file is available from
Profantasy's website at http://www.profantasy.com, under the
Updates section.  If you're not sure if you have the latest
version, you may check by starting CC2 and typing XPCFG at
the command line.  A dialog box with the caption "Installed
XP Modules" will pop up containing a list of DLL files that
CC2 is using.  Find the DLL called "cc2web.dll", select it,
and hit the "About" button.  This will bring up another
dialog that lists the XP commands provided by this DLL.  If
the command "LTPM" is included in this list, you have the
latest version.  If it does not, you must download the file
from Profantasy's website and place it in your CC2
installation directory prior to using the Mappa Harnica
Toolkit.


COMPATIBILITY WITH OTHER PROFANTASY SOFTWARE:

As far as we know, Mappa Harnica is fully compatible with all
other Profantasy software.  If you find otherwise, please do
not hesitate to let us know!

The only problem of which we are aware concerns installation
of any other CC2 add-on (such as Character Artist, or CC2
Dioramas, or even Realms Overseer) when Mappa Harnica has
already been installed previously.  We have had several
reports from users of such add-ons not installing properly
if Mappa Harnica has been installed.

Therefore, we recommend that if you install Mappa Harnica and
then at some later date wish to install another CC2 add-on,
you should first uninstall Mappa Harnica, then install the
add-on, and finally, reinstall Mappa Harnica.


WHAT'S NEW FOR 2.0:

  Atlas and Regional Scale Mapping

	The most significant change is the addition of both
	atlas and regional scale mapping, allowing users to
	create overland maps in the Harnic style, at paper
	scales of 8 cm = 12.5 miles and 1 cm = 12.5 miles
	respectively.

  Menus Optimized at Installation Time

	All the Mappa Harnica Toolkit toolbars now come in
	two sizes, one for displays of 800 by 600 pixels, the
	other for displays of 1024 by 768 pixels or more.
	When the toolkit is installed, the setup application
	automatically determines which toolbars are best for
	your display and configures the Mappa Harnica Toolkit
	to use them.  This way, users confined to 800 by 600
	displays may use the toolkit, but those users with
	higher resolution displays gain access to a greater
	number of toolbar buttons.  Additionally, the install
	customizes the Mappa Harnica menus and toolbars to go
	with the version of CC2 (either Pro, i.e. 6.12 or
	later, or else the old 6.038k) found on the computer
	on which the installation is being performed.  Users
	with CC2 Pro (version 6.12 or later) will benefit from
	the inclusion in Mappa Harnica menus of some of the
	standard CC2 Pro commands, such as the symbol manager.

  Installation with CC2 Demo

	With previous versions of the Mappa Harnica Toolkit,
	the installation would sometimes fail when the user
	had only the CC2 Demo.  This is no longer the case.

  Underground-Oriented Interior Scale Symbols and Commands

	Symbols found in Harnic publications for natural and
	artificial features of underground environments (e.g.
	limestone surfaces, sudden drops, loose rock, and
	even mining cart railways) are now included for
	interior scale maps.  Some of these features are
	provided as symbols, some as fill patterns, and some
	are created by commands invoked from new toolbar
	buttons.

  Crenellation Command

	A crenellation creation command has been added for
	interior scale maps, allowing the painless addition of
	castle battlements to any interior map.

  Interior Symbols Separated into Multiple Catalogs

	The interior symbols have been separated into a number
	of catalogs, and a number of the layer-changing
	commands available via the toolbar now switch to the
	most appropriate symbol catalogs for their layers.

  Local Scale Miscellaneous Symbols Improved

	The local scale miscellaneous symbols catalog has been
	altered.  The old windmill symbol has been replaced
	with one adhering to the Harnic local scale standard,
	and a slipway has been added as well.  Additionally,
	a number of the symbols had been inappropriately
	configured as "smart" symbols, meaning they attempted
	to rotate to line up with whatever entities they might
	be placed over.  This has been corrected, and now the
	only "smart" symbols are the ones that should be.

  Text Drawing Commands Now Available for All Map Scales

	Appropriate text drawing commands are now available
	for each of the map scales, encouraging a standardized
	approach to the addition of map text.

  Vegetation-Adding Commands for Woodlands and Areas of Scrub

	Three new commands have been added that allow the
	quick laying down of trees and shrubs.  The first adds
	random vegetation symbols at random spots within a
	designated rectangular area.  The second places such
	symbols around the edge of a smooth polygon in order
	to disguise the polygon's edges.  The last scatters
	symbols beyond the border of such a polygon in order
	to blend a woodland area with the surrounding cleared
	land.  Additionally, the catalogs containing all the
	color varieties of the deciduous or fir tree symbols
	are now weighted so as to ensure that more dark trees
	than shade or light ones are placed when using any of
	the random tree commands.

  Most Macros Changed to Scripts

	Because the Mappa Harnica Toolkit macro collection
	was growing so large, and because of stability issues
	arising therefrom, nearly all Mappa Harnica Toolkit
	macros have been transformed into scripts.  This
	change should be transparent to the user.

  Commands No Longer Cause CC2 Errors with Hidden Layers

	Some commands used to cause CC2 macro errors when
	they moved entities to hidden layers, then tried to
	further manipulate those entities but could not find
	them.  These commands now ensure that the layers to
	which entities are moved are showing before they
	attempt further manipulation of the moved entities.

  GM Layer Button Button Fixed for Interior Scale

	In the previous version of Mappa Harnica, the toolbar
	button used to switch to the GM Layer on the interior
	scale toolbars would, when pressed, cause a CC2 error
	to occur.  This has been fixed.

  EPATH and EPOLY No Longer Incorporate Hidden Entities

	The EPATH and EPOLY commands in the previous version
	of Mappa Harnica sometimes tried to incorporate hidden
	entities when their incorporate functionality was used.
	This has been fixed so that hidden entities may not be
	incorporated.

  Hedge Command Improved

	The command used to draw hedges for local scale maps
	has been dramatically improved, and is now much less
	dangerous to use (i.e. it should not crash CC2 outright
	as the old one sometimes did).  The new script is
	slower to run, but the reliability gained makes such
	a sacrifice more than worth it.

  Border Masking Now Works with Maps Featuring Solid Titlebars

	Previously, the border masking command did not work
	properly with maps based upon the "new style" templates
	(those with solid rounded rectangle titlebars).  This
	has been fixed.

  Wattle and Daub Wall and Wooden Wall Fill Styles Changed

	The interior scale fill styles "Wattle and Daub Wall",
	"Wooden Wall (0)", and "Wooden Wall (90)" have been
	altered to use more closely spaced lines.

  Low Wall Entities Now Outlined in Black

	Entities converted into low stone, wooden, or wattle
	and daub walls using the appropriate buttons for
	interior scale maps are now outlined in black.

  Submerged Sand/Mud Bar Fill Style Changed

	The local scale fill style "Submerged Sand/Mud Bar"
	has been altered to appear at 1/2 the scale it used
	before.

  Rough/Broken Terrain Button and Command Added For Local Scale

	Previously, the fill style "Rough/Broken Terrain" was
	included in the local scale templates, but there was
	no toolbar button or command available to change an
	entity to use this fill.  The appropriate command and
	button have been added to the toolbars.

  Low Wall Button and Command Added for Local Scale

	An automated conversion command and toolbar button that
	turns lines, paths, and polygons into low walls has
	been added for local scale maps.

  Contour Buttons Changed

	Previously, the toolbar buttons for land and water
	contours merely set the pen style, color, etc.  They
	now work as do the other local scale commands, i.e.
	they convert existing entities into contours.

  Water Tank Wall Thickness Changed

	The command that creates water tanks at the interior
	scale now uses 6" instead of 1' thickness for the
	walls of the resulting tank.

  Palisades Layer Changed

	The command that creates palisades at the interior
	scale now places its entities on the Fortifications
	layer instead of the Structures layer.

  CC2 Command Modifiers Now Work with Add Staircase Command

	Previously, CC2 command modifiers (such as "LIKE"
	or "ON") could cause the Add Staircase command to
	fail if the modifiers were invoked using the toolbar
	buttons.  This has been fixed.


WHAT'S NEW FOR BETA 1.1:

  Automated Install/Uninstall

	Mappa Harnica no longer requires tedious user labor
	to install; it is now installed and uninstalled
	automatically.  See installation and uninstallation
	instructions in this file.  Installation may be
	performed over previously-installed copies of Mappa
	Harnica, including manually-installed versions (i.e.
	beta 1.0).

  Interior Scale Shrubs

	The ability to create shrubs, hedges, scrub, etc. for
	interior-scale maps has been added.  The "Random
	Shrubs" button allows the user to build up shrubs and
	other ground cover using randomly selected, scaled,
	and rotated symbols.

  New ARECT XP Command

	A new XP command, ARECT, has been added.  This allows
	the user to quickly draw angled rectangles with the
	designating of three points.

  XP Commands Using Randomization Improved

	The XP commands that use pseudo-random numbers (e.g.
	ADDRANDOMSYMS) have been improved so that, when used
	several times in rapid succession from within a
	macro, they will not yield the same results each
	time.

  Conversion Macro Improvements

	Each of the linear conversion macros, as well as the
	hay conversion macro, now perform sanity checks in
	order to ensure that the entity being converted is of
	the proper type.  If it is not, the macro notifies
	the user and stops the conversion process without
	doing any damage.

	Additionally, the hedge conversion macro has been
	enhanced, at the suggestion of Linda Kekumu.  It no
	longer groups created entities; if the hedge is being
	created from a polygon, the two resulting paths are
	left separate, and may thus be easily manipulated
	after conversion.  A hedge converted from a path now
	comes out as a single polygon instead of two paths
	and two lines; again, this makes it easier to alter
	after the conversion process is complete.  Note that
	these changes *seem* to have resulted in a safer
	macro as well; it is possible that the hedge macro
	is no longer capable of crashing CC2!  However, we
	*strongly* urge the use of caution with this macro
	in case this turns out not to be true.  Always save
	your CC2 file prior to this macro's application.

	The macro changes require the latest cc2web.DLL file,
	available from Profantasy as a free download; see the
	system requirements section in this file.

  New Windmill Symbol

	A symbol representing a windmill has been added to
	the local miscellaneous symbol catalog.

  Dashed Lines Use Map Scale

	In the previous release, dashed line styles defined
	in the local and interior map templates used paper
	scale, meaning that for a given line, the number of
	dashes varied depending upon the zoom level.  Each
	of these line styles has been changed to use map
	scale, meaning that the number of dashes along a
	given line stays constant regardless of the zoom.

  Underwater Rock Symbols' Outline Color Corrected

	The symbol catalogs containing underwater (shallow
	and deep water) rocks for local maps have had the
	symbols' outline color corrected.  In the previous
	release, it was color 0 (black).  It has been
	changed to 199 (dark blue); this matches the color
	of the underwater rocks symbol fill style.

  Water Fill Pattern Scale Corrected

	The interior scale water symbol fill style has been
	rescaled to more closely match the scale of the
	equivalent pattern found in Harnic interior maps.

  Add Staircase Macro Improved

	The "Add Staircase" macro for interior scale maps
	has been altered to allow the "justification" of
	the staircase relative to the two endpoints (left,
	center, or right) to be chosen.  Previously, it
	always acted as if the endpoints described the
	centerline of the staircase.

  Buttons Added to Toolbars

	Three buttons have been added to the toolbars to
	provide easy access to "Angled Rectangle" (ARECT),
	"Offset One" (OFFSET1), and "Zoom to Text" (ZTEXTD).
	Two buttons, "Add Node" and "Delete Node", have been
	removed from the left side toolbars to make room for
	the ARECT and OFFSET1 buttons.  The ZTEXTD button
	has been added to the File toolbar.

	Additionally, a "Convert to Wooden Surface" button
	has been added to the right side local map toolbars.
	In order to make room for it, the "Add Simple Hedge
	Around" button has been removed.  The simple hedge
	command is still available via the menu.

  
2.0 COMPATIBILITY WITH BETA 1.1:

Maps created with the Mappa Harnica Toolkit 2.0 are fully
compatible with beta 1.1, and those created with the earlier
version are equally compatible with 2.0.  You should have
absolutely no trouble viewing or modifying maps created with
one version if you are using the other.

However, there have been some cosmetic changes made to symbol
fills in the latest release.  Most users probably will notice
little if any difference; however, perfectionists may wish to
update maps they made with beta 1.1 to use the latest patterns.
The steps that must be taken in order to do this are explained
below.

Again, you do not have to update your maps in order to make
them compatible!  You should only do this if you really want
to.  Also, note that the following instructions assume that
you have a good working knowledge of CC2.

  Local Maps

	If your map uses the submerged sand/mud bar fill
	style, it should be updated to use the proper scale.
	Open the Fill Styles dialog, and switch to the
	"Symbol Fills" tab.  Now select "Submerged Sand/Mud
	Bar" in the "Fill Style Name" drop-down combo box.
	In the text entry fields below, replace the contents
	of "X spacing" and "Y spacing" with 200, and replace
	the contents of both "X Scale" and "Y Scale" with
	0.5.  Now close the dialog using the "OK" button and
	save your map.

	Version 2.0 includes commands that automate the
	setting of text properties before drawing text.  The
	"large" text for interior maps uses Times New Roman
	font, which unfortunately was not included in the
	earlier versions of the "Local Template.fct" file.
	If your map was based upon this template, then you
	will need to include Times New Roman in it before
	you add text.  To do this, open the "Text Spec"
	dialog (command line TSPEC) and look in the list of
	fonts.  If only "Arial" is present, then click the
	"More Fonts" button in the dialog, scroll down to
	"Times New Roman" in the dialog that comes up in
	response, choose it, and hit "OK".  The "Times New
	Roman" font should now be listed in the font list.
	Now close the dialog using the "OK" button and
	save your map.

  Interior Maps

	If your map uses the daub and wattle wall fill style,
	it should be updated to use the proper scale.  Open
	the Fill Styles dialog, and switch to the "Scaleable
	Hatching" tab.  Now select "Daub and Wattle Wall" in
	the "Fill Style Name" drop-down combo box.  In the
	text entry fields below, replace the contents of
	"Spacing" with 0.7.  Now close the dialog using the
	"OK" button and save your map.

	If your map uses the wooden wall (0) or wooden wall
	(90) fill style, it should be updated to use the
	proper scale.  Open the Fill Styles dialog, and switch
	to the "Scaleable Hatching" tab.  Now select "Wooden
	Wall (0)" in the "Fill Style Name" drop-down combo box.
	In the text entry fields below, replace the contents of
	"Spacing" with 0.5 and "Y Offset" with 0.25.  Now select
	"Wooden Wall (90)" in the "Fill Style Name" drop-down
	combo box, and change its text entry fields as well,
	replacing "Spacing" with 0.5 and "X Offset" with 0.25.
	Finally, close the dialog using the "OK" button and save
	your map.

	If your map uses one or more of the low wooden wall,
	low stone wall, or low wattle and daub wall fill styles,
	you may want to make these filled areas outlined in
	black, as is done in version 2.0.  Simply use the
	"Outline in Black" button on any such entities to give
	them the right look.


BETA 1.1 COMPATIBILITY WITH BETA 1.0:

Maps created with Mappa Harnica beta 1.1 are fully compatible
with beta 1.0, and those created with the earlier version are
equally compatible with beta 1.1.  You should have absolutely
no trouble viewing or modifying maps created with one version
if you are using the other.

However, there have been some cosmetic changes made to the
symbols, symbol fills, and line styles in the latest release.
Most users probably will notice little if any difference;
however, perfectionists may wish to update maps they made
with beta 1.0 to use the latest symbols and patterns.  The
steps that must be taken in order to do this are explained
below.

Again, you do not have to update your maps in order to make
them compatible!  You should only do this if you really want
to.  Also, note that the following instructions assume that
you have a good working knowledge of CC2.

  Local Maps

	If your map contains any underwater rock symbols,
	these should be updated to use the proper outline
	color.  Luckily, this task is easily accomplished.
	At the CC2 command line, type UPDATESYMDEFS.  CC2
	will notify you that this command cannot be undone;
	proceed.  It will then ask you at the command line
	for the symbol catalog to use; right click in order
	to bring up the "open file" dialog, and navigate to
	your Harn\Symbols directory.  There, you should find
	the "UPDATED SYMBOLS beta 1.1" symbol catalog; choose
	this file.  CC2 will quickly replace any underwater
	rock symbol definitions with the corrected versions.

	The two dashed line styles, "Fence" and "Log Boom",
	should be altered to match beta 1.1's equivalent
	styles.  Edit each of these line styles.  Turn off
	"Paper Scale" in each case.  Then, change ""Pattern
	length" to 40.0 for "Fence" and 45.0 for "Log
	Boom".

  Interior Maps

	The two dashed line styles, "Fine Grained Dash" and
	"Dash Dash Long Dash", should be altered to match
	beta 1.1's equivalent styles.  Edit each of these
	line styles.  Turn off "Paper Scale" in each case.
	Then, change ""Pattern length" to 1.8 for "Fine
	Grained Dash" and 7.0 for  for "Dash Dash Long
	Dash".

	The "Water" symbol fill style should be rescaled.
	Change its X and Y spacing to 4.0, and its X and Y
	scale to 0.8.

	If you have created your own shrubs or hedges, you
	may wish to replace them with new ones constructed
	using the "Random Shrubs" command (unless your
	shrubbery is prettier than ours, of course).


INSTALLATION INSTRUCTIONS:

NOTE:	If you have a previously installed version of Mappa
	Harnica, you may simply install a new version of the
	software over it.  You do not have to uninstall old
	versions first.  This is true even if you have the
	manually-installed Mappa Harnica beta 1.0 on your
	system.

1)	Make sure that any antivirus programs, crashguard
	software, etc. is disabled before proceeding.

2)	Unzip the contents of the Mappa Harnica ZIP file into
	a temporary directory (for example, if you have a
	temp directory on drive C, use c:\temp\MappaHarnica).
	Do *not* use your CC2 installation directory for this
	purpose, or any of its subdirectories; otherwise, the
	installation will not work correctly!

3)	Using Windows Explorer, navigate to the directory you
	specified when you unzipped the file in step 1.  You
	should see, amongst other things, an executable named
	"Setup".

4)	Run the "Setup" program by double-clicking it in the
	Explorer window, and follow the instructions provided
	by the program to complete the installation process.
	Be careful to run "Setup", not "AuxSetup"; the latter
	only partially completes the setup process, and must
	only be used directly by the "Setup" program!

5)	Once you have completed the installation process, you
	may remove the temporary directory that you created
	in step 2.

6)	When starting CC2 for the first time after the Mappa
	Harnica Toolkit installation, if one of the Mappa
	Harnica Toolkit menus is being displayed (i.e. the
	regional, atlas, local, or interior scale menus),
	then switch to your standard menu, then switch back
	to whichever menu you wish to use for your mapping.
	This ensures that the latest menus have been loaded
	into your CC2.


ABORTING INSTALLATION:

Due to circumstances beyond our control, an installation that
is stopped before it can complete does not fully clean up
after itself.  If you abort an installation while Install-
shield is running because you have decided not to install
Mappa Harnica, you will want to follow the uninstallation
instructions given below, starting from step 2 instead of 1.
This will remove the modifications that the aborted install
will have made to your CC2 menus, toolbars, and macro file.


USE:

For help using Mappa Harnica, see the "MH Toolkit Manual"
document that can be found in the Harn subdirectory of your
CC2 installation directory once installation is complete.
The manual is in PDF format, and requires Adobe Acrobat or
Acrobat Reader of at least version 5.0.  The latest Acrobat
Reader may be downloaded for free from:

	http://www.adobe.com


UNINSTALLATION INSTRUCTIONS:

1)	Make sure that any antivirus programs, crashguard
	software, etc. is disabled before proceeding.

2)	Follow the standard procedure for uninstalling a
	program under Windows.  For example, in Windows 2000,
	go to the Start menu, select "Settings>Control Panel",
	and double-click the icon marked "Add/Remove Programs"
	in the Control Panel window.  When the Add/Remove
	Programs window pops up, select "Mappa Harnica" from
	the list of installed programs and remove it.  This
	process may be different on other versions of Windows.

3)	Once the uninstallation program from step 2 has run,
	your CC2 will still be left with Mappa Harnica menu
	items, toolbar buttons, and macros.  To get rid of
	these, use Windows Explorer to navigate to the "Harn"
	subdirectory of your CC2 installation directory
	(for example, if your CC2 installation directory is
	"c:\Program Files\CC2", then navigate to the directory
	"c:\Program Files\CC2\Harn").  You should see an
	executable named "CleanCC2".

4)	Run the "CleanCC2" program by double-clicking it in
	the Explorer window.  It will ask permission to remove
	Mappa Harnica menu items, buttons, and macros, and if
	you tell it to proceed, it will announce when it has
	finished.

5)	If there is nothing of value to you in the Harn
	subdirectory of your CC2 installation directory, you
	may manually remove the subdirectory (*not* your CC2
	installation directory!) and its contents.  The
	latter will include, at the very least, the "CleanCC2"
	executable, which you no longer need once you have
	followed the above uninstallation instructions.

