VASSAL Reference Manual |
Mass Piece LoaderThe 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.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:
Display ColumnsItem: 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. ControlsImage Directory: Select the directory containing your images.Do not load images 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: Opens 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 that 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:
EXAMPLE:(See image of Modified Layer Trait above)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'. |