Edit Menu

The Edit Menu provides access to the ability to perform linear measurements from one data point to another, to get information on a particular data point and to adjust the color mapping parameters.

[Edit Menu]
Edit Menu

Linear Distance...

This menu selection is used to generate a linear distance from one point to another in the dataset. This measurement does not take into account the surface topology, so all measurements will be in a straight line, from point A to point B.

Only two (2) points can be selected for each measurement. Select points by holding down the SHIFT key and clicking on each point in turn, using the left mouse button.

[Linear Distance Dialog]
Linear Distance Dialog

The Linear Distance dialog is relatively simple and straight-forward. Each of the elements of this dialog is described in the following listing.

Information Pane

This area is used to display instructions for the user and for the display of any measurement data.

Description

The description text area is used to give a name to any line that you might wish to save for later use.

Add Line

This button is used to save a line. The line must be named in the Description area before it can be saved with the Add Line button.

Line Listing Area

This section of the window is used to display each saved line. Details, such as the name of the line, the XYZ values for the endpoints, and the total length of the line, are displayed for reference.

Line...

After the user chooses a line from the line listing area, the Line button may be used to customize the display of the chosen line in a new window, called "Annoline".

[Annoline Window]
Annoline Window
  1. Show
  2. The Show button will turn on the display of the chosen line, if it is not already turned on.

  3. Hide
  4. The Hide button will turn off the display of the chosen line.

  5. Text
  6. Use this text entry box to modify the name of the chosen line.

  7. Start
  8. This section displays the exact X, Y and Z values of the first endpoint of the chosen line.

  9. End
  10. The End section displays the exact X, Y and Z values of the second endpoint of the chosen line.

  11. Color...
  12. This button will open a color picking dialog box so that the user can change the color of the chosen line.

  13. Graphic Size (m)
  14. This slider adjusts the thickness of the line in the display window. The number value is expressed in meters.

  15. Dismiss
  16. Use the Dismiss button to close the Annoline window.

Delete Line

Use this button to delete any line from the line listing area. The line must be selected in the list by clicking one time using the left mouse button. Please note that there is no undo for this action.

Update

The Update button refreshes the view in this window.

Repeat

The Repeat button allows the user to create multiple measurement lines. Simply press the Repeat button to start the line creation process.

Pick Point Text

The text that is entered in this area will be used to name the line endpoints. By default, "Point" is used.

Pick Point Size (m)

This slider allows the user to adjust the size of the endpoints in the display window. This slider will change the size of the endpoints of any newly-created lines, not of existing lines.

Dismiss

Use the Dismiss button to close the Linear Distance dialog.

Linear Distance Example

In this example, you will open a scan file, set the endpoints of a measurement line, save the line, then delete that line.

  1. Use File | Open to open and select a Head & Face scan for use in this example.
  2. Select Edit | Linear Distance...
  3. Pick the first end point by holding down the SHIFT key then clicking on the desired point with the left mouse button.
  4. [Pick First Point]
    Pick First Point
  5. Pick the second end point by holding down the SHIFT key then clicking on the desired point with the left mouse button.
  6. [Pick Second Point]
    Pick Second Point

    You should now see both end points in the viewing window and a measurement value in the Linear Distance window:

    [Linear Distance]
    Linear Distance
  7. Give the line a name. In the Description text area, type "mouth".
  8. [Linear Distance]
    Linear Distance
  9. Save the line by pressing the Add Line button.
  10. [Add Line]
    Add Line

    The line will now appear in the middle section of the Linear Distance window, as illustrated below:

    [Linear Distance]
    Linear Distance
  11. To delete the line, simply highlight the line by clicking on it one time, then click the Delete Line button.
  12. [Delete Line]
    Delete Line

Point Info...

Select this menu item to get the specifics for a particular data point. A point is select by holding down the "SHIFT" key and clicking on the point that is of interest. The information displayed in the dialog box will be values such as the index of the point in the entire range map, the X, Y, and Z values, and any associated color texture information.

