Unigine.PackageUng Class

PackageUng Class

Properties

int CompressionType#

int NumFiles#

Members

---

PackageUng ( string 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

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

PackageUng Clone ( ) #

Clones the package.

void Close ( ) #

Closes the package.

int CreatePackage ( string name ) #

Creates a package with a given name.

Arguments

• string name - Package name.

Return value

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

string 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 IsSupported ( ) #

Returns a value indicating if UNG-packages are supported.

Return value

1 if UNG packages are supported; otherwise, 0.

int Load ( string name ) #

Loads a package with a given name.

Arguments

• string name - Package name.

Return value

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

int ReadFile ( byte[] OUT_data, int size ) #

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

Arguments

• byte[] OUT_data - Data array.
  Notice

  This output buffer is to be filled by the Engine as a result of executing the method.
• int size - File size, in bytes.

Return value

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

int SelectFile ( string name, out int size ) #

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

Arguments

• string name - File name.
• out int size - Integer variable to store the size of the selected file.

Return value

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

int WriteFile ( string name, byte[] OUT_data, int size ) #

Writes data to a file with a given name.

Arguments

• string name - File name.
• byte[] OUT_data - Data to be written.
  Notice

  This output buffer is to be filled by the Engine as a result of executing the method.
• 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.

bool ContainsFile ( string name ) #

Checks if the package contains the specified file.

Arguments

• string name - File name.

Return value

true if the package contains the specified file; otherwise, false.

bool RemoveFile ( string name ) #

Removes the specified file from the package.

Arguments

• string name - File name.

Return value

true if the specified file is successfully removed from the package; otherwise, false.

bool RemoveFile ( int num ) #

Removes the file with the specified ID from the package.

Arguments

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

Return value

true if the specified file is successfully removed from the package; otherwise, false.

int FindFile ( string name ) #

Returns the file ID in the package by its name.

Arguments

• string name - File name.

Return value

File ID. A number between 0 and the total number of files in the package, or -1, if the file doesn't exist.