GPVMF - Set Vertex Morphing Factors

Purpose

Use GPVMF to insert a Set Vertex 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 Vertex Morphing Factors structure element, depending upon the edit mode.

During traversal, the graPHIGS API combines the value of fdata with a primitive's vertex morphing values to modify its rendered vertex coordinates.

In vertex morphing, the graPHIGS API combines the vertex coordinate values (x, y, z) with the vertex morphing scale factors in the fdata parameter (s₁ , s₂ , ..., s_nscale ) and the vertex morphing vectors
(( dx₁ , dy₁ , dz₁ ), ( dx₂ , dy₂ , dz₂ ), ..., ( dx_nvector , dy_nvector , dz_nvector ))
to create the new vertex coordinate values (x', y', z') as follows:
x' = s₁ x + s₂ dx₁ + s₃ dx₂ +...+ s_nscale dx_nvector
y' = s₁ y + s₂ dy₁ + s₃ dy₂ +...+ s_nscale dy_nvector
z' = s₁ z + s₂ dz₁ + s₃ dz₂ +...+ s_nscale dz_nvector

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 morphing scale factors with value zero in this function call.

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

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

Parameters