vectorize

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

Synopsis

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.

Return value

None

Keywords

Related

Flags

Long name (short name)	Argument types	Properties
browserView(bv)	boolean
Specifies whether to preview the render in the browser. This option is swf only.
byFrame(bf)	float
Specifies the frame increment.
camera(c)	string
Specifies the camera to render.
combineFillsEdges(cfe)	boolean
Specifies whether fills and edges should be combined as a single object in Flash. This option is swf only.
currentFrame(cf)	boolean
Specifies whether to render the current frame only.
curveTolerance(ct)	float
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.
customExtension(ce)	string
Specifies a custom extension to use for the filename. Any non-empty string is valid.
detailLevel(dl)	int
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]
Specifies the red, green, and blue components of the edge color. Valid values are: 0 to 255 for each color component.
edgeDetail(ed)	boolean
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
Specifies the edge style. Valid values are: "Outline", "EntireMesh", "None".
edgeWeight(ew)	float
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
Specifies the end frame.
filenameFormat(ff)	string
Specifies the file name format. Valid values are: "name", "name.ext", "name.#.ext", "name.ext.#", "name.#", "name#.ext", "name_#.ext".
fillStyle(fs)	string
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.
flashVersion(fv)	int
Specifies the Flash version of the swf output. Valid values are: 3, 4, 5. This option is swf only.
frameRate(fr)	int
Specifies the frame rate. This option is for svg and swf only.
height(h)	int
Specifies the height of the output image in pixels.
hiddenEdges(he)	boolean
Specifies whether hidden edges should be rendered; ie. edges that have are not visible from the camera.
highlightLevel(hl)	int
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.
highlights(hi)	boolean
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.
imageFormat(imageFormat)	string
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".
layer(l)	name
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.
minEdgeAngle(mea)	float
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.
outlinesAtIntersections(oai)	boolean
Specifies if edges should be drawn when two polygons intersect. By default this flag is enabled.
outputFileName(of)	string
Specifies the output file name.
pixelAspectRatio(par)	float
Specifes the pixel aspect ratio.
reflectionDepth(rd)	int
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.
reflections(rf)	boolean
Specifies whether reflections should be rendered. This option has no effect for ai, eps, and svg.
renderLayers(rl)	boolean
Specifies whether render layers should be rendered into separate files.
renderOptimization(ro)	string
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.
renderView(rv)	boolean
Specifies whether to display the rendered image to the render view. This option is not applicable when batch rendering.
secondaryCurveFitting(scf)	boolean
Specifies whether to do secondary curve fitting.
shadows(sh)	boolean
Specifies whether shadows should be rendered. This option has no effect for ai, eps, and svg.
showBackFaces(sb)	boolean
Specifies whether back faces will should be rendered; ie. faces whose normals are pointed away from the camera.
startFrame(sf)	float
Specifies the start frame.
svgAnimation(sa)	string
Specifies the SVG animation type. Valid values are: "Native", "HTMLScript". This option is SVG only.
svgCompression(sc)	boolean
Specifies whether the SVG output should be compressed. This option is svg only.
width(w)	int
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.
cmds.polySphere()
# 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')