PowerPreview: High Quality Nitrous Previews

31 votes
Version: 
0.71a - Beta 9
Date Updated: 
04/27/2017

This is an updated version of my PowerPreview script for Nitrous....
Here's a preview pic of the GUI and a high quality nitrous viewport showing the great quality you can achive with NitrousCool

PowerPreview for 3ds Max 2012+

Here is a link to the full screen snapshot done with PowerPreview, the timelimit was set to 90secs, but it would have been perfect quality wise already after 30-40 secs...

PowerPreview

The purpose of the script is to be able to create viewport previews in the highest Nitrous-rendering quality possible. Additionally the size of the preview is NOT limited to  the desktop/or 3ds Max window size. There is a hard limit at 6400*6400 currently, but that is set in the code to prevent people from killing their Max sessions by dialing insane numbers in the resolution spinners. I successfully created some 4800*2400 avis on my 512MB graphics card Laughing

See more details below...

DETAILS:

-------------------------------------------------------------------------------------------------------------------------------------------
 PowerPreview V0.71a Beta 9
-------------------------------------------------------------------------------------------------------------------------------------------
Power Preview :  High Quality Nitrous Preview  - !!! BETA RELEASE !!!
Created:  June  6, 2011
Modified: April 27, 2017
-------------------------------------------------------------------------------------------------------------------------------------------

LIMITS EXISTING UP TO THIS VERSION:

  • 3ds Max Limitation: 3ds Max has to be the foreground application, otherwise Nitrous will stop refining the viewport progressively. Because of this issue IT'S IMPORTANT TO DISABLE THE SCREENSAVER.
    Energy saving mode is okay, even if it is set to put the display to sleep...
  • 3ds Max Bug:  AVI files bigger than 1GB get corrupted, please file a bug report at Autodesk (fixed in Max 2013)
  • Pressing "Cancel" on 32 bit Max might crash 3ds Max, this is currently under investigation
  • Locked target file (eg. playing in an AVI Player) cause PowerPreview to report an "Internal Error"
  • Advanced Nitrous options ( eg. dynamic reflections) tend to fail from time to time on lower-end GPUs
  • Workarround: set timebudget high enough, press create preview/snapshot, look at output: if something's wrong, toggle any Nitrous option on&off. This will eventually bring Nitrous's output back to glitch free again,
    If everything looks okay, turn down the timebudget again and wait for the preview to be created

-------------------------------------------------------------------------------------------------------------------------------------------

HISTORY:

HISTORY

Version:  V0.71a - Beta 9 - PRERELEASE - 3ds Max 2018+ Compatibility Fix

  • added missing icon in installer package (3ds Max2018+) to prevent exception at launch causing incomplete UI

Version:  V0.71 - Beta 9 - PRERELEASE

  • Implemented progressive refinement while 3ds Max is not the active Application ( 3ds Max 2014+ only)
  • Object Selection is maintained during preview creation now (including stack selection).
    This allow previews with selected object features (like wireframe selected, modifier stack's "Show Endresult" etc...)
  • fixed world axis being visible in previews

 

Version:  V0.70b - Beta 8, ( 3ds Max 2014 related Update + Bugfixes )

  • fixed NitrousTweaker's Procedural Texturesize error
  • fixed Viewportmenu disappearing after using 3ds Max's internal "Make Preview" functionality
  • fixed various Maxscript compiler related errors in 3ds Max 2014 and above

Version:  V0.70 - Beta 8 - Internal PRERELEASE

  • Increased resolution limit again ti 6.4Kx6.4K. Beyond that, severe graphics driver crashes might occure
  • unintended bitmap scaling fixed, this caused subtle graphics artefacts, especially visible on wireframe previews
  • complete code restructuring and modularization (some of it still in progress)
  • implementation of various (still internal only) data structures for future project managment usage
  • Nitrous Settings Copy&Paste functionality ( between viewports )
  • Some UI reorganization
  • fixed viewport switching/resolution issues

Version:  V0.60 - Beta 6, ( 3ds Max 2013 related Update)

  • Increased resolution limit again ti 6.4Kx6.4K. Beyond that, severe graphics driver crashes might occure
  • unintended bitmap scaling fixed, this caused subtle graphics artefacts, especially visible on wireframe previews
  • implemented basic preview creation mode switching feature, choose between various methods,
    currently you can switch to the default 3ds Max's "Make Preview" mode and back only
  • Filename postfixing based on token expansion added. Added checkboxes for convenient use
    Known tokens are currently: "%scene", "%view", "%date", "%time","%begin","%end",
  • DOF/Boken shape/image handling added:  per viewport bokeh shape mechanism implemented
  • UI rearranged, introduced "Minimal UI" button
  • Checkbox to disable  "Progressive Refinement" added for fastest previews
  • Various additional fixes...

 Version:  V0.51a - Beta 5, DC20120216, HOTFIX

  • Fixed "visibility in undefined" error for people having the viewcube-plugin completly removed
  • Please note regarding the gamma fixes:
    due to a Max bug/Limitation, maxscript always uses an output gamma value of 1.0 when it saves a bitmap
    Thus when doing a "Preview", the current display gamma settings are applied to the written files,
    that means it' provides complete WYSIWYG ("What you see is what you get")
    Contrary to the "Preview" creation, when doing a "Viewport Snapshot" and using the framebuffer save button to save the bitmap, the current "output gamma" setting is applied to the written image

Version:  V0.51 - Beta 5, DC20120215

  • Fixed filename-frame numbering when writing to  image sequence
  • Fixed double gamma issues with snapshot mode when display gamma is enabled
  • Implemented ViewCube hiding ;-)
  • Implemented basic UI and options for upcoming nitrous features (3ds Max 2013 DOF,Bokeh)

