Crate ages_ice_archive

Operations over SEGA ICE archives, used in Phantasy Star Online 2.

Currently, only ICE versions 3 and 4 are supported for reading and writing. These are the only kinds of ICE files in the game client and protocol, so it should be usable for all available ICE files.

Examples

Reading an ICE file:

use std::fs::File;
use ages_ice_archive::{Group, IceArchive};

let mut ice_archive = IceArchive::new(
    File::open("ice_file.ice").unwrap()
).unwrap();
ice_archive.unpack_group(Group::Group1);
ice_archive.unpack_group(Group::Group2);

println!("Group 1:");
for f in ice_archive.iter_group(Group::Group1).unwrap() {
    println!("\t{}", f.name().unwrap());
}

println!("Group 2:");
for f in ice_archive.iter_group(Group::Group1).unwrap() {
    println!("\t{}", f.name().unwrap());
}

Writing an ICE file:

use std::io::Write;
use ages_ice_archive::{Group, IceWriter};
use ascii::AsciiStr;

let mut ice_writer = IceWriter::new(4).unwrap();
{
    let mut file = ice_writer.begin_file(
        AsciiStr::from_ascii("hello.txt").unwrap(),
        AsciiStr::from_ascii("txt").unwrap(),
        Group::Group1,
    );
    file.write_all(b"hello world");
    file.finish();
}
let mut buf = Vec::new(); // any Write sink is acceptable
ice_writer.finish(&mut buf).unwrap();

Structs

GroupNotUnpacked	Error returned by iter_group when the specified group has not been unpacked.
IceArchive	A loaded ICE archive whose file groups can be iterated over.
IceFile	A handle to an ICE Archive's file entry.
IceFileWriter	An IO sink for writing bytes to a file before completing its insertion into an in-progress ICE archive.
IceWriter	Type for writing an ICE archive.
UnsupportedVersion	Error indicating that the provided ICE version is unsupported by this implementation.

Enums

Group

One of the two file groups in an ICE archive.