VirtualBox

Changeset 75138 in vbox for trunk/doc/manual/en_US


Ignore:
Timestamp:
Oct 29, 2018 9:29:11 AM (6 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
126216
Message:

FE/VBoxManage: Renamed the video capturing options to better reflect which option is generic to capturing and which is bound to the video recording feature. This also should make space for the upcoming audio feature options. Got rid of the deprecated stuff which was in there for too long.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/user_VBoxManage.xml

    r74003 r75138  
    18861886    </sect2>
    18871887
    1888     <sect2 id="vboxmanage-modifyvm-videocap">
    1889 
    1890       <title>Video Capture Settings</title>
     1888    <sect2 id="vboxmanage-modifyvm-capture">
     1889
     1890      <title>Capture Settings</title>
    18911891
    18921892      <para>
    1893         The following settings for changing video recording parameters
    1894         are available through <computeroutput>VBoxManage
     1893        The following settings for changing video and/or audio capture
     1894        parameters are available through <computeroutput>VBoxManage
    18951895        modifyvm</computeroutput>.
    18961896      </para>
     
    19001900        <listitem>
    19011901          <para>
    1902             <computeroutput>--videocap on|off</computeroutput>: This
     1902            <computeroutput>--capture on|off</computeroutput>: This
    19031903            option enables or disables recording a VM session into a
    1904             WebM/VP8 file. If this option is enabled, recording will
    1905             start when the VM session is started.
    1906           </para>
    1907         </listitem>
    1908 
    1909         <listitem>
    1910           <para>
    1911             <computeroutput>--videocapscreens all|&lt;screen ID&gt;
     1904            file. If this option is enabled, recording will start when the
     1905            VM session is started.
     1906          </para>
     1907        </listitem>
     1908
     1909        <listitem>
     1910          <para>
     1911            <computeroutput>--capturescreens all|&lt;screen ID&gt;
    19121912            [&lt;screen ID&gt; ...]</computeroutput>: This option allows
    19131913            to specify which screens of the VM are being recorded. Each
     
    19181918        <listitem>
    19191919          <para>
    1920             <computeroutput>--videocapfile
     1920            <computeroutput>--capturefile
    19211921            &lt;filename&gt;</computeroutput>: This option sets the
    19221922            filename VirtualBox uses to save the recorded content.
     
    19261926        <listitem>
    19271927          <para>
    1928             <computeroutput>--videocapres
     1928            <computeroutput>--capturemaxtime
     1929            &lt;ms&gt;</computeroutput>: This option sets the maximum
     1930            time in milliseconds the capturing will be enabled
     1931            since activation. The capturing stops when the defined time
     1932            interval has elapsed. If this value is zero the capturing is
     1933            not limited by time.
     1934          </para>
     1935        </listitem>
     1936
     1937        <listitem>
     1938          <para>
     1939            <computeroutput>--capturemaxsize
     1940            &lt;MB&gt;</computeroutput>: This option limits the maximum
     1941            size of the captured file (in MB). The capturing stops
     1942            when the file size has reached the specified size. If this
     1943            value is zero the capturing will not be limited by file size.
     1944          </para>
     1945        </listitem>
     1946
     1947        <listitem>
     1948          <para>
     1949            <computeroutput>--captureopts &lt;key=value&gt;
     1950            [,&lt;key=value&gt; ...]</computeroutput>: This format can
     1951            be used to specify additional capturing options. These
     1952            options only are for advanced users and must be specified in
     1953            a comma-separated key=value format. For example:
     1954            <computeroutput>foo=bar,a=b</computeroutput>.
     1955          </para>
     1956        </listitem>
     1957
     1958        <listitem>
     1959          <para>
     1960            <computeroutput>--capturevideores
    19291961            &lt;width&gt;x&lt;height&gt;</computeroutput>: This option
    1930             sets the resolution (in pixels) of the recorded video.
    1931           </para>
    1932         </listitem>
    1933 
    1934         <listitem>
    1935           <para>
    1936             <computeroutput>--videocaprate
    1937             &lt;rate&gt;</computeroutput>: This option sets the bitrate
     1962            sets the video resolution (in pixels) of the recorded file.
     1963          </para>
     1964        </listitem>
     1965
     1966        <listitem>
     1967          <para>
     1968            <computeroutput>--capturevideorate
     1969            &lt;rate&gt;</computeroutput>: This option sets the video bitrate
    19381970            in kilobits (kb) per second. Increasing this value makes the
    19391971            video look better for the cost of an increased file size.
     
    19431975        <listitem>
    19441976          <para>
    1945             <computeroutput>--videocapfps &lt;fps&gt;</computeroutput>:
    1946             This option sets the maximum number of frames per second
     1977            <computeroutput>--capturevideofps &lt;fps&gt;</computeroutput>:
     1978            This option sets the maximum number of video frames per second
    19471979            (FPS) to be recorded. Frames with a higher frequency will be
    19481980            skipped. Reducing this value increases the number of skipped
    19491981            frames and reduces the file size.
    1950           </para>
    1951         </listitem>
    1952 
    1953         <listitem>
    1954           <para>
    1955             <computeroutput>--videocapmaxtime
    1956             &lt;ms&gt;</computeroutput>: This option sets the maximum
    1957             time in milliseconds the video capturing will be enabled
    1958             since activation. The capturing stops when the defined time
    1959             interval has elapsed. If this value is zero the capturing is
    1960             not limited by time.
    1961           </para>
    1962         </listitem>
    1963 
    1964         <listitem>
    1965           <para>
    1966             <computeroutput>--videocapmaxsize
    1967             &lt;MB&gt;</computeroutput>: This option limits the maximum
    1968             size of the captured video file (in MB). The capturing stops
    1969             when the file size has reached the specified size. If this
    1970             value is zero the capturing will not be limited by file
    1971             size.
    1972           </para>
    1973         </listitem>
    1974 
    1975         <listitem>
    1976           <para>
    1977             <computeroutput>--videocapopts &lt;key=value&gt;
    1978             [,&lt;key=value&gt; ...]</computeroutput>: This format can
    1979             be used to specify additional video capturing options. These
    1980             options only are for advanced users and must be specified in
    1981             a comma-separated key=value format. For example:
    1982             <computeroutput>foo=bar,a=b</computeroutput>.
    19831982          </para>
    19841983
Note: See TracChangeset for help on using the changeset viewer.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette