Unigine::PackageUng Class

This class is used to operate with UNG packages.

PackageUng Class

Members

---

static PackageUngPtr create(const char * password = 0, int compression_type = 2)

Constructor. Creates a package using specified compression type, protected by a given password, if provided. By default a package is created using ZLIB compression and without password protection.

Arguments

• const char * password - Password.
• int compression_type - Compression type. One of the COMPRESSION_* variables.

int isSupported()

Returns a value indicating if UNG-packages are supported.

Return value

1 if UNG packages are supported; otherwise, 0.

int writeFile(const char * name, unsigned char * data, int size)

Writes data to a file with a given name.

Arguments

• const char * name
• unsigned char * data - Data to be written.
• int size - Size of the data to be written, in bytes.

Return value

1 if the data was successfully written to a file; otherwise, 0.

int selectFile(const char * name, int & size)

Selects a file with a given name as a current one and puts its size to size.

Arguments

• const char * name
• int & size - Integer variable to store the size of the selected file.

Return value

1 if a file was selected successfully; otherwise, 0.

int getNumFiles()

Returns the number of files in the package.

Return value

Number of files.

int getCompressionType()

Returns the type of compression used in the package.

Return value

Compression type. One of the COMPRESSION_* variables.

void close()

Closes the package.

int load(const char * name)

Loads a package with a given name.

Arguments

• const char * name

Return value

1 if a package was loaded successfully; otherwise, 0.

Ptr<PackageUng> clone()

Clones the package.

const char * getFileName(int num)

Returns the name of a file with a given ID.

Arguments

• int num - File ID. A number between 0 and the total number of files in the package.

Return value

File name.

int createPackage(const char * name)

Creates a package with a given name.

Arguments

• const char * name - Package name.

Return value

1 if a package was created successfully; otherwise, 0.

int readFile(unsigned char * data, int size)

Reads the contents of the currently selected file and puts it into the data array.

Arguments

• unsigned char * data - Data array.
• int size - File size, in bytes.

Return value

1 if a file was read successfully; otherwise, 0.

---

int COMPRESSION_NONE

Description

No compression is used.

int COMPRESSION_BEST_SPEED

Description

LZ4 compression is used (for faster performance).

int COMPRESSION_BEST_SIZE

Description

ZLIB compression used (for best compression).