LOGFORMAT(OPCSDEFS)   Optical Printer Control System    LOGFORMAT(OPCSDEFS)

    NAME
        logformat - format how counters appear in log files

    SYNOPSIS
        logformat string

    EXAMPLES
        logformat \# %0ar:%0br:%0cr  %13aF %13bF %13cF %0dS\n
        logformat \# Camera Count=%13cF, Command:

        An example output using the above format string might yield the
        following in the log file:

                # 0:1:1   26(1'10)      0(0'0)      0(0'0)  170.00
                  -----   --------      ------      ------  ------
                    |       |              |           |      |
                    |       |              |           |      |
                  Ratio   Aerial        Main        Camera  Fader
                          Counter       Counter     Counter Position

    DESCRIPTION
        When the camera operator enables LOG(OPCS) and LOGCOUNTERS(OPCSDEFS)
        is enabled, LOGFORMAT(OPCSDEFS) sets the format string used to 
        determine how the counters are printed in the logs.

        The format string can contain 'format sequences' which are replaced
        with various dynamic counter values when printed to the log. Like
        printf() in the C language, backslash escape sequences are honored:

                \r  - carriage return (no line feed)
                \e  - escape
                \n  - a carriage return/line feed
                \t  - tab

        ..and OPCS-specific '%' format sequences, such as:
        
                %5cF     -- print channel 'c' counter in frames(ft'frms) format
                 |||        (e.g. 16(1'0) with 5 digit padding
                 |||
                 ||Indicates "frames(feet)" format
                 |Channel 'c' (camera)
                 The number of digits to pad

        ..which is an example of the general syntax:

                %<width><channel><op>

        ..where:

            <width> a numeric value of how many characters to pad.

            <channel> the channel letter for the counter. ('a'-'p')

            <op> the format operator character which can be one of:

                    r - ratio value, e.g. "1:1:1"
                    p - position, e.g. "26"
                    f - feet'frames, e.g. "1'10"
                    F - frames(feet), e.g. "26(1'10)"
                    S - special (currently, "%0dS" prints fader in degrees)

        '%%' can be used to print a percent character. (OPCS K1.13b+)
        Any other characters are inserted in the logfile verbatim.

	(OPCS K2.03) If FPF(OPCSDEFS) is set to 0 for a channel,
	"-" will be printed in place of a feet'frames value.

    BUGS
	Versions of OPCS earlier than K2.03 would blow out with a
	DIVISION BY ZERO error if FPF(OPCSDEFS) is set to zero for a channel.

	In K2.03, an fpf of zero is supported to disable footage counts,
	such as for film stocks that have a non-integer number of
	frames per foot, e.g. IMAX 15 perf (4.26666) and 10 perf (6.40).

    ORIGIN
        Gregory Ercolano, Venice California 04/07/98