object

      Object associated with this media control interface command. The object can be one of the following:

      • Device type
      • Device name
      • Filename
      • Alias
      AUDIO
        Specifies the audio attributes of the device context determined by the ALL, LEFT, RIGHT, OVER, and VOLUME keywords.

        ALL

          Applies to both or all of the channels (default).

          Specify ON or OFF with the ALL keyword.

          ON

            Enables audio.
          OFF
            Disables audio.
          LEFT
            Applies to the left channel.

            Specify ON or OFF with the LEFT keyword.

            ON

              Enables audio for the left channel.
            OFF
              Disables audio for the left channel.
            RIGHT
              Applies to the right channel.

              Specify ON or OFF with the RIGHT keyword.

              ON

                Enables audio for the right channel.
              OFF
                Disables audio for the right channel.
              OVER milliseconds
                Applies the change over the specified time period (fade).
              VOLUME percentage
                Sets the volume level.
              AUDIOSYNC value
                Sets the audio synchronization value, where value is the MMTIME value to adjust audio time ahead relative to video time.

                FORWARD

                  Sets the audio synchronization value, where value is the MMTIME value to adjust audio time ahead relative to video time.
                REVERSE
                  Sets the audio synchronization value, where value is the MMTIME value to adjust audio time back relative to video time.
                BRIGHTNESS level
                  Sets the capture card brightness to the specified level (0 - 100). The default value is determined by the user through the Setup application; if no value is set by the user in the Setup, a default provided by the particular device-specific physical device driver is used.
                CHANNELS integer
                  Sets the number of channels in the audio soundtrack recording (1 = mono, 2 = stereo). The default setting is 1.
                CONTRAST level
                  Sets the capture card contrast to the specified level (0 - 100). The default value is determined by the user through the Setup application; if no value is set by the user in the Setup, a default provided by the particular device-specific physical device driver is used.
                HUE level
                  Sets the capture card hue to the specified level (0 - 100). where 0 is maximum green, 100 is maximum red, and 50 is neutral. The default value is determined by the user through the Setup application; if no value is set by the user in the Setup, a default provided by the particular device-specific physical device driver is used.
                GRAPHIC COLOR integer
                  Sets the transparent color used as the "chroma-key" on video overlay hardware (has the same effect as specifying the TRANSPARENT COLOR integer). The color is set as a numeric value in the range 0 - (n-1) where n represents the number of colors available. This value only pertains to video overlay devices, such as Video Blaster.

                  The default value is determined by the user through the Setup page for the digital video device; if a default value is not set by the user, 0x2D becomes the default.

                MONITOR state
                  Sets monitoring as specified by state. When monitoring is turned on, a monitor window is created. The monitor window is similar to that of the playback window. Valid state values are:

                  on

                    Enables monitoring.
                  off
                    Disables monitoring.
                  RECORD AUDIO ON
                    Enables audio soundtrack recording. This is the default.
                  RECORD AUDIO OFF
                    Disables audio soundtrack recording.
                  REFERENCE FRAME INTERVAL n
                    Sets the reference frame interval where n refers to a reference frame (I-frame) being inserted every nth frame. A value of 0 results in no I-frames, 1 causes every frame to be an I-frame, 2 causes every other frame to be an I-frame, and so on. Although there is no upper bound on the reference frame interval, a reference frame interval that does not exceed two seconds produces the best results. The default reference frame interval is every 15th frame (once a second at the default frame rate of 15 frames per second).
                  SATURATION level
                    Sets the capture card saturation to the specified level (0 - 100). The default value is determined by the user through the Setup application; if no value is set by the user in the Setup, a default provided by the particular device-specific physical device driver is used.
                  SAMPLESPERSEC integer
                    Sets the number of waveform samples per second in the audio soundtrack recording. This value is usually 11025, 22050, or 44100. The default is 11025.
                  SPEED FORMAT PERCENTAGE
                    Sets the speed format to percentage (playback only).
                  SPEED FORMAT FPS
                    Sets the speed format to frames per second (playback only).
                  TIME FORMAT MILLISECONDS
                    Sets the time format to milliseconds. All position information is this format following this command. You can abbreviate milliseconds as ms.
                  TIME FORMAT MMTIME
                    Sets the time format to MMTIME.
                  TIME FORMAT FRAMES
                    Sets time format to frames. All position information is specified in frames following this command. When the device is opened, frames is the default mode.
                  TIME FORMAT HMS
                    Sets time format to Hours, Minutes, Seconds. All position information is this format following this command.
                  TIME FORMAT HMSF
                    Sets time format to Hours, Minutes, Seconds, and Frames. All position information is this format following this command.
                  TRANSPARENT COLOR integer
                    Sets the transparent color used as the "chroma-key" on video overlay hardware (has the same effect as specifying GRAPHIC COLOR integer). The color is set as a numeric value in the range 0 - (n-1) where n represents the number of colors available. This value only pertains to video overlay devices, such as Video Blaster.

                    The default value is determined by the user through the Setup page for the digital video device; if a default value is not set by the user, 0x2D becomes the default.

                  VIDEO COMPRESSION fourcc
                    Specifies the FOURCC compression type used for recording motion video. Only symmetric compressors will be enabled for real-time recording. Possible types include:

                    DIB

                      Raw (uncompressed format)
                    ULTI
                      Ultimotion
                    RT21
                      Indeo 2.1
                    IV31
                      Indeo 3.1
                    Note: Compressors are not available for FLIC, MPEG, and Indeo 3.2 in this version of OS/2.
                  VIDEO RECORD RATE frames per second
                    Sets the frame rate for recording as an integral number of frames per second. This sets the target record rate, but there is no guarantee this rate will be attained. Drop frame records will be inserted into the output data stream to indicate frames dropped during the record process. The default record frame is rate 15 frames per second.
                  VIDEO RECORD FRAME DURATION integer
                    Sets the frame rate for recording as the time duration of each frame in microseconds. This is useful for setting non-integer frame rates; for example, 12.5 frames per second of a PAL videodisc: 1000000/12.5 = 80000 microseconds. The default frame duration is 66,667 microseconds, equivalent to 15 frames per second. The maximum frame duration is 1,000,000 microseconds (1 frame per second), and the minimum frame duration is 33,333 microseconds (30 frames per second).
                  VIDEO QUALITY level
                    Sets the compression quality level setting to be sent to the CODEC. This value is in the range 0 - 10,000. Not all CODECs support quality level settings. The default setting for video quality is 5000.
                  VIDEO COLOR integer
                    Sets transparency color for transparency in video on dual-plane video adapters such as RealMagic. Graphics will be seen wherever the transparency color appears in the video. The color is set as a numeric value in the range 0...(n - 1). Where n represents the number of available colors.
                  WAIT
                    The command is executed synchronously. The function waits until the requested action is complete before returning to the application.
                  NOTIFY
                    The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

                  [Back] [Next]