Struct twmap::TwMap

pub struct TwMap {
    pub version: Version,
    pub info: Info,
    pub images: Vec<Image>,
    pub envelopes: Vec<Envelope>,
    pub groups: Vec<Group>,
    pub sounds: Vec<Sound>,
}

The TwMap struct represents a Teeworlds 0.7 map or a DDNet 0.6 map. Which one of those it is will always be determined during the parsing process and is stored in the version field.

The library cares a lot about the integrity of the struct. The check method verifies that all limitations are met.

Parsing

TwMap has several different parsing methods: parse, parse_path, parse_file, parse_dir, parse_datafile

Each of them execute the check method to finalize the process.

If you want to leave out the checks, you can use the _unchecked variation of that parsing method if it is provided. Note that the _unchecked variation might also exclude some common fixes.

Saving

TwMap can save maps in the binary format (save, save_file) and in the MapDir format (save_dir).

Each saving method will first execute check, if the map fails the check, it will not be saved.

Loading

When loading a map from the binary format, a lot of data will be decompressed in the process. Since this is the main slowdown factor, some larger data chunks will be left compressed. The compressed parts are the data field in Images and Sounds and the tiles field in tile map layers. If you want to save the map at the end anyways, then you can simply use the load method on the entire map. If not, use the load method only on the images, sounds and tile map layers that you want to use.

Note:

• you can also use load on slices and vectors of Images, Sounds, Layers, Groups with layers,
• some methods rely on having parts of the map loaded, especially more abstract methods like mirror and rotate_right
• if you want to leave out the checks on the decompressed data, you can use the load_unchecked methods

Fields

version: Version

info: Info

images: Vec<Image>

envelopes: Vec<Envelope>

groups: Vec<Group>

sounds: Vec<Sound>

Implementations

impl TwMap

pub fn load(&mut self) -> Result<(), MapError>

pub fn load_unchecked(&mut self) -> Result<(), MapError>

impl TwMap

pub fn empty(version: Version) -> TwMap

Returns a empty map struct with only the version set.

pub fn physics_group(&self) -> &Group

Returns a reference to the physics group.

pub fn physics_group_mut(&mut self) -> &mut Group

Returns a mutable reference to the physics group.

impl TwMap

pub fn parse_file<P: AsRef<Path>>(path: P) -> Result<TwMap, Error>

For parsing a binary map file.

pub fn parse_file_unchecked<P: AsRef<Path>>(path: P) -> Result<TwMap, Error>

pub fn parse(data: &[u8]) -> Result<TwMap, Error>

For parsing binary map data.

pub fn parse_unchecked(data: &[u8]) -> Result<TwMap, MapFromDatafileError>

