MEL (Legacy)

Command (MEL)

bluePencil

Return Value

Return type is based on flags

Flags

Long name (short name) Arguement types Properties
-draw (-d) C
Activates the Blue Pencil drawing tool.
-createAndDraw (-cad) C
Creates the Blue Pencil node (drawing surface) and activates the drawing tool.
-widthHeight (-wh) int  int C
Specifies the width and height of the drawing surface at creation time.
-exists (-ex) C
Checks if the Blue Pencil node exists. Returns true/false.
-clear (-cl) int C
Removes drawing data from the specified layer. 0=Background, 1=Foreground.
-deleteAll (-da) C
Removes all Blue Pencil data from the Maya scene.
-foregroundColor (-fc) int  int  int C
Sets the current draw color. Values must be in the range 0-255.
-canvasColor (-cc) int  int  int C
Sets the current canvas color. Values must be in the range 0-255.
-activeCamera (-ac) string C
Sets the active camera by name.
-backgroundImage (-bi) string C
Sets the canvas image. Parameter is the absolute path to the image.
-layer (-l) int C  Q
Sets the active layer. 0=Background, 1=Foreground.
-layerOpacity (-lo) int  int C
Sets the layer opacity. The first parameter is the layer, the second is the opacity (0-255).
-time (-t) time C
The time at which a key operation will occur.
-blankKey (-b) C
Inserts a blank key. If the time flag is not used, the key will be created at the current time.
-duplicateKey (-dup) C
Inserts a duplicate key. If the time flag is not used, the key will be created at the current time.
-deleteKey (-dk) C
Removes key. If the time flag is not used, the key at the current time will be removed.
-cutKey (-ck) C
Cuts the key and copy the drawing data to the clipboard.
-copyKey (-cpk) C
Copies drawing data to the clipboard.
-pasteKey (-pk) C
Creates a key and copies the clipboard contents to it.
-lightbox (-lb) int  int C
Sets the number of pre and post keys to be displayed when the lightbox is enabled.
-lightboxPreEnable (-pre) boolean C  Q
Enable/disable the lightbox for keys prior to the current key.
-lightboxPostEnable (-pst) boolean C  Q
Enable/disable the lightbox for keys after the current key.
-tool (-tl) int C
Sets the current tool. Pencil Tool=0, Brush Tool=1, Eraser Tool=2, Eyedropper=3.
-pencilOptions (-po) int  int  boolean C
Sets the pencil options (diameter, opacity, tabletPressureEnabled).
-brushOptions (-bo) int  int  int  int  boolean C
Sets the brush options (diameter, opacity, flow, hardness, tabletPressureEnabled).
-eraserOptions (-eo) int  int  int  int  boolean C
Sets the eraser options (diameter, opacity, flow, hardness, tabletPressureEnabled).
-toolboxDialog (-td) C
Displays the Toolbox dialog.
-toolOptionsDialog (-tod) C
Displays the Tool Options dialog.
-layerOptionsDialog (-lod) C
Displays the Layer Opacity dialog.
-retimingToolDialog (-rtd) C
Displays the Retiming Tool.
-activeCameraDialog (-acd) C
Displays the Active Camera dialog.
-foregroundColorDialog (-fcd) C
Displays the Foreground Color dialog.
-canvasColorDialog (-ccd) C
Displays the Canvas Color dialog.
-backgroundImageDialog (-bid) C
Displays the Background Image Select dialog.
-lightboxDialog (-lbd) C
Displays the Lightbox Settings dialog.
-about(-ab) C
Displays the About dialog.