Krakatoa Camera Modifier

../../../_images/krakatoa_camera_modifier.png

Available in Krakatoa v1.1.0 and higher

Depth Of Field Bokeh and Anamorphic Squeeze controls available in Krakatoa MX v2.6.1 and higher

Purpose

  • The Krakatoa Camera modifier can be added to any Camera or Light object in 3ds Max
  • It provides override controls to set a Camera or Light’s view to Perspective, Ortho or Spherical Lens camera, override the Field Of View value and specify an f-stop value for Depth Of Field calculations.

Options

Enable Manipulate Mode

  • This checkbox duplicates the functionality of the 3ds Max Select And Manipulate icon in the Main Toolbar.
  • When checked, object manipulators will be activated.
  • The Krakatoa Camera Modifier implements its own manipulator which is visible only when a Camera with a Krakatoa Camera modifier is selected:
  • Perspective Lens Override, 90 degrees FOV Override:
../../../_images/KMX_camera_modifier_manipulator_perspective.png
  • Ortho Lens Override:
../../../_images/KMX_camera_modifier_manipulator_ortho.png
  • Spherical Lens Override, 90 degrees FOV Override:
../../../_images/KMX_camera_modifier_manipulator_spherical.png
  • The small green manipulator handles can be dragged along the yellow circle to adjust the Field Of View.
  • The large green manipulator handle can be dragged along the camera’s axis to adjust the Focal Depth.
  • The yellow overlay text display all relevant settings - Lens Type, Field Of View, Focal Depth - in the viewport.

Override Lens Type

  • The Override Lens Type checkbox controls whether the Lens Type of the underlying camera will be changed or not.
  • When checked, the camera can be switched to one of the following modes:
    • Perspective Lens
    • Ortho Lens
    • Spherical Lens (default).

Override Field Of View

  • The Override Field Of View checkbox controls whether the Field Of View angle in degrees of the underlying camera will be changed or not.
  • When checked, the field of view can be specified in the range from 0.1 to 360.0 degrees using the FOV (deg.) spinner.
  • When using Perspective and Ortho lenses, you should use values up to 180 degrees.
  • The value is animatable.
  • Default is 180.0 degrees.

Override Depth Of Field

  • The Override Depth Of Field checkbox controls whether the f-stop value will be specified and the camera would render Depth Of Field effects or not.
  • When checked, the f-stop value can be specified and optionally animated.
  • Default is 2.0.

Override Focal Depth

  • The Override Focal Depth checkbox controls whether the focal depth will be taken from the camera, or will be overwritten by the modifier.
  • When checked, the Focal Depth value can be specified and optionally animated.
  • Default is 100.0.

See also the topic Depth Of Field.

Bokeh Filter Map

  • The Map Button can be used to select a texture map defining the Bokeh Filter shape.
  • By default, no map is defined, and the Depth Of Field samples will be distributed in the circle of confusion without filtering.
  • When a map is defined and the Use Alpha As Bokeh Filter is checked, and if the Alpha channel is valid, the samples will be filtered using the Alpha channel.
  • If no Alpha channel is available in the map, the RGB channel value will be used to filter the samples.
  • If the Blend RGB checkox is checked (default), the RGB color of the texture will be blended with the sample’s color using the specified Blend RGB percentage value (default is 50.0%)
  • The Map will be rendered in multiple Power-Of-Two resolutions (Mip-Mapping), and the resolution closest to the diameter of the Circle Of Confusion will be used.
  • The Mip-Map Scale integer value can be used to scale the relationship between the Circle Of Confusion and the Bokeh texture’s resolution, so that small COF can pick from a larger resolution map.

Apply Anamorphic Squeeze

  • When checked, the Squeeze Factor value will be used to change the shape of the Circle Of Confusion by sqeezing it horizontally or vertically.
  • Default value is 1.0 (no squeeze).
  • Values less than 1.0 will squeeze the Circle Of Confusion vertically.
  • Values greater than 1.0 will squeeze the Circle Of Confusion horizontally.
  • The value can be keyframed over time.

Bokeh Shape / Sequeeze Preview

  • The preview control will provide an approximation of the look of the Bokeh effect based on the currently selected filter map and related parameters.
  • Updating the controls in the Krakatoa Camera Modifier will update the preview controls automatically.
  • Changing the settings of the texture map in the Material Editor will require a manual update by pressing the Update Preview button.

See the topics Bokeh Effect Controls and Anamorphic Squeeze Controls for more info and demo videos.

Apply Sub-Pixel Offset

  • The Apply Sub-Pixel Offset checkbox enables a fine-tuning mechanism which can be used to offset the Krakatoa output by up to 1 pixel left, right, up or down to better match other renderer’s projections.
  • Both spinners default to 0.0 (no offset).
Example: To match the Krakatoa Spherical Camera output to a Cebas finalRender fisheye camera, you have to enter 1.0 in the Offset Y field, while leaving Offset X at 0.0

Value Presets

  • All spinners provide [>>] Preset buttons with some typical values.
    • The current value can also be added to the Presets list or Removed from the list if already on it.
    • These function similar to the [>>] Preset buttons found in the Krakatoa GUI.