Diver iOS App, version 4.3.0; How To
iPad App
Figure 1. The iOS Diver app on the iPad; tap the Diver icon to launch the app.
launch-app
Figure 2. After the app launches the Diver login screen appears.* Enter your login email & password and tap the LOGIN button.
Tap the "browse Diver anonymously" (circled in blue below) link to enter Diver without logging in (anonymous users can browse dives, but only logged in users can create new clips).
Diver login is by invitation only, email joro@stanford.edu to request an invite code. Once you've obtained an invite code tap the register link (circled in green below) and fill in the signup form to complete registration. After registering you'll be automatically signed in to your account and will have full access to the app. A password will be emailed to you.
*If you've previously logged in you'll automatically be taken to the browse view (figure 3) immediately after the app launches without having to log-in again.
login
Figure 3. After logging into (or anonymously entering) Diver, the "Browse Dives" view opens showing a list of all saved dives with the newest to oldest clips in descending order.
When logged in* tabs appear (circled in green below) at the top of the browse list. Tap the "My Stuff" tab to filter by only your dive clips, or tap "Everyone" to see everyone's dive clips.
Search (figure 4) or scroll, and then tap any of the thumbnails to go to the "Diver Player" view (figures 15-17) and watch the dive clip.
*Tabs are visible to logged in users only. When browsing anonymously all dive clip filtering automatically defaults to "Everyone".
browse-dives
Note: If the dive clip's already been rendered (figure 23) the projector icon (tap to play the rendered video, see figure 24) and plus (tap to add the clip to the stitcher, see figure 26) will be visible (circled in red above). If you authored the dive the pencil icon (circled in red) will also be visible (tap to edit the clip's text, figure 21). The flag icon is visible for all dives (tap it to report any issues you have with the clip).
Figure 4. In addition to the "My Stuff" and "Everyone" tabs (figure 3) you can also search/filter the entire collection of saved dive clips on any word from a comment.
Search with whole words only, i.e. a single word or multiple words separated by spaces–  and with only the letters a-z, A-Z, numbers 0-9, and/or these special characters ~!@$%&*)-_=]:";',.?/ allowed in search words.
Tap the CLEAR link (circled in green, below the search button) to clear the search and start over.
Note: Words in comments preceded by hashtags (#) become search links–  tapping a linked word (circled in purple) automatically initiates a search i.e. returning only those words preceded by the # tag; e.g. search all dive clips with #PresidentTrump included in the comment.
browse-dives-search
Figure 5. Tap the menu icon (circled in green) at the top of the screen to open the main menu.
Tap any of the menu items to initiate the specified action or navigate to another view; or tap the icon again to close the menu.
e.g. To pick new videos to load into Diver, tap "My Videos" (circled in blue) in the main menu and choose one of your own videos (see figures 6-7).
main-menu
Note: When in the Player, Settings, or How To views users can return to Diver's Browse view by tapping the big "D" (logo-d) in the Diver logo at the top left corner of the screen.
Figure 6. Tap "My Videos" from the main menu (figure 5) to pick from any video already in your iPad's camera roll.
Select one of your videos (e.g. circled in green below) to load into Diver, or tap "Cancel" (circled in red) to go back.
Note: Videos shot in portrait mode will be stretched to fit for landscape in Diver.
my-videos
Figure 7. After picking (figure 6) use the iPad's built in editor (circled in green) to select a portion* of your video to import into Diver.
Tap the play button (circled in purple below) to preview your selection. Tap "Use" (circled in red) to load the selection into Diver, or tap "Videos" (circled in blue) to pick another video.
*Imported videos can be a maximum of 4 minutes long.
my-videos-edit
Figure 8. Back in the Diver app tap the play button (circled in green below) to play the video.
Tap the step-buttons (circled in blue) to precisely step the video forward or backward in 1/8th second increments; or press & hold the step-buttons to more rapidly step through the video.
Time-code (circled in blue above the step buttons) is displayed (as both current playback time and total duration) to e.g. help precisely position the video before tapping RECORD (see figure 9).
video-loaded
Preview videos in full-screen prior to making a dive— tap the enlarge icon (circled in purple) to enter full-screen mode. Tap anywhere on the full-screen video to toggle play & pause. Tap the close (X) icon to exit full-screen and return to the Diver Player.
Figure 9. Tap the RECORD button to make a temporal/spatial dive clip. If paused the video begins playing. The button blinks red to indicate recording is in progress. Drag or resize the guided-noticing rectangle (see figures 11-14), all of the rectangle's motion is saved as part of the clip recording. Tap RECORD again to stop the recording.
Note: Maximum dive clip RECORD time is 90 seconds; minimum dive clip RECORD time is 1 seconds. No diving is allowed on "My Videos" selections longer than 4 minutes (see figure 7).
dive-record
How to use the Guided-Noticing Rectangle
Drag, resize, and zoom Diver's "guided-noticing" rectangle. Note that that all finger taps/presses inside the guided-noticing rectangle temporarily display a transparent yellow square (to resize), double squares (to zoom), or a circle (to drag) under your finger indicating where to tap/press to initiate the desired action.
See figures 11 through 14...
Figure 11. Drag to move Drag the guided-noticing rectangle from the center to change its position.
gn-drag
Figure 12. Resize from corner Drag diagonally from any corner of the guided-noticing rectangle to resize.
gn-resize
Figure 13. Pinch to zoom Pinch with two fingers inside the guided-noticing rectangle to shrink or enlarge.
gn-pinch
Figure 14. Default size/position Double-tap to return the guided-noticing rectangle to default position and size.
gn-doubletap
Figure 15. After making a new dive clip with RECORD type your comments (up to 256 characters*). All words in comments (whether preceded by a # tag or not) are searchable. Adding a keyword preceded by a hashtag (e.g. #PresidentTrump) anywhere in a comment makes that word a clickable search link (see figure 4).
Tap the SAVE button to save the clip, or tap the CANCEL button to discard the clip and start over.
*By limiting to only a few words comments can appear as large(r) font headlines in the text area of the rendered dive clips (see figures 23-25).
Prior to saving you can PREVIEW & TRIM the clip (see figure 22, Dive clip TRIM). The undo icon (circled in purple below) becomes activate after trimming, tap it to revert changes.
dive-save
Figure 16. Tap the video thumbnail (circled in green below) to playback your recording. Dive recordings will automatically stop playing at the end of the clip. At any time tap the thumbnail again (or tap the play/pause button or move the video slider) to stop the dive clip from playback.
During RECORD playback the dive clip's in & out points are indicated by markers (circled in red below) on the time slider.
dive-playback
Figure 17. For dive clips made with RECORD you can play back only the panned/zoomed area that's inside the guided-noticing rectangle's path (called "Free‑D"™) by checking the ZOOM checkbox (circled in red) below the thumbnail (note that the checkbox is only visible during RECORD playback).
You can also play dive clips made with RECORD in a continuous loop by checking the LOOP checkbox (also only visible during RECORD playback).
Tap the (circled in green) ENLARGE icon (during RECORD playback) to go from portrait to landcape mode and play dive clip videos at fullscreen (see figure 17).
dive-player-icons
Figure 18. After tapping the ENLARGE icon (figure 16) the app enters fullscreen video playback mode (in portrait or landscape, depending on device orientation).
If the ZOOM icon (figure 16) was selected before tapping ENLARGE only the video that's inside the guided-noticing rectangle plays fullscreen ("Free‑D"™). Otherwise the entire frame plays fullscreen with the guided-noticing rectangle floating on top of the video.
Tap the close/X icon (circled in green) at the top corner of the screen to exit fullscreen and return to portrait mode. If LOOP (figure 16) was not checked the app automatically exits fullscreen when the dive clip ends.
Note: The Diver app automatically detects orientation and rotates videos accordingly (landscape or portrait) when playing fullscreen; e.g. to watch fullscreen videos at their largest size turn your iPad to landscape/horizontal view during playback.
enlarge-fullscreen
Figure 19. After saving a dive clip it can take up to a few minutes to finish processing.
Dive processing takes place remotely and won't slow down, block, or otherwise adversely affect performance of the app. You can playback the dive clip (see figure 17) while it's still processing, however the RENDER icon (figures 23-25) won't appear and you won't be able to e.g. share the dive clip (figure 27) until the processing completes.
While the dive finishes processing its thumbnail icon will indicate "IMAGE PROCESSING" (and with videos picked from "My Videos" — indicate "VIDEO UPLOADING" or "VIDEO TRANSCODING") in the Diver Browse view (as circled in the screen capture below).
Note: While dive clips are uploading & transcoding the "My Videos" menu item (figure 5) will be disabled– i.e. you can only upload/transcode one video at a time from your iPad.
fig21-media-processing
Figure 20. To check if the dive clip's finished processing, refresh the Browse view.
Scroll to the top of the view and then pull straight down. Make certain you pull all the way down from the very top of the Browse view until both activity spinners (circled in green below) appear, then let go. The Browse view automatically springs back into position and refreshes.
In addition to pull-down, users can alternatively tap the "refresh" icon (circled in blue) to refresh the browse view.
If the dive clip has completed processing the thumbnail will change from "IMAGE PROCESSING" to a still image of the start frame from your dive (circled in red below).
Note: As dive clips are processed the thumbnail image will change to indicate status (uploading, transcoding, etc.). When complete the final thumbnail will in most instances automatically display without manually refreshing the view.
fig22-browse-refresh
Figure 21. If you previously created & saved a dive clip you can delete, edit, trim, or render it at any time after processing completes (see figures 19-20)*. You can only delete, edit, trim, or render the clips you own; you can't perform these functions on someone else's clips.
Tap DELETE to permanently remove the dive clip. Tap EDIT to edit the dive clip's comment.
Note: The DELETE, EDIT, TRIM, and RENDER icons (circled in red below) are replaced with the ZOOM, LOOP, and ENLARGE icons (figure 17) while the dive clip is playing. When the dive clip stops playing, DELETE, EDIT, TRIM and RENDER will appear again.
*The DELETE, EDIT, TRIM, and RENDER icons aren't displayed until after "My Videos" upload & transcode complete.
fig23-icons
Figure 22. Dive clip TRIM
Tap the TRIM icon to open the dive clip trim editor.
Tap the left-side step buttons (circled in green below) to trim the dive clip's IN-time in 1/8 second increments, or tap the right-side step buttons (circled in blue) to trim the dive clip's OUT-time. Press & hold the step-buttons to more rapidly step through and trim the video.
Alternatively, you can drag the marker triangles above the slider to change the IN/OUT times. The time-code indicators help to more precisely trim the dive clip.
Tap the SAVE button to save the trimmed clip, or tap CANCEL to revert the changes and close the dive clip trim editor.
Note: Dive clips are limited to a minimum 2 seconds and a maximum 90 seconds.
Pro Tip: Double-tap a triangle marker to reset to the saved IN or OUT time. If the markers overlap or are too close together to select & drag, tap a step button or tripple-tap a marker to toggle the markers front to back.
dive-clip-trim
Figure 23. Dive clip RENDER
Rendered dive clips are self contained video files that can play anywhere even without the Diver app.
Tap the RENDER icon, the dive clip render popup opens.
Tap the RENDER button in the popup (circled in green below) to place the dive clip into the rendering cue, or tap CANCEL to exit without rendering.
Rendering can take several minutes to complete, you'll receive a notification (and email) with links when the video's ready.
Note: You can only render the dives you own, you can't render someone else's clips. Additionally, if the dive clip was created prior to Diver version 1.3.0 the render function will not be available.
dive-clip-render
Figure 24. RENDER, Playback
After the dive clip render completes* a check mark appears next to the RENDER icon (circled in red below), tap to play the rendered dive clip video.**
Tap the share icon (circled in purple) to copy*** the rendered dive clip's URL to your iPad's pasteboard; you can then paste & share the link on e.g. Twitter or Facebook (see figure 27), send it in an email or text, open and play the clip in a web browser, etc.
Tap the download icon (circled in blue) to save*** the rendered dive clip video to your iPad's camera roll.
To exit the rendered dive clip playback and return to the main Diver player screen tap the close/X icon (circled in green).
Note that rendered dive clips play fullscreen in either landscape or portrait mode. The Diver app automatically detects orientation; e.g. rotate the iPad to landscape/horizontal position to watch fullscreen videos at their largest size.
*Completed renders are accessible by everyone and not just the dive clip's owner.
**In app (iPad only) version >=3.7.3 you can switch between either video format (2-up or square) for playback by tapping the 2-up/square icons (circled in orange below).
***In app version >=3.3.0 both the download and share link offer the option of selecting video in either a 2-up (576x242) or square (600x600) format (see figure 25).
dive-share-link
Figure 25. RENDER, Download & Share
Some dive clips rendered with app version >=3.3.x will include the option to download and share videos in two different formats:
1) 2-up; 576 wide X 242 high with both the guided noticing rectangle (on the left) and the zoomed portion of the video (on the right).
2) zoomed; 600X600 square video format, i.e. just the zoomed area form inside the guided-noticing rectangle.
If the square (600X600) format video's available a popup will appear when tapping the download or share (figure 26) icons. Tap the the 2-up icon (circled in purple below) to download or share the 576X242 video, or tap the zoomed icon (circled in blue) to download or share the 600X600 video.
Videos download as self contained MP4 files, playable anywhere even without the Diver app. All files are saved to the iPad's camera roll.
Shares link to web pages (see figure 27) where users can play rendered dive clips in a browser without downloading videos or installing the app.
Note: If the square (600X600) format’s unavailable download (and share) will automatically default to 2-up (576X242) video.
diveclip-render-download
Figure 26. Dive clip Stitcher
Stitch (combine) up to 4 rendered dive clips (figures 23-25) into a single downloadable video.
Add clips to be stitched…
From the Diver Player (figure 21) tap RENDER or the check (check) icon (circled in red below) to open the rendered dive clip player, then tap plus (plus) next to the download and share icons (see figure 25) to add the clip. Clips can also be added to the stitcher by tapping the plus (plus) icon from the Browse view (see figure 3).
Open the Stitcher popup…
Once clips are added the "Stitcher" menu (figure 5) item becomes active, tap it to open the dive clip stitch popup.
Drag a thumbnail atop any square to change the order in which clips are stitched. Drag a thumbnail anywhere outside the popup to remove a clip from the stitch list.
Tap the PREVIEW button (circled in purple) to preview the stitched clips in either the 2up (576X242) or square (600x600) video formats.
Tap the STITCH (circled in green) button to stitch the clips. Stitching can take several minutes to complete, you'll receive a notification (and email) with links when the video's ready.
diveclip-stitch
Figure 27. Share via social apps or the web...
Sharing a rendered dive URL (figures 23-25) on e.g. Facebook or Twitter automatically populates the post or tweet with a link to the dive. Tapping the post opens the dive clip in a web browser (e.g. Safari).
Tap the play button to play the video in your web browser (e.g. Safari). If Diver is installed on the iPad tapping the "open in app" link (at the top of the web page) automatically opens the dive clip in the Diver app.
An example dive clip shared on a) Facebook; and b) in Safari:
dive-share-facebook-safari
Figure 28. After login the Settings options is available in the main menu (figure 5). Tap it to load the Settings page. In Settings tap the black arrows (circled in blue) to change your Password, Name, or Email. Tap the Logout button (circled in red below) to log out.
The current version # of the Diver app (e.g. "v 4.3.0 43040125222015") is also displayed in the bottom right corner (circled in green below) of the Settings page.
diver-settings
iPhone App
Diver is a "Universal" iOS app, the same App Store download can be launched natively on either iPad or iPhone.
Figure 29. iPhone Browse view...
If you've previously logged into Diver on the iPhone launching the app opens it in Browse view (see below), otherwise the app opens with the login screen (figure 2).
The iPhone's Browse view displays a list all available dive clips (see figures 3-4).
Tapping a thumbnail (e.g. circled in red below) opens that dive clip in the iPhone player (see figure 30).
iphone-browse
Figure 30. iPhone Player view...
After tapping a thumbnail (figure 29) the dive clip opens in the Diver player view.
Most features from the iPad version are also available on the iPhone*, e.g. play an existing clip (see figure 16), RECORD a new dive clip (see figure 9), etc.
Tap the ←BACK button (at the top of the app, circled in green) to go back to Diver's browse view.
iphone-player
Tap the RENDER icon (circled in red) to render the dive clip (see figure 23) or play an already rendered clip (figure 24).
Note: Rendered dive clips play fullscreen in landscape mode; i.e. the iPhone version of the Diver app does not automatically detect orientation, instead manually rotate the phone.
iphone-rotate-player
Build # 43040125222015;  © 2002-2022