XSI_Shader

Defines a Autodesk Softimage shader.

These are embedded inside the XSI_Material template. The connection name provides the path to connect the parameter of a particular shader to another shader or image.

 

If the shader parameters are animated, their fcurves are exported to the dotXSI file.

This template corresponds to the CSLXSIShader class.

Limitations

SI|3D does not export or read this template.

Introduced

3.5

Template

XSI_Shader <shader name>
{
   <path>,
   <output>,
   <param_number>,
   <cnx_number>,
   <param_name>,<param_type>,<param_value>, 
   // for each parameter
   <cnx_name>,<cnx_point>,<cnx_type>
   // for each connection 

   XSI_TextureLayer
   // for each texture layer

   XSI_ShaderMultiPortConnection
   // for each connection with a multi-output shader
}

Members

Member name

Description

name

Shader name

path

Softimage path name

output

Output type. Possible values are:

• 0 = Unknown

• 1 = Boolean

• 2 = Integer

• 3 = Scalar

• 4 = Color

• 5 = Vector

• 6 = Texture space

• 7 = Texture

• 8 = String

• 9 = Filename

• 10 = Lens

• 11 = Light

• 12 = Material

• 13 = Model

• 14 = Multi

param_number

All parameters that are part of this operator

cnx_number

Number of connection points

param_name

Parameter name

param_type

Parameter type. Possible values are:

• “BOOLEAN”

• “BYTE”

• “INTEGER”

• “FLOAT”

• “STRING”

param_value

Parameter value

cnx_name

Name of connection source

Note: If nothing is connected, this value is an empty string (““).

cnx_point

ID of connection point (index number)

cnx_type

Type of connection source. Possible values are:

• “SHADER” = shader is connected

• “IMAGE” = image is connected

• ““ = nothing is connected

Example with Connections to Ambient and Diffuse

In the example below, a shader called Phong connects to two other shaders called ambient_blend and diffuse_blend:

XSI_Shader Phong 
{ 
   "Softimage.material-phong.1", 
   4, 
   43, 
   21, 
   "Name","STRING","Phong",
   "specular.red","FLOAT",1.000000,
   "specular.green","FLOAT",1.000000,
   "specular.blue","FLOAT",1.000000,
   "specular.alpha","FLOAT",0.000000,
   "ambience.red","FLOAT",0.200000,
   "ambience.green","FLOAT",0.200000,
   "ambience.blue","FLOAT",0.200000,
   "ambience.alpha","FLOAT",1.000000,
   "shiny","FLOAT",50.000000,
   "transparency.red","FLOAT",0.000000,
   "transparency.green","FLOAT",0.000000,
   "transparency.blue","FLOAT",0.000000,
   "transparency.alpha","FLOAT",0.000000,
   "trans_glossy","FLOAT",0.000000,
   "transparent_samples","INTEGER",0,
   "reflectivity.red","FLOAT",0.000000,
   "reflectivity.green","FLOAT",0.000000,
   "reflectivity.blue","FLOAT",0.000000,
   "reflectivity.alpha","FLOAT",0.000000,
   "reflect_glossy","FLOAT",0.000000,
   "reflect_samples","INTEGER",0,
   "index_of_refraction","FLOAT",1.000000,
   "translucency","FLOAT",0.000000,
   "incandescence.red","FLOAT",1.000000,
   "incandescence.green","FLOAT",1.000000,
   "incandescence.blue","FLOAT",1.000000,
   "incandescence.alpha","FLOAT",0.000000,
   "inc_inten","FLOAT",0.000000,
   "bump.x","FLOAT",0.000000,
   "bump.y","FLOAT",0.000000,
   "bump.z","FLOAT",0.000000,
   "notrace","BOOLEAN",0,
   "diffuse_inuse","BOOLEAN",1,
   "specular_inuse","BOOLEAN",1,
   "reflect_inuse","BOOLEAN",1,
   "refract_inuse","BOOLEAN",1,
   "incand_inuse","BOOLEAN",1,
   "translucent_inuse","BOOLEAN",1,
   "radiance.red","FLOAT",1.000000,
   "radiance.green","FLOAT",1.000000,
   "radiance.blue","FLOAT",1.000000,
   "radiance.alpha","FLOAT",1.000000,
   "ambient","ambient_blend","SHADER",
   "diffuse","diffuse_blend","SHADER",
   "specular","","",
   "shiny","","",
   "transparency","","",
   "trans_glossy","","",
   "reflectivity","","",
   "reflect_glossy","","",
   "index_of_refraction","","",
   "translucency","","",
   "incandescence","","",
   "inc_inten","","",
   "bump","","",
   "notrace","","",
   "diffuse_inuse","","",
   "specular_inuse","","",
   "reflect_inuse","","",
   "refract_inuse","","",
   "incand_inuse","","",
   "translucent_inuse","","",
   "radiance","","",
}

Example with Render Tree

This example represents the result of exporting the following render tree:

 

 

