MGPickerItem

跳转到: MEL概要. Python概要. 返回值. 标签. MEL例子. Python例子.

MEL概要

MGPickerItem [-applyMirroredAttribute] [-annotation] [-addSelectMember] [-attributeType] [-attribute] [-attributeValue] [-bgHorizontalAlign] [-backgroundImage] [-bgKeepRatio] [-bgMargin] [-boolState] [-bgScaleFit] [-bevel] [-bgVerticalAlign] [-command] [-closeCurve] [-clearSelectMembers] [-commandType] [-componentWidth] [-componentWidthPolicy] [-drawBGRect] [-drawBackgroundShape] [-exist] [-fillColor] [-frameColor] [-frameVisible] [-fullNamespace] [-floatState] [-gradient] [-gradientMode] [-height] [-highlightImage] [-hoverLightness] [-image] [-interactive] [-imageMargin] [-intState] [-label] [-labelBold] [-labelColor] [-labelFont] [-labelFontSize] [-labelHorizontalAlign] [-labelItalic] [-links] [-labelPosition] [-leftSlope] [-labelVerticalAlign] [-masterButtons] [-mirror] [-name] [-opacity] [-parent] [-postAction] [-pressedImage] [-postChangeCommand] [-postChangeCommandType] [-preChangeCommand] [-preChangeCommandType] [-rotation] [-roundness] [-resizePreferSize] [-removeSelectMember] [-rightSlope] [-shape] [-slaveButtons] [-strokeColor] [-sliderChangeCommand] [-sliderChangeCommandType] [-shapeDirection] [-select] [-sliderHAttribute] [-sliderHMin] [-sliderHRange] [-sliderHSpeed] [-sliderHMax] [-showItemTip] [-selectMembers] [-subNamespace] [-stringState] [-sliderVAttribute] [-sliderVMin] [-sliderVRange] [-sliderVSpeed] [-sliderVMax] [-strokeWidth] [-type] [-usePickerNamespace] [-view] [-valueColor] [-visible] [-visibilityOperator] [-width] [-xPosition] [-yPosition] itemIDString

Python概要

MGPickerItem (itemIdString, [applyMirroredAttribute=boolean], [annotation=string],  [addSelectMember=string], [attributeType=string], [attribute=string], [attributeValue=float], [bgHorizontalAlign=string], [backgroundImage=string], [bgKeepRatio=boolean], [bgMargin=[int, int, int, int]], [boolState=[boolean]], [bgScaleFit=boolean], [bevel=boolean], [bgVerticalAlign=string], [command=string], [closeCurve=boolean], [clearSelectMembers=boolean], [commandType=string], [componentWidth=int], [componentWidthPolicy=string], [drawBGRect=boolean], [drawBackgroundShape=boolean], [exist=boolean], [fillColor=[float, float, float, float]], [frameColor=[float, float, float, float]], [frameVisible=boolean], [fullNamespace=boolean], [floatState=float], [gradient=boolean], [gradientMode=int], [height=int], [highlightImage=string], [hoverLightness=int],[image=string], [interactive=boolean], [imageMargin=[int, int, int, int]], [intState=[int]], [label=string], [labelBold=boolean], [labelColor=[float, float, float, float]], [labelFont=string], [labelFontSize=int], [labelHorizontalAlign=string], [labelItalic=boolean], [links=boolean], [labelPosition=string], [leftSlope=int], [labelVerticalAlign=string], [masterButtons=boolean], [mirror=string],[name=string], [opacity=float], [parent=string], [postAction=string], [pressedImage=string], [postChangeCommand=string], [postChangeCommandType=string], [preChangeCommand=string], [preChangeCommandType=string], [rotation=int], [roundness=int], [resizePreferSize=boolean], [removeSelectMember=string], [rightSlope=int], [shape=boolean], [slaveButtons=boolean], [strokeColor=[float, float, float, float]], [sliderChangeCommand=string], [sliderChangeCommandType=string], [shapeDirection=string], [select=int], [sliderHAttribute=string],[sliderHMin=float], [sliderHRange=boolean], [sliderHSpeed=float], [sliderHMax=float],[showItemTip=string],  [selectMembers=string],[subNamespace=string], [stringState=string], [sliderVAttribute=string], [sliderVMin=float], [sliderVRange=boolean], [sliderVSpeed=float], [sliderVMax=float], [strokeWidth=int], [type=string], [usePickerNamespace=boolean], [view=string], [valueColor=[float, float, float, float]], [visible=boolean], [visibilityOperator=string], [width=int], [xPosition=int], [yPosition=int])

 
MGPickerItem不可撤消, 可以查询且可以编辑。
 

