Depth Of Field Generator PRO - v3.0.74, (c) 2006 Richard Rosenman, Martin Vicanek. Release date: 09/30/06, Updated 06/17/07. INSTALLATION: Simply unzip "dofpro30.zip" and copy "dofpro.8bf" and "convert.exe" to your "\Photoshop\Plug-Ins\" folder, or whichever plugin folder your host program uses. Load your program, open an image, go to the filter menu and under "Richard Rosenman", select "Depth Of Field Generator PRO". INSTALLATION FOR REGISTRATION: Installation for registration requires three simple steps. 1 - Register your copy of Depth Of Field Generator PRO at http://www.dofpro.com/registration.htm 2 - Launch the filter as described above in the installation section. On the bottom right hand corner of the filter, you will notice a request code. Please send this code, along with your full name and your purchase order receipt to richard@richardrosenman.com. Alternately, you can click on "SAVE" next to the request code and email the saved "DOFPRO.REQ" file along with your full name and your purchase order receipt. As soon as we receive this information, your license will be generated and emailed back to you promptly. 3 - Once you have received your license file for Depth Of Field Generator PRO, simply place the file into THE SAME FOLDER AS YOUR "dofpro.8bf" FILE. This is very important as placing the license file in a different folder than the one it currently resides in will not switch your copy of Depth Of Field Generator PRO to REGISTERED mode. As an example, if you followed the steps outlined in the above INSTALLATION section, you would also place the license file into the "/Photoshop/Plug-Ins/" folder. REGISTRATION: If you would like to register Depth Of Field Generator PRO, please visit http://www.dofpro.com/registration.htm LICENSING: You may freely download the plugin and try it as much as you want, whenever you want, wherever you want, by whomever you want, while in DEMO mode. Once registered, ONE (1) Depth Of Field Generator PRO license entitles ANY user to UNLIMITED use of the software, for an INDEFINITE period of time, on ONE (1) workstation ONLY. Currently, there is no floating license option. If you wish to use Depth Of Field Generator PRO on multiple workstations such as in a studio environment, multiple licenses are required for EACH node. COMPATIBILITY: For compatibility information regarding Depth Of Field Generator PRO, please visit http://www.dofpro.com/compatibility.htm DEPTH OF FIELD GENERATOR PRO v3.0 FEATURE SET: * Realistic simulation of complex depth of field camera effects. * Full Batch / Animation / Keyframing support, including: - Industry standardized sequentially padded file reader - Support for all common graphics file formats including .bmp, .gif, .jpg, .jpeg, .png, .tif, .tiff, .tga - Source, Depth Map and Output image specification - Hold frame option for single source frames requiring sequential depth maps - Hold frame option for single depth map frames requiring sequential source maps - Automatic Start and End frame counter - Start and End frame adjustment / range selection - Log file generation and display - Automatic preview window updater - Full keyframe animation support of all sliders complete with animation curves - Graphic display and interactive editing of all animation curves - Broad range of animation curve interpolation methods - Custom interpolation mode for ease in/out, hard in/out etc. - Keyframe jump-to features - Keyframe copy and paste features - Interactive timeline scrubbing - Frame preview * Various Depth Map modes, including: - Fixed Defocus - Vertical Gradient - Radial Gradient - External Depth Map * Powerful focal point adjustment and visualization tools, including: - Focal Depth controller allowing the user to change the focal point of an already existing depth map - Preview window clickable option for interactively selecting where the user wants the focal point - Option to display the currently selected depth map or focal point - Option to overlay the depth map over the source image for visual representation of the focal plane * Numerous Depth Map editing tools, including: - Inversion - Brightness - Contrast - Gamma - Rotation - Stretch Range - Clamp Range - Scale Range * Depth Map Edge Management for artefact reduction/elimination, including: - Alias Depth Map - Selectable Edge Threshold - Edge Blurring - Option to display selected edges * Full Aperture/Bokeh control, including: - Custom Aperture Maps (Create your own aperture shapes in any external application) - Selectable Aperture Shape (Circular, Pentagonal, Hexagonal, Heptagonal, Octagonal, Custom Aperture Map) - Adjustable Aperture Size- Adjustable Bokeh Angle - Adjustable Bokeh Curvature/Roundness (Both negative and positive values) - Adjustable Bokeh Spherical Aberration (Bokeh rings/cores - Both negative and positive values) - Option to toggle between low and high aperture sizes to accommodate film and print requirements - Option to display selected Bokeh * Highlight Enhancement Tools, including: - New and improved Highlight preservation algorithm - New and improved Bokeh visibility algorithm - Selectable Highlight Threshold - Selectable Highlight Enhancement - Ability to Tint Highlights with selectable color - Option to display selected highlights (both processed and unprocessed) * Sophisticated Grain Rendering Engine, including: - Animated or static grain - Monochromatic or random color grain - Uniform, Photometric, Additive or Subtractive modes - Fixed, Depth Map or Blur Amount-controlled distribution - Ability to Tint Grain with selectable color - Instant display of selected grain on a gradient strip * Highly Detailed Rendering Console, including: - Single-Frame Progress Bar Indicator - Detailed graphical batch progress bar - Detailed numerical batch progress bar - Detailed single frame and batch mode timer - Detailed status messaging window - Option to disable preview window for faster workflow - Resolution controlled menu for faster workflow - Selected aperture shape visual display - Full preview rendering statistics - Full final image rendering statistics - Zoom preview options for faster workflow * Easy interface navigation and usability, including: - Saving and loading of user settings - Help display - Source Image Information display - Global reset option - Local reset options (per category) DESCRIPTION: Depth of Field Generator PRO is the result of ongoing research, development and programming collaboration between Richard Rosenman and Martin Vicanek in an effort to produce a Photoshop(r) compliant plugin capable of delivering high quality, sophisticated Depth of Field and Bokeh effects quickly and efficiently as a post process. Depth Of field (DOF) is the amount of distance between the nearest and furthest objects that appear in acceptably sharp focus as seen by a camera lens. This field varies with the focal length of the lens, its f-stop setting, and the wavelength of light. Depth of field is heavily used in photography, film and computer graphics as a creative element, in typical examples ranging from portraiture to macro photography. In photography, DOF is governed by three factors: aperture, lens focal length and shooting distance. Many consumer class cameras, however, do not provide sufficient and independent control of these parameters. Digital cameras, in particular, usually show a wide depth of field - i.e. they are more tolerant to defocus effects. While this may be welcome in some instances (e.g. snapshot applications), it is often a serious deficiency in others (e.g. portraiture/macro photography). In computer graphics, physically accurate DOF can be effectively generated using complex raytracing techniques that tend to increase rendering times significantly. As a result, computer generated broadcast, print and film production often lacks DOF as a consequence of the lengthy calculation times. Depth of Field Generator PRO is available in two versions. v1.5 is intended for photographers and digital artists who require DOF processing on single frames only with a limited featureset. v3.0 is intended for photographers, digital artists and production studios who require DOF processing for animation, video, film and print, or for those who wish to have additional DOF control using v3.0's advanced features. The term "Bokeh", which in Japanese literally means "blurring", has been introduced into the film, photography and computer graphics industries to describe the out-of-focus blur characteristics. It is determined mainly by the shape of the camera lens and can be best seen on out-of-focus highlights which assume the shape of the lens aperture. A lens with few aperture diaphragm blades (say 5) tends to produce pentagonal highlights, whereas a lens with more aperture blades (say 7-8) tends to produce rounder (heptagonal/octagonal) highlights. Ultimately, a higher number of aperture blades will produce more circular highlights. Depth of Field Generator PRO features numerous modes of operation to suit virtually any requirement. In its most powerful mode, DOF PRO uses a specified depth map to derive an accurate DOF effect. A Depth Map is a greyscale image where the grey level at any given point represents the distance of the object from the camera at the same point in the original image. Most 3D Computer Graphics applications are easily capable of producing depth maps along with the rendered image. For photographic images, the user has to create the depth map manually which can be greatly facilitated through the use of the filter's powerful gradient features. DOF PRO v3.0 can not only accept single frame source and depth maps, but also animated sequences in a wide variety of file formats. Why Depth of Field Generator PRO? Naturally occurring depth of field has extremely complex optical characteristics. It cannot be simply simulated through the use of a standard blur filter. Lens size, subject distance, aperture shape, lens curvature, film grain, spherical aberration, lens asymmetry, transparency, light refraction, motion blur and much more must be taken into account in order to achieve an accurate and convincing depth of field effect. A simple gaussian blur is one of the least effective methods of reproducing a believable DOF effect. In addition, a competent DOF filter must also have additional features for dealing with unavoidable post-processing artefacts such as edge management controls, depth map aliasing tools, and highlight enhancement functions. DOF PRO carefully takes into consideration all of these aspects in order to produce the highest quality depth of field output possible. Depth of Field Generator PRO comes with an impressive featureset to meet today's creative industry requirements. v1.5 and v3.0 now feature completely new and improved highlight preservation algorithms as well as new and improved Bokeh visibility algorithms. Various automatic depth map generation and modification tools are available to assist artists in the creation of hand-made depth maps. Numerous aperture shapes are available, each with the ability to control it's size, angle, curvature and even aberration (v3.0). Custom aperture maps have been implemented in DOF PRO v3.0 allowing the artist to create his or her own aperture shapes resulting in unlimited flexibility and control over your Bokeh effects. Support for all common graphics file formats including .bmp, .gif, .jpg, .jpeg, .png, .tif, .tiff, .tga has now been included in v3.0 allowing DOF PRO to be easily integrated into your studio pipeline. A powerful grain generation engine has been developed for v3.0 to assist in the realistic simulation of today's digital imaging pixel noise effects often present in both photographic and monte-carlo raytraced images. Industry-standardized keyframing complete with editable function curves has been introduced in v3.0 allowing the artist to freely animate any / all sliders. This allows common effects such as focus sweeps to be performed easily and professionally with very little setup time required. The interface for v3.0 has been greatly improved and most effects now offer realtime visualization including aperture display, grain representation, function curve updates and slider animation. The aperture size limit has been significantly extended in v3.0 to further assist print and film studio production houses. A highly advanced rendering console provides the artist with detailed status messages, concise progress meters and estimated processing timeframes. All of these new code implementations produce depth of field camera effects that are extremely accurate and precise in simulating real-world phenomena. Depth of Field Generator PRO v3.0 now supports an impressive new feature called Spherical Aberration. This particular effect occurs when an increased refraction of light strikes the lens edge as opposed to the center. While a perfect lens focuses all incoming rays to a point on the optical axis, a real lens with spherical surfaces suffers from spherical aberration: it focuses rays more tightly if they enter further from the optical axis than if they enter closer to the axis. It therefore does not produce a perfect focal point. When the focus is closer to the lens than the axial focus, it is called undercorrected spherical aberration and is often exhibited by a brighter halo around the focus point. Conversely, when the focus is located further than the axial focus, it is called overcorrected spherical aberration and is often exhibited by a brighter core and faint halo around the focus point. DOF PRO can handle positive and negative spherical aberration for any of the predefined aperture shapes in order to achieve stunningly realistic Bokeh effects. Depth of Field Generator PRO v3.0 also offers the capability to use custom aperture maps. Custom aperture maps are images that can be personally created as your own aperture shapes. The benefit of this is significant as users can now produce specialized Bokeh effects previously not possible with v2.0. Starbursts can replace your standard Bokeh effects for enhanced photographic optical glitters, polygonal aperture shapes with more than 8 blades can be used, highly-specific spherical aberration profiles can be created, apertures containing refractive dispersion can be developed, and best of all, real-world Bokehs can be extracted from photographic images to produce extremely realistic depth of field. Access our DOF PRO Aperture Map Library or create your own and share it with other users on our forum. Custom aperture maps will take your DOF PRO renderings to a much higher level than previously possible. Depth of Field Generator PRO v3.0 features full batch / animation / keyframing capabilities internally from within the filter. This completely eliminates the setup time required for Photoshop(r) actions and allows batch / animation / keyframing capabilities to be used from within any host capable of running Adobe Photoshop(r) compliant filters. For a list of compatible hosts, please see the compatibility list at http://www.dofpro.com/compatibility.htm. DOF PRO uses industry-standardized keyframing techniques combined with fully editable animation curves and interactive updates. Any number of sliders in DOF PRO can now be keyframed over any number of frames using single or batch RGB and / or depth map sequences. Eight different interpolation schemes are provided including custom curves for user-defined ease-ins and ease-outs. A new timeline slider provides the user with realtime animation scrubbing control and additional keyframing tools have been implemented such as keyframe jumping, copying and pasting. Existing keyframed data can be saved and reloaded for future use and a preview frame option allows the user to see the results of the keyframed sequence at any frame within the timeline. DOF PRO's powerful keyframing features provide a complete DOF animation and processing package suitable for use in any production environment capable of running Adobe Photoshop(r) compliant filters. Depth of Field Generator PRO v3.0 now includes an advanced pixel grain-rendering engine for even more realistic DOF effects. Noise and grain are important naturally occurring by-products of most monte-carlo raytraced images, digital CCD cameras and conventional film stocks. The introduction of grain and noise in defocused image areas is crucial in producing a realistic DOF effect. However, this is often difficult to achieve due to varying degrees of defocusing throughout the image which therefore requires varying degrees of pixel grain. DOF PRO v3.0 allows pixel grain to be applied in an animated or non-animated fashion and in monochromatic or random color channel methods. The grain can be applied uniformly, photometrically (luma-sensitive), additively, or subtractively and can be distributed in a fixed manner, or even through the use of the focus map which effectively allows the user to recover lost grain of varying intensity. The grain can be tinted in color and a realtime GUI window displays a preview of your currently selected noise attributes. DOF PRO's new pixel grain rendering engine takes your images from a realistic to a photorealistic level. Photometric Burnout is a specific effect that occurs when a subject is photographed in front of an intense backlight (natural or artificial). This produces overexposed image areas in which the subject appears to be silhouetted against the background and it's edges become corroded and contracted. Burnouts are quite different than blurs because the corroded edges of the subject(s) remain sharp and faithfully represent the camera's aperture shape. Since DOF PRO uses optically correct DOF algorithms, photometric burnouts can be easily simulated with virtually no setup time involved. Depth of Field Generator PRO is a production-tested plugin currently being used by thousands of satisfied customers worldwide. Our users range from individual freelance digital artists and photographers to major broadcast, film and print production studios. DOF PRO has been developed with quality output being the number one priority - to produce the most sophisticated and photorealistic DOF effects possible as a post process thus providing a faster alternative to computationally intensive traditional 3D raytracing techniques. We work closely with our users and production studios in an effort to further develop DOF PRO and meet the digital community's creative demands. We continue to maintain our commitment to making DOF PRO as accessible as possible, often by working directly with other software developers to ensure third-party applications are fully compatible. DOF PRO has been reviewed by numerous publishers world-wide, always receiving outstanding reviews, honorary mentions and feature publications. Most important of all, DOF PRO has become the chosen tool for uncompromised, high-quality DOF effects. To register your copy of Depth Of Field Generator PRO, please visit the registration page at http://www.dofpro.com/registration.htm. DOF PRO has been priced competitively in an effort to ensure the plugin is accessible by independent artists as well as large production studios. Control Groups -------------- The Graphical User Interface (GUI) is structured into groups of controls which belong to a logical unit. Individual controls or entire control groups may be enabled or disabled, depending on the settings of other controls. Depth ----- This section contains all the controls related to the image's depth map information. Generally speaking, the depth map information determines the amount of blur applied to a particular region of the image. Mode: Specifies the mode of operation of the filter. The following modes are available: Fixed Defocus - applies a uniform blur to the entire image. This is the simplest (although not the fastest) of all modes. It can be useful for background images. Vertical Gradient - provides a simple depth model based on a vertical gradient, assuming objects at the bottom to be closest. For many landscape images, this option may be a reasonable choice in absence of an appropriate depth map. Radial Gradient - allows you to set a focal point with a gradually increasing blur as you move away from that point. This option may be a reasonable choice for portraiture applications. Depth Map - performs a DOF simulation based on an externally loaded depth map. Load Depth Map: Opens a host dialog to select and load the depth map. If the depth map has been loaded successfully, its filename will be displayed. In v1.2 and above, you no longer have to reload the depth map upon filter invocation if you previously had it loaded. Invert: The default assumption is that black areas in the depth map represent distant objects while white areas represent close objects. Use the Invert option if the depth map is the other way around, or if you want the depth map reversed. Note that the result will be inconsistent if the depth order is wrong. This control will be disabled in Fixed Defocus mode as there will be no depth map present. View Depth: Displays the depth model used, bright for close objects, dark for distant objects. Disabled in Fixed Defocus mode. View Focus: Displays a focus map. White represents objects in focus, black represents objects completely out of focus, grey in between. Note: you can click on the preview window to set the focal depth or you can adjust it with the focal depth slider. Disabled in Fixed Defocus mode. Focal Depth: Slider to adjust the focal depth to a particular grey level of the depth model used (Vertical Gradient or Depth Map). Use this to shift the focus from one object to another. Disabled in Fixed Defocus and Radial Gradient modes. Edges ----- Advanced and optional section to manage, reduce and eliminate possible artefacts at the edges of focused and defocused objects. Such artefacts may occur when using antialiased depth maps or when the difference in focus between two overlapping objects is severe. On the other hand, aliased depth maps tend to produce aliased edges in the processed image. If you encounter visible artefacts, our recommendation is to remove the antialiasing from the depth map and, if necessary, slightly blur the image at the edges of the depth map using the following controls. The controls in this section are only enabled in Depth Map mode. Alias Depth Map: Option to remove antialiasing from depth map. Since most computer graphics applications antialias depth maps by default, we have provided an aliasing operator. View Edges: Displays edges in the depth map according the Edge Threshold setting. This identifies critical areas which may need slight blurring. Edge Threshold: Specifies a threshold for edge detection in the depth map. Blur Image Edge: Controls the amount of blur applied to the processed image at the edges of the depth map. Aperture -------- Here is where you specify the size and shape of the aperture (i.e. the amount of defocus). Higher values may result in significantly longer processing times. Shape: Lets you select the aperture shape from circular, pentagonal, hexagonal, heptagonal, octagonal and Custom Aperture Map. Load: Allows you to load an externally created aperture map. This option will only be enabled when "Custom Aperture Map" has been selected as the aperture shape. Custom Aperture Maps must be in 8 or 24 bit uncompressed BMP format, at a fixed resolution of 256x256. There is a known bug with some 8 bit BMP maps not loading correctly (See Known Bugs Below). View: Displays the selected aperture shape and size. Set the size to a larger value to see more detail. Size: Specifies the aperture size. The value corresponds to the radius in pixels at maximum out-of-focus. 0-225: Toggles the range of the aperture size from 0 t0 225. This is useful for print and film production in which high resolution renders are required with increased DOF. When selected, the "Aperture Size" slider will turn orange as higher values may result in significantly longer processing times. Angle: Allows you to specify aperture orientation. Moving from 0 to 100 covers all orientations without multiples - e.g. full scale (100) rotates a hexagon by 60 degrees. If "Custom Aperture Map" is selected, the value 0-100 will cover 360 degrees. This slider is disabled if Circle is selected as aperture shape. Curvature: Allows you to specify blade curvature. 0 corresponds to straight lines, -100 results in concave lines and 100 results in convex lines (circle). This slider is disabled if Circle is selected as aperture shape. Abber: Specifies the amount of Spherical Aberration to introduce to the aperture shape. Positive values will result in a 'halo' effect, negative values in a 'core' effect. Highlights ---------- This control group deals with highlight management. Due to the limited dynamic range of the image, highlights are usually clipped as a trade-off to a reasonable overall exposure. When highlights are out of focus, this truncated light intensity may be restored as the light is distributed over a larger area. View Selected: Displays the selected highlights. Note that white areas (RGB = (255,255,255)) are always fully selected while darker areas are gradually less selected according to the threshold slider value. View Processed: Displays the processed highlights only - i.e. without the rest of the image below threshold. This option is useful for faster preview of the highlight's Bokeh. Threshold: Determines the onset of highlights. Image areas with brightness values above threshold will be enhanced in order to restore their original (unclipped) brightness. Enhancement: Controls the amount of enhancement. Careful adjustment is recommended, as too high values will result in white and aliased highlights. Tint Color: Allows you to tint the highlights. This may be useful to restore color information which has been clipped away in the image. The default color is set to white which contains the original highlight color information. Grain ----- DOF PRO v3.0 now supports a full-feature grain rendering engine. This engine allows you to add specific noise to the image in order to simulate pixel grain or to restore noise which was in the original image but has been reduced by blurring the out-of-focus areas. A gradient strip is provided to show the selected grain characteristics. Animated: Press for randomized grain distribution in each frame of a sequence. Monochromatic: Press for monochromatic grain. Otherwise red, green and blue channel will each receive independent noise. Distribution Modes: Two drop-down boxes are provided to specify the way how noise is applied to the image. The following options are available: Uniform - applies the same amount of noise to each pixel. Photometric - applies more noise to darker pixels than to brighter pixels. This resembles the properties of digital photos or Monte-Carlo raytraced images. Additive - adds random color values to each pixel. Subtractive - subtracts random color values from each pixel. Fixed - generates spatially independent grain. Focus Map - yields Focus Map-controlled grain, i.e. no grain in focus area, with gradually increasing grain for out-of-focus regions. Blur Amount - similar but not identical to the Focus Map option. Use the Blur Amount mode to recover grain lost by blurring. Tint Color: Option to add colored noise. Note that in Subtractive mode, the grain will appear to have the complementary color. Rendering Console ----------------- This control group deals with rendering management. Because Depth Of Field Generator PRO performs some very complex and sophisticated calculations, render times may be slow. As a result, a great deal of effort has been placed into providing a powerful and robust rendering system which offers the user speed optimization options and detailed status messaging of exactly what is occurring at every stage of the operation and processing of the DOF. Progress: Indicates the currently processed percentage of the preview. Status: Indicates what controller is currently being used, what operation is currently being performed, or what errors, if any, have been encountered. Preview: Enables or disables the preview window for faster workflows. Res/Zoom/100%/Fit: The Res feature controls the resolution of the preview window. This can significantly increase the speed of your rendering by having the filter process every 1st, 2nd, 3rd, 4th, or 5th line only. Make sure to switch it back to 1:1 before applying your final result. The Zoom buttons will display your image in various scaled down resolutions for faster previewing. The "100%" button will force the preview window to display at full resolution (100%). The "Fit" button will force the preview window to display the entire image. Batch Progress (Graphical Display): This will display a progress bar describing the percentage of the batch processing currently completed. Batch Progress (Numerical Display): This will display a numerical value describing the percentage of the batch processing currently completed. Preview: Displays the resolution and total time elapsed for rendering the preview. If batch mode is enabled, this will read "Frame:" and will display the total time elapsed for the currently processed frame. Full: Displays the resolution and total time estimated for rendering the full image. Please note that only estimates for Fixed Defocus mode are accurate. If batch mode is enabled, this will read "Batch:" and will display the estimated total time left for the completion of the currently specified batch process. Aperture Shape -------------- Displays a visual representation of the currently selected aperture shape. Size: If pressed the aperture is displayed at the currently selected size. Info: Displays the selected aperture shape, size, angle, curve and spherical aberration. Batch ----- These controls deal with the batch / animation / keyframing capabilities of the filter. Please see WORKFLOW TIPS below for more information regarding this control group. Configure: Enables the batch control groups for configuring a batch process. Selecting this again will reset the variables and disable the control group. Execute: Runs the configured batch process. Source Image Filename: Opens a file browser for selecting the source image for batch processing. Initially, the currently specified image file for single frame processing will be defaulted. From Version 3.0 onwards, all standard image file formats are supported. Depth Map Filename: Opens a file browser for selecting the depth map for batch processing. Initially, if a depth map has been specified for single frame processing, the currently specified depth map will be defaulted. From Version 3.0 onwards, all standard image file formats are supported. Output Image Filename: Opens a file browser for selecting the output image for batch processing. Initially, a suggested output filename based on the image filename will be defaulted. From Version 3.0 onwards, all standard image file formats are supported. Hold (Source Image): This will hold a single image frame throughout the batch processing. This is useful for when you have one image file with a sequence of depth maps. Hold (Depth Map): This will hold a single depth map throughout the batch processing. This is useful for when you have one depth map with a sequence of image maps. Start: This specifies the currently selected start frame of the sequence. If you change the start frame to a frame that does not exist, the slider will turn red and an "Out of Range" warning will be displayed. The start frame cannot be greater than the end frame. End: This specifies the currently selected end frame of the sequence. If you change the end frame to a frame that does not exist, the slider will turn red and an "Out of Range" warning will be displayed. The end frame cannot be less than the start frame. Create Log File: This will create a detailed log file containing important information regarding the batch process. Display Log File: This will launch Notepad and display the log file. Keyframing ---------- DOF PRO v3.0 now supports industry-standardized keyframing of sliders for the entire batch sequence. Keyframes are anchor points where all sliders have certain, user-configurable values. For all other frames, slider values are determined by interpolation between keyframes. If the first or the last frame is not a keyframe, the outer frames are determined by extrapolation. For each slider, a graphical representation of the corresponding animation curve may be displayed. Slider selector for curve display: Selects the slider for which the curve (i.e. slider value as a function of frame number) should be displayed. Note that all DOF PRO sliders are animatable. Interpolation method selector: Specifies the method used for interpolating between keyframes. Options include: Linear - simple linear interpolation between keyframes. Flat (i.e. zero slope) extrapolation. Cubic Flat - cubic interpolation with zero slope at keyframes. Flat extrapolation. 5th Degree Flat - fifth degree polynomial interpolation with zero slope at keyframes, flat extrapolation. Similar to Cubic Flat, but with smoother behavior at keyframe transition points. Cubic - cubic interpolation, linear extrapolation with "natural" non-zero slopes. Cubic Ease Out - cubic interpolation with zero slope at first keyframe, "natural" slopes otherwise. Cubic Ease In - cubic interpolation with zero slope at last keyframe, "natural" slopes otherwise. Cubic Ease In/Out - cubic interpolation with zero slope at first and last keyframes, "natural" slopes otherwise. Custom - lets you specify incoming and outgoing slopes (see below, "In" and "Out" sliders) for the currently displayed slider curve at each keyframe individually. Curve Display Area: Graphical representation of the slider values as a function of frame number. Keyframes are highlighted with yellow color. A white vertical bar represents the current frame position. Frame: Slider which specifies the current frame. Its range extends from the start frame to the end frame. << Previous Keyframe: Navigates from the current frame to the previous keyframe. Copy: Only enabled if the current frame is a keyframe. Press to copy all slider settings of the current keyframe. Paste: Press to apply slider settings to current frame, which will thereby become a keyframe. The Copy button is only enabled if the Copy button was pressed before. >> Next Keyframe: Navigates from the current frame to the next keyframe. View Frame: Display current frame with animated slider settings. Load appropriate depth map if applicable. Set/Delete Keyframe: Press to define current frame as keyframe. Note that all current slider values (not only the displayed one) will be set. If the current frame is a keyframe, the button is depressed and renamed as "Del Keyframe". Hitting the button will release it and the current frame will no longer be a keyframe. Reset KFs: Reset all keyframes. In/Out: Sliders to set the incoming/outgoing slope at the current keyframe. Only active in Custom interpolation mode. Other Controls -------------- These controls deal with the general functioning and operation of the filter. LOAD/SAVE: Allows you to load or save your current settings. Please note that if you have a depth map loaded, you will have to reload the map on filter invocation. Keyframing data will also be loaded or saved if applicable. OK/CANCEL: Apply or cancel the filter respectively. HELP: Displays a general help window. RESET: Resets all controllers to default settings. INFO: Displays computer display settings and information regarding the source image. REQUEST CODE SAVE: Saves your request code in the filter's root directory in a file called "dofpro.req". This file can then be emailed as an attachment during your registration process for convenience instead of having to manually copy the code. WORKFLOW TIPS: Depth Of Field Generator PRO has been optimized for quality. As a result, it is important to understand the basic functioning of the software in order to know how to get the most out of it. The controls have been arranged in a logical order which make it very intuitive to use. However, the most efficient workflow is not necessarily top down. Below is a quickstart tutorial for single frame and batch processing. You may need to come back to sliders already set and do several such iterations until you get the desired result. SINGLE FRAME QUICKSTART: ------------------------ 1. Open the RGB image in your paint program and run Depth Of Field Generator PRO from the filters menu. 2. Select the depth mode, load a depth map if desired, check that it is actually there ("View Depth"), set focus. 3. Select aperture shape, angle and curvature, and finally size. Note that the processing time scales as the square of the size. You may want to set the preview zoom level to a smaller size in the "Rendering Console" for faster previews. Alternately, you can temporarily disable the preview window if you want to readjust sliders, or change your preview resolution to a lower setting using the "Res" dropdown menu in the "Rendering Console". 4. Set the highlights processing sliders as desired. Use "View Selected" and "View Processed" for faster previews. 5. Check for possible edge artefacts. If necessary, select "Alias Depth Map" and blur edges appropriately to eliminate artefacts. BATCH / ANIMATION QUICKSTART: ----------------------------- 1. Open the sequentially padded RGB image in your paint program and run Depth Of Field Generator PRO from the filters menu. Generally, you would want to open the frame which would be most suitable for applying the DOF effect. While this is most often frame 0, you can open any frame from the sequence. 2. Select the depth mode, load the respective sequentially padded depth map if desired, check that it is actually there ("View Depth"), set focus. It is important to use the same frame depth map as the RGB image or your DOF effect will be incorrect. Therefore, if your RGB image is frame 30, you would also load the corresponding frame 30 depth map. 3. Select aperture shape, angle and curvature, and finally size. Note that the processing time scales as the square of the size. You may want to set the preview zoom level to a smaller size in the "Rendering Console" for faster previews. Alternately, you can temporarily disable the preview window if you want to readjust sliders, or change your preview resolution to a lower setting using the "Res" dropdown menu in the "Rendering Console". 4. Set the highlights processing sliders as desired. Use "View Selected" and "View Processed" for faster previews. 5. Check for possible edge artefacts. If necessary, select "Alias Depth Map" and blur edges appropriately to eliminate artefacts. 6. Enable Batch processing. You will see the source, depth map and output filenames automatically change to the currently specified RGB and depth map images. An output filename will also be suggested. If you have loaded an RGB image that is not sequentially padded (no counter), you will get a warning. If you have only one RGB image that has a corresponding sequence of depth maps, click on the "hold" button in the "Source Image" section. Likewise, if you have only one depth map that has a corresponding sequence of RGB images, click on the "hold" button in the "Depth Map" section. 7. Specify the start and end frames required for the batch processing. The start frame will have automatically been set to the currently loaded RGB frame and the end frame will have automatically been set to the end frame of the sequence. If you specify a new start or end frame which is out of the currently existing sequence range, the respective controller will turn red indicating those frames do not exist. Make sure all three filenames have matching frame numbers or you will get an error when you run the batch process. 8. Click on "Execute" to start the batch processing. If "Create Log File" is enabled, a file containing detailed information pertaining to the batch processing will be saved in the filter's root directory. Clicking on "Display Log File" will automatically launch Windows Notepad and display the file. During the batch process, various status messages will continuously be displayed containing information about the current activity, time elapsed, time required, time per frame, etc. KEYFRAMING QUICKSTART: ---------------------- 1. Open the sequentially padded RGB image in your paint program and run Depth Of Field Generator PRO from the filters menu. Generally, you would want to open the frame which would be most suitable for applying the DOF effect. While this is most often frame 0, you can open any frame from the sequence. 2. Select the depth mode, load the respective sequentially padded depth map if desired, check that it is actually there ("View Depth"), set focus. It is important to use the same frame depth map as the RGB image or your DOF effect will be incorrect. Therefore, if your RGB image is frame 30, you would also load the corresponding frame 30 depth map. 3. Select aperture shape, angle and curvature, and finally size. Note that the processing time scales as the square of the size. You may want to set the preview zoom level to a smaller size in the "Rendering Console" for faster previews. Alternately, you can temporarily disable the preview window if you want to readjust sliders, or change your preview resolution to a lower setting using the "Res" dropdown menu in the "Rendering Console". 4. Set the highlights processing sliders as desired. Use "View Selected" and "View Processed" for faster previews. 5. Check for possible edge artefacts. If necessary, select "Alias Depth Map" and blur edges appropriately to eliminate artefacts. 6. Enable Batch processing. You will see the source, depth map and output filenames automatically change to the currently specified RGB and depth map images. An output filename will also be suggested. If you have loaded an RGB image that is not sequentially padded (no counter), you will get a warning. If you have only one RGB image that has a corresponding sequence of depth maps, click on the "hold" button in the "Source Image" section. Likewise, if you have only one depth map that has a corresponding sequence of RGB images, click on the "hold" button in the "Depth Map" section. 7. Specify the start and end frames required for the batch processing. The start frame will have automatically been set to the currently loaded RGB frame and the end frame will have automatically been set to the end frame of the sequence. If you specify a new start or end frame which is out of the currently existing sequence range, the respective controller will turn red indicating those frames do not exist. Make sure all three filenames have matching frame numbers or you will get an error when you run the batch process. 8. Set the "Frame" slider to the first frame of your sequence, adjust your DOF parameters and select "Set Keyframe". You will notice the "Frame" slider turns yellow to indicate a key has been set. 9. Set the "Frame" slider to the last frame of your sequence, adjust your DOF parameters and select "Set Keyframe". You will notice the "Frame" slider turns yellow to indicate another key has been set. 10. Switching between the various controllers in the keyframing drop-down menu will now display their respective animation curves. Likewise, scrubbing through the animation sequence using the "Frame" slider will show you the animated the controllers in DOF PRO. At this point, you can also define an alternate animation curve interpolation method by selecting one from the right drop-down menu under the keyframing control group. 11. Click on "Execute" to start the batch processing. If "Create Log File" is enabled, a file containing detailed information pertaining to the batch processing will be saved in the filter's root directory. Clicking on "Display Log File" will automatically launch Windows Notepad and display the file. During the batch process, various status messages will continuously be displayed containing information about the current activity, time elapsed, time required, time per frame, etc. IMPORTANT NOTES: - It is important to recognize the difference between a depth map and a focus map. They are not the same. A depth map contains information regarding the location of objects within the scene. A focus map contains information regarding the focal point of the camera. It is not recommended that you use a focus map as your depth map because this will confuse Depth Of Field Generator PRO since there are two depth map branches. Instead, it is recommended that your depth map is output from white to black and then the focus set within the filter using the Focal Depth slider. For instance, if you wish to have an object located in the distance in focus, you would not generate a black to white depth map despite the fact that white generally means objects will be in focus and black that objects will be defocused. Instead, you would generate a standard white to black depth map, and then set the focal depth controller (F-Depth) within the filter from 255 to 0. This will effectively change the focal point from the foreground to the background, as seen by clicking on the "View Focus" button. - Bokeh effects work best on small, bright highlights. If the highlight is too large, the Bokeh effect will get lost within it and it will not be as clearly visible. If you wish to enhance the Bokeh effects, play with the "Highlight Enhancement" tools by adjusting the "Threshold" and "Enhancement" settings until you get the desired result. Be careful when increasing the "Enhancement" controller as values too high can result in aliased highlights. - The Highlight Enhancement algorithm has been completely recoded so that it now provides accurate preservation of original highlights without losing intensity as defocusing increases. In addition, the Bokeh visibility algorithm has also been completely recoded so that Bokeh effects are now significantly more visible than in previous versions. Finally, increasing the Highlight Enhancement controller will now only proportionally affect defocused highlights thus leaving fully focused areas of the image untouched. - Batch processing works with industry standardized sequentially padded image files. If your source, depth or output filenames do not contain matching padded counters, you will get an error. Some acceptable examples are: test_0000.bmp (if less than 10,000 frames) test_000.bmp (if less than 1,000 frames) test_00.bmp (if less than 100 frames) test0000.bmp (if less than 10,000 frames) test000.bmp (if less than 1,000 frames) test00.bmp (if less than 100 frames) Some unacceptable examples are: test_0.bmp test0.bmp - From Version 3.0 onwards, DOF PRO offers support for all common graphics file formats including .bmp, gif, .jpg, .jpeg, .png, .tif, .tiff, .tga. 32 bit images, as well as alpha channels, are not yet supported. - Setting a keyframe will set a key for ALL sliders, regardless of what curve you currently have shown. - Pressing 'Escape' will always cancel the current operation for both single or batch mode processing. MINIMUM SYSTEM REQUIREMENTS: Depth Of Field Generator PRO will run on any PC capable of running Adobe Photoshop v4.0 or higher, or any applications compatible with Adobe's plugin specifications. For software compatibility information, please refer to http://www.dofpro.com/compatibility.htm Depth Of Field Generator PRO will NOT run on Macintosh systems. This is unfortunately a compiler limitation, not a developer decision. DOF PRO has been specifically developed for use with high-resolution displays. Therefore a minimum display resolution of 800x600 is required for v1.5 although a minimum display resolution of 1024 x 768 x 24 bit color is recommended. A minimum display resolution of 1024x768 is required for v3.0 although a minimum display resolution of 1280 x 1024 x 24 bit color is recommended. Depth Of Field Generator PRO works exclusively on RGB images. If you see the plugin greyed out in your plugins menu, you are probably not in RGB mode. From Version 3.0 onwards, Depth Of Field Generator PRO batch mode works with all common graphics file formats including .bmp, .gif, .jpg, .jpeg, .png, .tif, .tiff, .tga. Support for additional image file formats may be added in the future. 32 bit images, as well as alpha channels, are not yet supported. Depth Of Field Generator PRO works exclusively on 24 bit images (8 bits per channel). 48 bit (16 bits per channel) support is intended to be implemented into future updates. Depth Of Field Generator PRO can run with any amount of memory, so long as the host application such as Adobe Photoshop is capable of running. However, a minimum memory capacity of 512 MB is recommended. Running the filter (or any filter for that matter) on extremely large images may result in memory shortages and may prevent the filter from functioning. Depth Of Field Generator PRO has been optimized for quality. Therefore, Depth Of Field Generator PRO will require more processing time than many other plugins. A reasonable performance is achieved with an 800 MHz processor, a faster processor is certainly an advantage. Alternately, if you find the updates to be too slow, you can significantly improve the speed by setting the preview zoom level to a smaller size in the "Rendering Console". Alternately, you can temporarily disable the preview window if you want to readjust sliders, or change your preview resolution to a lower setting using the "Res" dropdown menu in the "Rendering Console". If at any time there is any doubt regarding Depth Of Field Generator PRO's compatibility or functioning, simply try the demo version. If it works, so will the registered version. KNOWN BUGS: V3.0 - 8 Bit BMP depth maps and aperture maps with palettes not set to 256-color greyscale may not load properly. v3.0.74 - System info will display OS as "Unknown" while running under Windows Vista. This will be fixed in a future release. ENHANCEMENTS: v1.1 - Implemented preview window zoom feature. v1.2 - Implemented autoload depth map feature on filter invocation. v1.5 - New and improved Highlight preservation algorithm. v1.5 - New and improved Bokeh visibility algorithm. v2.0 - Implemented full batch / animation capabilities. v3.0 - Implemented common image file formats. v3.0 - Implemented custom aperture maps. v3.0 - Implemented spherical aberration. v3.0 - Implemented full feature grain rendering engine. v3.0 - Implemented full keyframing support for all sliders. v3.0.73 - Accept image files and depth maps with embedded alpha channels. v3.0.73 - 169 frame batch processing error fixed. v3.0.74 - Windows Vista compatibility. COMMENTS: Programming by Martin Vicanek and Richard Rosenman. Special thanks to the FMML Group and ImageMagick LLC. FEEDBACK: If you love, hate or absolutely don't give a damn about Depth Of Field Generator PRO, please let us know at richard@richardrosenman.com or martin.vicanek@web.de. Depth Of Field Generator PRO HOMEPAGE: http://www.dofpro.com Depth Of Field Generator PRO REGISTRATION: http://www.dofpro.com/registration.htm The Official DOF PRO Support Forum: http://www.dofpro.com/forum/