virtual tour example

home gallery product info downloads buy now support learn more search

support

Extra stuff

This web page describes extra stuff in The Panorama Factory V5.2 and newer.  Some features may also be available in earlier versions of The Panorama Factory, but we do not attempt to document the differences between versions.

These features exist to help support @ panoramafactory.com diagnose difficulties you may be having with The Panorama Factory.  They may be used for other purposes, but we do not guarantee their suitability for any other purpose.  These features may change without notice.


Screen capture

The Panorama Factory contains a built-in screen capture function.  To capture a a single window, dialog box, etc. inside The Panorama Factory, hover the mouse over the window and type CTRL+F7.  To capture the entire screen, hover the mouse outside of The Panorama Factory and type the key.

Holding down SHIFT with CTRL+F7 delays for 10 seconds before capturing the screen to make it possible to set up the screen (e.g. popup menus) if needed.

Holding down ALT with CTRL+F7 when hovering over a window engages the enlargement function.  This enlarges the capture rectangle until its boundary covers a uniform color.  If your desktop is a single color, this enlarges the screen capture to include all overlapping windows.

SHIFT and ALT may be combined.

The screen capture displays an expanding rectangle to confirm the area captured and then you are given the opportunity to save the screen image in any of the image formats supported by The Panorama Factory.

top


Send a screen capture to customer support

You may find it helpful to send a screen image to support @ panoramafactory.com to help illustrate a problem you are experiencing.  Or we may ask you to send one.

To send a screen capture, start by capturing the screen as described in the previous section.

To send the screen capture without saving it to a file, hold down the CTRL and ALT keys and click Cancel.  If you want to send the screen capture and also save it to a file, hold down the CTRL and ALT keys when you click OK on the Save image dialog box.

top


Send an image file to customer support

You may find it helpful to send an exported image to support @ panoramafactory.com to help illustrate a problem you are experiencing.  Or we may ask you to send one.

To send an exported image, use the Save current image as command (File menu).  When you are prompted to save the file, hold down the CTRL and ALT keys when you click OK on the Save image dialog box.

top


Send a project file to customer support

You may find it helpful to send an entire stitching project to support @ panoramafactory.com to help illustrate a problem you are experiencing.  Or we may ask you to send one.

To send a project file, hold down the CTRL and ALT keys and click this toolbar button: .

top


Memory usage report

To create a report summarizing the current state of virtual memory usage, open the Timers dialog box (Tools menu).  While holding down the CTRL and ALT keys (PC) or COMMAND and ALT keys (Mac), click the Reset button.  The memory usage report will be written to the file pfmemusage.txt in the system temp folder.

top


Open a project when the imported images are missing

If one or more of the imported images is missing, The Panorama Factory will ordinarily refuse to open the project.  For each missing image file, The Panorama Factory displays a message box saying Cannot open file abc.jpg.  To substitute a gray rectangle for the missing image file, hold down the CTRL and ALT keys (PC) or COMMAND and ALT keys (Mac), when you click OK on this message box.

top


Runtime trace

The Panorama Factory contains a runtime trace feature that may be enabled by creating a special file.  To enable the trace feature, create the file pftrace.txt in the system temp folder.  The first line of the file controls the trace options.  Trace messages are appended to the end of the file.  Set the first line of the file to:

 

max    mask.1    count.1    mask.2    count.2    ...

  max Decimal integer representing the maximum size that the file may grow in kbytes.  Trace is automatically disabled when the file exceed this size.
  mask Hexadecimal mask value controlling the trace options.  DO NOT start this value with 0x.  Its value is interpreted as hexadecimal without any special prefix or suffix notation.
  count Decimal integer limiting the number of trace lines to print.  When the trace line number reaches this value, the next mask and count values are used.  When the trace line number reaches the final count value, trace is disabled.

The trace mask values are created by the bitwise OR of these values:

00000001 (0) Major steps during low-level application startup.
00000002 (1) Major steps during interactive application startup.
00000004 (2) Certain steps in the Options dialog box.
00000008 (3) Loading the languages list in the Options dialog box.
00000010 (4) Reserved.
  00000020 (5) Memory allocation.  Displays a message every 100 allocations and also for each allocation of 64K (0x10000) bytes or larger
