.. _Command History:

=======================
Command History
=======================


About
=================

This Extension provides an interface that connects the UI operations in |omni|
to their corresponding python commands.

To access this Extension, go to the top menu bar and click `Window > Commands`.


User Interface
=================

.. figure:: /content/images/dg_usd_command_history.png
    :align: center
    :width: 400

Configuration Options
^^^^^^^^^^^^^^^^^^^^^^

Below are the options that are supported:

* **Search commands**: Search for all the commands that can be executed.
* **Clear History**: Clears history for all the commands that have been executed and show up in history.
* **Top-level commands**: Generate python scripts corresponding to all top-level commands in history and copy to clipboard.
* **Selected commands**: Generate python scripts corresponding to selected commands in history and copy to clipboard.



Tutorials & Examples
=====================

The following example demonstrates a simple scenario of creating and transforming a cube followed by changing via the UI.
It then shows how to use the Extension to generate the corresponding python command to replicate the scenario.

.. raw:: html

    <div style="width: 100%;display: inline-block;position: relative;">
        <div id="dummy" style="margin-top: 56%;">
        </div>
        <div align="center">
        <div id="kaltura_player_1" style="position:absolute;top:0;left:0;left: 0;right: 0;bottom:0;border:solid thin black;"></div>
        <script type="text/javascript" src="https://cdnapisec.kaltura.com/p/2935771/embedPlaykitJs/uiconf_id/46302491"></script>
        <script type="text/javascript">
            try {
            var kalturaPlayer = KalturaPlayer.setup({
            targetId: "kaltura_player_1",
            provider:
            { partnerId: 2935771, uiConfId: 46302491 }
            });
            kalturaPlayer.loadMedia(
            {entryId: '1_gj8588po'}
            );
            } catch (e)
            { console.error(e.message) }
        </script>
        </div>
    </div>