ジャンプ先: 概要. 戻り値. 関連項目. Python 例.

概要

particleExists( string )

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

particleExists は 「元に戻す」が可能、「照会」が不可能「編集」が不可能 です。

このコマンドは、指定した名前のパーティクルまたはソフト オブジェクトが存在するかどうか照会するために使用します。トランスフォーム名とシェイプ名のどちらでも使用できるほか、ソフト オブジェクト名も使用可能です。

戻り値

boolean 指定した名前のパーティクル オブジェクトかソフト オブジェクトが存在する場合は true。存在しない場合は false を返します。

関連項目

particle

Python 例

import maya.cmds as cmds

# If the object does not exist then false (0) is returned
cmds.file( f=True, new=True )
cmds.particleExists( 'particleShape1' )
# Result: 0 #

# Create a particle shape and then querying for
# it will return true (1)
cmds.emitter()
# Result: emitter1 #
cmds.particle()
# Result: particle1 particleShape1 #
cmds.connectDynamic( 'particle1', em='emitter1' )
# Result: particleShape1 #
cmds.particleExists( 'particleShape1' )
# Result: 1 #

# You may also query using the transform name
cmds.particleExists( 'particle1' )
# Result: 1 #

# The name of a soft body object can be used to query as well
cmds.polySphere( r=1, sx=20, sy=20, ax=(0, 1, 0), tx=2, ch=1 )
# Result: pSphere1 polySphere1 #
cmds.soft( c=True )
# Result: pSphere1Particle #
cmds.particleExists( 'pSphere1Particle' )
# Result: 1 #