Extension2forAutodeskMaya2013Readme

Thisdocumentcontainsbugnumbersandcorrespondingdescriptionsforissuesfixedinthisrelease.In addition,thisdocumentmaycontaininformationaboutnewfunctionalityinthisrelease(where applicable).Itisstronglyrecommendedthatyoureadthisdocumentbeforeyouinstallthisrelease.For reference,youshouldsavethisreadmetoyourharddriveorprintacopy. Importantnotes: Thisreleaseisafullproductinstallationonalloperatingsystems.UninstallyourexistingMaya applicationbeforeinstallingthisrelease. Thisreleaseincludesallofthefixesfromtheservicepack(s)thatprecededit.Therefore,youdo notneedtodownloadandinstallalltheprecedingreleaseinadditiontothisextension.

Contents
AdditionalResources....................................................................................................................................1 WhatsNew?.................................................................................................................................................1 WhatsFixed?................................................................................................................................................7 FeatureLimitationsandNotes .....................................................................................................................8 .

AdditionalResources
Forcompleteinstructionsaboutuninstallingandinstallingthisrelease,see:www.autodesk.com/maya install2013enu. Forcompletedocumentationandlearningresources,see:www.autodesk.com/mayadocs. Forhardwarequalifications,see:www.autodesk.com/mayahardware. Toreportissueswiththisrelease,see:www.autodesk.com/mayasupport. Formoreresources,see:www.autodesk.com/mayalearningpath.

WhatsNew?
Mayaand.NETSDK
ThenewMaya.NETSDKallowsyoutocreatepluginsforMayausingMicrosoft's.NETtechnologyand loadpluginsstoredin.NETassemblies.IncludedwiththeSDKarethe.NETSDKclasslibraries,theVisual StudioXMLdocumentationandC#examplefiles. FormoreinformationregardingtheMaya.NETSDK,seehttp://www.autodesk.com/mayasdkdoc2013 enu.

DirectX11MayaUberShaderenhancements
TheDirectX11MayaUberShaderenhancementsinExtensionforMaya2013includethefollowing new/updatedfeatures:

Usingthe_MAYA_macro
IfyoushareyourHLSLfileswithotherapplicationsbutneedtoincludeMayaspecificcode,you canwrapyourHLSLcodeinthe_MAYA_macro,similartotheexamplebelow:
#ifdef _MAYA_ float2 UV = float2(U, 1.0-V); #endif

Light0/Light1/Light2
Thefollowingnewattributehasbeenadded: Light0Type Selectthetypeoflight,forexample,spot,point,directionalorambient.TheDefaultandNone optionsareusedinternallybythedx11Shader.mllplugin.Selectingeitheroftheseoptions resultsinapointlight.

AmbientandEmissive
TheAmbientEmissiveMapattributehasbeenrenamedtoEmissiveMap. Thefollowingnewattributehasbeenadded: AmbientOcclusionMap Selectthisoptiontoaddambientocclusiontoyourscene.Connectaprebakedmapthataffects onlyambientlightintheshader.

Diffuse
YoucannowuseimagebasedlightingwiththeDirectX11MayaUberShader,aswellassimulate diffuseshadingforhair.Thefollowingattributesareneworupdated: DiffuseModel Selectamongthreediffuseshadingmethods,dependingonyourobject.SelectBlendedNormal (Skin)sothatthediffuselightingonanobjectismorerealisticforsimulatingskin.SelectSoften Diffuse(Hair)tosimulatethediffuselightingforhair.SelectLambertforothermodels. Note:UseoftheDepthPeelingTransparencyAlgorithmwithDiffuseMapAlphaiscurrently notsupported. BlendedNormalMask/BlendedNormal