pub fn parse_datafile(df: &Datafile<'_>) -> Result<TwMap, Error>

For parsing the datafile of a binary map.

pub fn parse_datafile_unchecked(
    df: &Datafile<'_>
) -> Result<TwMap, MapFromDatafileError>

impl TwMap

pub fn save_file<P: AsRef<Path>>(&mut self, path: P) -> Result<(), Error>

Saves the map in the binary format. Will overwrite if that file already exists.

pub fn save(&mut self, output: &mut dyn Write) -> Result<(), Error>

Saves the map in the binary format. Since it uses a dyn Write as a parameter, you are free to save it into a vec, file, etc.

impl TwMap

pub fn check(&self) -> Result<(), MapError>

pub fn check_ddnet(&self) -> Result<(), DDNetError>

pub fn check_vanilla(&self) -> Result<(), VanillaError>

pub fn check_individually(&mut self) -> Vec<MapError>

pub fn check_info(&self) -> Result<(), InfoError>

pub fn check_images(&self) -> Result<(), ImageError>

pub fn check_envelopes(&self) -> Result<(), EnvelopeError>

pub fn check_groups(&self) -> Result<(), GroupError>

pub fn check_layers(&self) -> Result<(), LayerError>

pub fn check_sounds(&self) -> Result<(), SoundError>

impl TwMap

pub fn find_physics_layer<T: PhysicsLayerChecking>(&self) -> Option<&T>

Returns a reference to the specified physics layer, if the map contains it. Note that every map must have a Game layer to pass the checks.

impl TwMap

pub fn parse_path_unchecked<P: AsRef<Path>>(path: P) -> Result<Self, Error>

pub fn parse_path<P: AsRef<Path>>(path: P) -> Result<Self, Error>

Parses binary as well as MapDir maps.

impl TwMap

pub fn remove_duplicate_physics_layers(&mut self) -> u16

Removes duplicate physics layers of each type. Note that every map must have at most 1 physics layer of each type to pass the checks. The removal process prioritizes removing the layers in front.

impl TwMap

pub fn remove_everything_unused(&mut self) -> u32

Combination of every other remove_unused method.

pub fn remove_unused_layers(&mut self) -> u16

Removes all layers for which is_empty returns true.

pub fn remove_unused_groups(&mut self) -> u16

Removes all groups that contain zero layers.

pub fn is_image_in_use(&self, index: u16) -> bool

Returns true if the image index is set for a tiles layer or a quad.

pub fn edit_image_indices(
    &mut self,
    edit_fn: impl Fn(Option<u16>) -> Option<u16>
)

For easy remapping of all image indices in tiles layers and quads.

pub fn remove_unused_images(&mut self) -> (u16, u16)

Removes all images for which is_image_in_use returns true. Return value: (count of removed external images, count of removed embedded images)

pub fn is_sound_in_use(&self, index: u16) -> bool

Returns true if the sound index is set for a sounds layer.

pub fn edit_sound_indices(
    &mut self,
    edit_fn: impl Fn(Option<u16>) -> Option<u16>
)

For easy remapping of all sound indices in sounds layers.

pub fn remove_unused_sounds(&mut self) -> u16

Removes all sounds for which is_sound_in_use returns true.

pub fn is_env_in_use(&self, index: u16) -> bool

Returns true if the envelope index is in use.

pub fn edit_env_indices(&mut self, edit_fn: impl Fn(Option<u16>) -> Option<u16>)

For easy remapping of all envelope indices in tiles, quads and sounds layers.

pub fn remove_unused_envelopes(&mut self) -> u16

Removes all sounds for which is_env_in_use returns true.

impl TwMap

pub fn process_tile_flag_opaque(&mut self)

Fill in all OPAQUE tile flags.

impl TwMap

pub fn zero_unused_tile_parts(&mut self) -> usize

impl TwMap

Increases the size of the tilemap layers by the specified tile amount in each direction. To keep the look of the map the same, this also moves the quads in quads layers and adjust the offset of groups as well as their clipping.

pub fn extend_layers(
    self,
    up: u16,
    down: u16,
    left: u16,
    right: u16
) -> Option<TwMap>

impl TwMap

pub fn lossless_shrink_layers(self) -> Option<TwMap>

Downsizes all tile map layers as much as possible. Note that this will also reduce the size of physics layers and thereby moves the world border!

pub fn lossless_shrink_tiles_layers(self) -> Option<TwMap>

Downsizes all tiles layers as much as possible.

impl TwMap

pub fn mirror(self) -> Option<TwMap>

Mirrors the map. Switches left and right.

pub fn rotate_right(self) -> Option<TwMap>

Rotates the map clockwise.

impl TwMap

pub fn save_dir<P: AsRef<Path>>(&mut self, path: P) -> Result<(), Error>

Saves the map in the MapDir format to the passed path. Will not overwrite existing files/directories, this would result in an IO-error.

pub fn parse_dir<P: AsRef<Path>>(path: P) -> Result<TwMap, Error>

For parsing a TwMap map directory.

pub fn parse_dir_unchecked<P: AsRef<Path>>(path: P) -> Result<TwMap, Error>

Trait Implementations

impl Clone for TwMap

fn clone(&self) -> TwMap

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TwMap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<TwMap> for TwMap

fn eq(&self, other: &TwMap) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &TwMap) -> bool

This method tests for !=.

impl StructuralPartialEq for TwMap