VirtualBox

Changeset 105387 in vbox


Ignore:
Timestamp:
Jul 17, 2024 5:04:04 PM (6 months ago)
Author:
vboxsync
Message:

FE/VBoxManage + Manual: Updates for the new recording API. Russian translation TBD. bugref:10718

Location:
trunk
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/en_US/man_VBoxManage-controlvm.xml

    r105266 r105387  
    480480        <arg choice="plain">off</arg>
    481481      </group>
    482     </cmdsynopsis>
    483 <!--
    484     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-start">
     482
    485483      <command>VBoxManage controlvm</command>
    486484      <group choice="req">
    … …  
    489487      </group>
    490488      <arg choice="plain">recording start</arg>
    491       <arg><replaceable>wait</replaceable></arg>
    492     </cmdsynopsis>
    493 
    494     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-stop">
     489      <arg>--wait</arg>
     490
    495491      <command>VBoxManage controlvm</command>
    496492      <group choice="req">
    … …  
    499495      </group>
    500496      <arg choice="plain">recording stop</arg>
    501     </cmdsynopsis>
    502 
    503     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-attach">
     497
    504498      <command>VBoxManage controlvm</command>
    505499      <group choice="req">
    … …  
    508502      </group>
    509503      <arg choice="plain">recording attach</arg>
    510     </cmdsynopsis>-->
    511 
    512     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-screens">
     504
    513505      <command>VBoxManage controlvm</command>
    514506      <group choice="req">
    … …  
    522514        <arg choice="plain"><replaceable>screen-ID</replaceable><arg rep="repeat">,<replaceable>screen-ID</replaceable></arg></arg>
    523515      </group>
    524     </cmdsynopsis>
    525 
    526     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-filename">
     516
    527517      <command>VBoxManage controlvm</command>
    528518      <group choice="req">
    … …  
    532522      <arg choice="plain">recording filename</arg>
    533523      <arg choice="req">filename</arg>
    534     </cmdsynopsis>
    535 
    536     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videores">
     524
    537525      <command>VBoxManage controlvm</command>
    538526      <group choice="req">
    … …  
    542530      <arg choice="plain">recording videores</arg>
    543531      <arg choice="req"><arg choice="req"><replaceable>width</replaceable></arg>x<arg choice="req"><replaceable>height</replaceable></arg></arg>
    544     </cmdsynopsis>
    545 
    546     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videorate">
     532
    547533      <command>VBoxManage controlvm</command>
    548534      <group choice="req">
    … …  
    552538      <arg choice="plain">recording videorate</arg>
    553539      <arg choice="req"><replaceable>rate</replaceable></arg>
    554     </cmdsynopsis>
    555 
    556     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videofps">
     540
    557541      <command>VBoxManage controlvm</command>
    558542      <group choice="req">
    … …  
    562546      <arg choice="plain">recording videofps</arg>
    563547      <arg choice="req"><replaceable>fps</replaceable></arg>
    564     </cmdsynopsis>
    565 
    566     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxtime">
     548
    567549      <command>VBoxManage controlvm</command>
    568550      <group choice="req">
    … …  
    572554      <arg choice="plain">recording maxtime</arg>
    573555      <arg choice="req"><replaceable>sec</replaceable></arg>
    574     </cmdsynopsis>
    575 
    576     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxfilesize">
     556
    577557      <command>VBoxManage controlvm</command>
    578558      <group choice="req">
    … …  
    582562      <arg choice="plain">recording maxfilesize</arg>
    583563      <arg choice="req"><replaceable>MB</replaceable></arg>
    584     </cmdsynopsis>
    585 
    586     <!--
    587     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-opts">
     564
    588565      <command>VBoxManage controlvm</command>
    589566      <group choice="req">
    … …  
    594571      <arg choice="req"><replaceable>key</replaceable>=<arg><replaceable>value</replaceable></arg></arg>
    595572    </cmdsynopsis>
    596     -->
    597573
    598574    <cmdsynopsis id="synopsis-vboxmanage-controlvm-setcredentials">
    … …  
    15131489    </refsect2>
    15141490    <refsect2 id="vboxmanage-controlvm-recording">
    1515       <title>Enable or Disable the Recording of a Virtual Machine Session</title>
     1491      <title>Recording of a Virtual Machine Session</title>
    15161492      <remark role="help-copy-synopsis"/>
    15171493      <para>
    … …  
    15241500        value is <literal>off</literal>.
    15251501      </para>
    1526     </refsect2>
    1527 <!--
    1528     <refsect2 id="vboxmanage-controlvm-recording-start">
    1529       <title>Starts the Recording of a Virtual Machine Session</title>
    1530       <remark role="help-copy-synopsis"/>
     1502
    15311503      <para>
    15321504        The <command>VBoxManage controlvm
    … …  
    15351507        WebM/VP8 file.
    15361508      </para>
    1537     </refsect2>
    1538     <refsect2 id="vboxmanage-controlvm-recording-stop">
    1539       <title>Stops the Recording of a Virtual Machine Session</title>
    1540       <remark role="help-copy-synopsis"/>
     1509
    15411510      <para>
    15421511        The <command>VBoxManage controlvm
    … …  
    15441513        stops the recording of a VM session.
    15451514      </para>
    1546     </refsect2>
    1547     <refsect2 id="vboxmanage-controlvm-recording-attach">
    1548       <title>Attaches to a running Recording of a Virtual Machine Session</title>
    1549       <remark role="help-copy-synopsis"/>
     1515
    15501516      <para>
    15511517        The <command>VBoxManage controlvm
    … …  
    15531519        attaches to a running recording of a VM session.
    15541520      </para>
    1555     </refsect2>
    1556 -->
    1557     <refsect2 id="vboxmanage-controlvm-recording-screens">
    1558       <title>Specify the Virtual Machine Screens to Record</title>
    1559       <remark role="help-copy-synopsis"/>
     1521
    15601522      <para>
    15611523        The <command>VBoxManage controlvm
    … …  
    15801542          </para></listitem>
    15811543      </itemizedlist>
    1582     </refsect2>
    1583     <refsect2 id="vboxmanage-controlvm-recording-filename">
    1584       <title>Specify the File in Which to Save Virtual Machine Recording</title>
    1585       <remark role="help-copy-synopsis"/>
     1544
    15861545      <para>
    15871546        The <command>VBoxManage controlvm
    … …  
    15951554        <filename>webm</filename> file name extension.
    15961555      </para>
    1597     </refsect2>
    1598     <refsect2 id="vboxmanage-controlvm-recording-videores">
    1599       <title>Specify the Resolution of the Recorded Video</title>
    1600       <remark role="help-copy-synopsis"/>
     1556
    16011557      <para>
    16021558        <command>VBoxManage controlvm <replaceable>vmname</replaceable>
    … …  
    16251581          </para></listitem>
    16261582      </itemizedlist>
    1627     </refsect2>
    1628     <refsect2 id="vboxmanage-controlvm-recording-videorate">
    1629       <title>Specify the Bit Rate of the Video</title>
    1630       <remark role="help-copy-synopsis"/>
    1631 <!-- @todo r=andy Clarify rate. -->
     1583
    16321584      <para>
    16331585        The <command>VBoxManage controlvm
    … …  
    16451597        value.
    16461598      </para>
    1647     </refsect2>
    1648     <refsect2 id="vboxmanage-controlvm-recording-videofps">
    1649       <title>Specify the Maximum Frequency of the Video</title>
    1650       <remark role="help-copy-synopsis"/>
     1599
    16511600      <para>
    16521601        The <command>VBoxManage controlvm
    … …  
    16641613        the Recording tab of the Display page to view the default value.
    16651614      </para>
    1666     </refsect2>
    1667     <refsect2 id="vboxmanage-controlvm-recording-maxtime">
    1668       <title>Specify the Maximum Amount of Time to Record Video</title>
    1669       <remark role="help-copy-synopsis"/>
    1670 <!-- @todo r=andy Clarify time format. -->
     1615
    16711616      <para>
    16721617        The <command>VBoxManage controlvm
    … …  
    16771622        you stop the recording.
    16781623      </para>
    1679     </refsect2>
    1680     <refsect2 id="vboxmanage-controlvm-recording-maxfilesize">
    1681       <title>Specify the Maximum Size of the Recorded Video</title>
    1682       <remark role="help-copy-synopsis"/>
     1624
    16831625      <para>
    16841626        The <command>VBoxManage controlvm
    … …  
    16901632        modify this setting while recording is enabled.
    16911633      </para>
    1692     </refsect2>
    1693     <!--
    1694     <refsect2 id="vboxmanage-controlvm-recording-opts">
    1695       <title>Specify Custom Options for Recording Video and/or Audio</title>
    1696       <remark role="help-copy-synopsis"/>
     1634
    16971635      <para>
    16981636        The <command>VBoxManage controlvm
    … …  
    17091647      </para>
    17101648    </refsect2>
    1711     -->
     1649
    17121650    <refsect2 id="vboxmanage-controlvm-setcredentials">
    17131651      <title>Specify Credentials for Remote Logins on Windows Virtual Machines</title>

  • trunk/doc/manual/ru_RU/man_VBoxManage-controlvm.xml

    r105266 r105387  
    456456        <arg choice="plain">off</arg>
    457457      </group>
    458     </cmdsynopsis>
    459 <!--
    460     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-start">
     458
    461459      <command>VBoxManage controlvm</command>
    462460      <group choice="req">
    … …  
    465463      </group>
    466464      <arg choice="plain">recording start</arg>
    467       <arg><replaceable>wait</replaceable></arg>
    468     </cmdsynopsis>
    469 
    470     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-stop">
     465      <arg>--wait</arg>
     466
    471467      <command>VBoxManage controlvm</command>
    472468      <group choice="req">
    … …  
    475471      </group>
    476472      <arg choice="plain">recording stop</arg>
    477     </cmdsynopsis>
    478 
    479     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-attach">
     473
    480474      <command>VBoxManage controlvm</command>
    481475      <group choice="req">
    … …  
    484478      </group>
    485479      <arg choice="plain">recording attach</arg>
    486     </cmdsynopsis>
    487 -->
    488     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-screens">
     480
    489481      <command>VBoxManage controlvm</command>
    490482      <group choice="req">
    … …  
    498490        <arg choice="plain"><replaceable>экран</replaceable>,[<replaceable>экран</replaceable>...]</arg>
    499491      </group>
    500     </cmdsynopsis>
    501 
    502     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-filename">
     492
    503493      <command>VBoxManage controlvm</command>
    504494      <group choice="req">
    … …  
    508498      <arg choice="plain">recording filename</arg>
    509499      <arg choice="req">filename</arg>
    510     </cmdsynopsis>
    511 
    512     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videores">
     500
    513501      <command>VBoxManage controlvm</command>
    514502      <group choice="req">
    … …  
    518506      <arg choice="plain">recording videores</arg>
    519507      <arg choice="req"><replaceable>ширина</replaceable>x<replaceable>высота</replaceable></arg>
    520     </cmdsynopsis>
    521 
    522     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videorate">
     508
    523509      <command>VBoxManage controlvm</command>
    524510      <group choice="req">
    … …  
    528514      <arg choice="plain">recording videorate</arg>
    529515      <arg choice="req"><replaceable>битрейт</replaceable></arg>
    530     </cmdsynopsis>
    531 
    532     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-videofps">
     516
    533517      <command>VBoxManage controlvm</command>
    534518      <group choice="req">
    … …  
    538522      <arg choice="plain">recording videofps</arg>
    539523      <arg choice="req"><replaceable>кадров/сек</replaceable></arg>
    540     </cmdsynopsis>
    541 
    542     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxtime">
     524
    543525      <command>VBoxManage controlvm</command>
    544526      <group choice="req">
    … …  
    548530      <arg choice="plain">recording maxtime</arg>
    549531      <arg choice="req"><replaceable>сек</replaceable></arg>
    550     </cmdsynopsis>
    551 
    552     <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording-maxfilesize">
     532
    553533      <command>VBoxManage controlvm</command>
    554534      <group choice="req">
    … …  
    15811561    </refsect2>
    15821562    <refsect2 id="vboxmanage-controlvm-recording">
    1583       <title>Включить или выключить запись сессии виртуальной машины</title>
     1563      <title>Recording of a Virtual Machine Session</title>
    15841564      <remark role="help-copy-synopsis"/>
    15851565      <para>
    … …  
    15941574        Эта команда не влияет прямо на состояние выполнения ВМ.
    15951575      </para>
    1596     </refsect2>
    1597     <refsect2 id="vboxmanage-controlvm-recording-screens">
    1598       <title>Задать экран виртуальной машины для записи</title>
    1599       <remark role="help-copy-synopsis"/>
     1576
     1577      <para>
     1578        The <command>VBoxManage controlvm
     1579        <replaceable>vmname</replaceable> recording start</command> command
     1580        starts the recording of a VM session into a
     1581        WebM/VP8 file.
     1582      </para>
     1583
     1584      <para>
     1585        The <command>VBoxManage controlvm
     1586        <replaceable>vmname</replaceable> recording stop</command> command
     1587        stops the recording of a VM session.
     1588      </para>
     1589
     1590      <para>
     1591        The <command>VBoxManage controlvm
     1592        <replaceable>vmname</replaceable> recording attach</command> command
     1593        attaches to a running recording of a VM session.
     1594      </para>
     1595
    16001596      <para>
    16011597        Команда <command>VBoxManage controlvm
    … …  
    16201616          </para></listitem>
    16211617      </itemizedlist>
    1622     </refsect2>
    1623     <refsect2 id="vboxmanage-controlvm-recording-filename">
    1624       <title>Задать файл для сохранения записанной сессии виртуальной машины</title>
    1625       <remark role="help-copy-synopsis"/>
     1618
    16261619      <para>
    16271620        Команда <command>VBoxManage controlvm
    … …  
    16381631        Эта команда не влияет прямо на состояние выполнения ВМ.
    16391632      </para>
    1640     </refsect2>
    1641     <refsect2 id="vboxmanage-controlvm-recording-videores">
    1642       <title>Задать разрешение записанного видео</title>
    1643       <remark role="help-copy-synopsis"/>
     1633
    16441634      <para>
    16451635        Команда <command>VBoxManage controlvm <replaceable>имя-ВМ</replaceable>
    … …  
    16671657          </para></listitem>
    16681658      </itemizedlist>
    1669     </refsect2>
    1670     <refsect2 id="vboxmanage-controlvm-recording-videorate">
    1671       <title>Задать битрейт видео</title>
    1672       <remark role="help-copy-synopsis"/>
    1673 <!-- @todo r=andy Clarify rate. -->
     1659
    16741660      <para>
    16751661        Команда <command>VBoxManage controlvm
    … …  
    16881674        Эта команда не влияет прямо на состояние выполнения ВМ.
    16891675      </para>
    1690     </refsect2>
    1691     <refsect2 id="vboxmanage-controlvm-recording-videofps">
    1692       <title>Задать максимальную частоту видео</title>
    1693       <remark role="help-copy-synopsis"/>
     1676
    16941677      <para>
    16951678        Команда <command>VBoxManage controlvm
    … …  
    17111694        Эта команда не влияет прямо на состояние выполнения ВМ.
    17121695      </para>
    1713     </refsect2>
    1714     <refsect2 id="vboxmanage-controlvm-recording-maxtime">
    1715       <title>Задать максимальное время записи видео</title>
    1716       <remark role="help-copy-synopsis"/>
    1717 <!-- @todo r=andy Clarify time format. -->
     1696
    17181697      <para>
    17191698        Команда <command>VBoxManage controlvm
    … …  
    17271706        Эта команда не влияет прямо на состояние выполнения ВМ.
    17281707      </para>
    1729     </refsect2>
    1730     <refsect2 id="vboxmanage-controlvm-recording-maxfilesize">
    1731       <title>Задать максимальный размер записанного видео</title>
    1732       <remark role="help-copy-synopsis"/>
     1708
    17331709      <para>
    17341710        Команда <command>VBoxManage controlvm
    … …  
    17441720      </para>
    17451721    </refsect2>
     1722
    17461723    <refsect2 id="vboxmanage-controlvm-setcredentials">
    17471724      <title>Задать учетные данные для удаленного входа в виртуальные машины Windows</title>

  • trunk/src/VBox/Frontends/VBoxManage/VBoxManageControlVM.cpp

    r105266 r105387  
    17971797                 || !strcmp(a->argv[1], "videocap") /* legacy command */)
    17981798        {
     1799            setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING);
     1800
    17991801            if (!strcmp(a->argv[1], "videocap"))
    18001802                RTMsgWarning(ControlVM::tr("Sub command 'videocap' is deprecated -- please use 'recording' instead ."));
    … …  
    18211823            if (RT_SUCCESS(parseBool(a->argv[2], &fEnabled)))
    18221824            {
    1823                 //setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING);
    18241825                CHECK_ERROR_RET(recordingSettings, COMSETTER(Enabled)(fEnabled), RTEXITCODE_FAILURE);
    18251826
    … …  
    18291830            else if (!strcmp(a->argv[2], "start"))
    18301831            {
    1831                 //setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_START);
    18321832                bool fWait = false;
    18331833                if (a->argc >= 4 && !strcmp(a->argv[3], "--wait"))
    … …  
    18471847            else if (!strcmp(a->argv[2], "stop"))
    18481848            {
    1849                 //setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_STOP);
    18501849                ComPtr<IProgress> progress;
    18511850                CHECK_ERROR_BREAK(recordingSettings, COMGETTER(Progress)(progress.asOutParam()));
    … …  
    18541853            else if (!strcmp(a->argv[2], "attach"))
    18551854            {
    1856                 //setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_ATTACH);
    18571855                ComPtr<IProgress> progress;
    18581856                CHECK_ERROR_BREAK(recordingSettings, COMGETTER(Progress)(progress.asOutParam()));
    … …  
    18611859            else if (!strcmp(a->argv[2], "screens"))
    18621860            {
    1863                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_SCREENS);
    18641861                ULONG cMonitors = 64;
    18651862                CHECK_ERROR_BREAK(pGraphicsAdapter, COMGETTER(MonitorCount)(&cMonitors));
    … …  
    18831880            else if (!strcmp(a->argv[2], "filename"))
    18841881            {
    1885                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_FILENAME);
    18861882                if (a->argc != 4)
    18871883                {
    … …  
    18971893                     || !strcmp(a->argv[2], "videoresolution"))
    18981894            {
    1899                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_VIDEORES);
    19001895                if (a->argc != 5)
    19011896                {
    … …  
    19311926            else if (!strcmp(a->argv[2], "videorate"))
    19321927            {
    1933                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_VIDEORATE);
    19341928                if (a->argc != 4)
    19351929                {
    … …  
    19531947            else if (!strcmp(a->argv[2], "videofps"))
    19541948            {
    1955                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_VIDEOFPS);
    19561949                if (a->argc != 4)
    19571950                {
    … …  
    19751968            else if (!strcmp(a->argv[2], "maxtime"))
    19761969            {
    1977                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_MAXTIME);
    19781970                if (a->argc != 4)
    19791971                {
    … …  
    19971989            else if (!strcmp(a->argv[2], "maxfilesize"))
    19981990            {
    1999                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_MAXFILESIZE);
    20001991                if (a->argc != 4)
    20011992                {
    … …  
    20192010            else if (!strcmp(a->argv[2], "opts"))
    20202011            {
    2021 #if 0 /* Add when the corresponding documentation is enabled. */
    2022                 setCurrentSubcommand(HELP_SCOPE_CONTROLVM_RECORDING_OPTS);
    2023 #endif
    20242012                if (a->argc != 4)
    20252013                {
Note: See TracChangeset for help on using the changeset viewer.

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