SoftenDiffuseMaskfromExtension1hasbeenrenamedtoBlendedNormalMaskinExtension 2.Likewise,SoftenDiffusehasbeenrenamedtoBlendedNormal. IBLMap Usethisfeaturetoaddimagebasedlightingtoyourscene.Youcanconnecta.ddscubemap ora2Dsphericalorlatlongmap;or,acombinationofacubemapanda2Dmap. Thisfeatureallowsyoutorapidlyprototypeyourcharacterindifferentlightingenvironments. IBLCubeMap Selectthisoptiontoconnecta.ddscubemap. IBL2DMap Selectthisoptiontoconnecta2Dsphericalorlatlongmap. IBLType SelectfromthedropdownlistthetypeofIBLmap(s)thatyouareconnecting.Youcanconnect a.ddscubemapora2Dsphericalorlatlongmap;or,acombinationofacubemapanda2D map. IBLIntensity Usethisslidertoincreaseordecreasetheintensityofyourimagebasedlighting. IBLBlur Usethisslidertoblurtheimagebasedmap. IBLRotation UsethisslidertorotateyourIBLmap;forexample,ifyouwantthesuninyourIBLmapto appearelsewhereonyourobject. IBLSphericalPinch Adjustthisattributetoreducepinchingartifactsthatmayoccurwithsomesphericalmaps.

Specular
Youcannowsimulatemetalorhairusinganisotropicspecularlighting.Thefollowingattributes areneworupdated: SpecularModel Selectamongthreespecularshadingmethods,dependingonyourmodel.SelectKelemen Szirmaykalos(Skin)toperformKelemenSzirmaykalosspecularcalculationstobettersimulate humanskin.SelectAnisotropic(BrushedMetal/Hair)toaddanisoptropicspecularlightingto simulatemetalorhair.SelectBlinnshadingforothermodels. AnisotropicDirectionMap IfyouselecttheAnisotropic(BrushedMetal/Hair)optionunderSpecularModel,youcan optionallyaddadirectionalmaptocontrolthedirectionoftheanisotropichighlight.Ifyoudo

notselectthisoption,youcanstillusetheAnisotropicSpecularColorandAnisotropic Roughnessoptionstocontrolthecolorandshapeofyourspecularhighlight. Note:Currently,youmustuseatangentspacemap. AnisotropicDirectionType SelectfromthedropdownlistthetypeofdirectionmapyouareconnectingtotheAnisotropic DirectionMapattribute. AnisotropicSpecularColor Usethisoptiontocontrolthecolorofyourspecularhighlight. AnisotropicRoughness Usethisoptiontocontroltheshapeofyourspecularhighlight. MixBlinnAnisotropicbyDirectionAlpha SelectthisoptiontoblendbetweenBlinnandanisotropicspecularlightingbasedonthealpha channelinthedirectionmap.

Normal
Thefollowingnewattributeshavebeenadded: SupportNonUniformScale Selectthisoptiontocorrectlydisplaynormalsforobjectsthathavenonuniformscalingapplied. NormalX(Red)/NormalY(Green) Usetheseoptionstosetwhethertheredandgreenchannelsofyournormalmaparepositiveor negative. Important:Forthisoptiontoworkcorrectly,youmustensurethatTangentSpace>Coordinate SystemissettoRightHandedundertheshapenode.

Reflection
Youcannowuse2Dsphericalorlatlongreflectionmaps,andthefollowingattributesarenewor updated: ReflectionMap Selectthisoptiontouseareflectionmapinyourscene. ReflectionType Youcanconnecta.ddscubemapora2Dsphericalorlatlongmapinanystandardsupported imageformat(including.HDR);or,acombinationofacubemapanda2Dmap.Selectfromthe dropdownlistthetypeofmap(s)youareusing. Reflection2DMap Selectthisoptiontoconnecta2Dsphericalorlatlongmap.

Tip:IBLandreflectionmapsshouldbeinthesamecolorspaceasyourotherinput textures.WhenusingtheLinearSpaceLightingsettingintheMayaUbershader,inputtextures areexpectedtobeinsRGBdisplayspace;therefore,IBLandreflectionmapsshouldbe convertedintothisspacethroughimageeditingsoftware.Ifrenderinglinearoutputandusing theViewport2.0Gammasettingforpreview,allinputtexturesshouldbeinscenereferred linearcolorspaceandtheLinearSpaceLightingsettingintheMayaUbershadershouldnotbe used. ReflectionRotation Usethisoptiontorotateyourreflectionmap. ReflectionSphericalPinch Whenusingsphericalreflectionmaps,youcanusethisoptiontoreducethepinchingartifacts thatsomesphericalmapsmayexhibit. ReflectionsAffectOpacity Selectthisoptionsothatareasontheobjectthathavereflectionorspecularitydonotbecome fullytransparent(forexample,likeasoapbubble).Whenthisoptionisdisabled,reflectionsand specularlightingdonotaffectopacity(forexample,withsemitransparentobjectssuchashair).

