Python.pdf

Python

Legal Notice

Autodesk® Maya® 2008

by Autodesk, Inc., this publication, or parts thereof, may not be reproduced in

any form, by any method, for any purpose.

Certain materials included in this publication are reprinted with the permission

of the copyright holder.

Mozilla codebase under the Mozilla Public License. Source code may be found

at http://www.mozilla.org/source.html. The Mozilla software is distributed under

the Mozilla Public License on an "AS IS" basis, WITHOUT WARRANTY OF

ANY KIND. The Mozilla Public License may be found at www.mozilla.org/MPL/.

reserved. This software is based in part on the work of the Independent JPEG

Group.

Portions of the subdivision surface implementation technology are protected by

U.S. patents 6,037,949, 6,222,553, 6,300,960, and 6,489,960 and used under

license from Pixar.

Trademarks

The following are registered trademarks or trademarks of Autodesk, Inc., in the

USA and other countries: 3DEC (design/logo), 3December, 3December.com,

3ds Max, ActiveShapes, Actrix, ADI, Alias, Alias (swirl design/logo),

AliasStudio, Alias|Wavefront (design/logo), ATC, AUGI, AutoCAD, AutoCAD

Learning Assistance, AutoCAD LT, AutoCAD Simulator, AutoCAD SQL

Extension, AutoCAD SQL Interface, Autodesk, Autodesk Envision, Autodesk

Insight, Autodesk Intent, Autodesk Inventor, Autodesk Map, Autodesk

MapGuide, Autodesk Streamline, AutoLISP, AutoSnap, AutoSketch, AutoTrack,

Backdraft, Built with ObjectARX (logo), Burn, Buzzsaw, CAiCE, Can You

Imagine, Character Studio, Cinestream, Civil 3D, Cleaner, Cleaner Central,

ClearScale, Colour Warper, Combustion, Communication Specification,

Constructware, Content Explorer, Create>what's>Next> (design/logo), Dancing

Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignKids,

DesignProf, DesignServer, DesignStudio, Design|Studio (design/logo), Design

Your World, Design Your World (design/logo), DWF, DWG, DWG (logo), DWG

TrueConvert, DWG TrueView, DXF, EditDV, Education by Design, Extending

the Design Team, FBX, Filmbox, FMDesktop, Freewheel, GDX Driver, Gmax,

Heads-up Design, Heidi, HOOPS, HumanIK, i-drop, iMOUT, Incinerator,

IntroDV, Inventor, Inventor LT, Kaydara, Kaydara (design/logo), LocationLogic,

Lustre, Maya, Mechanical Desktop, MotionBuilder, ObjectARX, ObjectDBX,

Open Reality, PolarSnap, PortfolioWall, Powered with Autodesk Technology,

Productstream, ProjectPoint, Reactor, RealDWG, Real-time Roto, Render

Queue, Revit, Showcase, SketchBook, StudioTools, Topobase, Toxik, Visual,

Visual Bridge, Visual Construction, Visual Drainage, Visual Hydro, Visual

Landscape, Visual Roads, Visual Survey, Visual Syllabus, Visual Toolbox,

Visual Tugboat, Visual LISP, Voice Reality, Volo, and Wiretap.

The following are registered trademarks or trademarks of Autodesk Canada

Co. in the USA and/or Canada and other countries: Backburner, Discreet, Fire,

Flame, Flint, Frost, Inferno, Multi-Master Editing, River, Smoke, Sparks, Stone,

Wire.

mental ray is a registered trademark of mental images GmbH licensed for use

by Autodesk, Inc. Adobe, Illustrator and Photoshop are either registered

trademarks or trademarks of Adobe Systems Incorporated in the United States

and/or other countries. The Ravix logo is a trademark of Electric Rain, Inc.

"Python" and the Python logo are trademarks or registered trademarks of the

Python Software Foundation. All other brand names, product names or

trademarks belong to their respective holders.

Disclaimer

THIS PUBLICATION AND THE INFORMATION CONTAINED HEREIN IS

MADE AVAILABLE BY AUTODESK, INC. "AS IS." AUTODESK, INC.,

DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED,

INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF

MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE

REGARDING THESE MATERIALS.

Published by:

Autodesk, Inc.

111 Mclnnis Parkw ay

San Rafael, CA 94903, USA

All use of this Software is subject to the terms and conditions of the Autodesk

End User License Agreement accepted upon installation of this Software and/

or packaged with the Software.

Patents

Protected by one or more of U.S. Patent Nos. 6,384,835, 6,356,271,

