Difference between revisions of "Softimage XSI extensions"

From COLLADA Public Wiki
Jump to: navigation, search
(a little editing & formatting & question)
Line 1: Line 1:
= <image> extra =
+
== <image> extra ==
== <XSI_Image> ==
+
=== <XSI_Image> ===
 
Stores information about a specific image used in the scene.
 
Stores information about a specific image used in the scene.
 +
{{editor|what=Why do the member names given here not match what's in the example? For example, in table it's "channel_count"; in example, it's "NumChannels".}}
 
{| border=1 cellspacing=0 cellpadding=3 align=center
 
{| border=1 cellspacing=0 cellpadding=3 align=center
 
|-
 
|-
Line 13: Line 14:
 
|-
 
|-
 
| channel_count || Number of channels. Possible values are:
 
| channel_count || Number of channels. Possible values are:
3 = RGB
+
* 3: RGB
4 = RGBA
+
* 4: RGBA
 
|-
 
|-
 
| bitsPerPixels || Number of bits per pixel. Possible values:
 
| bitsPerPixels || Number of bits per pixel. Possible values:
24
+
* 24
32
+
* 32
 
|-
 
|-
 
| minX || Leftmost X of the cropping rectangle.
 
| minX || Leftmost X of the cropping rectangle.
Line 28: Line 29:
 
| maxY || Rightmost Y of the cropping rectangle.
 
| maxY || Rightmost Y of the cropping rectangle.
 
|-
 
|-
| frame_rate || Specifies frame rate to use. If this value is 0, the scene frame rate is assumed; otherwise, this value is the new frame rate.
+
| frame_rate || Frame rate to use. If this value is 0, the scene frame rate is assumed; otherwise, this value is the new frame rate.
 
|-
 
|-
 
| frame_count || Number of frames for sequence.
 
| frame_count || Number of frames for sequence.
 
|-
 
|-
| first || Specifies frame number for first frame in sequence.
+
| first || Frame number for first frame in sequence.
 
|-
 
|-
| last || Specifies frame number for last frame in sequence.
+
| last || Frame number for last frame in sequence.
 
|}
 
|}
  
== Example ==
+
=== Example ===
 
  <image id="noIcon_pic_img" format="bitmap" height="256" width="256" depth="32">
 
  <image id="noIcon_pic_img" format="bitmap" height="256" width="256" depth="32">
 
     <init_from>$XSI_HOME/Application/rsrc/noIcon.pic</init_from>
 
     <init_from>$XSI_HOME/Application/rsrc/noIcon.pic</init_from>
Line 75: Line 76:
 
  </image>
 
  </image>
  
= <light> extra =
+
== <light> extra ==
  
 
  <light id="lights_0">
 
  <light id="lights_0">
Line 100: Line 101:
 
  </light>
 
  </light>
  
= <camera> extra =
+
== <camera> extra ==
 
  <camera id="cameras_0">
 
  <camera id="cameras_0">
 
     <optics>
 
     <optics>
Line 133: Line 134:
 
  </camera>
 
  </camera>
  
= <node> extra =
+
== <node> extra ==
  
 
  <node id="Camera">
 
  <node id="Camera">
Line 197: Line 198:
 
  </node>
 
  </node>
  
= <COLLADA> document extra =
+
== <COLLADA> document extra ==
== <SI_Scene> ==
+
=== <SI_Scene> ===
 
Contains global scene information.
 
Contains global scene information.
  
Line 207: Line 208:
 
| Timing || Specifies whether time values are expressed as frames or seconds.
 
| Timing || Specifies whether time values are expressed as frames or seconds.
 
Possible values are:
 
Possible values are:
FRAMES, SECONDS
+
*FRAMES
 +
*SECONDS
 
|-  
 
|-  
| start || Start time (in either frames or seconds, depending on the value of the Timing flag) of the scene.
+
| start || Start time of the scene (in either frames or seconds, depending on the value of the Timing flag).
 
|-
 
|-
| end || End time (in either frames or seconds, depending on the value of the Timing flag) of the scene.
+
| end || End time of the scene (in either frames or seconds, depending on the value of the Timing flag).
 
|-
 
|-
| frameRate || Frames per second
+
| frameRate || Frames per second.
 
|}
 
|}
  
== Example ==
+
=== Example ===
 
  <extra>
 
  <extra>
 
   <technique profile="XSI">
 
   <technique profile="XSI">

Revision as of 00:14, 18 April 2007

<image> extra

<XSI_Image>

Stores information about a specific image used in the scene.

