Plugins » ZipInstaller 2.3.3
Compatible with P3dO 2.3.5 and above



note this picture has been edited to showcase errors for tutorial purprose. The original ZIP file (by Digital Meanderings) was perfect.


Purpose

Install/Uninstall a figure file from a ZIP into Poser. Checking validity of paths in ZIP and fixing wrong paths.

ZipInstaller has 2 main features:
Install Uncompress archive content to your HD.
Uninstall Remove previously unzipped files from your disk.

ZipInstaller may be used as a classic unzipper. But when Poser files are detected within an archive, ZipInstaller does a number of supplementary operations.

ZipInstaller will plug itself in Files menu and add a shortcut icon to P3dO's InDepth toolbar.

Note ZipInstaller needs the P3dO ZipExplorer plugin to be installed (which is what P3dO does by default, so this is just FYI).


Overview

Calling from P3dO
Click the ZipInstaller icon in InDepth toolbar or call from file menu ("Unzip to").

How to use

Click the Upper Tab (#1) to set the mode you wish to use: Install or Uninstall.
Select files, fix paths (see next paragraph).
Click button (#2) to actually Unzip (Extract) to disk or delete (Delete) from disk.

Toolbar buttons
Extract Uncompress selected source files to the Output location (as indicated in "Output path" column - the final output being "Runtime" + "Output path").
Delete Delete the selected files from disk. warning: Uninstall/Delete will not delete any file in the ZIP itself but undo a previous installation thus removing files from your disk.
Refresh This is a helper button that can be used to re-evaluate grid content. Check for existing source file and collision detection.
Select Scene Select all Poser files and unselect others.
Unselect All Quick select/unselect helper.
Destination subfolder The relative path in ZIP does not necessarily match with Poser requirement. This button offers various alternative solutions:
   - use the ZIP archive structure (Archive)
   - use Poser file References. ZipInstaller will also fix problems from Poser References, if any (Scene)
   - copy all into the destination directory (Flat)
   Non 3D files - e.g. pictures - don't have a relative path and thus simply go into the destination or ZIP directories. The Poser button has no effect on such files destination.

List columns
Name and Archive Path columns are the actual file location in ZIP.
Extract to and Output Name make the final file location. Output Name being the path relative to Destination directory.
   The destination Runtime may be changed by selecting a Runtime in the runtime combo. You may also choose any other directory by using the Folder selection button.
Collision a check mark in this column indicates the destination file already exists.
   warning: if you edit an Output Name collision status will not be checked. Click the Refresh button to do so.
Scene indicates this file is part of a Poser file. This is a helper to indicate which file should be unzipped.


Install

Please read the Overview paragraph above for the howto procedure.
In summary click the Extract button and ZipInstaller will unzip the selected content to your hard disk under the location specified by the Extract to field.

Invalid paths issues and fix
ZipInstaller will compare ZIP paths to Poser requirements and to the Poser file References in the archive.
v Green marker indicates the ZIP path has a perfect match to Poser requirement. You may unzip without problem.
v Blue marker indicates part of the path has a problem. Edit manually or set the Destination button to Scene (see Toolbar above). This should fix Blue issues.
v Red marker is for wrong or empty paths. Again Edit manually or click the Scene button.

Notes
- During Extraction Destination directory structure is automatically created (missing directories will be created).
- After a Move or Deletion empty directories are deleted. That is directories where the files were previously stored. For safety reasons those directories parent directories are not deleted.


Uninstall

The purpose of Uninstall is to remove file installed from a ZIP.
ZipInstaller doesn't require an Unsetup list or anything like that and is thus able to Undo previous installations from any Unzipper.

From P3dO click a ZIP file and open ZipInstaller as you would to install it but instead select the Uninstall mode.

All files detected by ZipInstaller (Collision column checked) will be removed when you click the Delete button.

Notes
- Empty directories deleted. That is directories where the files were previously stored. For safety reasons those directories parent directories are not deleted.
- ZipInstaller will remove files installed from other Unzippers as well. All the needed information are taken from the ZIP itself, thus use it even if you didn't installed the Scene with ZipInstaller.