GPDMF - Set Data Morphing Factors

Purpose

Use GPDMF to insert a Set Data Morphing Factors structure element into the open structure following the element pointer, or to replace the element pointed at by the element pointer with a Set Data Morphing Factors structure element, depending on the current edit mode.

During traversal, the graPHIGS API combines the values of fdata with a primitive's data morphing vectors to modify its rendered data mapping data.

In data morphing, the graPHIGS API combines the data mapping data values
(x₁ , x₂ , ..., x_ndata ) with the data morphing scale factors in the fdata parameter
(s₁ , s₂ , ..., s_nscale ) and the data morphing vectors
((d_{1 ,1} , d_{1 ,2} , ..., d_{1, ndata} ),  (d_{2, 1} , d_{2 ,2} , ..., d_{2 ,ndata} ), ...,  (d_{n vector,1} , d_nvector,2 , ..., d_{nvector,ndata} ))
to obtain the new data mapping data values (x'₁ , x'₂ , ..., x'_ndata ) as follows:
x'₁ = s₁ x₁ + s₂ d₁ ,1 + s₃ d_{2, 1} +...+ s_nscale d_nvector,1
x'₂ = s₁ x₂ + s₂ d₁ ,2 + s₃ d₂ ,2 +...+ s_nscale d_nvector,2
...
x'_ndata = s₁ x_ndata + s₂ d_{1, ndata} + s₃ d_2,ndata +...+ s_nscale d _{nvector,ndata}

These equations show that the number of morphing scale factors should be one more than the number of morphing vectors in the affected primitive (nscale=nvector+1). However, if the number of morphing vectors and scale factors disagree at traversal time, then 0 value vectors and scale factors are assumed wherever necessary. For example, if you supply too many scale factors for a given primitive (nscale>nvector+1), then the graPHIGS API ignores the extra scale factors, as if there were additional 0 valued morphing vectors in the primitive definition. If you supply too few scale factors (nscale<nvector+1), then the graPHIGS API ignores the extra morphing vectors, just as if there were additional scale factors with value zero in this function call.

The traversal default for data morphing is flength=1 and fdata={1.0}

Use GPQWDT to inquire the morphing facilities of a specified workstation.

Parameters