00000040 (6) Progress messages.
00000080 (7) QuickTime import.
  00000100 (8) Temporary file creation during QuickTime export. While this option is enabled, the name of the temporary files are written to the trace and the files are not removed from the disk.
  00000200 (9) Color management.  In addition to regular trace messages, it will display the names of all known color profilesthe first time you click OK on the Color management dialog box after enabling this trace option.
  80000000   Trace is enabled only if the file does not contain any trace lines after the header line.  This has the effect of enabling trace for a single run of the program.
00000000 (z) Turn all trace options off.

Each time you start The Panorama Factory, the trace feature is initialized by the first line of the file, and then trace messages are appended to the end of the file.  The file is not truncated, so it continues to grow up to max kbytes.  At this point, trace is disabled and will not reenable regardless of the mask and count values.

Some examples:

10 00000003 100
Maximum file size is 10 kbytes.  The first 100 application startup messages are displayed.

100 FFFFFFFF 1000
Maximum file size is 100 kbytes.  The first 1000 trace messages are displayed, regardless of type.

100 00000060 1000 00000040 2000
Maximum file size is 100 kbytes.  The first 1000 memory trace and progress messages are displayed. Thereafter, 1000 more progress messages are displayed.

1 80000003 4
Maximum file size is 1 kbyte.  The names of the first 4 temporary files created by QuickTime export are displayed in the trace file, but only on the first run of the program.  The 4 files are not deleted.  QuickTime export typically creates 4 temporary files if the exported image contains hotspots and 3 if it does not contain hotspots, so this trace line will capture the temporary files from the first QuickTime export after starting the application.

100 0 0
Maximum file size is 100 kbytes.  Trace is initially disabled but may be enabled by a key combination as described below.

You may turn trace on or off from the keyboard.  Start by typing \ while holding down the CTRL and ALT keys.   Then type digit and/or letters while continuing to hold down the CTRL and ALT keys.   The digits to type for particular trace options are shown in parentheses in the list above.  Turning on a trace option adds it to the set of options that are already on without turning any off and simultaneously sets the trace limit to display 1000 more messages.  The letter z turns all trace options off.

The Panorama Factory will ask if you want to send the trace file to to support @ panoramafactory.com if the trace stops for any of these reasons:

  1. The trace count was reached.

  2. You typed \ twice while holding down the CTRL and ALT keys.

  3. You exited the application.

The trace file is not automatically sent if the program terminates abnormally.  In this case, you must locate the file pftrace.txt in the system temp folder and send it to us manually.

Here are some convenience links for turning trace on and off.

  Windows Mac
100 00000000 10000
Enable trace but set the mask to zero.  By default, no trace lines will be written into the file.  You can use the keyboard commands to turn trace options on and off.
pftrace_enable.bat <coming_soon>
100 80000063 10000
Create a single memory trace the next time The Panorama Factory runs and then disable trace thereafter.
pftrace_memory.bat <coming_soon>
100 8000000F 10000
Create a single application startup/options trace the next time The Panorama Factory runs and then disable trace thereafter.
pftrace_startup.bat pftrace_startup.dmg
Open the trace file in the default text editor. pftrace_view.bat <coming_soon>
Disable trace and remove the trace file. pftrace_off.bat <coming_soon>

top


Opening the system temp folder/tmp

If you have not changed the location of the system temp folder, you can open it this way:

Windows Vista and Windows 7

  1. Click the Windows logo menu (usually located in the lower left hand corner of the screen).

  2. Enter %TMP% into the box containing the phrase "Start Search" (Windows Vista) or "Search programs and files" (Windows 7) and press the ENTER key.

Windows XP

  1. Click the Windows Start menu (usually located in the lower left hand corner of the screen).

  2. Select the Run command from the Start menu, enter %TMP% into the Run dialog box and then click OK.

Mac OS X 10.5 (Leopard) and 10.6 (Snow Leopard)

  1. Open a Finder window.

  2. Choose the Go to Folder ... command from the Go menu in Finder.  A dialog box will appear for you to type the folder name.

  3. Enter /tmp into the dialog box and click Go.

  4. If the file you are looking for does not appear here, you may find it in Leopard's new login-specific temp folder.  To open this folder, start the Terminal application (from /Applications/Utilities).  Enter the command open $TMPDIR in the Terminal window to open the login-specific temp folder:

Mac OS X 10.3 (Panther) and 10.4 (Tiger)

  1. Open a Finder window.

  2. Choose the Go to Folder ... command from the Go menu in Finder.  A dialog box will appear for you to type the folder name.

  3. Enter /tmp into the dialog box and click Go..

top


Revised: January 16, 2010

 1999-2009 Smoky City Design, LLC and John Strait