Visualization Functions

The following group of functions allow for the OpenVSP GUI to be manipulated through the API. Click here to return to the main page. More...

Functions
void	vsp::StartGUI ()
void	vsp::EnableStopGUIMenuItem ()
void	vsp::DisableStopGUIMenuItem ()
void	vsp::StopGUI ()
void	vsp::PopupMsg (const std::string &msg)
void	vsp::UpdateGUI ()
bool	vsp::IsGUIBuild ()
void	vsp::Lock ()
void	vsp::Unlock ()
bool	vsp::IsEventLoopRunning ()
void	vsp::ScreenGrab (const string &fname, int w, int h, bool transparentBG, bool autocrop=false)
void	vsp::SetViewAxis (bool vaxis)
void	vsp::SetShowBorders (bool brdr)
void	vsp::SetGeomDrawType (const string &geom_id, int type)
void	vsp::SetGeomWireColor (const string &geom_id, int r, int g, int b)
void	vsp::SetGeomDisplayType (const string &geom_id, int type)
void	vsp::SetGeomMaterialName (const string &geom_id, const string &name)
void	vsp::AddMaterial (const string &name, const vec3d &ambient, const vec3d &diffuse, const vec3d &specular, const vec3d &emissive, const double &alpha, const double &shininess)
vector< string >	vsp::GetMaterialNames ()
void	vsp::SetBackground (double r, double g, double b)
void	vsp::SetAllViews (int view)
void	vsp::SetView (int viewport, int view)
void	vsp::FitAllViews ()
void	vsp::ResetViews ()
void	vsp::SetWindowLayout (int r, int c)
void	vsp::SetGUIElementDisable (int e, bool state)
void	vsp::SetGUIScreenDisable (int s, bool state)
void	vsp::SetGeomScreenDisable (int s, bool state)

Detailed Description

Function Documentation

AddMaterial()

void vsp::AddMaterial ( const string & name, const vec3d & ambient, const vec3d & diffuse, const vec3d & specular, const vec3d & emissive, const double & alpha, const double & shininess )

extern

Set the visualization material the specified geometry

string pid = AddGeom( "POD" );
 
AddMaterial( "RedGlass", vec3d( 44, 2, 2 ), vec3d( 156, 10, 10 ), vec3d( 185, 159, 159 ), vec3d( 44, 2, 2 ), 30, 0.4 );
 
SetGeomMaterialName( pid, "RedGlass" );

Parameters

[in]	name	string Material name
[in]	ambient	vec3d Ambient color RGB triple on scale [0, 255]
[in]	diffuse	vec3d Diffuse color RGB triple on scale [0, 255]
[in]	specular	vec3d Specular color RGB triple on scale [0, 255]
[in]	emmissive	vec3d Emissive color RGB triple on scale [0, 255]
[in]	shininess	double Shininess exponent on scale [0, 127]
[in]	alpha	double Transparency factor on scale [0, 1]

DisableStopGUIMenuItem()

void vsp::DisableStopGUIMenuItem ( )

extern

Disable Stop GUI Menu Item from the OpenVSP GUI.

This reverses the operation of EnableStopGUIMenuItem.

EnableStopGUIMenuItem();
StartGUI();

See also

EnableStopGUIMenuItem

EnableStopGUIMenuItem()

void vsp::EnableStopGUIMenuItem ( )

extern

Enable Stop GUI Menu Item from the OpenVSP GUI.

Typically used for the blocking-mode OpenVSP GUI from the API.

This will add a "Stop GUI" option to the file pulldown menu and will also cause the exit button on the window frame to have the same effect. When selected, these options will stop the OpenVSP GUI event loop, returning control to the API program. OpenVSP will not terminate, the model will remain in memory and will be responsive to subsequent API calls.

EnableStopGUIMenuItem();
StartGUI();

See also

DisableStopGUIMenuItem

FitAllViews()

void vsp::FitAllViews ( )

extern

Fit contents to all viewports

FitAllViews();

GetMaterialNames()

vector< string > vsp::GetMaterialNames ( )

extern

Get the names of all visualization materials

array< string > @mat_array = GetMaterialNames();
 
