Captioning specification for Screen tab

[think(box)]

CAPTIONING SPECIFICATION for Screen tab

Goals

1. Only add features when compared to v4.01 (fullscreen taskbar caption control was lost in v4.10 beta #11)

2. Keep it straightforward and SIMPLE

3. NOVICE FRIENDLY - show developer must not be confused nor have to ask caption questions in forum

4. EXCLUSIVE caption control by SHOW DEVELOPER ONLY, in all three windowed and fullscreen modes

5. Satisfy as many PTE users' needs as is reasonably possible

6. Use Microsoft "Windows app" common function only where it makes sense

7. Fully specify PTE function since topic contributors are so picky (me too) and confusion wastes our time

This is a specification

This is a complete specification of proposed PTE and P2E function, covering everything that Igor as well as show developers need to know.

PTE GRAPHICAL DESIGN for Screen tab captions as changed from v4.01 appearance:

In PTE Project Options, Screen tab, provide ONE text box with NO graying EVER. It is ALWAYS ACTIVE and in use. This box has the descriptive title "Caption of show". The text in this box is entered by the SHOW DEVELOPER ONLY (no DEFAULT entries). PTE either RESTORES previous text when a .PTE project file is opened, or CLEARS text under certain DEFAULT conditions described below. The "Caption of show" text is used in ALL THREE SHOW MODES - windowed, windowed without border, and fullscreen.

Text box "Caption of show" is placed ABOVE the Fullscreen mode and Windowed mode radio buttons, since it is global to them.

CAPTIONING FUNCTIONALITY

DEFAULTS

1. "Caption of show" text box is CLEARED and made BLANK for the following cases, causing DEFAULT captioning to be used upon show "Create":

• PTE startup - when there is no previous show to automatically open
  
• In File menu, "New" (project) is selected
  
• NOTE - New "project name" is NEVER USED in "Caption of show". Only user text or the showname is used
  

2. PTE NEVER puts DEFAULT show name in the "Caption of show" text box. Only text entered by P2E show developer appears in the text box. This facilitates differentiation between a default show name and a developer-entered show name, even if IDENTICAL.

3. IF the "Caption of show" text box is BLANK, as in ZERO characters, not even <space>:

The "Create" file NAME is determined (without .EXE). This name (with .EXE) is customarily stored in the .PTE tag,

opt_exefn=

Then, for any command that creates a .EXE showfile, the "Create" file NAME is used for:

• Windowed mode show with border, title bar caption
  
• Windowed mode show with border, task bar caption
  
• Windowed mode show without border, task bar caption
  
• Fullscreen mode show without border, task bar caption
  

Note - The name of .EXE file from hard drive is IGNORED and not used in P2E show captioning when show is started. PTE's "Create" file name that was used to CREATE a show is the ONLY default NAME ever used for captions. I.e. when user renames the .EXE file in Windows Explorer the show developer's caption will still be displayed, NOT the (renamed) disk file name. See goal number 4.

CAPTIONS ENTERED BY SHOW DEVELOPER

1. Text ENTERED MANUALLY in text box "Caption of show" is used for captions as shown below, and is stored in .PTE file under the following tag as was used for v4.01 "Caption of window",

opt_scr_caption=

2. Text is RESTORED in text box "Caption of show" when an existing .PTE project file is opened, using value from tag described in item 1.

3. Text is RESTORED in text box "Caption of show" when an existing .PTE show template is opened, using value from tag described in item 1.

4. For items 1 to 3, the text in "Caption of show" box is used for captions as in default operation:

• Windowed mode show with border, title bar caption
  
• Windowed mode show with border, task bar caption
  
• Windowed mode show without border, task bar caption
  
• Fullscreen mode show without border, task bar caption
  

[Igor]

Dear Bill,

Let me thank you for the work you have done!

I just added all corrections as you have suggested in your specification,

concerning "Caption of show".

It will be presented in the next beta #16.