((EDITOR: This page needs the following improvement: Why do the member names given here not match what's in the example? For example, in table it's "channel_count"; in example, it's "NumChannels". ))

Member Description
filename Name of source file.
imageX Image size in X.
imageY Image size in Y.
channel_count Number of channels. Possible values are:
  • 3: RGB
  • 4: RGBA
bitsPerPixels Number of bits per pixel. Possible values:
  • 24
  • 32
minX Leftmost X of the cropping rectangle.
maxX Rightmost X of the cropping rectangle.
minY Leftmost Y of the cropping rectangle.
maxY Rightmost Y of the cropping rectangle.
frame_rate Frame rate to use. If this value is 0, the scene frame rate is assumed; otherwise, this value is the new frame rate.
frame_count Number of frames for sequence.
first Frame number for first frame in sequence.
last Frame number for last frame in sequence.

Example

<image id="noIcon_pic_img" format="bitmap" height="256" width="256" depth="32">
   <init_from>$XSI_HOME/Application/rsrc/noIcon.pic</init_from>
   <extra>
      <technique profile="XSI">
            <XSI_Image>
               <xsi_param sid="FileName">"" </xsi_param>
               <xsi_param sid="SizeX">256 </xsi_param>
               <xsi_param sid="SizeY">256 </xsi_param>
               <xsi_param sid="NumChannels">4 </xsi_param>
               <xsi_param sid="BitsPerPixel">0 </xsi_param>
               <xsi_param sid="CropMinX">0.000000 </xsi_param>
               <xsi_param sid="CropMaxX">0.000000 </xsi_param>
               <xsi_param sid="CropMinY">1.000000 </xsi_param>
               <xsi_param sid="CropMaxY">1.000000 </xsi_param>
               <xsi_param sid="FrameRate">0.000000 </xsi_param>
               <xsi_param sid="NumberOfFrames">0 </xsi_param>
               <xsi_param sid="FirstFrame">0 </xsi_param>
               <xsi_param sid="LastFrame">0</xsi_param>
            </XSI_Image>
            <XSI_TimeControl>
               <xsi_param sid="in">0.000000 </xsi_param>
               <xsi_param sid="out">0.000000 </xsi_param>
               <xsi_param sid="startOffset">0.000000 </xsi_param>
               <xsi_param sid="scale">1.000000</xsi_param>
            </XSI_TimeControl>
            <XSI_Extrapolation>
               <xsi_param sid="type">"HOLD" </xsi_param>
               <xsi_param sid="value">0.000000</xsi_param>
            </XSI_Extrapolation>
            <XSI_Extrapolation>
               <xsi_param sid="type">"HOLD" </xsi_param>
               <xsi_param sid="value">0.000000</xsi_param>
            </XSI_Extrapolation>
      </technique>
   </extra>
</image>

<light> extra

<light id="lights_0">
    <technique_common>
        <directional>
            <color>1.000000 1.000000 1.000000</color>
        </directional>
    </technique_common>
    <extra>
        <technique profile="XSI">
                <SI_LightInfo>
                    <xsi_param sid="FalloffActive">FALSE </xsi_param>
                    <xsi_param sid="FalloffMode">1 </xsi_param>
                    <xsi_param sid="Start">1.000000 </xsi_param>
                    <xsi_param sid="End">100.000000 </xsi_param>
                    <xsi_param sid="ShadowsActive">FALSE </xsi_param>
                    <xsi_param sid="Umbra">0.750000 </xsi_param>
                    <xsi_param sid="LightAsEnergy">FALSE </xsi_param>
                    <xsi_param sid="Factor">0.750000 </xsi_param>
                    <xsi_param sid="Intensity">0.750000</xsi_param>
                </SI_LightInfo>
        </technique>
    </extra>
</light>

<camera> extra

<camera id="cameras_0">
    <optics>
        <technique_common>
            <perspective>
                <yfov>42.152946</yfov>
                <znear>0.100000</znear>
                <zfar>32768.000000</zfar>
            </perspective>
        </technique_common>
    </optics>
    <extra>
        <technique profile="XSI">
                <XSI_Camera>
                    <xsi_param sid="std">9 </xsi_param>
                    <xsi_param sid="aspect">1.333333 </xsi_param>
                    <xsi_param sid="fov">0.000000 </xsi_param>
                    <xsi_param sid="fovtype">1 </xsi_param>
                    <xsi_param sid="proj">1 </xsi_param>
                    <xsi_param sid="orthoheight">0.100000 </xsi_param>
                    <xsi_param sid="interestdist">53.318638 </xsi_param>
                    <xsi_param sid="near">0.000000 </xsi_param>
                    <xsi_param sid="far">0.000000 </xsi_param>
                    <xsi_param sid="projplane">FALSE </xsi_param>
                    <xsi_param sid="projplanewidth">0.188976 </xsi_param>
                    <xsi_param sid="projplaneheight">0.141732 </xsi_param>
                    <xsi_param sid="projplaneoffx">0.000000 </xsi_param>
                    <xsi_param sid="projplaneoffy">0.000000</xsi_param>
                </XSI_Camera>
        </technique>
    </extra>
</camera>

<node> extra

<node id="Camera">
  <translate sid="translation">51.437595 191.629105 4.282786</translate>
  <rotate sid="rotation_z">0.000000 0.000000 1.000000 -0.000001</rotate>
  <rotate sid="rotation_y">0.000000 1.000000 0.000000 68.400002</rotate>
  <rotate sid="rotation_x">1.000000 0.000000 0.000000 -7.150594</rotate>
  <scale sid="scale">1.000000 1.000000 1.000000</scale>
  <instance_camera url="#cameras_0"/>
  <extra>
    <technique profile="XSI">
        <SI_Visibility>
          <xsi_param sid="visibility">FALSE</xsi_param>
        </SI_Visibility>
        <XSI_Transform>
          <xsi_param sid="rotorder">"XYZ" </xsi_param>
          <xsi_param sid="siscaling">TRUE</xsi_param>
          <XSI_Limit>
            <xsi_param sid="parameter">"posx" </xsi_param>
            <xsi_param sid="minactive">FALSE </xsi_param>
            <xsi_param sid="minlimit">0.000000 </xsi_param>
            <xsi_param sid="maxactive">FALSE </xsi_param>
            <xsi_param sid="maxlimit">0.000000</xsi_param>
          </XSI_Limit>
          <XSI_Limit>
            <xsi_param sid="parameter">"posy" </xsi_param>
            <xsi_param sid="minactive">FALSE </xsi_param>
            <xsi_param sid="minlimit">0.000000 </xsi_param>
            <xsi_param sid="maxactive">FALSE </xsi_param>
            <xsi_param sid="maxlimit">0.000000</xsi_param>
          </XSI_Limit>
          <XSI_Limit>
            <xsi_param sid="parameter">"posz" </xsi_param>
            <xsi_param sid="minactive">FALSE </xsi_param>
            <xsi_param sid="minlimit">0.000000 </xsi_param>
            <xsi_param sid="maxactive">FALSE </xsi_param>
            <xsi_param sid="maxlimit">0.000000</xsi_param>
          </XSI_Limit>
          <XSI_Limit>
            <xsi_param sid="parameter">"rotx" </xsi_param>
            <xsi_param sid="minactive">FALSE </xsi_param>
            <xsi_param sid="minlimit">0.000000 </xsi_param>
            <xsi_param sid="maxactive">FALSE </xsi_param>
            <xsi_param sid="maxlimit">0.000000</xsi_param>
          </XSI_Limit>
          <XSI_Limit>
            <xsi_param sid="parameter">"roty" </xsi_param>
            <xsi_param sid="minactive">FALSE </xsi_param>
            <xsi_param sid="minlimit">0.000000 </xsi_param>
            <xsi_param sid="maxactive">FALSE </xsi_param>
            <xsi_param sid="maxlimit">0.000000</xsi_param>
          </XSI_Limit>
          <XSI_Limit>
            <xsi_param sid="parameter">"rotz" </xsi_param>
            <xsi_param sid="minactive">FALSE </xsi_param>
            <xsi_param sid="minlimit">0.000000 </xsi_param>
            <xsi_param sid="maxactive">FALSE </xsi_param>
            <xsi_param sid="maxlimit">0.000000</xsi_param>
          </XSI_Limit>
        </XSI_Transform>
    </technique>
  </extra>
</node>

<COLLADA> document extra

<SI_Scene>

Contains global scene information.

Member Description
Timing Specifies whether time values are expressed as frames or seconds.

Possible values are:

  • FRAMES
  • SECONDS
start Start time of the scene (in either frames or seconds, depending on the value of the Timing flag).
end End time of the scene (in either frames or seconds, depending on the value of the Timing flag).
frameRate Frames per second.

Example

<extra>
  <technique profile="XSI">
      <SI_Scene>
        <xsi_param sid="timing">"SECONDS" </xsi_param>
        <xsi_param sid="start">1.000000 </xsi_param>
        <xsi_param sid="end">100.000000 </xsi_param>
        <xsi_param sid="frameRate">29.970030</xsi_param>
      </SI_Scene>
      <SI_Angle>
        <xsi_param sid="type">0</xsi_param>
      </SI_Angle>
      <SI_Ambience>
        <xsi_param sid="red">0.000000 </xsi_param>
        <xsi_param sid="green">0.000000 </xsi_param>
        <xsi_param sid="blue">0.000000</xsi_param>
      </SI_Ambience>
      <SI_CoordinateSystem>
        <xsi_param sid="handRotation">1 </xsi_param>
        <xsi_param sid="uAxis">0 </xsi_param>
        <xsi_param sid="vAxis">1 </xsi_param>
        <xsi_param sid="xAxis">0 </xsi_param>
        <xsi_param sid="yAxis">2 </xsi_param>
        <xsi_param sid="zAxis">5</xsi_param>
      </SI_CoordinateSystem>
  </technique>
</extra>