The Mass Piece Loader allows you to create multiple Game Pieces at once, based on a directory of appropriately named images. All Game Pieces created will use the same Piece template, but will have different images loaded into their Layer traits.
VASSAL Piece Mass Loader is activated with a right-click on an item
which can contain pieces. Decks, At Start Stacks and Piece Palettes are
all good examples of such entities; right-click on the item and select
Add Multiple Pieces:
VASSAL Piece Mass Loader window shows up:
Images can be loaded into multiple levels within each Layer trait. A modified version of the Layer trait is used which defines how image names are matched and loaded into each level.
The processing works as follows:
- Locate all images that match any of the selection criteria in any level of any layer defined in the template.
- Any remaining images are used as the base images.
- A level image is matched to a base image when it commences with the base image, but has a different suffix and matches the rule recorded against the level.
Images that match one of the level definitions, but do not match any base image are ignored.
A Layer trait is added to the counter only if it has at least one image in a level.
The table in the lower half of the screen shows the Game Pieces that will be created.
Display Columns
- Item: A hierarchical display of the images that will be loaded into this piece in the various layer traits within the piece template. The Items displayed here will update automatically as you add and remove Layer traits and Image levels with the Layer traits in the Piece Template.
- Image File: The base image that will be loaded into the Basic Piece trait.
- Piece Name: The name of the Game Piece to be loaded. Each piece is given a standard based on the base image name. You can modify this field to give each piece a non-standard name.
- Skip?: Select if you want to skip this Game Piece during the load.
- Copies: This field can be modified to load multiple copies of a Game Piece based on one image.
Controls
- Image Directory: Select the directory containing your images.
- Do not load imaged into Basic Piece traits: Select this option if all of your images are to be loaded into Layer traits and you do not want any images loaded into the Basic Piece trait.
- Edit Piece Template: Open up a Game Piece Definition dialog to define the Game Piece template that will be used to create each new piece.
Piece Template
The Piece Template used to create each piece looks like the standard Piece Window used to define Prototypes. You can add any traits to the template except for the Basic Piece, this is created for you automatically. Define each trait in exactly the same way as you would for a normal piece, they are all the same as the for the standard Piece Window with the exception of the layer trait. The Layer trait included in the Mass Piece Definer is a modified version taht allows you to specify which images will be loaded into levels with the trait.
Modified Layer Trait
The Modified Layer trait is the same as a standard Layer trait except for the way the image for each level is defined. Instead of an Image Picker to select any image, you define how the image name you want to load is related to the base image that defines the piece.
The options you have to choose from are:
- Ends with: Load an image that starts with the base image name and ends with the specified string.
- Includes: Load an image that starts with the base image name and includes the specified string.
- Matches: Load an image that starts with the base image name and matches the specified Regular Expression.
- Same as: Load the specified image (i.e. load an image not related to the base image).
- Use Base image: Load the base image (usually used with the option to not load images into the Basic Piece).
Example
A set of counters has a 'back' side that shows the Transport
side of the counter. The image for the transport side of the counter is
the same as for the front side, but with a suffix of -trn.
Example counter names will be:
-
unit1.png -
unit1-trn.png -
unit2.png -
unit2-trn.png
The template will have a layer with a single level with the selection
set to Ends with -trn.