Home  Previous Next

MG-Picker Studio searchs 3 Basic paths and any count of other paths for the desired picker:

Fully Inside maya scene.
The picker could be stored in nodes, which is of maya's build-in type "subdivSurfaceVarGroup", and usually has a node name ends with suffix "_MGPIKR";
The image used by a in-scene picker node will be stored in maya scene directory/ pickerimages folder.

Partially Inside maya scene.
From MG-Picker Studio v 1.7, The picker nodes does not contain any picker contents, instead it contains just a file path attribute, that points to a picker file.
This is preferable way to distribute your picker, since the edit and maintainence of the picker file is separated with your rig maya scene,
yet your picker can be loaded with the clue in the picker node.
The file path support environment variables denoted by "$" or "${}", as well as 3 predefined variables:

${M_PROJ_DIR}: Current Maya project dicrectory.

${MAYA_CURRENT_SCENE_DIR}: Current Maya scene directory.

${M_CURRENT_ASSET_DIR}: Current asset maya scene directory. Say the asset is referenced, it will still give you the asset scene directory instead current maya scene directory.






maya scene directory / pickers subfolder.
You could publish your picker data and images within "maya scene directory / pickers / PickerName"  folder and will be auto-searched.

maya user applicaton directory / MG_PickerData / Picker Project.
In Windows, its My Document/maya/MG_PickerData/. Picker datas store within the current project name will be auto-searched.

Other paths added in MG-Picker Studio Preference dialog.

lightbulb These searching paths setting are actually stored in as a file called "SearchingPathConfig.ini"  in "maya/version/scripts/MG-PickerStudio/MGPicker_UserConfig" directory.

Share this file among the pipeline so everybody shares the same searching rule.


How to distribute picker files / nodes in pipeline

Since now you know the search paths MG-Picker Studio use to search and load the pickers, you know how to distribute your picker data in the pipeline.

Notice that only the in-scene picker node could be auto-loadable when a new scene is opened.

But wait, there are more ways:

Using programming way, which is the most customizable, but need bit of programming .

You can define two class inherit from MGP.loader.MGPickerRigListerBase  and MGP.loader.MGPickerLoaderBase .

MGPickerRigListerBase is for listing out all the rig asset names in your maya scene, or certain category of assets, such as characters, props, etc.

MGPickerLoaderBase is for returning a picker full path for an asset name, so it can be loaded.

With these two classes, you enable MG-Picker studio to auto-load pickers for all assets in your maya scene, also auto-load picker for a specific rig based on selection.

Check out here for more information.


The Portability of Picker Images:

There are several image properties for picker item, such as background image for panel, item image for select-button, command-button and slider handle, and menu icons.

MG-Picker Studio will try its best to set all these image path to relative path, by copying the image to the same directory the picker files stays, or the asset maya file directory/pickerimages folder when it is a picker node.

The same way, for a relative image path, MG-Picker Studio will try to solve the relative image path to absolute path in background by searching the image in the picker file directory or the asset maya file directory/pickerimages directory.

With that being said, if it is a picker file, the folder that contains the file should also contain the picker images it use,

if it is a picker node, there must be a folder called pickerimages beside the maya scene file. When the asset is referenced, MG-Picker Studio will still try to find the image in the asset file directory/pickerimages folder.

lightbulb If a mgpicker node been opened, and you assigned some images to it, then at the moment these paths will remain absolute path.

To copy these images to proper folder and convert these path to relative, go to "Picker menu / Process images To Relative Path..".

Home Previous Next