"Fossies" - the Fresh Open Source Software Archive

Member "dx-4.4.4/help/dxall930" (5 Feb 2002, 6384 Bytes) of package /linux/misc/old/dx-4.4.4.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 #!F-adobe-helvetica-medium-r-normal--18*
    2 #!N 
    3 #!N  #!Rrubbers RubberSheet #!N #!N 
    4 Category #!N #!N  #!Lcatrel,dxall759 h Realization  #!EL  #!N #!N Function #!N #!N Deforms a 
    5 surface, using the data values of that surface. #!N #!N Syntax 
    6 #!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*   
    7 data, scale, min, max #!EF ); #!EF #!N #!N #!EC #!N 
    8 #!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 
    9 Default TAB Description #!EF #!N TAB data TAB scalar field TAB 
   10 none TAB the field defining the surface to #!N TAB - 
   11 TAB - TAB - TAB be deformed. #!N TAB scale TAB 
   12 scalar TAB input dependent TAB displacement scaling #!N TAB min TAB 
   13 scalar or field TAB 0.0 TAB offset to be applied to 
   14 the #!N TAB - TAB - TAB - TAB surface data 
   15 values #!N TAB max TAB scalar or field TAB maximum data 
   16 value TAB value used for setting the maximum #!N TAB - 
   17 TAB - TAB - TAB displacement #!N TAB - TAB - 
   18 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 
   19 TAB Name TAB Type TAB Description #!EF #!N TAB graph TAB 
   20 scalar field TAB the deformed field #!N TAB - TAB - 
   21 TAB #!EF #!N #!N Functional Details #!N #!N This module takes 
   22 a specified scalar surface or line field and displaces each point 
   23 by an amount based on the data value at that point, 
   24 as follows: #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N displacement =  #!F-adobe-times-bold-r-normal--18*   scale 
   25 #!EF * (  #!F-adobe-times-bold-r-normal--18*   data #!EF -  #!F-adobe-times-bold-r-normal--18*   min #!EF ) 
   26 #!EF #!N #!N #!EC #!N #!N (see parameter descriptions). #!N #!I0 
   27 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   data #!EF #!EF #!I50 #!N 
   28 specifies the surface to be deformed. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
   29 scale #!EF #!EF #!I50 #!N is the scale factor used in 
   30 calculating the displacement. #!N #!N If this parameter is not specified, 
   31 the module provides a scale factor calculated as follows: #!CForestGreen #!N 
   32 #!N  #!F-adobe-courier-bold-r-normal--18*   #!N scale = (0.1 * diagonal of  #!F-adobe-times-bold-r-normal--18*   data 
   33 #!EF boundary box) / (  #!F-adobe-times-bold-r-normal--18*   max #!EF -  #!F-adobe-times-bold-r-normal--18*   min 
   34 #!EF ) #!N #!EF #!N #!N #!EC If  #!F-adobe-times-bold-r-normal--18*   min #!EF 
   35 is a field, the value used is the minimum data value 
   36 of that field. #!N #!N The resulting scale factor is attached 
   37 to the output object as a "RubberSheet scale" attribute (which can 
   38 be extracted with the Attribute module). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
   39 min #!EF #!EF #!I50 #!N is the offset applied to the 
   40 data values before they are scaled. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
   41 max #!EF #!EF #!I50 #!N is used to determine a scale 
   42 factor according to the formula shown above, if  #!F-adobe-times-bold-r-normal--18*   scale #!EF 
   43 is not specified. #!I0 #!N #!N #!N #!N #!I0 #!N Notes: 
   44 #!N #!I30 #!N 1. If the input data have no "normals" 
   45 component (e.g., the output of Slab), the perpendicular to the first 
   46 element is used as the displacement direction. In that case, for 
   47 a positive scale factor and a positive data value, the surface 
   48 is displaced in the direction given by the right-hand rule applied 
   49 to the connections at the surface (i.e., with the thumb representing 
   50 the direction of displacement and the fingers following the order of 
   51 points in the connections). #!N #!I30 #!N 2. If the input 
   52 does have a "normals" component, the displacement at the surface is 
   53 determined by the dependencies of the data and of the normals: 
   54 #!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N #!I30 #!N o If both 
   55 the data and the normals are position dependent, the surface is 
   56 displaced in the direction of the normal at each point. #!N 
   57 #!I30 #!N o If both are connection dependent, each face of 
   58 the input is displaced as a whole in the direction indicated 
   59 by the normal for that face. The amount of displacement is 
   60 proportional to the data value for that face. Additional sides are 
   61 added to each displaced face to complete the "box"; box sides 
   62 are not shared between neighboring faces. #!N #!I30 #!N o If 
   63 the data are position dependent and the normals are connection dependent, 
   64 each face is displaced in the direction indicated by the normal 
   65 for that face, but the amount of displacement varies across the 
   66 face in proportion to the data value. Additional sides are added 
   67 to each displaced face to complete the "box"; box sides are 
   68 not shared between neighboring faces. #!N #!I30 #!N o If the 
   69 data are dependent on connections and the normals are dependent on 
   70 positions, the displaced faces will be parallel to the original faces, 
   71 displaced by an amount proportional to the data value for that 
   72 face. Additional sides are added to each displaced face to complete 
   73 the "box"; box sides of neighboring faces are coincident. #!N #!I0 
   74 #!N #!EF #!N #!N #!I30 #!N 3. If the input data 
   75 are 1- or 2-dimensional, an additional dimension is added in the 
   76 resulting graph. #!N #!I30 #!N 4. If no colors are present, 
   77 the module adds a default color. #!N #!I30 #!N 5. RubberSheet 
   78 automatically adds shading to the output  #!F-adobe-times-bold-r-normal--18*   graph #!EF . #!I0 
   79 #!N #!N #!N #!N Components #!N #!N Creates new "positions" and 
   80 "connections" components. All other components, with the exception of "normals," are 
   81 propagated to the output. #!N #!N Example Visual Programs #!CForestGreen #!N 
   82 #!N  #!F-adobe-courier-bold-r-normal--18*   #!N AlternateVisualizations.net #!N RubberTube.net #!N ThunderGlyphSheet.net #!N UsingSwitchAndRoute.net #!N 
   83 SIMPLE/Rubbersheet.net #!EF #!N #!N #!EC #!N #!N See Also #!N #!N 
   84  #!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*   
   85 Next Topic #!EF #!N #!N  #!Lsample,dxall931 h Sample  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N