186 lines
18 KiB
HTML
186 lines
18 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>MGPickerLicence</title>
|
|
<meta name="generator" content="Help & Manual" />
|
|
<meta name="keywords" content="API,MGPickerLicence command" />
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
|
<link type="text/css" href="default.css" rel="stylesheet" />
|
|
<style type="text/css">
|
|
body { margin: 0px; background: #F8F8F8; }
|
|
</style>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="helpman_settings.js"></script>
|
|
<script type="text/javascript" src="helpman_topicinit.js"></script>
|
|
|
|
<script type="text/javascript">
|
|
HMSyncTOC("index.html", "mgpickerlicence.htm");
|
|
</script>
|
|
<script type="text/javascript" src="highlight.js"></script>
|
|
<script type="text/javascript">
|
|
$(document).ready(function(){highlight();});
|
|
</script>
|
|
</head>
|
|
<body>
|
|
|
|
|
|
<table style="width:100%; border:none; border-spacing:0px; padding:0px; background:#D0D0D0">
|
|
<tr style="vertical-align:middle">
|
|
<td style="text-align:right">
|
|
<a href="welcome.htm"><img border="0" src="../common/images/MGtoolsHelp_Home.gif" width="34" height="22" alt="Home" /></a>
|
|
<a href="mgpickerservice.htm"><img border="0" src="../common/images/MGtoolsHelp_previous.gif" width="34" height="22" alt="Previous" /></a>
|
|
<a href="mgimageprocesser.htm"><img border="0" src="../common/images/MGtoolsHelp_next.gif" width="34" height="22" alt="Next" /></a>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<!-- Placeholder for topic body. -->
|
|
<table style="width:100%;border:none;border-spacing:0px"><tr style="vertical-align:top"><td style="text-align:left;padding:5px">
|
|
<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="width:100%; border:none; border-spacing:2px;">
|
|
<tr>
|
|
<td style="vertical-align:middle; height:8px; padding:1px; border:none"><p><span style="font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;">command</span><span style="font-family: 'Times New Roman',Times,Georgia,serif;"> (MEL/Python)</span></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align:middle; height:5px; padding:1px; border:none"><h1 class="p_Heading1" style="margin: 19px 0 19px 0;"><span class="f_Heading1" style="font-size: 24pt; font-family: 'Times New Roman',Times,Georgia,serif;">MGPickerLicence </span><img alt="v2_transparent" width="34" height="12" style="margin:0;width:34px;height:12px;border:none" src="v2_transparent.png"/></h1>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<p class="p_Normal" style="margin: 14px 0 0 0;"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">Go to: <a href="mgpickerlicence.htm#synopsis" class="topiclink">Synopsis</a>. <a href="mgpickerlicence.htm#examples" class="topiclink">MEL examples</a>. <a href="mgpickerlicence.htm#pyexamples" class="topiclink">Python examples</a>.</span></p>
|
|
<p class="p_Normal" style="margin: 19px 0 0 0;"><a id="synopsis" class="hmanchor"></a><span style="font-size: 14pt; font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;"> Synopsis</span></p>
|
|
<p class="p_Normal" style="margin: 19px 0 0 0;"><span style="font-family: 'Courier New',Courier,monospace;">MGPickerLicence ([<a href="mgpickerlicence.htm#floating" class="topiclink">floating</a>=</span><span style="font-family: 'Courier New',Courier,monospace; font-style: italic;">[boolean]</span><span style="font-family: 'Courier New',Courier,monospace;">],[<a href="mgpickerlicence.htm#nodelocked" class="topiclink">nodeLocked</a>=</span><span style="font-family: 'Courier New',Courier,monospace; font-style: italic;">[string]</span><span style="font-family: 'Courier New',Courier,monospace;">], [<a href="mgpickerlicence.htm#state" class="topiclink">state</a>=</span><span style="font-family: 'Courier New',Courier,monospace; font-style: italic;">string</span><span style="font-family: 'Courier New',Courier,monospace;">])</span></p>
|
|
<p class="p_Normal" style="margin: 0 0 14px 0;"> </p>
|
|
<p class="p_Normal" style="margin: 0 0 14px 0;"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">MGPickerLicence is </span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;">NOT undoable</span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">, </span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">queryable, and editable.</span></p>
|
|
<p><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">This is a util command to query and edit the license state of MG-Picker Studio.</span></p>
|
|
<p class="p_Normal"> </p>
|
|
<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="width:100%; border:none; border-spacing:2px;">
|
|
<tr>
|
|
<td style="vertical-align:bottom; background-color:#CCCCCC; padding:1px; border:none"><p><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;">Long name (short name)</span></p>
|
|
</td>
|
|
<td style="vertical-align:bottom; background-color:#CCCCCC; padding:1px; border:none"><p><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif; font-style: italic; font-weight: bold;">Argument types</span></p>
|
|
</td>
|
|
<td style="vertical-align:bottom; background-color:#CCCCCC; padding:1px; border:none"><p><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;">Properties</span></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><a id="floating" class="hmanchor"></a><span style="font-family: 'Courier New',Courier,monospace; font-weight: bold;">-floating</span><span style="font-family: 'Courier New',Courier,monospace;">(</span><span style="font-family: 'Courier New',Courier,monospace; font-weight: bold;">-fl</span><span style="font-family: 'Courier New',Courier,monospace;">) </span><img alt="v2_transparent" width="34" height="12" style="margin:0;width:34px;height:12px;border:none" src="v2_transparent.png"/></p>
|
|
</td>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><span style="font-family: 'Courier New',Courier,monospace; font-style: italic;">boolean</span></p>
|
|
</td>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><img alt="create" width="13" height="16" style="margin:0;width:13px;height:16px;border:none" src="create.gif"/><img alt="query" title="query" width="13" height="16" style="margin:2px 2px 2px 2px;width:13px;height:16px;border:none" src="query.gif"/><img alt="edit" title="edit" width="13" height="16" style="margin:2px 2px 2px 2px;width:13px;height:16px;border:none" src="edit.gif"/></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="3" style="vertical-align:middle; padding:1px; border:none"><div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="width:100%; border:none; border-spacing:2px;">
|
|
<tr>
|
|
<td style="vertical-align:top; width:40px; padding:1px; border:none"><p style="line-height: 1.38;"><span style="color: #000000;"> </span></p>
|
|
</td>
|
|
<td style="vertical-align:middle; width:946px; padding:1px; border:none"><p style="line-height: 1.38;"><span style="font-size: 11pt; font-family: 'Times New Roman',Times,Georgia,serif;">In query mode, this returns information in a string array: </span></p>
|
|
<p style="line-height: 1.38;"><span style="font-size: 11pt; font-family: 'Times New Roman',Times,Georgia,serif;"> [0] the path to the directory that contains the connector executable.</span></p>
|
|
<p style="line-height: 1.38;"><span style="font-size: 11pt; font-family: 'Times New Roman',Times,Georgia,serif;"> [1] the floating license state, "-1" means the connection was tried but failed, "1" means a floating license is connected, "0" means all the other states, e.g. it is using a node-locked license, etc.</span></p>
|
|
<p style="line-height: 1.38;"><span style="font-size: 11pt; font-family: 'Times New Roman',Times,Georgia,serif;"> [2] the state of whether we auto-connect to floating license on program launch.</span></p>
|
|
<p style="line-height: 1.38;"><span style="color: #000000;"> </span></p>
|
|
<p style="line-height: 1.38;"><span style="font-size: 11pt; font-family: 'Times New Roman',Times,Georgia,serif;">In create/edit mode, the argument True means starting the floating license connection process, and False means disconnecting and logging out from the current floating license.</span></p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><a id="nodelocked" class="hmanchor"></a><span style="font-family: 'Courier New',Courier,monospace; font-weight: bold;">-nodeLocked</span><span style="font-family: 'Courier New',Courier,monospace;">(</span><span style="font-family: 'Courier New',Courier,monospace; font-weight: bold;">-nl</span><span style="font-family: 'Courier New',Courier,monospace;">) </span><img alt="v2_transparent" width="34" height="12" style="margin:0;width:34px;height:12px;border:none" src="v2_transparent.png"/></p>
|
|
</td>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><span style="font-family: 'Courier New',Courier,monospace; font-style: italic;">string</span></p>
|
|
</td>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><img alt="create" width="13" height="16" style="margin:0;width:13px;height:16px;border:none" src="create.gif"/><img alt="query" title="query" width="13" height="16" style="margin:2px 2px 2px 2px;width:13px;height:16px;border:none" src="query.gif"/><img alt="edit" title="edit" width="13" height="16" style="margin:2px 2px 2px 2px;width:13px;height:16px;border:none" src="edit.gif"/></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="3" style="vertical-align:middle; padding:1px; border:none"><div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="width:100%; border:none; border-spacing:2px;">
|
|
<tr>
|
|
<td style="vertical-align:top; width:40px; padding:1px; border:none"><br />
|
|
</td>
|
|
<td style="vertical-align:middle; width:946px; padding:1px; border:none"><p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">In query mode, this returns information in a string array:</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> [0] the user request-code of this machine.</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> [1] the registration code, an empty string means not registered with node-locked.</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> [2] the major.minor version of the registry in string form. e.g. "2.3" means the registration code used was for version 2.3. </span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> The main version matters the most as that usually means some new features may be locked if it was registered for an old version.</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> You can use cmds.MGPicker(q=True, version=True) to query the actual program version string (major.minor.path).</span></p>
|
|
<p class="p_Normal"> </p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">In create/edit mode, you specify the registration code for the registry. Using an empty string means unregistering the node-locked license.</span></p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><a id="state" class="hmanchor"></a><span style="font-family: 'Courier New',Courier,monospace; font-weight: bold;">-state</span><span style="font-family: 'Courier New',Courier,monospace;">(</span><span style="font-family: 'Courier New',Courier,monospace; font-weight: bold;">-st</span><span style="font-family: 'Courier New',Courier,monospace;">) </span><img alt="v2_transparent" width="34" height="12" style="margin:0;width:34px;height:12px;border:none" src="v2_transparent.png"/></p>
|
|
</td>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><span style="color: #000000;"> </span></p>
|
|
</td>
|
|
<td style="vertical-align:top; background-color:#EEEEEE; padding:1px; border:none"><p><img alt="query" title="query" width="13" height="16" style="margin:2px 2px 2px 2px;width:13px;height:16px;border:none" src="query.gif"/></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="3" style="vertical-align:middle; padding:1px; border:none"><div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="width:100%; border:none; border-spacing:2px;">
|
|
<tr>
|
|
<td style="vertical-align:top; width:40px; padding:1px; border:none"><br />
|
|
</td>
|
|
<td style="vertical-align:middle; width:946px; padding:1px; border:none"><p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">The state of license:</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> 0: No registered or logged in.</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> 1: Registered with a node-locked license but it is for an old version.</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> 2: Registered with node-locked license.</span></p>
|
|
<p class="p_Normal"><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;"> 3: Is logged in to a floating license.</span></p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<p class="p_Normal"> </p>
|
|
<hr style="height:2px; color:#CCCCCC; border-width:0; background-color:#cccccc;" /><div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 10px 0 0 0;"><table style="background-color:#eeeeee; border:none; border-spacing:1px;">
|
|
<tr>
|
|
<td style="vertical-align:top; padding:4px; border:none"><p><img alt="create" width="13" height="16" style="margin:0;width:13px;height:16px;border:none" src="create.gif"/><span class="f_ImageCaption"> </span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">Flag can appear in Create mode of command</span></p>
|
|
</td>
|
|
<td style="vertical-align:top; padding:4px; border:none"><p><img alt="edit" width="13" height="16" style="margin:0;width:13px;height:16px;border:none" src="edit.gif"/><span class="f_ImageCaption"> </span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">Flag can appear in Edit mode of command</span></p>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align:top; padding:4px; border:none"><p><img alt="query" width="13" height="16" style="margin:0;width:13px;height:16px;border:none" src="query.gif"/><span class="f_ImageCaption"> </span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">Flag can appear in Query mode of command</span></p>
|
|
</td>
|
|
<td style="vertical-align:top; padding:4px; border:none"><p><img alt="multiuse" width="13" height="16" style="margin:0;width:13px;height:16px;border:none" src="multiuse.gif"/><span class="f_ImageCaption"> </span><span style="font-size: 12pt; font-family: 'Times New Roman',Times,Georgia,serif;">Flag can be used more than once in a command.</span></p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<p style="margin: 19px 0 0 0;"><a id="examples" class="hmanchor"></a><span style="font-size: 14pt; font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;">MEL examples</span></p>
|
|
<p class="p_Normal" style="line-height: 1.0; white-space: nowrap; margin: 19px 0 0 0;"><span style="font-family: 'Courier New',Courier,monospace;">print("Query license state: " + `MGPickerLicence -q -state` + "\n");</span><br />
|
|
<span style="font-family: 'Courier New',Courier,monospace;">print("Node-Locked license state: " + stringArrayToString(`MGPickerLicence -q -nodeLocked`, ", ") + "\n");</span><br />
|
|
<span style="font-family: 'Courier New',Courier,monospace;">print("Floating license state: " + stringArrayToString(`MGPickerLicence -q -floating`, ", "));</span></p>
|
|
<p style="margin: 19px 0 0 0;"><a id="pyexamples" class="hmanchor"></a><span style="font-size: 14pt; font-family: 'Times New Roman',Times,Georgia,serif; font-weight: bold;">Python examples</span></p>
|
|
<p style="margin: 19px 0 0 0;"><span style="font-family: 'Courier New',Courier,monospace;">from maya import cmds</span></p>
|
|
<p style="margin: 19px 0 0 0;"><span style="font-family: 'Courier New',Courier,monospace;">print("Query license state:", cmds.MGPickerLicence(q=True, state=True))</span><br />
|
|
<span style="font-family: 'Courier New',Courier,monospace;">print("Node-Locked state:", cmds.MGPickerLicence(q=True, nodeLocked=True))</span><br />
|
|
<span style="font-family: 'Courier New',Courier,monospace;">print("Floating License state:", cmds.MGPickerLicence(q=True, floating=True))</span></p>
|
|
<p style="margin: 19px 0 0 0;"><span style="color: #000000;"> </span></p>
|
|
|
|
</td></tr></table>
|
|
<table height="30" width="100%" border="0" cellspacing="" cellpadding="0" bgcolor="#D0D0D0">
|
|
<tr valign="bottom" bgcolor="#D0D0D0" >
|
|
<td align="left" valign="middle" >
|
|
<a href="welcome.htm"><img border="0" src="../common/images/MGtoolsHelp_Home.gif" width="34" height="22" alt="Home" /></a>
|
|
<a href="mgpickerservice.htm"><img border="0" src="../common/images/MGtoolsHelp_previous.gif" width="34" height="22" alt="Previous" /></a>
|
|
<a href="mgimageprocesser.htm"><img border="0" src="../common/images/MGtoolsHelp_next.gif" width="34" height="22" alt="Next" /></a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
</body>
|
|
</html>
|