pymel.core.rendering.convertLightmap

static rendering.convertLightmap(*args, **kwargs)

Calculating global illumination is an expensive and time-consuming task that denies its usage in realtime rendering. As long as the lighting conditions in scenes do not change, illumination on objects can be precomputed and stored in appropriate data structures, like texture maps or vertex colors. These can then be applied in realtime applications like hardware rendering and game engines. The Lightmap Rendering feature allows to prerender surface color or surface lighting (including global illumination) into file textures and per-vertex colors, respectively, on a per object basis. These file textures can then be used as regular texture maps to speed up subsequent software renderings and to apply the precomputed rendering effects even to hardware rendering. For the purposes of baking and prelighting, mental ray for Maya supports the convertLightmap command. Any given shading group must be assigned to (some components) of the given object. Any number of shading group - object combinations can be given. The given object should uniquely identify a single instance of a single shape node. If just a transform name or a shape name is given, the command will try to determine the first child shape or instance parent. If a single object should be baked that has multiple materials assigned (per-face assignment on mesh objects, per-instance assignment on multiply instanced shape nodes) then every shading group has to be provided separately referencing the same object. On the other hand, if the same material has been applied to multiple objects (shared materials) then this shading group needs to be given multiple times for all of the objects. Besides the command flags, per-object settings are set through bakeset of each object. If an object does not have a bakeset, and -bo flag is not specified, default settings for a bakeset will be used. See node reference of TextureBakeSet and VertexBakeSet The lightmap rendering is done with the render quality currently set in the mental ray render globals. Especially, photon tracing and/or final gathering should be enabled to compute global illumination that will be considered during lightmap generation. But certain limitations apply to the current implementation: motion blur may not appear in lightmaps volumes and fog are not recognized in lightmaps the alpha channel is always rendered into file textures

Flags:

Long name (short name)		Argument Types	Properties
bakeSetDefault (bd)		unicode
	Specifies a bake-set to include all objects not assigned to any other bake-set in the scene. Flag can have multiple arguments, passed either as a tuple or a list.
bakeSetOverride (bo)		unicode
	If this parameter is given, the specified bakeset will be used instead of bakeset of each object.
camera (cam)		unicode
	Which camera to use for computing the direction of the incident ray. Default: current render camera
exportPathNames (xp)		unicode
	Export option for the file references such as : ink library, include mi file, texture file, lightmap, etc. The string can specifies an for individual file refs, with each character in the string representing a single file ref entry, with meaning 0-nochange 1-absolute 2-relative 3-nopath, or 0-nochange a-absolute r-relative n-nopath. The file ref entry is specified in this order : link library, include mi file, texture file, lightmap, light profile, output image, shadow map, finalgather map, photon map, demand load object mi file. Effective only if -mi/-miStream flag is present. Default: nochangeFor example, -xp aarrararrawill use absolute path for link libray, include file, light profile, shadow map, demapd load object mi file, and relative path for texture file, lightmap, output image, finalgather map, photon map
file (f)		unicode
	Specifies the absolute file name of the mental ray file to be generated. Effective only if -mi/-miStream flag is present.
help (h)		bool
	Prints a verbose help message.
miStream (mi)		bool
	If this parameter is given, besides the lightmap rendering, the command generates a mental ray file that can be used with mental ray standalone. -f/-file flag must be specified.
notUndoable (nun)		bool
	If this parameter is given, the command can not be undone.
project (prj)		unicode
	Set the project directory. If baking to a light map, light maps will be generated into lightMapsub directory in the project. If lightMapdirectory does not exist, the command fails to write light maps. Default: current project root directory
separator (sep)		unicode
	If this parameter is given, baking will use this string to separate instance and shape name parts when generating unique file names for complex dag objects (dag instances with multiple shapes, or hierarchical dag entries). Default: no separator.
shadows (sh)		bool
	Take shadow into account. If shadow is disabled in the mental ray render globals, mental ray for maya will enable the shadow map, and shadow method segments will be turned on.
transferMapSpace (ts)		unicode
	Use for transfer map operation only. Specify the map space. worldor object. Default: world
useLensBake (ulb)		bool
	Special texture bake mode, which uses a lens shader to shape the lens to the object. Not valid with the -vertexMap flag. Best suited to baking a single large object.
vertexMap (vm)		bool
	Bake illumination into vertices. If not present bake into a light map.

Derived from mel command maya.cmds.convertLightmap