这个命令创建, 查询或编辑一个picker对象，目前来讲picker对象包括选择按钮，命令按钮，属性按钮，滑条，文本及Picker面板。

如果这个picker对象不在当前激活视图里，则要指定-view及那个picker视图的id字符窜。
有些命令标签只对特别的picker对象类型有效，不过即使你用在不支持的类型也没有关系，只是不会有效果。

返回值

标签

applyMirroredAttribute, annotation, addSelectMember, attributeType, attribute, attributeValue, bgHorizontalAlign, backgroundImage, bgKeepRatio, bgMargin, boolState, bgScaleFit, bevel, bgVerticalAlign, command, closeCurve, clearSelectMembers, commandType, componentWidth,componentWidthPolicy, drawBGRect, drawBackgroundShape, exist, fillColor, frameColor, frameVisible, fullNamespace, floatState, gradient, gradientMode, height, highlightImage, hoverLightness, image, interactive, imageMargin, intState, label, labelBold, labelColor, labelFont, labelFontSize, labelHorizontalAlign, labelItalic, links, labelPosition, leftSlope, labelVerticalAlign, masterButtons, mirror, name, opacity, parent, postAction, pressedImage, postChangeCommand, postChangeCommandType, preChangeCommand, preChangeCommandType, rotation, roundness, resizePreferSize, removeSelectMember, rightSlope, shape, slaveButtons, strokeColor, sliderChangeCommand, sliderChangeCommandType, shapeDirection, select, sliderHAttribute, sliderHMin, sliderHRange, sliderHSpeed, sliderHMax, showItemTip, selectMembers, subNamespace, stringState, sliderVAttribute, sliderVMin, sliderVRange, sliderVSpeed, sliderVMax, strokeWidth, type, usePickerNamespace, view, valueColor, visible, visibilityOperator, width, xPosition, yPosition

MEL例子

//create pCube1 if not exists:
if(!`objExists pCube1`)
{
    polyCube -w 1 -h 1 -d 1 -sx 1 -sy 1 -sz 1 -ax 0 1 0 -cuv 4 -ch 1;
}

// create a new picker named "myPicker"
string $viewId = `MGPicker -e -createPicker "myPicker" "wrongNamespace" "" ""`;   //it is a untitled picker, not refer to a picker file / node.
MGPickerView -e -namespace "" $viewId;          //set the namespace to empty string.

//create picker panel first:
string $panel = `MGPickerItem -view $viewId -type "panel" -label "Panel1" -frameColor .2 .2 .22 1 -x 0 -y 0 -w 400 -h 300`;

//create other items:
string $selButton = `MGPickerItem -view $viewId -type "selectButton" -p $panel
                                        -x 20 -y 20 -w 100 -h 20 -shape "roundedRectangle" 
                                       -l "Select Button"
                                        -selectMembers "pCube1"`;
string $commandButton = `MGPickerItem -view $viewId -type "commandButton" 
                                                -p $panel 
                                                -x 20 -y 50 -w 100 -h 20 
                                                -l "Cmd Button"
                                                -c ("print (\"Current button is: \\\"\"+`MGPicker -q -currentItem`+\"\\\".\\n\")")`;
string $slider = `MGPickerItem -view $viewId -type "slider" -p $panel
                                -sliderHAttribute "pCube1.translateX"
                                -sliderVAttribute "pCube1.translateY"
                                -l "pCube:tx-ty"
                                -x 23 -y 100 -w 100 -h 100`;