[Point Info Dialog]
Point Info Dialog

The Point Info dialog is very similar in manner to the Linear Distance dialog. Each of the elements of the point info dialog is described in the following listing.

Information Pane

This area is used to display instructions for the user and for the display of any point data. Values that are displayed are as follows:

mapThis value is the name of the texture map. This value is used in CyScan ONLY.
IndexThe point index value is the unique index number of the selected point in the range map data set.
FRZThe FRZ (field, row, z sometimes frame, row, z) value is an uncalibrated value from the scanner. The field and row are used to determine adjacency during tessellation and normal calculations.
XYZThe values displayed here are the actual XYZ values for the chosen point, shown in millimeters.
RGBThese are the RGB values found at the chosen point. The values are displayed in a zero to one range (0.0-1.0).

Description

The description text area is used to give a name to any point that the user might wish to save for later use.

Add Point

This button is used to save a point. The point must be named in the Description area before it can be saved with the Add Point button.

Point Listing Area

This section of the window is used to display all saved points. Details, such as the name of the point and the XYZ values for the point, are displayed for reference.

Point...

After a user chooses a point from the point listing area, the Point button may be used to customize the display of the chosen point in a new window, called "Annotation".

[Annotation Window]
Annotation Window
  1. Show
  2. The Show button will turn on the display of the chosen point, if it is not already turned on.

  3. Hide
  4. The Hide button will turn off the display of the chosen point.

  5. Text
  6. Use this text entry box to modify the name of the chosen line.

  7. Coord:
  8. This section displays the exact X, Y and Z values of the chosen point.

  9. Text Offset
  10. This value controls how closely the "Text" is displayed in relation to the point itself.

  11. Color...
  12. This button will open a color picking dialog box so that the user can change the color of the chosen point.

  13. Graphic Size (m)
  14. This slider adjusts the thickness of the point in the display window. The number value is expressed in meters.

  15. Text Size (pt)
  16. This slider adjusts the size of the "Text" in the display window. The number value is expressed in points.

  17. Dismiss
  18. Use the Dismiss button to close the Annotation window.

Delete Point

Use this button to delete any point from the point listing area. The point must be selected in the list by clicking one time using the left mouse button. Please note that there is no undo for this action.

Save Points

The Save Points button is used to save all of the point information in the listing. When a user presses this button, the software will open a Save As dialog. The user should then navigate to an appropriate folder, name the file (a plain ASCII text file), then press the Save button in the dialog. This data can then be read into a post-processing application, such as a spreadsheet.

Update

The Update button refreshes the view in this window.

Repeat

The Repeat button allows the user to create multiple points. Simply press the Repeat button to start the point picking process.

Pick Point Text

The text that is entered in this area will be used to name the points. By default, "Point" is used.

Pick Point Size (m)

This slider allows the user to adjust the size of the points in the display window. This slider will change the size of any new points, not of existing points.

Dismiss

Use the Dismiss button to close the Point Info dialog.

Point Info Example