Version:  V0.50c - Beta 4, DC20120104, HOTFIX

  • Fixed time jumping bug during simple snapshot creation
  • Implemented simple Nitrous glitch recovery mechanism (still experimental)

Version:  V0.50b - Beta 4, DC20111221, HOTFIX

  • Fixed stupid installer bug: install only executed when existing PowerPreview install was detected - D'oh!!!!!
  • Removed dummy D3D button in Direct 3D mode - D3D options still wait to be implemented....

 Version:  V0.50a - Beta 4, DC20111220

  • Complete GUI rework, now features flexible rollout support, minimizing etc...
  • Introduced Nitrous config rollout
  • Experimental Nitrous options ( eg dynamic reflection ), buggy but work most of the time
  • Introduced Viewport SnapShot feature, supporting the same resolutions and features like the preview creation tool
  • Implemented update check tool, simply press a button to know if you have the latest version installed
  • Implemented timerange configurability, fixed bugs in previous versions related to timeline changes in the scene
  • Implemented Object Category Filtering and rudimentary overlay options (WIP)
  • Cranked up limits ( timelimit to 90 secs, max. resolution to 5000 x 5000 )       

Version:  V0.46a - Beta 3, DC20111212

  • Implemented compatbility wiht German and French Max Versions
  • Further improved UI logic and behavior
  • Improved future and internal 3d Max version stability 

Version:  V0.45c - Beta 2, DC20111210, HOTFIX

  • Fixed crash-to-tdesktop bug after preview creation on 32bit 3ds Max Versions
  • Fixed bug which could cause 3ds Max dialogs and menus to close immediatly after preview generation
  • Improved parts of the UI and the viewport selection change dedection code ( still work in progress)

Version:  V0.45b - Beta 1, DC20111205

  • Fixed various UI related issues, which messed with the parameters on viewport selection
  • Reimplemented iteration-based limiting ( enabled by default, set to 2048 Nitrous refinement iterations)
  • Note: all parameters in Timebudget Group are tweakable on the fly while a preview is in progress..
  • Statustext reflects wether the last frame did hit the time based limit, or the iteration limit
  • Fixed framerange detections ( WIP ), parameters are updated when "Create Preview" is pressed
  • Script works now in Direct3D mode  too, but of course without progressive options

Version:  V0.40c - Initial Alpha Release, DC20110728

-------------------------------------------------------------------------------------------------------------------------------------------
AUTHOR:

-------------------------------------------------------------------------------------------------------------------------------------------

FUTURE PLANS:

  • Too many to list Cool

-------------------------------------------------------------------------------------------------------------------------------------------

