Tertium
06-08-2008, 10:25 AM
TOCollectoREX is utility replacing and supplementing standard Resource Collector.
It allows gather all scene resources together, put them in specified place, find where all missing files are used (exactly in which objects). It can find which files in specified place are no longer used by scene. It also allows convert bitmaps to jpg, etc.
Utility supports XRefs of all types and processes all scenes linked to current.
Unlike all other such scripts, it really finds all resources (images, HDR-images, Vray meshes, IES-files, shaders), not only some bitmaps (Relink Bitmaps, Resource Collector).
Resource Collector est mort! Vive
http://www.collectorex.msk.ru/img/tocollectorex_24i.png Tertium Organum CollectoREX!
(http://www.collectorex.msk.ru (http://%20http://www.collectorex.msk.ru))
Utility functions
1. Collect resources – collection of all resources (images, HDR images, Vray meshes, IES-files, shader files) pointed by current scene or Xref-tree to specified folders and update scene links
2. Unused – search in collect folders files that no longer used by any scene (or whole Xref-tree) link. You can delete founded files or move them to "local recycle bin" - subfolder "$trash$" created in folder where unused file had founded
3. Relink to resources roots – attempt to rewrite all scene (or whole Xref-tree) links so that they poin to files with same names as before but within specified collect folders. If some file doesn't exist in corresponding collect folder, link pointing to it remains the same. This function is needed when you move the whole project or its resources to another location or even computer
4. Resolve links to existing – this function is for ascertainment of real file paths (instead of stored in scene) of resources used by scene (or whole Xref-tree) and for rewriting all scene links so that they point to really existing files
5. Missing files Identity – output full object trees of scene (or whole Xref-tree) entities, that point to missing files
6. Convert to JPEG/TGA – conversion ".tif", ".tiff", ".psd", ".png", ".tga" and ".bmp" files to JPEG or TGA (w/alpha, RLE-compressed) files; if converting file has alpha channel, user can choose operation variant
Interface
http://www.collectorex.msk.ru/img/3.gif http://www.collectorex.msk.ru/img/4.gif http://www.collectorex.msk.ru/img/5.gif
Technical requirements and usage hints
Tertium Organum CollectoREX created to work with scenes, which render by Default Scanline Renderer or Chaous Group VRay Renderer. Fry Renderer not supported. Maxwell renderer's materials: utility can extract only current layer and current coating info.
Utility has tested with following 3dsmax versions: 9sp1-sp2, 2008, 2009. Work in 9 w/o sp1 and previous versions - impossible.
Utility supports network paths. If you want to collect to network folder you must have read and write access to it.
It's desirable - but not indispensable - to restart Max before using utility. Utility operates with big data arrays - so MAXScript garbage collector errors may appear. In some cases instability and amassing gc errors may cause Max crash.
It's recommended to increase size of Initial Heap Allocation on MAXScript tab of Preference Settings window (Customize->Preferences…) at least to 100Mb. It will help utility to work more stable.
Why choose Tertium Organum CollectoREX
Because it:
allows collect resources of selected types only
collects resources of different types to different folders (if you want, you may set one folder for all types)
sujjests variant of operation, if file with copying file name already exists in collect folder, providing small view of file and info for you can choose what to do
when compares files uses full image comparison with and w/o alpha channel - if it is image or HDRI - and CRC comparison - if it is not image
collects only used in scene resources (bypassing Asset Tracking)
if you want can skip Material Editor content which is not used in scene; utility can clear it before each operation
skips resources from Scene States
after collect updates ALL links to ALL collected resources so as they point to real files
has many settings, which automatically save with current scene and later load from it
allows to save settings as global defaults - in order not to make setup with each new scene
allows to build workflow, based on periodical resource collect and semiautomatic maintenance of three or less collect folders (utility copies files to collect folders and can delete unused)
makes backup files (one or many when increment backup is on), not using Max but working with file system: saving by Max sometimes cause crash and data loss
automatically saves scene after operation complete: you may forget to save scene and so - lost data
allows to find out which scene objects point to missing files
allows to set new collect folders and rewrite all file links (without file copying) so that they point to files inside new collect folders - when you move your project to another machine or place it to another location within your machine you will need such relink to access moved resource files
outputs information about real file paths and allows to rewrite wrong links
allows (after collect operation) to view which files are unused by project and suggests to delete them or move to local recycle bin
converts big images (".tif", ".tiff", ".psd", ".png", ".tga" and ".bmp") to JPEG or TGA+alpha - for less disk space usage and scene load speed increasing
allows to process all scenes linked to current scene by XRef-links of all kinds, in batch mode
has anti-crash mechanism for batch mode: stores its state before processing each file to be able to continue after crash, if one occures
outputs (in files and in console) detailed log about all operations and their parameters; log file names contains incrementing number
allows break every operation on every phase, including batch operation
Install
Unpack archive. In Max select MAXScript->Run script and choose mzp-file. Then select Custimize->Custoimize User Interface..., in window "Custoimize User Interface" go to Toolbars tab and choose "Tertium Organum" from Category combo box. Draq button "Tertium Organum CollectoREX" to toolbar. In order to view CollectoREX icon you must restart Max.
Quick start
Main utilite purpose - collect all files linked with project to choosen by user folders. It's for order in mind and on hard disk. It's for transferring scenes to another computers. For collector quick start:
1. Load your scene (for beginning - not containing Xrefs).
2. Launch utility (utility button on toolbar is trigger button - click it once more to close utility).
3. To realtime log view open MAXScript Listener (F11 or MAXScript -> MAXScript Listener)
4. Choose collect folders, options from category Affect will become available
http://www.collectorex.msk.ru/img/1.gif
5. Click Collect Resources button.
http://www.collectorex.msk.ru/img/2.gif
6. Utitlity will collect all project resources, update resource links in scene and save scene. In scene folder will appear two files: backup-file and log-file.
The typical utility workflow
The user creates the scene, links to it various resources and edits it. After end of each stage (if his work style means division into stages) or simply periodically user uses Collect resources function of utility. If required (for example, upon end of development of complex textures in Adobe Photoshop) user uses Convert to JPEG/TGA and from time to time - Unused to find out, what resources are not necessary any more, and so can be deleted. If in current scene objects from other scenes are merged, the user can use Resolve links to existing to find out, what actual resources loaded in the merged or imported piece of the scene. If any files are output in list Missing Files at scene loading, it is possible to use Missing Files Identity to know, which objects point to missing files and to fix a problem.
The same workflow if the scene uses XRef-links, but usage Continue op after crash is possible at 3dsmax failures.
For convenience the user can save a utility configuration as global defaults (for example if he prefers simple backup than incremental or does not want clear Material Editor every time utility function starts).
Demo limitations
- At the name of the main rollout there is word DEMO
- At start the utility suggests to generate a request file
- The utility outputs from time to time messages, that it is a demo
- The utility does not make any changes in the scene
- During collection not all files are copied to collect folders
- Not all files are converted in JPEG/TGA
- Operations which are prohibited in a demo are in-detail outputting to log-file, looking to which contents it is offered to estimate utility functional
- Full version includes offline manual
Refusal from using the utility
Using the utility or refusal from it does not impose any limitations on your technological process. If you refuse its usage and delete it from the system, no data will be lost, your scenes processed by the utility, will continue to open and be ok, as before. The same concerns and the resource files collected or converted by means of the utility.
Details see on Site: http://www.collectorex.msk.ru (http://collectorex.msk.ru/)
Full user's guide: http://www.collectorex.msk.ru/about_en.html
(http://www.collectorex.msk.ru/about_en.html)Download DEMO version: http://www.collectorex.msk.ru/tocollectorex_demo.zip
It allows gather all scene resources together, put them in specified place, find where all missing files are used (exactly in which objects). It can find which files in specified place are no longer used by scene. It also allows convert bitmaps to jpg, etc.
Utility supports XRefs of all types and processes all scenes linked to current.
Unlike all other such scripts, it really finds all resources (images, HDR-images, Vray meshes, IES-files, shaders), not only some bitmaps (Relink Bitmaps, Resource Collector).
Resource Collector est mort! Vive
http://www.collectorex.msk.ru/img/tocollectorex_24i.png Tertium Organum CollectoREX!
(http://www.collectorex.msk.ru (http://%20http://www.collectorex.msk.ru))
Utility functions
1. Collect resources – collection of all resources (images, HDR images, Vray meshes, IES-files, shader files) pointed by current scene or Xref-tree to specified folders and update scene links
2. Unused – search in collect folders files that no longer used by any scene (or whole Xref-tree) link. You can delete founded files or move them to "local recycle bin" - subfolder "$trash$" created in folder where unused file had founded
3. Relink to resources roots – attempt to rewrite all scene (or whole Xref-tree) links so that they poin to files with same names as before but within specified collect folders. If some file doesn't exist in corresponding collect folder, link pointing to it remains the same. This function is needed when you move the whole project or its resources to another location or even computer
4. Resolve links to existing – this function is for ascertainment of real file paths (instead of stored in scene) of resources used by scene (or whole Xref-tree) and for rewriting all scene links so that they point to really existing files
5. Missing files Identity – output full object trees of scene (or whole Xref-tree) entities, that point to missing files
6. Convert to JPEG/TGA – conversion ".tif", ".tiff", ".psd", ".png", ".tga" and ".bmp" files to JPEG or TGA (w/alpha, RLE-compressed) files; if converting file has alpha channel, user can choose operation variant
Interface
http://www.collectorex.msk.ru/img/3.gif http://www.collectorex.msk.ru/img/4.gif http://www.collectorex.msk.ru/img/5.gif
Technical requirements and usage hints
Tertium Organum CollectoREX created to work with scenes, which render by Default Scanline Renderer or Chaous Group VRay Renderer. Fry Renderer not supported. Maxwell renderer's materials: utility can extract only current layer and current coating info.
Utility has tested with following 3dsmax versions: 9sp1-sp2, 2008, 2009. Work in 9 w/o sp1 and previous versions - impossible.
Utility supports network paths. If you want to collect to network folder you must have read and write access to it.
It's desirable - but not indispensable - to restart Max before using utility. Utility operates with big data arrays - so MAXScript garbage collector errors may appear. In some cases instability and amassing gc errors may cause Max crash.
It's recommended to increase size of Initial Heap Allocation on MAXScript tab of Preference Settings window (Customize->Preferences…) at least to 100Mb. It will help utility to work more stable.
Why choose Tertium Organum CollectoREX
Because it:
allows collect resources of selected types only
collects resources of different types to different folders (if you want, you may set one folder for all types)
sujjests variant of operation, if file with copying file name already exists in collect folder, providing small view of file and info for you can choose what to do
when compares files uses full image comparison with and w/o alpha channel - if it is image or HDRI - and CRC comparison - if it is not image
collects only used in scene resources (bypassing Asset Tracking)
if you want can skip Material Editor content which is not used in scene; utility can clear it before each operation
skips resources from Scene States
after collect updates ALL links to ALL collected resources so as they point to real files
has many settings, which automatically save with current scene and later load from it
allows to save settings as global defaults - in order not to make setup with each new scene
allows to build workflow, based on periodical resource collect and semiautomatic maintenance of three or less collect folders (utility copies files to collect folders and can delete unused)
makes backup files (one or many when increment backup is on), not using Max but working with file system: saving by Max sometimes cause crash and data loss
automatically saves scene after operation complete: you may forget to save scene and so - lost data
allows to find out which scene objects point to missing files
allows to set new collect folders and rewrite all file links (without file copying) so that they point to files inside new collect folders - when you move your project to another machine or place it to another location within your machine you will need such relink to access moved resource files
outputs information about real file paths and allows to rewrite wrong links
allows (after collect operation) to view which files are unused by project and suggests to delete them or move to local recycle bin
converts big images (".tif", ".tiff", ".psd", ".png", ".tga" and ".bmp") to JPEG or TGA+alpha - for less disk space usage and scene load speed increasing
allows to process all scenes linked to current scene by XRef-links of all kinds, in batch mode
has anti-crash mechanism for batch mode: stores its state before processing each file to be able to continue after crash, if one occures
outputs (in files and in console) detailed log about all operations and their parameters; log file names contains incrementing number
allows break every operation on every phase, including batch operation
Install
Unpack archive. In Max select MAXScript->Run script and choose mzp-file. Then select Custimize->Custoimize User Interface..., in window "Custoimize User Interface" go to Toolbars tab and choose "Tertium Organum" from Category combo box. Draq button "Tertium Organum CollectoREX" to toolbar. In order to view CollectoREX icon you must restart Max.
Quick start
Main utilite purpose - collect all files linked with project to choosen by user folders. It's for order in mind and on hard disk. It's for transferring scenes to another computers. For collector quick start:
1. Load your scene (for beginning - not containing Xrefs).
2. Launch utility (utility button on toolbar is trigger button - click it once more to close utility).
3. To realtime log view open MAXScript Listener (F11 or MAXScript -> MAXScript Listener)
4. Choose collect folders, options from category Affect will become available
http://www.collectorex.msk.ru/img/1.gif
5. Click Collect Resources button.
http://www.collectorex.msk.ru/img/2.gif
6. Utitlity will collect all project resources, update resource links in scene and save scene. In scene folder will appear two files: backup-file and log-file.
The typical utility workflow
The user creates the scene, links to it various resources and edits it. After end of each stage (if his work style means division into stages) or simply periodically user uses Collect resources function of utility. If required (for example, upon end of development of complex textures in Adobe Photoshop) user uses Convert to JPEG/TGA and from time to time - Unused to find out, what resources are not necessary any more, and so can be deleted. If in current scene objects from other scenes are merged, the user can use Resolve links to existing to find out, what actual resources loaded in the merged or imported piece of the scene. If any files are output in list Missing Files at scene loading, it is possible to use Missing Files Identity to know, which objects point to missing files and to fix a problem.
The same workflow if the scene uses XRef-links, but usage Continue op after crash is possible at 3dsmax failures.
For convenience the user can save a utility configuration as global defaults (for example if he prefers simple backup than incremental or does not want clear Material Editor every time utility function starts).
Demo limitations
- At the name of the main rollout there is word DEMO
- At start the utility suggests to generate a request file
- The utility outputs from time to time messages, that it is a demo
- The utility does not make any changes in the scene
- During collection not all files are copied to collect folders
- Not all files are converted in JPEG/TGA
- Operations which are prohibited in a demo are in-detail outputting to log-file, looking to which contents it is offered to estimate utility functional
- Full version includes offline manual
Refusal from using the utility
Using the utility or refusal from it does not impose any limitations on your technological process. If you refuse its usage and delete it from the system, no data will be lost, your scenes processed by the utility, will continue to open and be ok, as before. The same concerns and the resource files collected or converted by means of the utility.
Details see on Site: http://www.collectorex.msk.ru (http://collectorex.msk.ru/)
Full user's guide: http://www.collectorex.msk.ru/about_en.html
(http://www.collectorex.msk.ru/about_en.html)Download DEMO version: http://www.collectorex.msk.ru/tocollectorex_demo.zip