polyColorPerVertex

Go to: Synopsis. Flags. Return value. Keywords. Related. MEL examples.

Synopsis

polyColorPerVertex [-alpha double] [-colorB double] [-colorDisplayOption] [-colorG double] [-colorR double] [-colorRGB double double double] [-notUndoable] [-relative] [-remove]

polyColorPerVertex is undoable, queryable, and editable.

Flags

Long name (short name)	[argument types]	Properties
-relative(-rel)
When used, the color values specified are added relative to the current values. In query mode, this flag needs a value.
-remove(-rem)
When used, the color values are removed from the selected or specified objects or components. This option only supports meshes with no construction history, or meshes whose construction history includes a recent polyColorPerVertexNode. For meshes whose construction history includes a polgon operation the polyColorPerVertexNode, consider using the polyColorDel command instead In query mode, this flag needs a value.
-colorR(-r)	double
Specifies the R channel of color In query mode, this flag needs a value.
-colorG(-g)	double
Specifies the G channel of color In query mode, this flag needs a value.
-colorB(-b)	double
Specifies the B channel of color In query mode, this flag needs a value.
-colorRGB(-rgb)	double double double
Specifies the RGB channels of color In query mode, this flag needs a value.
-alpha(-a)	double
Specifies the alpha channel of color In query mode, this flag needs a value.
-notUndoable(-nun)
Execute the command, but without having the command be undoable. This option will greatly improve performance for large numbers of object. This will make the command not undoable regardless of whether undo has been enabled or not. In query mode, this flag needs a value.
-colorDisplayOption(-cdo)
Change the display options on the mesh to display the vertex colors. In query mode, this flag needs a value.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command

Return value

Keywords

Related

MEL examples

// To set the rgb channels of selected vertices:
polyColorPerVertex -rgb 0.8 0.0 0.4;
// To set just the "g" channel of selected vertices:
polyColorPerVertex -g 0.5;
// To add to the current value of just the "g" channel of selected vertices:
polyColorPerVertex -rel -g 0.2;
// To query the "g" and "b" channels of color on selected vertices:
polyColorPerVertex -q -g -b;