INSTALLATION:

  • 3ds Max Version 2012 and up and viewport set to Nitrous recommended
  • Use automatic installer or copy the zip contents to your Max folders manually....
  • "Spacefrog Tools-PowerPreview.mcr" should go to your "usermacros/macroscripts" folder
  • "SF_PowerPreview.mse"  should go to your userscripts folder ( usually "[MaxRoot]\Scripts\" )
  • Assign keyboard-shortcut/button or menu to "PowerPreview: Enhanced Preview" in the "Spacefrog Tools" category

-------------------------------------------------------------------------------------------------------------------------------------------

USAGE:

  • Start the script using your prefered method and select the viewport you want to have a preview generated from...
  • The script detects when you select another viewport and adjusts its output resolution automatically,
  • To create "bigger than screen" previews use "Preview Scale Factor" - slider and/or resolution spinners
  • Set the output file and format. Due to a bug/limit in 3sd Max, number of codecs available on 64 bit is limited
  • Adjust the timebudget( ms) you want Nitrous to give per frame ( first slider ),
  • You can re-adjust the budgets during preview creation if you are not satisfied with the output quality
  • Nitrous options are currently "Live" too, meaning  changes in the options are directly applied to the output,

-------------------------------------------------------------------------------------------------------------------------------------------
NOTES:

  • Please do not share the script directly, simply guide people to this page or share the download link
  • There are bugs, quirks and shortcomings in the script of course
  • Thus feedback is welcome,  please post here or on the original threads i created on various boards
  • Of course i do not take responsibility if the script burns your GPU, toasts your hamster or turns you into a bunny
  • You have been warned!
  • Happy Previewing! Cool

-------------------------------------------------------------------------------------------------------------------------------------------

Version Requirement: 
Max 2012 and up, runs on versions Max 2010 and 2011, but without Nitrous of course

Comments

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
spacefrog's picture

New update is online !

As promised, i have put the new update online. This version works with Max 2014 and has some pretty hefty changes under the hood. Just read the history section. It's been on internal testing for some time now so it should work without major bugs...
And finally i changed the preview pic in the title post. Be sure to check out the full res glass image. The link is at the beginning of the introductory text

Happy previewing !

cheers, Josef

SethHamburg's picture

.

I too :-(

Univerpix Studio's picture

Error in 2014 x64

I git this error message at run:

--Compile error: Duplicate struct member name:
CaptureViewportConfigDialog

I use 3ds Max 2014 x64, Win7

c0mpani0ncube's picture

thanks alot for taking the

thanks alot for taking the time to update. i've found this script very very useful last couple of years!

spacefrog's picture

Hi CompanioncubeThanks to

Hi Companioncube

Thanks to you for reporting this error. I wondered when the first person would think it's worth posting about it ;-). It has to do with some changes to Maxscript that happend with Max 2014.
The problem is fixed already here and i will prepare and update the download during this week. Would have done this already if i would'nt be so damn busy with other things ...

So be sure to check back at the end of the week, an update is coming ;-)

c0mpani0ncube's picture

2014

get this error with 2014

-- Error occurred during fileIn in #C:\Users\cube\AppData\Local\Autodesk\3dsMax\2014 - 64bit\ENU\scripts\SF_PowerPreview.mse; line number: 2259
-- Error occurred in anonymous codeblock; filename: C:\Users\cube\AppData\Local\Autodesk\3dsMax\2014 - 64bit\ENU\usermacros\Spacefrog Tools-PowerPreview.mcr; position: 310; line: 7
-- Frame:
-- encryptedScript: "C:\Users\cube\AppData\Local\Autodesk\3dsMax\2014 - 64bit\ENU\scripts\SF_PowerPreview.mse"
-- vanillaScript: "C:\Users\cube\AppData\Local\Autodesk\3dsMax\2014 - 64bit\ENU\scripts\SF_PowerPreview.ms"
>> MAXScript MacroScript Error Exception:
-- Compile error: Duplicate struct member name: CaptureViewportConfigDialog <<

harumscarum's picture

single screenshots

great script. thank you
i use it just for single screenshots and would be great to have an option "only current frame"
also important suggestion to keep user settings for path/filename.extension

i love filename templates feature, could you please add one template for path - %projectfolder (screenshots to be saved in "screenshots" folder which is in same folder where cureent *.max file is)

thank you again for such a useful tool

Braiz's picture

Dynamic/realtime reflections?

Hi Spacefrog, I've been looking for this script for quite a while. Simply beautiful work, nothing less. I do have some trouble getting the realtime viewport reflections to work. Am I doing something wrong? I've tried pretty every setting in the UI, changing shaders and so forth. I'm running a gtx 560, which is a fair GPU, not great though.

Can you help me with this issue?

iancamarillo's picture

gamma for large scale images

If I use the Preview Method: "Grab Viewport" (because I want to make 4k previews) and use h.264 compression with quicktime, the gamma looks close. But I'm not sure. is there another work around for outputting large scale sequences?

osmanzort's picture

Thanks so much for your

Thanks so much for your effort, I'm sure this will be very useful in real time works like the game industry.

I don't know how to run a script so I couldn't try it out. Can you post a simple method to run it?

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.