Entity user-defined attributes FCOLLADA extension: Difference between revisions

From COLLADA Public Wiki
Jump to navigation Jump to search
Glaforte (talk | contribs)
171 edits
First draft.
 
Elf (talk | contribs)
xyz
3,132 edits
extensions->extension
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{extensions|company=[[Feeling Software extensions|Feeling Software]]|product=[[FCollada]]}}
{{extension|company=[[Feeling Software extensions|Feeling Software]]|product=[[FCollada]]}}


== Entity user-defined attributes extension ==
This <extra> at the entity level is used to add user-defined attributes that are meant to be animatable/editable in the DCC packages.
This <extra> at the entity-level is used to add user-defined attributes that are meant to be animatable/editable in the DCC packages.


ColladaMax supports entity levels for materials, meshes, cameras, and lights. These will be displayed in the UI for up to two levels of the user-defined attributes tree.


ColladaMax supports entity-levels for materials, meshes, cameras and lights. These will be displayed in the UI for up-to two levels of the user-defined attributes tree.
ColladaMaya supports entity levels for cameras, lights, scene nodes, materials, meshes, skin clusters, and blend shapes. All the levels of the user-defined attributes tree are accessible and modifiable/animatable through Maya's plug systems, but only the first level is editable in Maya's attribute editor.
 
 
ColladaMaya supports entity-levels for cameras, lights, scene nodes, materials, meshes, skin clusters and blend shapes. All the levels of the user-defined attributes tree are accessible and modifiable/animatable through Maya's plug systems, but only the first level is editable in Maya's attribute editor.
'''NOTE''': the <dynamic_attributes><notes> element is modifiable through Maya's note textbox below the bottom of the attribute editor. '''NOTE2''': be careful when assigning long and short names for attributes, since Maya already uses a bunch of them and we don't handle attribute name clashes.


*'''NOTE''': The <dynamic_attributes><notes> element is modifiable through Maya's note textbox below the bottom of the attribute editor.
*'''NOTE2''': Be careful when assigning long and short names for attributes, because Maya already uses a bunch of them and we don't handle attribute name clashes.


{| border=1 cellspacing=0 cellpadding=3 align=center
{| border=1 cellspacing=0 cellpadding=3 align=center
Line 17: Line 15:
|-
|-
| <dynamic_attributes> || || Contains a tree of XML nodes and attributes that should be available to a user in the DCC package.
| <dynamic_attributes> || || Contains a tree of XML nodes and attributes that should be available to a user in the DCC package.
|-
| || short_name || Used by ColladaMaya for the plug name. This optional attribute allows you to give a second, scriptable, name for the user-defined attribute.
| || short_name || Used by ColladaMaya for the plug name. This optional attribute allows you to give a second, scriptable, name for the user-defined attribute.
|-
| || long_name || Used by ColladaMaya for the plug name. This optional attribute allows you to give a more descriptive scriptable name for the user-defined attribute.
| || long_name || Used by ColladaMaya for the plug name. This optional attribute allows you to give a more descriptive scriptable name for the user-defined attribute.
|-
| || type || Necessary attribute. This enumerated type defines the data type of the user-defined attribute. Possible values are: bool, int, int2, int3, string, float, float2, float3, float4, float4x4, color3.
| || type || Necessary attribute. This enumerated type defines the data type of the user-defined attribute. Possible values are: bool, int, int2, int3, string, float, float2, float3, float4, float4x4, color3.
|-
|-
|}
|}


 
== Examples ==
== Example ==
  < !-- Prefered by ColladaMaya. -->
   <library_geometries>
   <library_geometries>
     <geometry>
     <geometry>
Line 37: Line 38:
     </geometry>
     </geometry>
   </library_geometries>
   </library_geometries>
{{extensions|company=[[Feeling Software extensions|Feeling Software]]|product=[[FCollada]]}}
 
  < !-- Prefered by ColladaMax. -->
  <library_geometries>
    <geometry>
      <extra>
        <technique profile="FCOLLADA">
          <dynamic_attributes>
         
            < !-- In ColladaMax: this element's name will be the name of the UI panel. -->
            <weapon_info>
              <weapon_name short_name="wn" type="string">AK47</weapon_name>
              <weapon_damage short_name="wd" type="float">34</weapon_damage>
            <weapon_info>
          </dynamic_attributes>
        </technique>
      </extra>
    </geometry>
  </library_geometries>

Latest revision as of 05:07, 23 February 2009

Extension information
  • Purpose: unstated
  • Company(s): [[Feeling Software]]
  • Product(s): [[FCollada]]
  • Last updated: unstated
  • Contact for technical issues:
This article is part of the COLLADA extensions directory
Adding to the extensions directory

This <extra> at the entity level is used to add user-defined attributes that are meant to be animatable/editable in the DCC packages.

ColladaMax supports entity levels for materials, meshes, cameras, and lights. These will be displayed in the UI for up to two levels of the user-defined attributes tree.

ColladaMaya supports entity levels for cameras, lights, scene nodes, materials, meshes, skin clusters, and blend shapes. All the levels of the user-defined attributes tree are accessible and modifiable/animatable through Maya's plug systems, but only the first level is editable in Maya's attribute editor.

  • NOTE: The <dynamic_attributes><notes> element is modifiable through Maya's note textbox below the bottom of the attribute editor.
  • NOTE2: Be careful when assigning long and short names for attributes, because Maya already uses a bunch of them and we don't handle attribute name clashes.
Element Supported Attribute Description
<dynamic_attributes> Contains a tree of XML nodes and attributes that should be available to a user in the DCC package.
short_name Used by ColladaMaya for the plug name. This optional attribute allows you to give a second, scriptable, name for the user-defined attribute.
long_name Used by ColladaMaya for the plug name. This optional attribute allows you to give a more descriptive scriptable name for the user-defined attribute.
type Necessary attribute. This enumerated type defines the data type of the user-defined attribute. Possible values are: bool, int, int2, int3, string, float, float2, float3, float4, float4x4, color3.

Examples

 < !-- Prefered by ColladaMaya. -->
 <library_geometries>
   <geometry>
     <extra>
       <technique profile="FCOLLADA">
         <dynamic_attributes>
           <weapon_name short_name="wn" type="string">AK47</weapon_name>
           <weapon_damage short_name="wd" type="float">34</weapon_damage>
         </dynamic_attributes>
       </technique>
     </extra>
   </geometry>
 </library_geometries>

 < !-- Prefered by ColladaMax. -->
 <library_geometries>
   <geometry>
     <extra>
       <technique profile="FCOLLADA">
         <dynamic_attributes>
         
           < !-- In ColladaMax: this element's name will be the name of the UI panel. -->
           <weapon_info> 
             <weapon_name short_name="wn" type="string">AK47</weapon_name>
             <weapon_damage short_name="wd" type="float">34</weapon_damage>
           <weapon_info>
         </dynamic_attributes>
       </technique>
     </extra>
   </geometry>
 </library_geometries>
Retrieved from "https://wikis.khronos.org/collada/index.php?title=Entity_user-defined_attributes_FCOLLADA_extension&oldid=6020"