TessellationandDisplacement
Whenconnectingtangentvectordisplacementmaps,youcannowusetheDisplacementModel dropdownlist.Thefollowingattributesareneworupdated. DisplacementModel Selectfromthedropdownlistwhetheryouareusingagreyscaledisplacementmapora tangentvectormap.YoucancreatevectordisplacementmapsinMudbox.However,youmust usethesamelowpolygonmodelinMayaasyoudoinMudbox. Whenusingavectordisplacementmap,youusuallyalsowanttoprovideanormalmaptothe shadertoprovidethecorrectnormalstotheshaderafterthevectordisplacementmaphas movedthevertices. Note:SelectTangentasyourCoordinateSpaceifyououtputyournormalmapfromMudbox. SelectAbsoluteTangentasyourVectorSpaceifyououtputyourvectordisplacementmapfrom Mudbox. DisplacementCoordsys Selectthecorrectdisplacementaxisforvectordisplacementmaps.Theaxisisdeterminedby theapplicationfromwhichyougeneratedthevectordisplacementmap,forexample,Mudbox.

Useof.exr/.tiffiles
WhencreatinganewsceneinExtension2forMaya2013,ifyouareusing.exrfilesfor greyscaledisplacementmaps,younolongerneedtoadjusttheDisplacementOffsetor

DisplacementHeightvaluesandthedefaultsettingsshouldworkautomatically.Ifyouareusing .exrfilesfortangentvectordisplacementmaps,youshouldsetyourDisplacementOffsetto0 andyourDisplacementHeightto1. However,ifyouhavealegacyscene,youmustadjustyourheightandoffsetvaluestoachieve thesameresultasinExtensionforMaya2013.Ingeneral,youshouldsettheDisplacement Heightto1andDisplacementOffsetto0fortangentvectordisplacementmapsand DisplacementHeightto1andDisplacementOffsetto0.5forgreyscaledisplacementmaps. Thischangedoesnotapplyto.tiffiles.Therefore,whencreatinganewsceneinExtension2, youmuststilladjusttheDisplacementOffsetorDisplacementHeightvaluesmanually. However,ifyouhavealegacyscene,thesamesettingsfromExtension1shouldalsoworkfor Extension2. Ingeneral,useof .exrfilesfordisplacementmapsisrecommended.

WorkingwithscenesfromExtension1
Currently,therearetwoversionsoftheubershaderavailable:theMayaUberShader.fxo fromExtensionforMaya2013,andtheAutodeskUberShader.fxofromExtension2, whichcontainsthenewfeaturesdescribedabove. IfyouloadascenefromExtension1intoExtension2,andyourexistingdx11Shadernodesare mappedtoanabsoluteshaderpaththatisstillvalid(the.fxofilestillexistsattheabsolute path),thesceneshouldworkasitdidinExtension1. IfyouloadascenefromExtension1intoExtension2,andyourexistingdx11Shadernodesare mappedtoanabsoluteshaderpaththatisnolongervalid(inotherwords,the.fxonolonger exists),youcanremaptotheMayaUberShader.fxofilesothatyoursceneworksasitdidin Extension1. Alternatively,youcanremaptotheAutodeskUberShader.fxofile,whichcontainsnew featuresfromExtension2.However,youmayneedtoadjustsomeofyourparameters;for example,reconnectyourambientemissivemap,orreenabletheReflectionMapoption. IfyoucreateanewDirectX11Shader,theAutodeskUberShader.fxofileisloaded,withall thenewfeaturesavailable.

NewMAYA_CER_INCLUDE_SCENE_NAMEenvironmentvariable
UsethisenvironmentvariabletodeterminewhetheryourscenefilenameisincludedwithyourCER reporttoAutodesk.Ifthisvariableisnotset,thescenenameisshowasundisclosed. 0=scenenameislistedasundisclosed 1=includeonlythefilename 2=includethefullpath/filename

