Lens Grapher Interface

The interface for the Lens Grapher is best understood as six distinct segments.

  1. Menus and Shelf Buttons
  2. Working Filename
  3. Lens Data Graph
  4. Table of Values
  5. Viewing Options
  6. Status Report Bar

1. Menus and Shelf Buttons

Every Command that is used in the Lens Grapher can be found in the one of the 4 menus:

  • File
    • Open (CTRL + O)
    • Close (CTRL + W)
    • Save files (CTRL + S)
    • Exit Program (CTRL + Q)
  • Edit
    • Bake Offsets (CTRL + B)
    • Undo (CTRL + Z)
    • Redo (CTRL + Y)
    • Average Cells (SHIFT + A)
    • Delete Point (DEL)
  • View
    • Toggle Viewable Area Graph (CTRL + F)
    • Toggle Graphing Over Rack Zoom or Rack Focus (CTRL + G)
    • Toggle Graphed Lens Parameter (CTRL + H)
    • Toggle Non-Highlighted Graph Visibility (CTRL + R)
    • Toggle Graph to Force Drawing to Zero as Reference Base (CTRL + 0)
    • Focus Step Increment Down (CTRL + LEFT ARROW)
    • Focus Step Increment Up ( CTRL + RIGHT ARROW)
    • Zoom Step Increment Down ( CTRL + UP ARROW)
    • Zoom Step Increment Up (CTRL + DOWN ARROW)
  • Help
    • About Lens Grapher
    • About Calibration File
    • About Lens Parameters

The shelf is detachable and movable to other docking locations in the interface.

  1. Open
  2. Save
  3. Undo
  4. Redo
  5. Close File
  6. Bake Offsets
  7. Average
  8. Delete Points

2. Filename and path

This section gives the filename and full path so it’s easily readable and you always know which file you’re working on. The “asterisk” becomes present at the end of the filename when the file has changed.

3. Lens Data Graph

Navigating the Graph

  • The graph is interactive in that you can click and drag around the graph to view different pieces of it.
  • Use the mouse wheel to zoom in and out of the graph
  • Scrolling down to a Chart Magnification Factor of 1 will always reset the graph, in case you’ve lost your place
  • The farthest the Chart Magnification Factor will zoom in is to a factor of 20

Each of the data points in the graph have data specific tooltip help that pops up when the mouse hovers over the points.

Along the top of the graph, the title displays which dependent lens parameter is being graphed over the currently user selected independent parameter

  • Dependent Lens Parameters
    • Focal Length
    • Distortion
    • Entry Pupil
  • Independent Lens Parameters
    • Rack Zoom – Focal Length Step
    • Rack Focus – Focus Distance Step

Missing Data = Broken Lines

Any missing point(s) in the data file will render as a gap in the graph. This is visual feedback to the user that data is missing from the lens file, or has been deleted.

Modifying the View

Forcing The Graph to Zero

In the options tab on the right, there is a checkbox to “Force Graph to 0”. This ensures that all graphed data is drawn with relation to a zero value.The hotkey for this is CTRL+0.

NOTE: This is an excellent tool to use when viewing the “Viewable Area” graph!! Doing this will force showing all three graphs: viewable area, entry pupil, and focal length.

Showing / Hiding Non-Hilighted Graphs

Sometimes the number of graphs being rendered can obfuscate data interpretation. To this end, you can show, or hide, the currently non-hilighted data. In the Options box on the right of the interface is a slider for “Non-Highlighted Graph Opacity.” The slider controls the opacity of the graphs and allows for a smooth graduation of opacity from opaque to completely transparent. There is an embedded hotkey to toggling the opacity slider from off to partially opaque to fully opaque and back around again. That hotkey is CTRL+R.


4. Table

Viewing Data

The table shows data for all present calibration points in the lens. Any points that are missing or deleted are labeled as such.

Editing Data

Type new values in to the selected cell. Selected cells have a light yellow background color. If you prefer you can overwrite data through the Averaging procedure.

  • Averaging
    • The averaging function works on selected cells, where the order of selection is important
    • You may select anywhere from 3 cells to as many cells as are available in your data.
    • So, if you select four cells: A1, A2, B4, D6
      • D6 = (A1 + A2 + B4) / 3.0
    • This implementation allows for selecting non-adjacent cells when creating the final average output.

Hilighting Data

Use the CTRL and ARROW keys to navigate and highlight data in both the graph and table

“Deleting” Points

The “Del” key will delete any selected cell(s) from the table. Any deleted cell(s) will be removed from the graph. NOTE: “deleted” cells can be reconstituted (either by undeletion or the assigning of a new value)

“Missing” Points

“Missing” points render as “deleted” points do in the graph. In the table they show up as “missing” points. These points Cannot be reconstituted in the Lens Grapher and must therefore be reassigned in Previzion (via lens calibration interface) or by hand editing the text file.

5. Viewing Options

The options for the Lens Grapher are broken into three sections:

  • Z00m – Focus Controls
  • Lens Parameters
  • Options

Zoom – Focus Controls

Use the radio buttons to select which independent variable to view the data by zoom or by focus. Below are images that illustrate the difference

The sliders decide which graph and point are highlighted in both the graph and the table.

Lens Parameters

Choose which of the three dependent lens parameters to graph. Or…

Choose the viewable area graph.


Change the alpha opacity of the non-highlighted graphs with the opacity slider

Please note that when no columns or rows are highlighted then the opacity for all graphs defaults to full on

Force Graph to 0

This option will vertically scale the graph (if needed) to include a zero point in the rendering of the data. Any data set that already crosses from negative to positive, or vice versa, will be unaffected with this option is turned on. This does not edit the data in any way, only the rendering of it.

6. Status Report Bar

Here you can find feedback and program error reports. As en example, the undo and redo queues report, to this status bar, any modifications they make.