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::InitGUI ()
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 ()
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::SetGeomDisplayType (const string &geom_id, int type)
void	vsp::SetBackground (double r, double g, double b)
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

DisableStopGUIMenuItem()

void vsp::DisableStopGUIMenuItem ( )

extern

Disable Stop GUI Menu Item from the OpenVSP GUI.

This reverses the operation of EnableStopGUIMenuItem.

InitGUI();
EnableStopGUIMenuItem();
StartGUI();

See also

InitGUI, 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.

InitGUI();
EnableStopGUIMenuItem();
StartGUI();

See also

InitGUI, DisableStopGUIMenuItem

InitGUI()

void vsp::InitGUI ( )

extern

Initialize the GUI so it can be called from the API. Must be called before other GUI related API calls. In a multi-threaded environment, this must be called from the main thread only.

InitGUI();
StartGUI();

See also

StartGUI

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.

InitGUI();
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.

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

Parameters

[in]

msg

string Message to display.

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

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 goemetry

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 goemetry

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)

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

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

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

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.

InitGUI();
StartGUI();

See also

InitGUI

StopGUI()

void vsp::StopGUI ( )

extern

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

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

See also

InitGUI, StartGUI

Unlock()

void vsp::Unlock ( )

extern

Release the lock on the OpenVSP GUI event loop.

InitGUI();
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.

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

See also

InitGUI, StartGUI