::MatlabTop, Main, Index

proc ::Matlab::ExecCmd {appId cmd} {

    # Execute a Matlab command.
    #
    # appId - Identifier of the Matlab instance.
    # cmd   - String containing the Matlab command being executed.
    #
    # Returns the Matlab answer as a string.

    set retVal [$appId Execute $cmd]
    return $retVal
}

proc ::Matlab::Open {{visible true}} {

    # Open a Matlab instance.
    #
    # visible - If set to true, show the application window.
    #           Otherwise hide the application window.
    #
    # Use an already running instance, if available.
    #
    # Returns the identifier of the Matlab application instance.
    #
    # See also: OpenNew Visible Quit

    variable matlabAppName

    set appId [Cawt GetOrCreateApp $matlabAppName true]
    Matlab Visible $appId $visible
    return $appId
}

proc ::Matlab::OpenNew {{visible true}} {

    # Open a new Matlab instance.
    #
    # visible - If set to true, show the application window.
    #           Otherwise hide the application window.
    #
    # Returns the identifier of the new Matlab application instance.
    #
    # See also: Open Visible Quit

    variable matlabAppName

    set appId [Cawt GetOrCreateApp $matlabAppName false]
    Matlab Visible $appId $visible
    return $appId
}

proc ::Matlab::Quit {appId} {

    # Quit a Matlab instance.
    #
    # appId - Identifier of the Matlab instance.
    #
    # Returns no value.
    #
    # See also: Open

    $appId Quit
}

proc ::Matlab::Visible {appId visible} {

    # Toggle the visibility of a Matlab application window.
    #
    # appId   - Identifier of the Matlab instance.
    # visible - If set to true, show the application window.
    #           Otherwise hide the application window.
    #
    # Returns no value.
    #
    # See also: Open OpenNew

    $appId Visible [Cawt TclInt $visible]
}