for ( int i = 0; i < int( mat_array.size() ); i++ )
{
    Print( mat_array[i] );
}

Returns

vector<string> Array of material names

IsEventLoopRunning()

bool vsp::IsEventLoopRunning ( )

extern

Test if the OpenVSP GUI event loop is running.

StartGUI();
 
if ( IsEventLoopRunning() )
{
    Print( "Event loop is running." );
}

Returns

bool True if the OpenVSP GUI event loop is running. False otherwise.

IsGUIBuild()

bool vsp::IsGUIBuild ( )

extern

Test if the current OpenVSP build includes graphics capabilities.

if ( IsGUIBuild() )
{
    Print( "OpenVSP build is graphics capable." );
}
else
{
    Print( "OpenVSP build is not graphics capable." );
}

Returns

bool True if the current OpenVSP build includes graphics capabilities. False otherwise.

Lock()

void vsp::Lock ( )

extern

Obtain the lock on the OpenVSP GUI event loop. This will prevent the interactive GUI from updating or accepting user input until the lock is released – thereby allowing longer-time commands including analyses to execute without the chance of the OpenVSP state changing during execution.

StartGUI();
 
string pod_id = AddGeom( "POD" );
 
Lock();
string rid = ExecAnalysis( "CompGeom" );
 
array<string>@ mesh_id_vec = GetStringResults( rid, "Mesh_GeomID" );
 
DeleteGeomVec( mesh_id_vec );
Unlock();

See also

Unlock

PopupMsg()

void vsp::PopupMsg ( const std::string & msg )

extern

Cause OpenVSP to display a popup message.

StartGUI();
 
PopupMsg( "This is a popup message." );

Parameters

[in]

msg

string Message to display.

ResetViews()

void vsp::ResetViews ( )

extern

Reset views of all viewports

ResetViews();

ScreenGrab()

void vsp::ScreenGrab ( const string & fname, int w, int h, bool transparentBG, bool autocrop = false )

extern

Capture the specified screen and save to file. Note, VSP_USE_FLTK must be defined

int screenw = 2000;                                             // Set screenshot width and height
int screenh = 2000;
 
string fname = "test_screen_grab.png";
 
ScreenGrab( fname, screenw, screenh, true, true );                // Take PNG screenshot

Parameters

[in]	fname	string Output file name
[in]	w	int Width of screen grab
[in]	h	int Height of screen grab
[in]	transparentBG	bool Transparent background flag
[in]	autocrop	bool Automatically crop transparent background flag

SetAllViews()

void vsp::SetAllViews ( int view )

extern

Set the view of all viewports

SetAllViews( CAM_CENTER );

Parameters

[in]

view

int CAMERA_VIEW enum

SetBackground()

void vsp::SetBackground ( double r, double g, double b )

extern

Set the background color

SetBackground( 1.0, 1.0, 1.0 );                                 // Set background to bright white

Parameters

[in]	r	Red 8-bit unsigned integer (range: 0-255)
[in]	g	Green 8-bit unsigned integer (range: 0-255)
[in]	b	Blue 8-bit unsigned integer (range: 0-255)

SetGeomDisplayType()

void vsp::SetGeomDisplayType ( const string & geom_id, int type )

extern

Set the display type of the specified geometry

string pid = AddGeom( "POD" );                             // Add Pod for testing
 
SetGeomDisplayType( pid, DISPLAY_DEGEN_PLATE );                       // Make pod appear as Bezier plate (Degen Geom)

See also

DISPLAY_TYPE

Parameters

[in]	geom_id	string Geom ID
[in]	type	Display type enum (i.e. DISPLAY_BEZIER)

SetGeomDrawType()

void vsp::SetGeomDrawType ( const string & geom_id, int type )

extern

Set the draw type of the specified geometry

string pid = AddGeom( "POD", "" );                             // Add Pod for testing
 
SetGeomDrawType( pid, GEOM_DRAW_SHADE );                       // Make pod appear as shaded

See also

DRAW_TYPE

Parameters

[in]	geom_id	string Geom ID
[in]	type	Draw type enum (i.e. GEOM_DRAW_SHADE)

