MOTORS(OPCS)		Optical Printer Control System		MOTORS(OPCS)

    NAME
        motors - enable/disable the motor hardware for debugging scripts

    USAGE
        motors [on|off]

    DESCRIPTION
        With off as an argument, this command will disable motor
	movement, causing any commands that run motors (pro,cam,rep,go..)
	to NOT move the motors. Counters will run, but the motors will not.
	Also buckle/viewer checks will be disabled, not checking the
	actual hardware.

	This command is useful for testing OPCS without motors and without
	any actual hardware connected, such as developing camera 'run' scripts
	on a portable computer, to be run later on an actual printer.

	RUN(OPCS) scripts will execute faster when 'motors off' is
	in effect, allowing one to rapidly debug complex scripts.

	When motors are disabled with this command, the current position
	of the motors are saved. When you re-enable the motors with 
	'motors on', the counters will revert to the previous positions
	just before 'motors off' was issued, avoiding confusion over
	where the motors REALLY are.

   ENVIRONMENT

	OPCS_NOMOTOR_FRAME_DELAY
	(NEW IN K2.21/TC) This environment variable can be set before OPCS
	is started to configure a per-frame msec delay for 'motors off'
	simulated shutter runs for camera/projectors.

        If unset or set to zero, 'motors off' shutter runs are instantaneous,
	the default behavior, enabling rapid debugging of RUN(OPCS) scripts.

	However, it is sometimes useful for simulated shutter runs to consume
	at least some per-frame time. Setting this variable to e.g. 250 msecs
	causes a 1/4 second delay per simulated frame.

	This variable can be set in AUTOEXEC.BAT, or anytime in DOS before
	OPCS is started. For example, this sets the delay to 250ms (1/4 sec):

	    set OPCS_NOMOTOR_FRAME_DELAY=250

	..and this disable the delay (same as if the variable is unset):

	    set OPCS_NOMOTOR_FRAME_DELAY=0

    EXAMPLES
        cam 12        # Runs the camera 12x
	motors off    # Disable running the motors
	cam 12        # Counter will advance 12x, but motor wont run
        motors on     # Enable motors. Counters revert to actual posn. 
        cam 12        # Run the camera normally

    SEE ALSO
        CHK(OPCS)  - check if counters are where they're supposed to be
	RUN(OPCS)  - run OPCS command scripts (quickly with 'motors off')

    ORIGIN
        Gregory Ercolano, Los Feliz California 08/23/90
© Copyright 1997 Greg Ercolano. All rights reserved.