XSI_Material sphere { 
   10, 
   "surface","Phong",
   "volume","",
   "environment","",
   "contour","",
   "displacement","",
   "shadow","Phong",
   "Photon","Phong",
   "PhotonVolume","",
   "normal","",
   "RealTime","",

   XSI_Shader Phong { 
       "Softimage.material-phong.1", 
       4, 
       43, 
       21, 
       "Name","STRING","Phong",
       "specular.red","FLOAT",1.000000,
       "specular.green","FLOAT",1.000000,
       "specular.blue","FLOAT",1.000000,
       "specular.alpha","FLOAT",0.000000,
       "ambience.red","FLOAT",0.200000,
       "ambience.green","FLOAT",0.200000,
       "ambience.blue","FLOAT",0.200000,
       "ambience.alpha","FLOAT",1.000000,
       "shiny","FLOAT",50.000000,
       "transparency.red","FLOAT",0.000000,
       "transparency.green","FLOAT",0.000000,
       "transparency.blue","FLOAT",0.000000,
       "transparency.alpha","FLOAT",0.000000,
       "trans_glossy","FLOAT",0.000000,
       "transparent_samples","INTEGER",0,
       "reflectivity.red","FLOAT",0.000000,
       "reflectivity.green","FLOAT",0.000000,
       "reflectivity.blue","FLOAT",0.000000,
       "reflectivity.alpha","FLOAT",0.000000,
       "reflect_glossy","FLOAT",0.000000,
       "reflect_samples","INTEGER",0,
       "index_of_refraction","FLOAT",1.000000,
       "translucency","FLOAT",0.000000,
       "incandescence.red","FLOAT",1.000000,
       "incandescence.green","FLOAT",1.000000,
       "incandescence.blue","FLOAT",1.000000,
       "incandescence.alpha","FLOAT",0.000000,
       "inc_inten","FLOAT",0.000000,
       "bump.x","FLOAT",0.000000,
       "bump.y","FLOAT",0.000000,
       "bump.z","FLOAT",0.000000,
       "notrace","BOOLEAN",0,
       "diffuse_inuse","BOOLEAN",1,
       "specular_inuse","BOOLEAN",1,
       "reflect_inuse","BOOLEAN",1,
       "refract_inuse","BOOLEAN",1,
       "incand_inuse","BOOLEAN",1,
       "translucent_inuse","BOOLEAN",1,
       "radiance.red","FLOAT",1.000000,
       "radiance.green","FLOAT",1.000000,
       "radiance.blue","FLOAT",1.000000,
       "radiance.alpha","FLOAT",1.000000,
       "ambient","ambient_blend","SHADER",
       "diffuse","diffuse_blend","SHADER",
       "specular","","",
       "shiny","","",
       "transparency","","",
       "trans_glossy","","",
       "reflectivity","","",
       "reflect_glossy","","",
       "index_of_refraction","","",
       "translucency","","",
       "incandescence","","",
       "inc_inten","","",
       "bump","","",
       "notrace","","",
       "diffuse_inuse","","",
       "specular_inuse","","",
       "reflect_inuse","","",
       "refract_inuse","","",
       "incand_inuse","","",
       "translucent_inuse","","",
       "radiance","","",
   }

   XSI_Shader diffuse_blend { 
       "Softimage.sib_color_8mix.1", 
       4, 
       79, 
       29, 
       "Name","STRING","diffuse_blend",
       "mixersize","INTEGER",8,
       "base_color.red","FLOAT",0.700000,
       "base_color.green","FLOAT",0.700000,
       "base_color.blue","FLOAT",0.700000,
       "base_color.alpha","FLOAT",0.000000,
       "mode1","INTEGER",1,
       "weight1.red","FLOAT",1.000000,
       "weight1.green","FLOAT",1.000000,
       "weight1.blue","FLOAT",1.000000,
       "weight1.alpha","FLOAT",0.500000,
       "alpha1","BOOLEAN",1,
       "inuse1","BOOLEAN",1,
       "color2.red","FLOAT",1.000000,
       "color2.green","FLOAT",1.000000,
       "color2.blue","FLOAT",1.000000,
       "color2.alpha","FLOAT",0.000000,
       "mode2","INTEGER",1,
       "weight2.red","FLOAT",0.500000,
       "weight2.green","FLOAT",0.500000,
       "weight2.blue","FLOAT",0.500000,
       "weight2.alpha","FLOAT",0.000000,
       "alpha2","BOOLEAN",0,
       "inuse2","BOOLEAN",0,
       "color3.red","FLOAT",1.000000,
       "color3.green","FLOAT",1.000000,
       "color3.blue","FLOAT",1.000000,
       "color3.alpha","FLOAT",0.000000,
       "mode3","INTEGER",1,
       "weight3.red","FLOAT",0.500000,
       "weight3.green","FLOAT",0.500000,
       "weight3.blue","FLOAT",0.500000,
       "weight3.alpha","FLOAT",0.000000,
       "alpha3","BOOLEAN",0,
       "inuse3","BOOLEAN",0,
       "color4.red","FLOAT",1.000000,
       "color4.green","FLOAT",1.000000,
       "color4.blue","FLOAT",1.000000,
       "color4.alpha","FLOAT",0.000000,
       "mode4","INTEGER",1,
       "weight4.red","FLOAT",0.500000,
       "weight4.green","FLOAT",0.500000,
       "weight4.blue","FLOAT",0.500000,
       "weight4.alpha","FLOAT",0.000000,
       "alpha4","BOOLEAN",0,
       "inuse4","BOOLEAN",0,
       "color5.red","FLOAT",1.000000,
       "color5.green","FLOAT",1.000000,
       "color5.blue","FLOAT",1.000000,
       "color5.alpha","FLOAT",0.000000,
       "mode5","INTEGER",1,
       "weight5.red","FLOAT",0.500000,
       "weight5.green","FLOAT",0.500000,
       "weight5.blue","FLOAT",0.500000,
       "weight5.alpha","FLOAT",0.000000,
       "alpha5","BOOLEAN",0,
       "inuse5","BOOLEAN",0,
       "color6.red","FLOAT",1.000000,
       "color6.green","FLOAT",1.000000,
       "color6.blue","FLOAT",1.000000,
       "color6.alpha","FLOAT",0.000000,
       "mode6","INTEGER",1,
       "weight6.red","FLOAT",0.500000,
       "weight6.green","FLOAT",0.500000,
       "weight6.blue","FLOAT",0.500000,
       "weight6.alpha","FLOAT",0.000000,
       "alpha6","BOOLEAN",0,
       "inuse6","BOOLEAN",0,
       "color7.red","FLOAT",1.000000,
       "color7.green","FLOAT",1.000000,
       "color7.blue","FLOAT",1.000000,
       "color7.alpha","FLOAT",0.000000,
       "mode7","INTEGER",1,
       "weight7.red","FLOAT",0.500000,
       "weight7.green","FLOAT",0.500000,
       "weight7.blue","FLOAT",0.500000,
       "weight7.alpha","FLOAT",0.000000,
       "alpha7","BOOLEAN",0,
       "inuse7","BOOLEAN",0,
       "base_color","","",
       "color1","Image","SHADER",
       "weight1","","",
       "alpha1","","",
       "inuse1","","",
       "color2","","",
       "weight2","","",
       "alpha2","","",
       "inuse2","","",
       "color3","","",
       "weight3","","",
       "alpha3","","",
       "inuse3","","",
       "color4","","",
       "weight4","","",
       "alpha4","","",
       "inuse4","","",
       "color5","","",
       "weight5","","",
       "alpha5","","",
       "inuse5","","",
       "color6","","",
       "weight6","","",
       "alpha6","","",
       "inuse6","","",
       "color7","","",
       "weight7","","",
       "alpha7","","",
       "inuse7","","",
   }

   XSI_Shader Image { 
       "Softimage.txt2d-image-explicit.1", 
       4, 
       29, 
       20, 
       "Name","STRING","Image",
       "tspace_id","STRING","Texture_Projection",
       "repeats.x","FLOAT",1.000000,
       "repeats.y","FLOAT",1.000000,
       "repeats.z","FLOAT",1.000000,
       "alt_x","BOOLEAN",0,
       "alt_y","BOOLEAN",0,
       "alt_z","BOOLEAN",0,
       "min.x","FLOAT",0.000000,
       "min.y","FLOAT",0.000000,
       "min.z","FLOAT",0.000000,
       "max.x","FLOAT",1.000000,
       "max.y","FLOAT",1.000000,
       "max.z","FLOAT",1.000000,
       "step.x","FLOAT",0.000000,
       "step.y","FLOAT",0.000000,
       "step.z","FLOAT",0.000000,
       "factor","FLOAT",5.000000,
       "torus_u","BOOLEAN",0,
       "torus_v","BOOLEAN",0,
       "alpha","BOOLEAN",0,
       "bump_inuse","BOOLEAN",0,
       "alpha_output","BOOLEAN",0,
       "alpha_factor","FLOAT",1.000000,
       "eccmax","FLOAT",20.000000,
       "maxminor","FLOAT",16.000000,
       "disc_r","FLOAT",0.300000,
       "bilinear","BOOLEAN",1,
       "filtered","BOOLEAN",0,
       "tex","noIcon.pic","IMAGE",
       "repeats","","",
       "alt_x","","",
       "alt_y","","",
       "alt_z","","",
       "min","","",
       "max","","",
       "step","","",
       "factor","","",
       "torus_u","","",
       "torus_v","","",
       "alpha","","",
       "bump_inuse","","",
       "alpha_output","","",
       "alpha_factor","","",
       "eccmax","","",
       "maxminor","","",
       "disc_r","","",
       "bilinear","","",
       "filtered","","",
   }


Autodesk Softimage v7.5