|
The 'Full path' strings are encoded in UTF-8 format, and can represent up to 400
characters.
Notes:
(1) ZTree window handle of the instance that last wrote to the pamphlet. Value is X86 standard little endian dword.
(2) When an Y or Ctrl-Y
command is issued, the corresponding application must respond with a return flag. The application must write back the zbar file in the
same format ZTree issued it in, including the block size, revision number and reserved bytes. This flag is the 7th character in the string and can receive a few values as response. See above. Any additional codes for
the return flag which may be added in the future will be characters with the high-bit not set (as to reserve the values >= 0x80 for ZTree itself), and
will not use the hyphen character '-' (which is set by ZTree v1.x per the ZAAP v1 spec). ZTree will wait indefinitely for an
response from the AA when issuing a Y or Ctrl-Y command, but can be interrupted by hitting the Esc key. A ZAAP can return an uppercase
'T' or 'U' return flag to indicate that the file has changed. This causes ZTree to publish a '@' command next, to
notify all ZAAPs that the file has been changed.
(3) If the return flag from a Y or Ctrl-Y command is an error (either "e" or "s"),
the AA should store a message into the "entry line" position of the zbar.dat structure. The length of such error messages should be kept under
73 characters to avoid truncation. The final NULL, the new checksum and a copy of the sequence number have to be refreshed by the AA
before writing to the file. If the format violates the zbar.dat structure rules or the checksum doesn't match, ZTree will not display
the error message in its lower lines.
(4) ZTree screen status informs the AAs what type of screen is being used in Z so they can adjust their
owns. 7 - Auto-view is in use. j - JFC function invoked l - Left
pane is active in split-view. m - Menu screen is in use. n - Normal screen is in
use. r - Right pane is active in split-view. s - Statistics screen is in
use. v - Internal Viewer is in use (in standard mode) x - Execute screen is in use.
(5) When ZTree
starts, the standard "@" is used. When a keyboard command is issued, the "^" is used for the Sh/Ctrl-X commands and "~" for the
Sh/Ctrl/Alt-X ones. When ZTree quits, "Q" is used as a command. When the user enters Y cmd, ZTree uses a "y"
pre-command while waiting for the user to finish the entry and "Y" command when the entry is finished. When the user enters a C
or M command, ZTree puts an "h" pre-command to instruct the AA to stop any work with the current file. When the filename under
the bar changes, ZTree updates the path and uses an "@" as command. When the screen changes format and the filename is the
same, ZTree changes the status and uses "w" as command.
(6) Codes generated with the Sh/Ctrl or Sh/Ctrl/Alt keys. See the SCKeys.kbd for
a list of keyboard codes available.
(7) When a Y or Ctrl-Y command is issued, ZTree informs the AA if it was a simple Y or a tagged Ctrl-Y operation
by means of this flag: "s" for Y, "t" for Ctrl-Y.
(8) Block size indicates the additional block of data that proceeds the
first full pathname, including the block size byte itself. Following the block size is a one byte value indicating the block revision format, currently
1.
(9) Stats indicator can be one of the following values: B - Split screen with stats visible for both panels. C -
Current panel stats are visible (split and non-split). N - Split screen and no stats visible.
(10) Y command string, up to 255 characters
(11)
Checksums are generated using R16 (Rotate-16bit) type. Description: Start CS word to
null. Pointer to beginning of string (sequence #) Loop: (until 3rd null after the reserved block is
processed) Rotate left CS 1 bit Add the character from string to CS
(w/MSB=0) Increment pointer End loop
|