flag

Synopsis

AVS/Express Flag simulation from the XP_DEMO suite, in 3D Wind Field, with Analysis or Textures applied.

Input Ports

Name Type Description

texture Image optional texture for flag

Parameters

The following lists all of the parameters found in the parameter blocks FlagParams and FlagLoopParams, which are accessed by the module FlagRaw and the UI Macro FlagUI.

Name Type Description UI Control

run boolean Toggle simulation on/off/ Run/Pause
step boolean Oneshot to trigger next simulation frame. Step
flag_wind_1 float First part of wind vector. Wind Vector 1
flag_wind_2 float Second part of wind vector. Wind Vector 2
flag_strength float Flag material strength. Material Strength
reset boolean Toggle the simulation reset. Flag Reset
release_top boolean Trigger release of top-left of flag. Release Top
release_bottom boolean Trigger release of bottom-left of flag. Release Bottom
flag_color integer Flag colouring mode choice: Solid Colour
Velocity Tricolor
Force Tricolor
Force Magnitude
Texture Map

Output Ports

Name Type Description

field Mesh_Struct+ Dim2+ Space3+ Node_Data output field of flag
obj DataObject output object of flag

Description

The Flag demo application is a running physical simulation. Over the 2D mesh of the flag, gravity, friction, wind force, and elasticity constraints are simulated. Optional controls allow two corner points to be constrained (tied) to a flag pole. Using the File-Open, you can select alternate flag images to use to color the flag. To view simulation parameters, Velocity Tricolor, Force Tricolor, and Force Magnitude modes can be selected. The raw mesh field data is available in the network, such that other visualization tools could be added, such as force magnitude contours, normal vector glyphs, etc. The simulation will run forever, and can be started using the Run/Pause control button. The flag strength control controls material strength parameter during the simulation.

Input Ports

texture

Optional input image to be used as texture map for the flag.

Parameters

run

Toggle execution of the flag simulation.

step

Single step through the simulation.

flag_wind_1

First part of wind velocity vector.

flag_wind_2

Second part of wind velocity vector.

flag_strength

Flag material strength.

reset

Reset the flag to it's original starting place.

release_top

Trigger to allow top-left corner to be released from its tie.

release_bottom

Trigger to allow bottom-left corner to be released from its tie.

flag_color

Select the colour mode for flag.

Output Ports

field

Output mesh and node data of the flag.

obj

Renderable object of the output mesh and node data of the flag.

Utility Macros

The low-level FlagRaw module and the modified FlagLoop module are used in this User Macro flag.

Example

An example application FlagEg is provided, which demonstrates the flag simulation with two image textures available.

Files

iac_proj/flag/flagmacs.v contains the flag User Macro, the Flag Functional Macro, the FlagUI UI Macro, and the example application FlagEg V definitions.

Other Notes

The FlagMacs library inherits its process. As this library contains no procedural code, the process is not important. The low-level FlagRaw module, executes under the process specified in its library, not the process defined in the high-level library.

The simulation will sometimes pause - pressing reset will restart the simulation successfully.

Author

Ian Curington - AVS

Modifications

Paul G. Lever
Andrew Dodd

Contact

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

See Also

FlagParams, FlagUI, Flag and FlagRaw.