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


vectorize([browserView=boolean], [byFrame=float], [camera=string], [combineFillsEdges=boolean], [currentFrame=boolean], [curveTolerance=float], [customExtension=string], [detailLevel=int], [edgeColor=[int, int, int]], [edgeDetail=boolean], [edgeStyle=string], [edgeWeight=float], [endFrame=float], [filenameFormat=string], [fillStyle=string], [flashVersion=int], [frameRate=int], [height=int], [hiddenEdges=boolean], [highlightLevel=int], [highlights=boolean], [imageFormat=string], [layer=name], [minEdgeAngle=float], [outlinesAtIntersections=boolean], [outputFileName=string], [pixelAspectRatio=float], [reflectionDepth=int], [reflections=boolean], [renderLayers=boolean], [renderOptimization=string], [renderView=boolean], [secondaryCurveFitting=boolean], [shadows=boolean], [showBackFaces=boolean], [startFrame=float], [svgAnimation=string], [svgCompression=boolean], [width=int])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

vectorize is NOT undoable, NOT queryable, and NOT editable.

This command renders Maya scenes to various vector and raster formats using the Maya Vector renderer.

Return value



vector, graphics, render, flash, swf, svg




browserView, byFrame, camera, combineFillsEdges, currentFrame, curveTolerance, customExtension, detailLevel, edgeColor, edgeDetail, edgeStyle, edgeWeight, endFrame, filenameFormat, fillStyle, flashVersion, frameRate, height, hiddenEdges, highlightLevel, highlights, imageFormat, layer, minEdgeAngle, outlinesAtIntersections, outputFileName, pixelAspectRatio, reflectionDepth, reflections, renderLayers, renderOptimization, renderView, secondaryCurveFitting, shadows, showBackFaces, startFrame, svgAnimation, svgCompression, width
Long name (short name) Argument types Properties
browserView(bv) boolean create
Specifies whether to preview the render in the browser. This option is swf only.
byFrame(bf) float create
Specifies the frame increment.
camera(c) string create
Specifies the camera to render.
combineFillsEdges(cfe) boolean create
Specifies whether fills and edges should be combined as a single object in Flash. This option is swf only.
currentFrame(cf) boolean create
Specifies whether to render the current frame only.
curveTolerance(ct) float create
Specifies the curve tolerance. Valid values are in the range: 0.0 to 15.0. The curve tolerance determines how aggressively the renderer tries to fit a series of connected, consecutive line segments to a curve. A value of 0.0 causes all line segments to be drawn without curve fitting. A value of 15.0 causes aggressive curve fitting.
secondaryCurveFitting(scf) boolean create
Specifies whether to do secondary curve fitting.
customExtension(ce) string create
Specifies a custom extension to use for the filename. Any non-empty string is valid.
detailLevel(dl) int create
Specifies the detail level. Valid values are: 0 to 50. The smaller the value, the more polygons may be combined to produce smaller files. A higher value results in a more accurate render, but also larger files and longer render times.
edgeColor(ec) [int, int, int] create
Specifies the red, green, and blue components of the edge color. Valid values are: 0 to 255 for each color component.
edgeDetail(ed) boolean create
Specifies whether edge detail should be rendered; ie. edges that have an angle between the face normals of any two adjacent polygons sharing an edge that is greater than the minimum edge angle (specified by the -mea flag).
edgeStyle(es) string create
Specifies the edge style. Valid values are: "Outline", "EntireMesh", "None".
edgeWeight(ew) float create
Specifies the edge weight to be used for all edges in points. There are 72 points per inch. A value of 0.0 specifies hairline edge weight.
endFrame(ef) float create
Specifies the end frame.
filenameFormat(ff) string create
Specifies the file name format. Valid values are: "name", "name.ext", "name.#.ext", "name.ext.#", "name.#", "name#.ext", "name_#.ext".
fillStyle(fs) string create
Specifies the fill style. Valid values are: "SingleColor", "TwoColor", "FourColor", "FullColor", "AverageColor", "AreaGradient", "MeshGradient", "None". AreaGradient and MeshGradient are not available for the eps and ai image formats.
renderOptimization(ro) string create
Specifies the render optimization. Valid values are: "Safe", "Good", "Aggressive". "Safe" will remove redundant geometry. "Good" removes redundant geometry as well as sub-pixel geometry that would not be visible without zooming into the high detail area. "Agressive" removes all of the geometry that "Good" removes but will also remove geometry at slightly above the single pixel level making it possible to visibly detect the removed geometry without zooming in on the affected region.
flashVersion(fv) int create
Specifies the Flash version of the swf output. Valid values are: 3, 4, 5. This option is swf only.
frameRate(fr) int create
Specifies the frame rate. This option is for svg and swf only.
height(h) int create
Specifies the height of the output image in pixels.
hiddenEdges(he) boolean create
Specifies whether hidden edges should be rendered; ie. edges that have are not visible from the camera.
outlinesAtIntersections(oai) boolean create
Specifies if edges should be drawn when two polygons intersect. By default this flag is enabled.
highlights(hi) boolean create
Specifies whether highlights should be rendered. This option has no effect for ai, eps, and svg. This option is for the SingleColor, AverageColor, and AreaGradient fill styles only.
highlightLevel(hl) int create
Specifies the highlight level. Valid values are: 1 to 8. The value specifies how many concentric rings will be used to render an object's highlight. This option is for the SingleColor, AverageColor, and AreaGradient fill styles only.
imageFormat(imageFormat) string create
Specifies the image format to render. Valid values for the Windows and Mac platforms are: "swf", "eps", "ai", "svg", "jpg", "iff", "sgi", "tga", "tif", "bmp". Additional valid values for the Windows platform are: "als", "cin", "gif", "yuv", "rla", "si". Additional valid values for the Mac platform are: "pntg", "ps", "png", "pict", "qtif", "qt".
minEdgeAngle(mea) float create
Specifies the minimum edge angle in degrees. Valid values are: 0.0 to 90.0. This angle is the minimum angle between adjacent polygon face normals that is used to determine if the edge is rendered when the -ed flag is specified.
outputFileName(of) string create
Specifies the output file name.
pixelAspectRatio(par) float create
Specifes the pixel aspect ratio.
reflections(rf) boolean create
Specifies whether reflections should be rendered. This option has no effect for ai, eps, and svg.
reflectionDepth(rd) int create
Specifies the reflection depth. Valid values are: 1 to 4. The value specifies how many levels of reflection will be applied. This option has no effect for ai, eps, and svg.
renderLayers(rl) boolean create
Specifies whether render layers should be rendered into separate files.
layer(l) name create
Render the specified render layer. Only this render layer will be rendered, regardless of the renderable attribute value of the render layer. The layer name will be appended to the output image file name. The specified render layer becomes the current render layer before rendering, and remains as current render layer after the rendering.
renderView(rv) boolean create
Specifies whether to display the rendered image to the render view. This option is not applicable when batch rendering.
shadows(sh) boolean create
Specifies whether shadows should be rendered. This option has no effect for ai, eps, and svg.
showBackFaces(sb) boolean create
Specifies whether back faces will should be rendered; ie. faces whose normals are pointed away from the camera.
startFrame(sf) float create
Specifies the start frame.
svgAnimation(sa) string create
Specifies the SVG animation type. Valid values are: "Native", "HTMLScript". This option is SVG only.
svgCompression(sc) boolean create
Specifies whether the SVG output should be compressed. This option is svg only.
width(w) int create
Specifies the width of the output image in pixels.

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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Create a poly sphere.
# Now vector render the current frame. The output will be a 320x240
# swf vector file using the single color fill option, and have
# "untitled.swf" as its name.
cmds.vectorize(imageFormat='swf', w=320, h=240, fs='SingleColor',
               c='persp', cf=True, ff='name.ext', of='untitled')