SetGeomMaterialName()

void vsp::SetGeomMaterialName ( const string & geom_id, const string & name )

extern

Set the visualization material the specified geometry

string pid = AddGeom( "POD" );
 
SetGeomMaterialName( pid, "Ruby" );

Parameters

[in]	geom_id	string Geom ID
[in]	name	string Material name

SetGeomScreenDisable()

void vsp::SetGeomScreenDisable ( int s, bool state )

extern

Set whether geom screen is disabled

SetGeomScreenDisable( ALL_GEOM_SCREENS, true );

Parameters

[in]	e	int GUI_GEOM_SCREEN enum for geom screen
[in]	state	bool True to disable geom screen

SetGeomWireColor()

void vsp::SetGeomWireColor ( const string & geom_id, int r, int g, int b )

extern

Set the wireframe color of the specified geometry

string pid = AddGeom( "POD", "" );
 
SetGeomWireColor( pid, 0, 0, 255 );

Parameters

[in]	geom_id	string Geom ID
[in]	r	int Red component of color [0, 255]
[in]	g	int Green component of color [0, 255]
[in]	b	int Blue component of color [0, 255]

SetGUIElementDisable()

void vsp::SetGUIElementDisable ( int e, bool state )

extern

Set whether all instances of GUI device type are disabled

SetGUIElementDisable( GDEV_INPUT, true );

Parameters

[in]	e	int GDEV enum for GUI device type
[in]	state	bool True to disable GUI device type

SetGUIScreenDisable()

void vsp::SetGUIScreenDisable ( int s, bool state )

extern

Set whether screen is disabled

SetGUIScreenDisable( VSP_CFD_MESH_SCREEN, true );

Parameters

[in]	e	int GUI_VSP_SCREEN enum for screen
[in]	state	bool True to disable screen

SetShowBorders()

void vsp::SetShowBorders ( bool brdr )

extern

Toggle viewing the border frame

SetShowBorders( false );                                        // Turn off red/black border on active window

Parameters

[in]

brdr

True to show the border frame, false to hide the border frame

SetView()

void vsp::SetView ( int viewport, int view )

extern

Set the view of a particular viewports

SetView( 0, CAM_CENTER );

Parameters

[in]

view

int CAMERA_VIEW enum

SetViewAxis()

void vsp::SetViewAxis ( bool vaxis )

extern

Toggle viewing the axis

SetViewAxis( false );                                           // Turn off axis marker in corner of viewscreen

Parameters

[in]

vaxis

True to show the axis, false to hide the axis

SetWindowLayout()

void vsp::SetWindowLayout ( int r, int c )

extern

Set the rows and columns of the window layout

SetWindowLayout( 2, 2 );

Parameters

[in]	r	int Number of viewport rows
[in]	c	int Number of viewport columns

StartGUI()

void vsp::StartGUI ( )

extern

Launch the interactive OpenVSP GUI. In a multi-threaded environment, this must be called from the main thread only. This starts the GUI event loop. It will also show the main screen and screens displayed when StopGUI() was previously called.

StartGUI();

StopGUI()

void vsp::StopGUI ( )

extern

Stop OpenVSP GUI event loop and hide screens. Keep OpenVSP running and in memory.

StartGUI();
 
StopGUI();
 
StartGUI();

See also

StartGUI

Unlock()

void vsp::Unlock ( )

extern

Release the lock on the OpenVSP GUI event loop.

StartGUI();
 
string pod_id = AddGeom( "POD" );
 
Lock();
string rid = ExecAnalysis( "CompGeom" );
 
array<string>@ mesh_id_vec = GetStringResults( rid, "Mesh_GeomID" );
 
DeleteGeomVec( mesh_id_vec );
Unlock();

See also

Lock

UpdateGUI()

void vsp::UpdateGUI ( )

extern

Tell OpenVSP that the GUI needs to be updated.

StartGUI();
 
string pod_id = AddGeom( "POD" );
 
string length = FindParm( pod_id, "Length", "Design" );
 
SetParmVal( length, 13.0 );
 
UpdateGUI();

See also

StartGUI