string $attributeButton = `MGPickerItem -view $viewId -type "attributeButton" 
                                                -attributeType "bool"
                                           -l "Toggle" 
                                                -p $panel
                                                -valueColor .1 .5 .5 1
                                                -x 200 -y 35 -w 100 -h 20`;
string $text = `MGPickerItem -view $viewId -p $panel -type "text" -x 200 -y 80 -labelFontSize 11
                                -l "The attribute button\ncontrols the select-button,\ncommand-button and the slider." 
                               -resizePreferSize`;        

//link the visibilities of select-button and command-button to attribute "on":
string $link1 = `MGPickerLink -view $viewId -s $selButton -t $attributeButton -targetValues "on"`;
string $link2 = `MGPickerLink -view $viewId -s $commandButton -t $attributeButton -targetValues "on"`;
string $link3 = `MGPickerLink -view $viewId -s $slider -t $attributeButton -targetValues "on"`;

//turn the value of attribute-button to On to show the buttons:
MGPickerItem -e -view $viewId -attributeValue 1 $attributeButton;

MGPickerView -e -updateSceneBoundary $viewId;  //update the scene boundary to show all the picker items.
MGPickerView -e -setClean $viewId;   //set the picker we just created clean.

Python例子

import maya.cmds as cmd

#create pCube1 if not exists:
if not cmd.objExists('pCube1'):
   cmd.polyCube (w=1, h=1,d=1,sx=1,sy=1,sz=1,ax=(0,1,0), cuv=4,ch=1)

# create a new picker named "myPicker"
#it is a untitled picker, not refer to a picker file / node.
viewId = cmd.MGPicker (edit=True, createPicker=("myPicker","wrongNamespace","",""))
cmd.MGPickerView(viewId, edit=True, namespace="")        #set the namespace to empty string.

#create picker panel first:
panel = cmd.MGPickerItem(view=viewId, type="panel",label="Panel1",frameColor=(.2,.2,.2,1), x=0,y=0,w=400,h=300)

#create other items:
selButton = cmd.MGPickerItem(view=viewId, type="selectButton",p=panel,
                                     x=20,y=20,w=100,h=20,shape="roundedRectangle",
                                     l="Select Button",
                                     selectMembers="pCube1")

commandButton = cmd.MGPickerItem (view=viewId, type="commandButton",
                                             p=panel,
                                             x=20,y=50,w=100,h=20,
                                             l="Cmd Button",
                                             c=("print (\"Current button is: \\\"\"+`MGPicker -q -currentItem`+\"\\\".\\n\")"))

slider = cmd.MGPickerItem(view=viewId, type="slider",p=panel,
                             sliderHAttribute="pCube1.translateX",
                             sliderVAttribute="pCube1.translateY",
                             l="pCube:tx-ty",
                             x=23,y=100,w=100,h=100)

attributeButton = cmd.MGPickerItem (view=viewId, type="attributeButton",
                                             attributeType="bool",
                                         l="Toggle",
                                             p=panel,
                                             valueColor=(.1,.5,.5,1),
                                             x=200,y=35,w=100,h=20)

text = cmd.MGPickerItem (view=viewId, p=panel, type="text",x=200,y=80,labelFontSize=11,
                             l="The attribute button\ncontrols the select-button,\ncommand-button and the slider.",
                             resizePreferSize=True)      

#link the visibilities of select-button and command-button to attribute "on":
link1 = cmd.MGPickerLink (view=viewId, s=selButton,t=attributeButton,targetValues="on")
link2 = cmd.MGPickerLink (view=viewId, s=commandButton ,t=attributeButton,targetValues="on")
link3 = cmd.MGPickerLink (view=viewId, s=slider ,t=attributeButton,targetValues="on")

#turn the value of attribute-button to On to show the buttons:
cmd.MGPickerItem (attributeButton, edit=True, view=viewId, attributeValue=1)
cmd.MGPickerView (viewId, edit=True,updateSceneBoundary=True)  #update the scene boundary to show all the picker items.
cmd.MGPickerView (viewId, edit=True,setClean=True)  #set the picker we just created clean.