texture_vplane

Synopsis

The user macro texture_vplane is used to generate a "vertical" plane and apply an image (or texture map) to the plane.

Input Ports

Name Type Description

&in_texture link input texture

Parameters

The following lists all of the parameters found in the parameter block TextureVPlaneParams, which are accessed by the user macro and the UI Macro TextureVPlaneUI.

Name Type Description UI Control

start_x float lower-left Coordinate Lower Left corner of image: X
start_y float lower-left Coordinate Lower Left corner of image: Y
start_z float lower-left Coordinate Lower Left corner of image: Z
end_x float upper-right Coordinate Upper Right corner of image: X
end_y float upper-right Coordinate Upper Right corner of image: Y
end_z float upper-right Coordinate Upper Right corner of image: Z
flip int flip the coordinates Flip Upper Left and Lower right

Output Ports

Name Type Description

out_fld Mesh_Unif+Node_Data output field with texture map data
out_obj DataObject output plane object with texture map

Description

The user macro texture_vplane is used to generate a "vertical" plane and apply an image (or texture map) to the plane.

It works in a similar fashion to the module supplied with Express called texture_mesh. This module add uv (texture map) data to a field according to the x and y coordinates of the field. Thus if you have an object (most commonly a plane) that is vertical, that is it has its normal perpendicular to the z direction, then the module texture_map doesn't work as expected.

Input Ports

&in_texture

The input texture to be mapped onto the plane.

Parameters

start_x

Lower-left X coordinate of the image.

start_y

Lower-left Y coordinate of the image.

start_z

Lower-left Z coordinate of the image.

end_x

Upper-right X coordinate of the image.

end_y

Upper-right Y coordinate of the image.

end_z

Upper-right Z coordinate of the image.

flip

Flip the Upper Left and Lower Right coordinates in the output.

Output Ports

out_fld

Output field with the texture mapped onto a uniform mesh.

out_obj

Output as a renderable data object.

Utility Macros

The functional macro TextureVPlane is used in this User Macro texture_vplane.

Example

An example application, TextureVPlaneEg is provided, which shows the AVS/Express madrill.x image used as a texture map.

Files

iac_proj/txvplane/txvpmacs.v contains the texture_vplane User Macro, the TextureVPlane Functional Macro, the TextureVPlaneUI UI Macro, and the example application TextureVPlaneEg V definitions.

Other Notes

The TextureVPlaneMacs library inherits its process. As this library contains no procedural code, the process is not important. The TextureVPlaneMods library does not contain any procedural code either.

Authors

Erik Thorvaldson
Visualisation Systems Pty Ltd. Australia

Contact

International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL

See Also

TextureVPlaneParams, TextureVPlaneUI and TextureVPlane.