3DSMax Version Control Scripts Version: 2.0 Release Date: April 02, 2003 Author: Jeff Hanna (Art Director, Lodestone Games, LLC) All scripts in this package are © copyright 2003, Lodestone Games, LLC. All Rights Reserved. An interface between 3DSMax and the Perforce version control system This packages works in Max 4.x and Max 5.x New in Version 2.0 * System checking on all open files. If you load a scene with the File\Open command it will automatically be checked to see if it is under version control, if it is checked out, etc... * Version Control Menu In addition to the entries on the File menu, the package also adds its own "Version Control" menu to Max's main menu bar. This menu contains all of the file manipulation commands, plus commands to show the results of the last command, and options dialog, and an "About" command. * Results Report At the end of every version control command execution a dialog will appear showing the results of that command. This functionality can be disable by going to the "Version Control\Options" menu and unchecking the "Display results of last command." checkbox. Even if this option is disabled the command results can be viewed by using the "Version Control\Results of Last Command" menu entry. * Max 5 additions The code now makes use of Max 5.x MaxScript optimizations where possible. There are fallback modes for Max 4.x. The Max 5 application window title bar will show the current version control status of any open scene. Command Reference ----------------- (File Menu) * Check Out from Version Control ------------------------------ This command will open up a file requester and allow the user to select a max scene for loading. The max file and all of the bitmaps used in the scene will be synchronized to the latest version and all files will be checked out for editing. If the scene is already checked out for editing the user will be alerted to this fact and the file will not be loaded into 3DS Max. * Check In to Version Control --------------------------- This command is used to submit changes to a checked out scene when the user is done editing it. The user will be prompted to enter a change description and asked if they would like to re-open the file for continued editing. The changes will be submitted, and if necessary the scene will be re-checked out for further work. If the scene does not exist in the version control archive the user will be notified that they must use the "Add New to Version Control" command instead. * Add New to Version Control -------------------------- New scenes are added to the version control archive with this command. The user will be prompted for a location and name for the max scene, a change description and whether they would like to immediately re-check out the file for further editing. The file will be saved to the user's hard drive and all files in the scene will be submitted to the version control archive. If necessary, the file will be re-checked out so that the user may continue to work on it. * Revert Scene (undo checkout) ---------------------------- Selecting this command will discard any changes made to the checked out file and will revert the checked out files to the last good versions in the version control archive. * View Scene from Version Control ------------------------------- This command functions similarly to the "Check Out From Version Control" command. The only difference is that the files for the 3DS Max scene are not checked out. All files are synchronized to the latest revisions in the version control archive. The 3DS Max scene is then loaded, but in a read-only state. This is useful for checking new versions of scenes without intending to make any changes to them. (Version Control Menu) * File manipulation commands are the same as the File Menu commands * Results of Last Command ----------------------- Displays a dialog with the results of the last executed Version Control command. * Options ------- Allows the user to toggle on/off the automatic displaying of command results after each Version Control command. * About Version Control Scripts ------------------------------ This brings up an about dialog showing the version of the scripts installed and other information.