dx-doc 1:4.4.4-7 / usr / share / doc / dx / help / dxall930

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rrubbers RubberSheet #!N #!N 
Category #!N #!N  #!Lcatrel,dxall759 h Realization  #!EL  #!N #!N Function #!N #!N Deforms a 
surface, using the data values of that surface. #!N #!N Syntax 
#!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N graph #!EF = RubberSheet(  #!F-adobe-times-bold-r-normal--18*   
data, scale, min, max #!EF ); #!EF #!N #!N #!EC #!N 
#!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB 
Default TAB Description #!EF #!N TAB data TAB scalar field TAB 
none TAB the field defining the surface to #!N TAB - 
TAB - TAB - TAB be deformed. #!N TAB scale TAB 
scalar TAB input dependent TAB displacement scaling #!N TAB min TAB 
scalar or field TAB 0.0 TAB offset to be applied to 
the #!N TAB - TAB - TAB - TAB surface data 
values #!N TAB max TAB scalar or field TAB maximum data 
value TAB value used for setting the maximum #!N TAB - 
TAB - TAB - TAB displacement #!N TAB - TAB - 
TAB - TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N 
TAB Name TAB Type TAB Description #!EF #!N TAB graph TAB 
scalar field TAB the deformed field #!N TAB - TAB - 
TAB #!EF #!N #!N Functional Details #!N #!N This module takes 
a specified scalar surface or line field and displaces each point 
by an amount based on the data value at that point, 
as follows: #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N displacement =  #!F-adobe-times-bold-r-normal--18*   scale 
#!EF * (  #!F-adobe-times-bold-r-normal--18*   data #!EF -  #!F-adobe-times-bold-r-normal--18*   min #!EF ) 
#!EF #!N #!N #!EC #!N #!N (see parameter descriptions). #!N #!I0 
#!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   data #!EF #!EF #!I50 #!N 
specifies the surface to be deformed. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
scale #!EF #!EF #!I50 #!N is the scale factor used in 
calculating the displacement. #!N #!N If this parameter is not specified, 
the module provides a scale factor calculated as follows: #!CForestGreen #!N 
#!N  #!F-adobe-courier-bold-r-normal--18*   #!N scale = (0.1 * diagonal of  #!F-adobe-times-bold-r-normal--18*   data 
#!EF boundary box) / (  #!F-adobe-times-bold-r-normal--18*   max #!EF -  #!F-adobe-times-bold-r-normal--18*   min 
#!EF ) #!N #!EF #!N #!N #!EC If  #!F-adobe-times-bold-r-normal--18*   min #!EF 
is a field, the value used is the minimum data value 
of that field. #!N #!N The resulting scale factor is attached 
to the output object as a "RubberSheet scale" attribute (which can 
be extracted with the Attribute module). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
min #!EF #!EF #!I50 #!N is the offset applied to the 
data values before they are scaled. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
max #!EF #!EF #!I50 #!N is used to determine a scale 
factor according to the formula shown above, if  #!F-adobe-times-bold-r-normal--18*   scale #!EF 
is not specified. #!I0 #!N #!N #!N #!N #!I0 #!N Notes: 
#!N #!I30 #!N 1. If the input data have no "normals" 
component (e.g., the output of Slab), the perpendicular to the first 
element is used as the displacement direction. In that case, for 
a positive scale factor and a positive data value, the surface 
is displaced in the direction given by the right-hand rule applied 
to the connections at the surface (i.e., with the thumb representing 
the direction of displacement and the fingers following the order of 
points in the connections). #!N #!I30 #!N 2. If the input 
does have a "normals" component, the displacement at the surface is 
determined by the dependencies of the data and of the normals: 
#!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N #!I30 #!N o If both 
the data and the normals are position dependent, the surface is 
displaced in the direction of the normal at each point. #!N 
#!I30 #!N o If both are connection dependent, each face of 
the input is displaced as a whole in the direction indicated 
by the normal for that face. The amount of displacement is 
proportional to the data value for that face. Additional sides are 
added to each displaced face to complete the "box"; box sides 
are not shared between neighboring faces. #!N #!I30 #!N o If 
the data are position dependent and the normals are connection dependent, 
each face is displaced in the direction indicated by the normal 
for that face, but the amount of displacement varies across the 
face in proportion to the data value. Additional sides are added 
to each displaced face to complete the "box"; box sides are 
not shared between neighboring faces. #!N #!I30 #!N o If the 
data are dependent on connections and the normals are dependent on 
positions, the displaced faces will be parallel to the original faces, 
displaced by an amount proportional to the data value for that 
face. Additional sides are added to each displaced face to complete 
the "box"; box sides of neighboring faces are coincident. #!N #!I0 
#!N #!EF #!N #!N #!I30 #!N 3. If the input data 
are 1- or 2-dimensional, an additional dimension is added in the 
resulting graph. #!N #!I30 #!N 4. If no colors are present, 
the module adds a default color. #!N #!I30 #!N 5. RubberSheet 
automatically adds shading to the output  #!F-adobe-times-bold-r-normal--18*   graph #!EF . #!I0 
#!N #!N #!N #!N Components #!N #!N Creates new "positions" and 
"connections" components. All other components, with the exception of "normals," are 
propagated to the output. #!N #!N Example Visual Programs #!CForestGreen #!N 
#!N  #!F-adobe-courier-bold-r-normal--18*   #!N AlternateVisualizations.net #!N RubberTube.net #!N ThunderGlyphSheet.net #!N UsingSwitchAndRoute.net #!N 
SIMPLE/Rubbersheet.net #!EF #!N #!N #!EC #!N #!N See Also #!N #!N 
 #!Lfacenor,dxall847 h FaceNormals  #!EL  ,  #!Lmaptopl,dxall892 h MapToPlane  #!EL  ,  #!Lnormals,dxall897 h Normals  #!EL  ,  #!Lslab,dxall949 h Slab  #!EL  #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   
Next Topic #!EF #!N #!N  #!Lsample,dxall931 h Sample  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N