6,204,860, 6,549,212, 6,414,700, 6,915,492, 6,348,924, 6,462,740, 5,889,528,

6,025,852, 5,999,195, 6,130,673, 6,389,154, 6,553,337, 6,850,638, 6,525,735,

7,034,824, 6,232,980, 5,852,450, 5,990,908, 6,363,503, 7,168,012, 6,888,542,

5,287,408, 6,317,128, 5,764,233, 6,037,948, 6,246,416, 6,266,071, 5,847,716,

7,139,444, 6,859,202, 6,798,416, 6,118,427, 5,809,219, 6,211,882, 5,808,625,

5,929,864, 5,818,452, 5,689,667, 5,926,178, 6,618,063; and patents pending.

Third-Party Software Credits and Attributions

Mozilla codebase under the Mozilla Public License. Source code may be found

at http://www.mozilla.org/source.html. The Mozilla software is distributed under

the Mozilla Public License on an "AS IS" basis, WITHOUT WARRANTY OF

ANY KIND. The Mozilla Public License may be found at www.mozilla.org/MPL/.

reserved. This software is based in part on the work of the Independent JPEG

Group.

modify, distribute, and sell this software and its documentation for any purpose

is hereby granted without fee, provided that (i) the above copyright notices and

this permission notice appear in all copies of the software and related

documentation, and (ii) the names of Sam Leffler and Silicon Graphics may not

be used in any advertising or publicity relating to the software without the

specific, prior written permission of Sam Leffler and Silicon Graphic.

THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF

ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT

LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A

PARTICULAR PURPOSE. IN NO EVENT SHALL SAM LEFFLER OR

SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTIAL,

INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY

DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR

PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF

DAMAGE, AND ON ANY THEORY OF LIABIBITLY, ARISING OUT OF OR IN

CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Portions relating to the implementation of the Edge Detection and Image

Segmentation (EDISON) System are provided "AS IS". More information may

be found at http://www.caip.rutgers.edu/riul/research/code.html.

Portions of the subdivision surface implementation technology are protected by

U.S. patents 6,037,949, 6,222,553, 6,300,960, and 6,489,960 and used under

license from Pixar.

source and binary forms, with or without modification, are permitted provided

that the following conditions are met: Redistributions of source code must

retain the above copyright notice, this list of conditions and the following

disclaimer. Redistributions in binary form must reproduce the above copyright

notice, this list of conditions and the following disclaimer in the documentation

and/or other materials provided with the distribution. Neither the name of

Industrial Light & Magic nor the names of its contributors may be used to

endorse or promote products derived from this software without specific prior

written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT

HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED

WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,

INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE

GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR

BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY

OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT

OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

POSSIBILITY OF SUCH DAMAGE.

Table of Contents

Python in Maya . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Using Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Python and threading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Python from an external interpreter . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Important differences between MEL and Python. . . . . . . . . . . . . . . . . 20

Current limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Python

1 Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

About

Table of Contents

Python

About

Python in Maya

Autodesk Maya supports the use of Python-style scripting wherever you used to

use MEL commands. The implementation of Python scripting in Maya provides

the same access to native Maya commands as is provided through MEL. That is,

all of the built-in Maya commands, such as sphere , ls , and so on, are

accessible through Python.

Commands that are written as MEL scripts—which are actually MEL global

procedures (procs)—are accessible using a call to access MEL ( maya.mel.eval ).

For more information, see ”MEL/Python communication” on page 14.

Note

There are certain MEL built-ins that are not available in Python,

though they generally have Python counterparts.These include math

functions ( abs , sin , cos , ...) and string functions ( match , gmatch ,

tokenize ...). (The set of MEL built-in functions can be considered

the MEL runtime library.)

Python comes with a wide variety of standard modules that provide

similar functionality. Refer to Python documentation for information

on what is available and how to use these functions in your Python

scripts.

Python Command Reference

There is a Python command reference similar to the MEL command reference. For

details on all Python commands, refer to the Python command reference

documentation in Maya Help.

You can access the help by selecting Help > Python Command Reference or

open the Maya Help (Help > Maya Help), and when the Help appears, click

CommandsPython at the bottom of the navigation frame.

Version

Maya installs Python with your Maya installation. Maya uses Python version 2.5.1

on all supported platforms. The standalone Python shell for Maya is named

mayapy.exe on Windows and mayapy on Linux and Mac OS X.

External resources

For information about getting started with Python, including reference material

and resources, see:

• www.python.org

Python

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: