db&w documentation wiki

finest software | finest docs

Site Tools


tools:dofhelper

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
tools:dofhelper [2019/11/24 16:10] – [Basic Functionality] lightwolftools:dofhelper [2020/03/02 16:17] (current) – [Allow Depth Picking] lightwolf
Line 1: Line 1:
-====== DoF Helper (WiP) ======+====== DoF Helper ======
  
 The DoF Helper is a Master plugins that helps in visualising and working with Depth of Field in Layout. The DoF Helper is a Master plugins that helps in visualising and working with Depth of Field in Layout.
Line 13: Line 13:
 The plugin may be added and removed at any time, the changes to the F-Stop and Focal Distance are applied directly to the respective cameras. The plugin may be added and removed at any time, the changes to the F-Stop and Focal Distance are applied directly to the respective cameras.
  
-===== Options =====+===== Handles ===== 
 + 
 +If the currently selected camera has Depth of Field activated, the DoF Helper will display five circles in the 3D viewports that can be used to edit the depth of field. 
 + 
 +From the one closest to the camera to the one furthest away, this is what they change. 
 + 
 +  * The closest handle allows for changing the near plane. This keeps the far plane where it is and adjust the Focal Distance and F-Stop of the camera accordingly. 
 +  * The last handle allows for changing the far plane. This keeps the near plane where it is and adjust the Focal Distance and F-Stop of the camera accordingly. 
 + 
 +<WRAP info> 
 +The handles will only display if Depth of Field is activated for the camera, and currently only for the Perspective and the Real Lens camera. 
 +If Focal Distance and/or Lens F-Stop are not animated, then changing the handles will edit the values directly. If they are animated, then the underlying envelopes will be changed depending on the state of the Auto Key setting in Layout. 
 +</WRAP> 
 + 
 +{{ :tools:pasted:20191202-100321.png}} 
 +If a camera is selected, an icon is displayed in the viewports to toggle DoF for the camera. 
 + 
 +In the camera view, a second icon is displayed to toggle focus selection by clicking on a mesh in the viewport. 
 +----
 {{ :tools:pasted:20191124-143342.png}} {{ :tools:pasted:20191124-143342.png}}
 +===== Options =====
 +
 ==== Presets ==== ==== Presets ====
  
 You can use the [[presets]] to load and save settings as well as save default settings that will be used when the plugin is added to a scene. You can use the [[presets]] to load and save settings as well as save default settings that will be used when the plugin is added to a scene.
  
-==== Selected Display ==== +{{:tools:pasted:20191124-143437.png }}
-{{ :tools:pasted:20191124-143437.png}} +
-==== Deselected Display ====+
  
-==== Near Colour ==== +==== Selected Display / Deselected Display ==== 
-==== Near Alpha ==== + 
-==== Far Colour ==== +These two options define how the Depth of Field is display for the currently selected or any unselected camera. 
-==== Far Alpha ====+ 
 +Most of these options display a volume in the scene that will be in focus ((Basically, the volume where the blur due to the DoF will be smaller than a rendered pixel. This is why it depends on the Render Resolution as well.)). This depends on the Render Resolution, the Frame, Focal Distance and Lens F-Stop of the camera. 
 + 
 +  * None - as the name implies, this displays no additional information. 
 +  * Simple - draws a wire frame box around the volume that will be in focus. 
 +  * Lines - draws three axis through the focus, each ending at the volume that will be in focus. 
 +  * Simple Volume - draws a semi-transparent box around the volume that will be in focus. 
 +  * Focus Plane - draws the plane that will be in focus as a solid, bent shape. 
 +  * Near & Far Plane - draws the near and far planes that encompass the volume that's in focus as solid, bent shapes. 
 + 
 +==== Near Colour / Near Alpha ==== 
 + 
 +The colour and transparency used to display the near plane. 
 +==== Far Colour Far Alpha ==== 
 +The colour and transparency used to display the far plane.
 ==== Use Grid Texture ==== ==== Use Grid Texture ====
 +This will render the focus, near and far planes using a grid texture.
 ==== Display Text ==== ==== Display Text ====
 +Overlays the Focal Distance, F-Stop as well as the distance of the near and far planes to the camera as numeric values.
 ==== Display In-Camera Focus ==== ==== Display In-Camera Focus ====
 +This displays a semi-transparent, white plane at the Focal Distance in the camera view if the camera used for the view is currently selected.
 ==== Allow Depth Picking ==== ==== Allow Depth Picking ====
 +This enables Depth Picking in the camera view, if the currently used camera is selected as well.
 +
 +Depth picking uses a ray casting function supplied by LightWave 3D. This uses an acceleration structure to speed things up, which needs to be created first.
 +For larger meshes, there may be a delay before the depth is picked for the first time. Subsequent picks will be very fast however.
 +
 +Also, the depth picking tries to be smart and only ray casts for the depth of items that are underneath the mouse position by using their bounding boxes first.
 +
 +==== Lock Focal Length ====
 +
 +Disables changing the focal length. This also removes the handle used to interactively change the focal length.
 +
 +==== Lock F-Stop ====
 +
 +Disables changing the F-Stop. This also removes the handles used to interactively change the F-Stop.
 +
 +==== Clamp Min. F-Stop / Clamp Max. F-Stop ====
 +
 +Limits the F-Stop. A limit can be either set for the minimum, the maximum or both values.
 +
 +
 +===== Development Stream for November 2019 =====
 +
 +During the development stream for November 2019, an early version of this plugin was demonstrated.
 +
 +{{youtube>g6rHXCmGG48?medium&start=240}}
  
 +----
 +[[https://www.patreon.com/dbw|{{  ::become_a_patron_button.png?nolink|}}]]
 +This is the plugin of the month for November 2019, made possible by the finest patrons on [[https://www.patreon.com/dbw|Patreon]].
  
  
tools/dofhelper.1574608216.txt.gz · Last modified: 2019/11/24 16:10 by lightwolf