Relink Bitmaps

As featured in 3D World – August 2011

Download Relink Bitmaps v2.04

(Self-installing .mzp file, just run this script via:  ”Maxscript->Run script”)

 NEW: Anyone who can break Relink Bitmaps and cause the script to error will receive a free license if you can send me a file that it breaks on or can provide me with steps for how to recreate the problem.

Friends/Community,

This tool is available to the community for free, but I kindly request if you see the value in time this tool saves you, that you donate whatever you can to help me pay off student loans.  Every donation helps immensely.  I do however understand that we’re all in this mess somehow and I understand if you aren’t able to donate immediately at this time.  To donate simply click the “Donate!” button on the script.  I am suggesting $10 for an individual, but whatever you can spare will insure the future development of this script and updates.

Tested thoroughly with (32-bit and 64-bit):   Max 2012, 2011, 2010, 2009, 2008, Max 9

New in Version 2.04

• Added an option to Relink All Bitmaps and not just missing ones.  The checkbox “All Maps” should do the trick. 
• Fixed a bug with the licensing system, if you have requested a license in the past and it wasn’t working, please email colin.senner@gmail.com your new request code (Generated by clicking the “Donate!” button).  Old License files will continue to work, but they now have a new format
• Command Line support added for “All Maps” feature (check the FAQ at the bottom for syntax)
• The new version deletes your “Relink Bitmaps.ini” file because new features have been added to it, this is to prevent errors.  Reconfigure manually.
• Fixed the icon not showing up properly after install (Thanks Artur)

Features:

• All 3dsmax supported Bitmap Texture types
• (new) Relinks Mental Ray Proxy files
• (new) Relinks VRay Proxies (.vrmesh)
• (new) Relinks VRayHDRI files
• (new) Relinks IES files (including VRayIES files)
• (new) Automatically checks for script updates and new versions
• 250% speed increase from previous versions
• Command-line mode available for automating repetative tasks (see documentation below)
• Configurable default user options saving button clicks and wasted time

Just a quick thank you to Christopher Grant at Scriptspot, and the users who have shared their time and ideas (and donations) to make this script better:   brittnell, hongxu, fajar and others!

As always, thank you for everything and be well,
-Colin

Documentation:

To reset the configuration .ini file in the Listener window (Maxscript->MAXScript Listener) type and hit [enter]:

resetConfig()

To reset the position of the Relink Bitmap’s dialog window (in case it gets stuck off screen) type:

resetPosition()

Relink Bitmaps has the ability to run automatically via the command line, here is the syntax:

sceneRelinkBitmaps searchArr ignoreCase:[t/f] recursive:[t/f] undoOn:[t/f] lowMemory:[t/f] allMaps:[t/f] progress:[progressBar]

/* sceneRelinkBitmaps – Relinks bitmaps in the current scene
searchArr: an array of directories to search, ie. #(“C:/maps”,”D:/maps”)
ignoreCase: true or false
ignoreExtension: true or false
recursive: true of false
undoOn: true or false
lowMemory: true or false
allMaps: true or false
progress: progressBar link to update progress, will update the .value in this while it relinks */

If you’re having problems with the script run it and in the listener type:

setDebugMode on

and send me the output and what you did so I can track it down for you asap

Previous Changelogs:

New in Version 2.03

• Changed the script path to use the user’s local scripts path instead of “C:\Program Files\Autodesk\3dsMax 20##\”, this should eliminate problems with needing administrator rights to install the script.
• Added the option to ignore the file’s extension allowing you to relink .jpgs to .tifs with ease.  Note: it will use whichever one it finds first.
• Corrected a bug with the “Find” button which would induce a crash if it was clicked with nothing in it.
  

New in Version 2.02

• Added a user requested option to delete all missing maps in a scene
• Fixed a bug with find a material producing an error

Older Versions:

Relink Bitmaps 2.0
Relink Bitmaps 2.01
Relink Bitmaps 2.02
Relink Bitmaps 2.03