In this example, the user will be shown how to open the Point Info window, select and add points, save the point information to a text file, then delete a point.

  1. Use File | Open to open and select a Head & Face scan for use in this example.
  2. Select Edit | Point Info...
  3. Pick a point on the bridge of the nose by holding down the SHIFT key then clicking with the left mouse button.
  4. [Choose Point]
    Choose Point
  5. Add the point.
    1. Type a name for the point into the Description box. For this example, the Description is set to "Bridge".
    2. [Point Description]
      Point Description
    3. Press the Add Point button.
    4. [Add Point]
      Add Point

      The window will now update and look similar to the illustration below:

      [Point Info]
      Point Info
  6. Pick another point and save it, following this procedure:
    1. Select a point on the subject's left pupil, as illustrated below:
    2. [Choose Another Point]
      Choose Another Point
    3. Type a name for the point into the Description box. For this example, the Description is set to "Pupil (L)".
    4. Press the Add Point button.
    5. The window will now update and look similar to the illustration below:

      [Point Info]
      Point Info
  7. Save the points.
    1. Click the Save Points... button.
    2. [Save Points]
      Save Points

      A Save As dialog will now appear.

      [Save As Dialog]
      Save As Dialog
    3. Enter a name for the file. For the purposes of this example, we have named the file "points.txt".
    4. [Save As Dialog]
      Save As Dialog
    5. Press the Save button to save the file.
  8. In case the user would like to remove a point from the listing, the Delete Point button is used.
    1. In the listing, choose the point that is to be deleted. For this example, click one time on the "Pupil (L)" point.
    2. [Choose a Point]
      Choose a Point
    3. Click the Delete Point button. Please note that there is no undo for this action.
    4. [Delete Point]
      Delete Point
  9. Close the Point Info window by clicking on the Window Close button or the Dismiss button.

Document Controls...

This menu selection is reserved for use by Cyberware technicians. The parameters in this panel should not be modified by any user at any time. Modification of these parameters may cause unexpected and permanent changes to the scanner hardware.

Texture Controls...

This set of controls adjusts the alignment of the color map to the range data.

A user should not change these values, except under the direct supervision of a Cyberware technician, or by closely following any troubleshooting procedures. The one occasion where it is necessary to manipulate these sliders is when you wish to zero the scanner. After a zeroing, it is always a good idea to check the color mapping and adjust the values, if necessary. The procedure for this is available in the color alignment guide of this user guide.

[Texture Resample Controls] [Texture Resample Controls]
Texture Resample Controls (RGB)Texture Resample Controls (sRGB)
Scale M Adjusts the size of the texture along the X axis. Increasing this value will stretch the color map along the X axis. Decreasing the value of this slider will shrink the color map along the X axis.
Move M The Move M slider adjusts the texture along the X axis. To move the color map up, increase the value of this slider. To move the color map down, decrease the value of the slider.
Move M Red Adjusts the position, in the X dimension, of the red texture channel. Increasing the value of this slider will move the Red channel to the right, while decreasing the value of this slider will move the Red channel to the left.
Move M Green Adjusts the position, in the X dimension, of the green texture channel. Increasing the value of this slider will move the Green channel to the right, while decreasing the value of this slider will move the Green channel to the left.
Move M Blue Adjusts the position, in the X dimension, of the blue texture channel. The value of this slider must be equal to the Move M Red and Move M Green sliders (each slider must be adjusted separately).
Scale N Adjusts the size of the texture along the Y axis. Increasing this value will stretch the color map along the Y axis. Decreasing the value of this slider will shrink the color map along the Y axis.
Move N The Move N slider adjusts the texture along the Y axis. To move the color map up, increase the value of this slider. To move the color map down, decrease the value of the slider.
Move N S-RGB The Move N S-RGB slider adjusts the texture along the Y axis for 3030/sRGB scanners. To move the color map up, increase the value of this slider. To move the color map down, decrease the value of the slider.
POV X These dimensions are built into the scanner so they are unlikely to vary. For POV Rot X, the value is the distance in meters between the apertures of the range and color lenses.
POV Y POV Y, the value is the distance in meters from the central ray of the range camera to the edge of the texture image.
POV Z POV Z is a hardware constant and should not be manipulated under any circumstances.
texgamma The texgamma slider adjust the gamma value of the color texture map. A higher number will brighten the color map while a lower number will darken the overall color map.
Process Selecting the Process button will apply any texture resampling changes to the dataset.
Save to EeProm This button will save the current settings in the Texture Resample Controls to the EeProm chip on the 3030 scanhead. All previous settings will be overwritten.
Dismiss The Dismiss button will close the Texture Resample window and put into effect any changes that the user made.