Snapshot - View

The Snapshot - View window displays a single snapshot record. This window is the primary window from which snapshot records can be accessed.

This window can be accessed from the CSDS Main Menu via 'Snapshot | View a record'.

The Snapshot Database is a set of before and after pictures for calls.

Contents

The Snapshot - View window consists of:

• Upper left - Priority, Beats, Tag
  See Snapshot - Fields and Flags
   
• Upper left - Before picture
  Dancers with multiple noses may be facing in any of the indicated directions.
   
• Upper center - Name of call, and Master ID if applicable.
  • Name of call is derived from decoding the handles of the snapshot record.
  • Master ID is a unique number identifying this snapshot record in the master snapshot database.
   
• Upper right - Flags for Private, Protected, No Fuzzy, Non-Standard, Bef Circular, and Aft Circular.
  See Snapshot - Fields and Flags
   
• Upper right - parsed handles for this snapshot.
  Each row:

  • If applicable, small button to show the definition of the call.
  • Name of the handle (call, concept, identifier, numeric, etc.)
  • Handle number in square parentheses [].
   
• Center of screen - After picture
  Dancers with multiple noses may be facing in any of the indicated directions.
   
• Lower left and center - Data table for the snapshot.
  • Before and After X and Y coordinates, Facing, and Roll attributes.
  • HexRot indicates a rotation value if this is a Hex snapshot.
  • Active indicates whether the dancer is active after the call.
   
• Lower right - Author of this snapshot, and if applicable, the creation date of the snapshot.
   
• Lower right - Flags for Asymmetric, Hex squares, Resolve, Getout generated, Mirror same, and Sex-dependent.
  See Snapshot - Fields and Flags

Menu

Edit

Data  (Ctrl+E)

• Invokes the Snapshot - Edit window to edit this snapshot.

Call Name  (Ctrl+N)

• Invokes the Edit Call Name dialog box to edit the call name for this snapshot.

Clone this record

After prompting for a call name, creates a new snapshot record by cloning the current snapshot record. This is an easy way to create another snapshot that is similar to the current snapshot.

Toggle delete  (Del or Ctrl+D)

• Toggles the delete status of the snapshot.
• When deleted, a red banner is displayed across the snapshot, and the snapshot is disabled from being accessed.
  
• Deleted records remain in the snapshot database until the next time the snapshot database is sorted. At this time, the deleted records are physically removed from the database.

Validate

These menu items are helpful for debugging.

Handle list

• The handle list is converted into a text string, parsed, and then the new handle list is then compared to the original handle list.
This catches issues with snapshot records after changes have been made to the parse database.

Record access

• The program internally tries all possible starting positions indicated in the snapshot record to see if the call execution part of the program actually uses this snapshot record.
• If the program does not access this snapshot record, the snapshot is superfluous and can probably be deleted.
• This is a way to find snapshot records that are no longer required, as the program becomes more sophisticated.

Record access - with Debug

• Same as Record access above, but with debugging enabled.
• This option generates a lot of message boxes, showing each step as call execution proceeds.
• Press the button (lower left) to stop showing the call execution debug messages.

Close  (Ctrl+Q)

• Closes this window.

Find

Find a Record  (Ctrl+F)

• Opens the Find Snaphot Record dialog box.
• After search parameters have been entered, and the OK button has been pressed, the program displays the first record matching the search parameters.
• Use Find next and Find previous, described below, to navigate to other records matching the search parameters.

Find All

• Opens the Find Snaphot Record dialog box.
• After search parameters have been entered, and the OK button has been pressed, the program displays a grid of all matching snapshot records.
• See Snapshot - Find All - Results.

Find next  (F3)

• Displays the next snapshot record matching the current search parameters.

Find previous  (Ctrl+F3)

• Displays the previous snapshot record matching the current search parameters.

Master ID  (Ctrl+M)

• Prompts for a snapshot Master ID number then searches for and displays the snapshot if found.

Record #  (Ctrl+R)

• Prompts for a snapshot Record # number and displays that snapshot.

Navigate

First record in database  (Home or Ctrl+F11)

• Displays record #1 in the snapshot database.

Previous record  (PgUp or F11)

• Displays the snapshot immediately preceding the current record (i.e., record # minus 1).

Next record  (PgDn or F12)

• Displays the snapshot immediately preceding the current record (i.e., record # plus 1).

Last record in database  (End or Ctrl+F12)

• Displays the last record in the snapshot database.
• This is usually the last record entered into the snapshot database.
• If you just entered a bad snapshot, you can easily find it just by looking at the last record.
• If you're looking for a recently added bad snapshot, you might find it by viewing the last record in the database then using Previous record (described above) until the bad snapshot is displayed.

Previously viewed record  (F5)

• Displays the previously viewed record.
• Similar to pressing the back arrow button on a web browser to display the previous page.

Last sorted record

• Displays the last sorted record in the snapshot database.
• The snapshot database consists of sorted records (1 through N) followed by unsorted records (N+1 until the end of the database). The unsorted records are all records entered after the snapshot database was last sorted.
• You can use this to your advantage if you're manually searching for a recently added snapshot. Just navigate to the last sorted record, then use Next record (described above) to traverse the unsorted region of the database.

Previous record with different first handle  (F1)

• Searches for and displays the previous record in the snapshot database with a different first handle.

Next record with different first handle  (F2)

• Searches for and displays the next record in the snapshot database with a different first handle.

Previous record with different second handle  (Ctrl+F1)

• Searches for and displays the previous record in the snapshot database with a different second handle.

Next record with different second handle  (Ctrl+F2)

• Searches for and displays the next record in the snapshot database with a different second handle.

Mirror record

• Searches for and displays the mirror image snapshot record, if found, for the current snapshot record.

Display

Dancer Preferences...

• Opens the Preferences - Dancers window.

Grid on/off

• Toggles whether or not the background grid is shown for the after picture.

Dancer information table

• Toggles whether or not the dancer information table (lower left and center) is displayed.

Flags and author

• Toggles whether or not the flags and author section (lower right) is displayed.

View

Before Bitmap  (Ctrl+B)

• Opens a Formation Bitmap window, showing the Before picture.

After Bitmap  (Ctrl+A)

• Opens a Formation Bitmap window, showing the After picture.

Before formation data

• Displays a text string specifying the Before position data, which can the copied to the clipboard, then pasted into a sequence to immediately set the dancers to that position.

After formation data

• Displays a text string specifying the After position data, which can the copied to the clipboard, then pasted into a sequence to immediately set the dancers to that position.