NAME

splitshp - Split Shape into frames or combine frames into Shapes

SYNOPSIS

splitshp SHAPE FRAME...

splitshp SHAPE

DESCRIPTION

Shape files are used for storage of all visible elements (from UI buttons to terrain features) of the games Exult supports. Shapes contain one or more frames. splitshp can be used to combine frames into one file, or split a Shape file into its component frames.

The mode of operation is determined by looking at the number of commandline arguments. Exactly one argument means splitting, more than one argument signals a combining operation.

Combining

Each FRAME names a Shape file typically consisting of only one frame (i.e. subsequent frames are ignored). All these frames are concatenated and written to the Shape file SHAPE.

Splitting

SHAPE will be read and split into its component frames. Each of those will be written to its own Shape file. The names of these files are determined by splitting the name of SHAPE before the last dot — anything before this dot is the STEM, anything else (including the dot) is the PREFIX, which may be empty in case there is no dot in the name. The output files are then named STEM_nnSUFFIX with nn replaced by the frame number.

EXAMPLES

splitshp button.shp button-up.shp button-down.shp: Packs the (first) two frames from button-up.shp and button-down.shp into the Shape file button.shp
splitshp grizzly: Unpacks the frames contained in the Shape file grizzly into the (single-frame) Shape files grizzly_00, grizzly_01, grizzly_02, etc.
splitshp boar.new.shp: Unpacks the frames contained in the Shape file boar.new.shp into the (single-frame) Shape files boar.new_00.shp, boar.new_01.shp, boar.new_02.shp, etc.

AUTHOR

This manpage was written by Robert Bihlmeyer. It may be freely redistributed and modified under the terms of the GNU General Public License version 2 or higher.