WhatsFixed?
Thissectiondescribesfixesincludedinthisextension.Foralistofincludedfixesfromprecedingreleases seethefollowingdocuments: http://images.autodesk.com/adsk/files/extension_maya2013_readme_enu.pdf http://images.autodesk.com/adsk/files/Maya2013_SP1Readme_enu0.pdf

Animation
BugNumber MAYA13850 MAYA15314 MAYA16179 MAYA17210 MAYA18066 MAYA18418 Description PlayblastinQuicktimedoesn'topeninviewerifnamecontains.(period) cMuscleSaveWeightsMEL errorwhenswitchingthe"loadby"options RotateOrdersettoincorrectvaluewhenaddedtoanimationlayer Skinclustermaxinfluencesbreakstools(weighthammer) PlayblastplayernotlaunchedautomaticallyonLinux Playblastplayercannotopenfilebecausethefilenameismissinganextension

FileReferencingandAssets
BugNumber MAYA12163 MAYA16547 MAYA17133 Description Fileisdirtyaftersavingit(possiblyduetotemporaryreferencenamespace) Loadingreferenceinstability LockedDAGcontainerallowsparenting

Modeling
BugNumber MAYA14958 MAYA16267 MAYA18018 MAYA18495 MAYA18753 Description AddwarningwhenMFnMesh.generateSmoothMesh()producesNANs UVseteditornotdisplayingallUV whenthereareintermediatemeshobjects DisplayofhighsurfaceprecisionNURBSgeometryisincorrect Polynormals'locked'whenreopeningscene AddGlobalPolyNormalMethodpreference

SimulationandEffects
BugNumber MAYA9865 Description ObjectscreatedusingMayaBulletshelf/menudonotworkasexpected

Rendering
BugNumber MAYA1859 MAYA12578 MAYA13789 MAYA14414 MAYA16275 Description Materialsrenderon partsofthemeshdifferentlythan theyappearassignedto(per faceshading)withmentalray Disabling"Filtering"inCameraDepthrenderpasswithmentalraycausesinstability Paintingontexturedobjectleadstoinstability SubstanceAttributeEditorbrokenwhenloadingscene Mayafilewithparticularlinecrasheswithlocknode(mentalray)

BugNumber MAYA16631 MAYA17081 MAYA17877 MAYA17888 MAYA18660 MAYA18671 MAYA18702 MAYA18706 MAYA18933 MAYA18977 MAYA19218 MAYA19578 MAYA19371 MAYA16156

Description TexturemodewithCGFXshadersinViewport 2.0isnotdisplayedproperly Wireframeobjectisalwaysdrawninthebackofimage plane Instabilitywith2kstereo paneloffscreenplayblast GPUmemoryissues Imageplanestayshiddenwithshowmenu Settingcameraimageplanechangesvisibilityofcamerahierarchy Clippingplanesignoredbymentalray Errorwhenrenamingimage planesordisconnecting image planes TexturesdontdisplayinViewport2.0whenfilesexchangedbetweenMayaand Mudbox Mia_MatXRoughnessbreaks render passandcontributionmaps MaterialinformationlostafterHypershadeDeleteUnusedNodes EXRtexturesusedintheDX11shadercorruption MayaCERreportstoomuchinfo Snapping/framinginUVEditorisincorrectifUseImageRatioison

Scripting
BugNumber MAYA15718 Description PyQtinstabilityissues

FeatureLimitationsandNotes
Thefollowingsectiondescribeslimitationsandothernotesaboutthisrelease.

Limitations
BugNumber MAYA7971 Description Compositeinstability onCentOS6withATIRadeon5870
Autodesk,Backburner,FBX,Maya,MotionBuilder,Mudbox,Softimage,and3dsMaxareregisteredtrademarksortrademarks ofAutodesk,Inc.,and/oritssubsidiariesand/oraffiliatesintheUSAand/orothercountries.Allotherbrandnames,product names,ortrademarksbelongtotheirrespectiveholders.Autodeskreservestherighttoalterproductandservicesofferings, andspecificationsandpricingatanytimewithoutnotice,andisnotresponsiblefortypographicalorgraphicalerrorsthatmay appearinthisdocument. 2012Autodesk,Inc.Allrightsreserved.