Plugins » AWK Plugin 2.2
Only compatible with P3dO 2.2 and above




Purpose

AWK (All You Wanted to know about 3D files) is a P3dO Poser plugin.

This plugin is dedicated to manage the content of 3D files.
Operations are: deleting, copying or moving an entire 3D scene to another directory (or Poser runtime).

Awk will add 2 sub-menu items in your P3dO pro Tools menu and Information tree popup.

Manage Current Scene A single 3D scene content (3D file, textures and other related files).
Manage Directory All files belonging to a given directory and their references (3D file, textures and other related files).


Manage Scene / Directory

Purpose
Manage Scene purpose is to copy a 3D Scene content from one location to another (a Poser Runtime) and by doing so to preserve, modify or restore the directory hierarchy.

Calling from P3dO
Scene Click the scene and wait for it to load in P3dO, then call the plugin. The Scene and its References are listed.
Directory All files belonging to the directory and their References are listed.

How to use the dialog
Name and Current Path columns compose the actual file location. When a file does not exist the Whole line is grayed and the file can't be edited (it will be ignored for any further action).
Runtime and Output compose the final file location.
   Destination path can be edited by hand, thus allowing to modify the output path or file name (none of these modification is reported to the Poser file, by now).
   The destination Runtime may be changed by selecting a Runtime in the runtime combo. You may also choose any arbitrary directory by using the Folder selection button.
Once the path have been edited select the files you wish to process and then click the appropriate toolbar button (read Toolbar buttons below).
   Destination directory structure is automatically created (missing directory wil be created).
   In case of Move or Delete the origin folders are scanned and deleted when empty (Parent folders are not cleaned).

Toolbar buttons
Move
Copy Moves or Copy selected source files to the Output location (as indicated in "Output path" column - the final output being "Runtime" + "Output path").
Undo Currently disabled.
Delete Delete the selected source files.
   You must take great care deleting files belonging to a 3D scene because many 3D applications share the same file for severall scenes. For example Poser geometries (.OBJ) are often shared between many files.
Refresh This is a helper button that can be used to refresh the grid content in regard to Windows. Checks if source file exists on disk and output file exists on disk.
Select All
Unselect All Quick selection/unselection (ctrl+A shortcut is equivalent to "Select All")

Notes
- The toolbar commands apply to the source Scene only. When you click Move, Copy or Delete, this means Move, Copy or Delete the source not the destination files.
- Manage Scene supersede the Delete Scene dialog that was available with previous versions of Awk. The Delete button of the dialog does what the Delete Scene dialog did, in that situation the Output path is just ignored.

Subdirectories
It is possible to manage a directory and its subdirectories at the same time.
In order to do this use P3dO subfolders mode (right-click on Folders tree, Explorer subfolders).
warning: it may take time to gather all the files related to the 3D files in a directory, it will take even more time in subfolders mode. So, it is not recommended to manage too many directories at a time.

AwkPlugin Manage Scene vs InDepth Scene Manager
P3dO also has a Scene Manager. Available in InDepth window | Manage button.
AwkPlugin and InDepth Scene Manager are 2 complementary tools for managing 3D Scenes.
InDepth is ideal for many things like copying, pasting, renaming,... while AwkPlugin main purpose is to copy/move a scene in respect with the directory structure.
Read more about InDepth Scene Manager, in P3dO's Help file.