Skip to main content

Skinning

Since CGI 3.14, skinning animationsyou can be played by importingimport skinning FBXFilmbox (FBX) or glTFGL Transmission Format (glTF) files. Scene Composer can then play the skinning animations. However, the following limitations exist.exist:

  • The maximum number of joints associated with each vertex is 4.
  • If the number of joints associated with a skinning meshSkinningMesh is 100 or less, Scene Composer performs skinning is performed using a shader.
  • If the number of joints associated with the skinning meshSkinningMesh is between 101 toand a255 maximum(maximum), ofScene 255,Composer performs skinning processing will be performed on the CPU,CPU. butIn this case, the performance will decrease.decreases.
  • CGI Studio manages rotationrotations using Euler,Euler angles, so itreproducing maythe animation might not be possible to reproduce the animation.
    possible.
  • If a SkinningMesh and the SkinningMesh's parent Transform are not identity matrices and the SkinningMesh's postureSkinningMesh does not giveappear theas expected result, pleaseexpected, set the identity matrix for SkinningMesh and the SkinningMesh's parent Transform.
  • If you place a SkinningMesh and Joint Nodes are placed under a Group, CGI Studio applies the changes made in the Group's Transform will be applied to the SkinningMesh twice.

In addition to the above, please note the following limitations when importing skinning in FBX file format.

  • CGI Studio does not support FBX format FbxSkin::eDualQuaternion and FbxSkin::eBlend are not supported.eBlend.
  • CGI Studio does not support FbxCluster::eAdditive in FBX format is not supported.format.

SkinningMesh

Note that you can create a SkinningMesh that you can beuse used onin Scene Composer by importing an FBX/FBX or glTF file that contains at least one skinning.skinned Themesh. properties of aA SkinningMesh createdthat you create by importing isa asfile follows.has the following properties:

Skin (Common Properties)
drawing-4-1725634469.pngdrawing-4-1725634469.png
Line Width

ItThis property is only addedavailable if you enable the [ Import as wireframe ] option is enabled when importing an FBX file that contains skinning. ThisThe Line Width property specifies the line width of the mesh when Scene Composer renders it is rendered as wire.a wireframe.

  • TheScene Composer determines the actual line width is determined by rounding the specified width to the nearest integer.
  • If the setting is less than “1”, itScene isComposer always setsets it to “1”.
Enable CPU Skinning

SpecifiesThis ifproperty specifies whether you enable CPU Skinning is enabled or not.Skinning. If enabled,you enable it, you can use vertex shaders other than those provided for skin can be used with Skinning Mesh. 

Note:Note: It is recommended to avoid CPU skinning calculations because they are slow and should thus be avoided.slow. If enabled,you enable CPU Skinning, edit or configure the shader mustin bea edited or configured soway that skinning is not doneperformed inby the shader.

Other ProperiesProperty items

TheCGI Studio sets the following propertyproperties itemsduring import, that are setnot at importing and cannot be changed.editable:

drawing-4-1715328271.pngdrawing-4-1715328271.png
Joint Node SetsThis property ses a joint node.
Enable Inverse Bind Matrix

SpecifiesThis ifproperty specifies whether Inverse Bind Matrix is enabledenabled.

or not.

If the property is enabled, then the joint uses the Inverse Bind Matrix.

If the property is disabled, then the joint uses the identity matrix.

Inverse Bind Matrix UsedThe toInverse bringBind Matrix brings coordinates that are being skinned into the same space as the joint.

Adding importedImported scenesScenes

Import of FBX or glTF files,files includingthat skinning,include isskinning performedby using the standard procedure (FBX import procedure, glTF import procedure). After importing, creatingcreate new scenes and animations from the scenes and animations contained in the imported resources.

  1. Select a scene contained in the imported resource and chooseselect [ Add Scene From Template... ] from the context menu.
    • The [ Add New Scene 3D ] dialog will appear.appears.
    • For more information on  the [ Add Scene From Template... ]  feature, see hereAdd Scene From Template.
  2. MakeConfigure the necessary settings on the [ Add New Scene 3D ] dialog and pressclick [ OK ] button..
    • TheScene Composer adds the scene will be added as a new scene in the Solution Explorer panel,panel, in the Solution > Scenes folder.
    • The sceneScene treeTree panel will displaydisplays the added scene.

      drawing-5-1732893834.pngdrawing-5-1732893834.png

CGI Studio adds the SkinningMesh is added to the imported scene (red frame in the right figure above). 

If the imported scene does not contain any camera or light nodes, add them to the new scene from the Node 3D item in the Toolbox panel and makeconfigure the necessaryrequired settings.

Add a Render Target

AddsAdd the camera of the addedimported scene to the render target.

When a camera node is added
  1. DisplaysDisplay the Render Targets panel.
    • AScene Composer has already added a camera with the added scene name has already been added in the panel.

  2. CheckSelect the checkboxes for the added cameras.
If the imported scene contains a camera
  1. In the Render Targets panel, selectright click on the Render Target and thenselect [ Add Camera to Render Target... ] from the context menu.
    • The [ Choose Item ] dialog will appear.appears.

  2. Expand the Scenes folder in the [ Choose Item ] dialog and select the cameras in the scene you added.

added Pressand theclick [ OK ] button in the dialog..

Add importedImported animationsAnimations

To play the skinning animation in the Player, add the animation infrom the imported resource.

  1. SelectRight-click an animation contained in the imported resource and chooseselect [ Add Animation From Template... ] from the context menu.
    • The [ Add New Animations ] dialog will appear.appears.
    • For more information on  the [ Add Animation From Template... ]  feature, see hereCreate animation from template.

  2. MakeConfigure the necessaryrequired settings onin the [ Add New Animations ] dialog and pressclick [ OK ] button..
    • TheYou scenecan will be added as a new scenesee in the Solution ExplorerExplorer, panel,that inScene theComposer Solution>Animationscreated folder.a new animation.

Play skinningSkinning animationAnimation

Use CGI Player is used to play back skinning animations in a composed scene.

  1. PressClick the [ Play selected scenario... ] icon on the toolbar to launch the CGI Player.
    • If youyour havesolution notcontains savedunsaved changes, Scene Composer opens the solution before this operation, the [ Save Solution ] dialog will appear andasking you willto besave askedthe solution. Click OK in the dialog to save the solution.
    • ByScene pressingComposer the [ OK ] button in the dialog,generates the asset file will be automatically generated and openedopens it in CGI Player.

  2. In the CGI Panel,Panel, check the target scene from the scene list on the left side.
    drawing-4-1715316125.pngdrawing-4-1715316125.png


  3. SelectUse the animation to be played from the toolbar pull-down menu.
    menu to select the animation, that you want the CGI Player to play.
    drawing-4-1715316183.pngdrawing-4-1715316183.png


  4. PressClick the Play buttonAnimation onin the toolbar to executeplay the animation playback.
    animation.
    • TheCGI Player starts to play the skinning animation specified in the display panel is played.Panel.
      drawing-4-1715328731.pngdrawing-4-1715328731.png
      SkinningAnime.gifSkinningAnime.gif