View source for Depth of Field test

[[Category:Test Scripts]]

==Purpose==
Test the functionality of the Depth of Field [DOF] render effect.

==Sources==
[[Depth_of_field]]

==Scope==
Video cards with OpenGL 3.0 or higher.

==Test Plan==
===Setup===
# Choose Me menu > Preferences.
# In the Preferences window, click Graphics tab.
# Click Advanced button to show additional options.
# If Lighting and Shadows is not a visible option, you'll need to get a viewer that includes the feature. See https://wiki.secondlife.com/wiki/Depth_of_field#How_can_I_see_the_depth_of_field_effect.3F
# Check Hardware skinning.
# Check Atmospheric shaders
# Check Lighting and Shadows
# Enable the Advanced menu (ctrl-alt-d)
# Open Advanced menu > Show Debug Settings
# Type in CameraFocalLength , set the value to 500 and hit enter. This will will accentuate the Depth of Field effect and make correctness testing easier.

===focus distance is always 16m when not alt-zooming or using flycam===
# Open Advanced menu > Show Debug Settings
# Type in CameraFocalLength , set the value to 50 (default) and hit enter.
# Close Debug Settings
# Hit the escape key so nothing has focus.
# Put your cursor over the sky.
# '''Verify''' your avatar is a little blurry.
# '''Verify''' objects farther than about 16m from you are sharp.
# Open Advanced menu > Show Debug Settings
# Type in CameraFocalLength , set the value to 500 and hit enter. This will will accentuate the Depth of Field effect and make correctness testing easier.

===Alt-zooming on something locks the DOF focus===
# Hold the Alt key and click an object
# '''Verify''' the object is now focused.
# Move your cursor over various objects.
# '''Verify''' the object the object you alt-zoomed on remains focused.

===DOF becomes stronger as you zoom closer to an object===
# Alt-zoom on an object while watching objects in the background.
# '''Verify''' object in the background become fuzzier as you zoom closer to the foreground object.


===DOF does nothing under water===
# Fly under water and '''verify''' the DOF effect is disabled.

===Media on a Prim looks sharp when focused===
# Alt-zoom on a media prim
# '''Verify''' the spot you alt-zoomed on looks sharp.
# Click the focus button on the media bar
# '''Verify''' the camera moves to point directly at the media the entire media face looks sharp.

===In mouselook, object behind the crosshair is focused===
# Enter mouselook mode by pressing the m key.
# Move your view around.
# '''Verify''' that whatever is behind the block cursor in the center of the screen is in focus.
# Exit mouselook mode by pressing the escape key.

===HUD attachments should be ignored===
# Attache a block to your HUD or wear any HUD attachments you own.
# Move your cursor over various objects.
# '''Verify''' your HUD object is always in focus.

===DOF should be off when in build/edit mode===
# Create a box
# '''Verify''' nothing is blurry because DOF has been disabled.
# Close the edit tools.
# '''Verify''' DOF has been enabled again.

=== Flycam Mode ===

=== Object under cursor gets focus in flycam mode ===
# Move your cursor over an object in world
# '''Verify''' object becomes in focus.

=== Specific point on object under cursors gets focus in flycam mode ===
# Move camera very near an object.
# Move cursor around on surface of object.
# '''Verify''' focus tracks mouse cursor "depth."

===Sky and void do not get DOF focus in flycam mode===
# Move your cursor from your avatar to the sky.
# '''Verify''' your avatar remains focused.
# Teleport your avatar next to the void (where there is no region and ocean is rendered)
# Move your cursor from your avatar to the ocean.
# '''Verify''' your avatar remains focused.

===Water within a region does get DOF focus in flycam mode===
# Teleport to some water that is within the boundary of a region.
# Move your cursor from your avatar to the water.
# '''Verify''' the water receives focus.

===if you hover your cursor over your nametag, your avatar should get focus in flycam mode===
# Move your cursor from a distant object to your nametag
# '''Verify''' your avatar becomes focused.


===CameraFieldOfView===
* Open Advanced menu > Show Debug Settings, and type CameraFieldOfView
* '''Verify''' that when you increase this, your focal planes get closer together. ie. the depth of area that is in focus becomes narrower.
* If it's set properly, then mousing around on things should properly focus 
* '''Verify''' this resets to a default of 60.

===CameraFNumber===
* Open Advanced menu > Show Debug Settings, and type CameraFNumber
* Set it to 32, you'll have to really zoom in on an object before the background gets fuzzy.
* Set it to 4, background should be very fuzzy.
* '''Verify''' this resets to a default of 9.

===CameraFocalLength===
* Open Advanced menu > Show Debug Settings, and type CameraFocalLength
* the longer this is, the more narrow the depth of field is. This is used in combination with field of view to calculate the aspect ratio.
* 50mm is what you'd expect to see with 35mm camera
* 200mm is like a telescope
* 5 - 15mm would be like cell phone camera.
* test:
* 1 is basically no DOF
* 1000 is exaggerated DOF, like tilt-zoom
* '''Verify''' this resets to a default of 50.

===CameraFocusTransitionTime===
* Open Advanced menu > Show Debug Settings, and type CameraFocusTransitionTime
* Change value to 3
* Move your cursor over a far away object
* '''Verify''' it takes 3 seconds for the object to become focused.
* '''Verify''' this resets to a default of 0.5s

===Objects with Transparency value of 100% allow right-clicks to pass through Unless it has a touch event.===
* Note: This is a functionality change in the viewer that supports [[Depth_of_field|DOF]]. Previously, right-clicks would not pass through 100% Transparent objects.
# Create 2 boxes.
# Set the Transparency of one box to 99% and the other to 100%
# Attempt to right-click through the objects.
# '''Verify''' you can click through the object that is 100% transparent, but cannot click through the object that is 99% transparent.
# Add a default script to the 100% Transparent object.
# Attempt to right-click through the object.
# '''Verify''' you can no longer click through the object.

* does this break any transparent content that needs right clicking or left clicking?

* does it match up with the right click-thru of semitransparent textures. no.

===Objects with Transparency of 66% or lower will not affect the DOF effect behind them.===
# Set Advanced menu > Show Debug Settings > CameraFocalLength to 500 
# Create a 2x2x2m cube
# Set the cube's transparency to 66%.
# Close the edit tool and alt-zoom on the cube.
# '''Verify''' you see a DOF effect on the objects or ground behind the cube.
# Set the cube's transparency to 67%.
# Close the edit tool and alt-zoom on the cube.
# '''Verify''' everything appears fuzzy behind the cube.


----
Tests to add sometime:
Can different real-world cameras be simulated by plugging in the right FNumber and FocalLength numbers?