Measure Tool Functions

This group of API functions can be used to control the Ruler Tool through the API. Click here to return to the main page. More...

Functions
void	vsp::ShowAllRulers ()
void	vsp::HideAllRulers ()
void	vsp::ShowAllProbes ()
void	vsp::HideAllProbes ()
void	vsp::ShowAllProtractors ()
void	vsp::HideAllProtractors ()
void	vsp::ShowAllRSTProbes ()
void	vsp::HideAllRSTProbes ()
std::string	vsp::AddProtractor (const std::string &startgeomid, int startsurfindx, double startu, double startw, const std::string &midgeomid, int midsurfindx, double midu, double midw, const std::string &endgeomid, int endsurfindx, double endu, double endw, const std::string &name)
std::vector< std::string >	vsp::GetAllProtractors ()
void	vsp::DelProtractor (const std::string &id)
void	vsp::DeleteAllProtractors ()
void	vsp::SetMeasureOriginGeomID (const std::string &measure_id, const std::string &geom_id)
std::string	vsp::GetMeasureOriginGeomID (const std::string &measure_id)
void	vsp::SetMeasureMidGeomID (const std::string &measure_id, const std::string &geom_id)
std::string	vsp::GetMeasureMidGeomID (const std::string &measure_id)
void	vsp::SetMeasureEndGeomID (const std::string &measure_id, const std::string &geom_id)
std::string	vsp::GetMeasureEndGeomID (const std::string &measure_id)
std::string	vsp::AddRSTProbe (const std::string &geomid, int surfindx, double r, double s, double t, const std::string &name)
std::vector< std::string >	vsp::GetAllRSTProbes ()
void	vsp::DelRSTProbe (const std::string &id)
void	vsp::DeleteAllRSTProbes ()
std::string	vsp::AddRuler (const std::string &startgeomid, int startsurfindx, double startu, double startw, const std::string &endgeomid, int endsurfindx, double endu, double endw, const std::string &name)
std::vector< std::string >	vsp::GetAllRulers ()
void	vsp::DelRuler (const std::string &id)
void	vsp::DeleteAllRulers ()
std::string	vsp::AddProbe (const std::string &geomid, int surfindx, double u, double w, const std::string &name)
std::vector< std::string >	vsp::GetAllProbes ()
void	vsp::DelProbe (const std::string &id)
void	vsp::DeleteAllProbes ()

Detailed Description

Function Documentation

AddProbe()

std::string vsp::AddProbe ( const std::string & geomid, int surfindx, double u, double w, const std::string & name )

extern

Create a new Probe and add it to the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string probe_id = AddProbe( pid1, 0, 0.5, 0.8, "Probe 1" );
 
SetParmVal( FindParm( probe_id, "Len", "Measure" ), 3.0 );
 
if ( probe_id.length() == 0 || probe_id == "NONE" )
{
    Print( "ERROR: AddProbe returned no id" );
    __failure++;
}

Parameters

[in]	geomid	string Parent Geom ID
[in]	surfindx	int Main surface index from the parent Geom
[in]	u	double Surface u (0 - 1) coordinate
[in]	w	double Surface w (0 - 1) coordinate
[in]	name	string Probe name

Returns

string Probe ID

Here is the call graph for this function:

Here is the caller graph for this function:

AddProtractor()

std::string vsp::AddProtractor ( const std::string & startgeomid, int startsurfindx, double startu, double startw, const std::string & midgeomid, int midsurfindx, double midu, double midw, const std::string & endgeomid, int endsurfindx, double endu, double endw, const std::string & name )

extern

Add a protractor measuring the angle at a middle point between two others, each given as a surface coordinate on a Geom.

string pid = AddGeom( "POD" );
 
Update();
 
string prid = AddProtractor( pid, 0, 0.2, 0.0, pid, 0, 0.5, 0.0, pid, 0, 0.8, 0.0, "TestProtractor" );
 
if ( prid.length() == 0 )                            { Print( "ERROR: AddProtractor" ); __failure++; }
 
if ( GetAllProtractors().size() != 1 )               { Print( "ERROR: AddProtractor" ); __failure++; }

See also

GetAllProtractors, DelProtractor

Parameters

[in]	startgeomid	string Geom ID the first leg starts on
[in]	startsurfindx	int Surface index on that Geom
[in]	startu	double U coordinate of the start, in [0, 1]
[in]	startw	double W coordinate of the start, in [0, 1]
[in]	midgeomid	string Geom ID the corner sits on
[in]	midsurfindx	int Surface index on that Geom
[in]	midu	double U coordinate of the corner, in [0, 1]
[in]	midw	double W coordinate of the corner, in [0, 1]
[in]	endgeomid	string Geom ID the second leg ends on
[in]	endsurfindx	int Surface index on that Geom
[in]	endu	double U coordinate of the end, in [0, 1]
[in]	endw	double W coordinate of the end, in [0, 1]
[in]	name	string Name for the protractor

Returns

string Protractor ID

Here is the call graph for this function:

Here is the caller graph for this function:

AddRSTProbe()

std::string vsp::AddRSTProbe ( const std::string & geomid, int surfindx, double r, double s, double t, const std::string & name )

extern

Create and add an RST Probe object to the Measure Tool. An RST Probe marks a point in the volume of a Geom rather than on its surface.

string pod1 = AddGeom( "POD", "" );
 
string pid = AddRSTProbe( pod1, 0, 0.5, 0.5, 0.5, "Example_RSTProbe" );
 
if ( pid.length() == 0 || pid == "NONE" )
{
    Print( "ERROR: AddRSTProbe returned no id" );
    __failure++;
}
 
// The new probe is the only one in the model, and it is not confused with a
// surface probe.
array< string > @probe_array = GetAllRSTProbes();
 
if ( probe_array.size() != 1 || probe_array[0] != pid )
{
    Print( "ERROR: AddRSTProbe did not add the probe" );
    __failure++;
}
 
if ( GetAllProbes().size() != 0 )
{
    Print( "ERROR: an RST probe was counted as a surface probe" );
    __failure++;
}
 
if ( GetContainerName( pid ) != "Example_RSTProbe" )
{
    Print( "ERROR: AddRSTProbe did not name the probe" );
    __failure++;
}

See also

GetAllRSTProbes, DelRSTProbe, DeleteAllRSTProbes, AddProbe

Parameters

[in]	geomid	string Parent Geom ID
[in]	surfindx	int Main surface index from the parent Geom
[in]	r	double R (0 - 1) volume coordinate
[in]	s	double S (0 - 1) volume coordinate
[in]	t	double T (0 - 1) volume coordinate
[in]	name	string RST Probe name

Returns

string RST Probe ID

Here is the call graph for this function:

Here is the caller graph for this function:

AddRuler()

std::string vsp::AddRuler ( const std::string & startgeomid, int startsurfindx, double startu, double startw, const std::string & endgeomid, int endsurfindx, double endu, double endw, const std::string & name )

extern

Add a ruler between two points on the model, each given as a surface coordinate on a Geom.

string pid = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pid, 0, 0.2, 0.0, pid, 0, 0.8, 0.0, "TestRuler" );
 
if ( rid.length() == 0 )                             { Print( "ERROR: AddRuler" ); __failure++; }
 
if ( GetAllRulers().size() != 1 )                    { Print( "ERROR: AddRuler" ); __failure++; }

See also

GetAllRulers, DelRuler

Parameters

[in]	startgeomid	string Geom ID the ruler starts on
[in]	startsurfindx	int Surface index on the starting Geom
[in]	startu	double U coordinate of the start, in [0, 1]
[in]	startw	double W coordinate of the start, in [0, 1]
[in]	endgeomid	string Geom ID the ruler ends on
[in]	endsurfindx	int Surface index on the ending Geom
[in]	endu	double U coordinate of the end, in [0, 1]
[in]	endw	double W coordinate of the end, in [0, 1]
[in]	name	string Name for the ruler

Returns

string Ruler ID

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteAllProbes()

void vsp::DeleteAllProbes ( )

extern

Delete all Probes from the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string probe_id_1 = AddProbe( pid1, 0, 0.5, 0.8, "Probe 1" );
string probe_id_2 = AddProbe( pid1, 0, 0.2, 0.3, "Probe 2" );
 
DeleteAllProbes();
 
array< string > @probe_array = GetAllProbes();
 
if ( probe_array.size() != 0 ) { Print( "Error: DeleteAllProbes" ); __failure++; }

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteAllProtractors()

void vsp::DeleteAllProtractors ( )

extern

Delete all Protractors from the Measure Tool

string pod1 = AddGeom( "POD", "" );
 
AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Protractor_1" );
AddProtractor( pod1, 0, 0.1, 0.0, pod1, 0, 0.4, 0.0, pod1, 0, 0.7, 0.0, "Protractor_2" );
 
DeleteAllProtractors();
 
if ( GetAllProtractors().size() != 0 )
{
    Print( "ERROR: DeleteAllProtractors left protractors behind" );
    __failure++;
}

See also

AddProtractor, GetAllProtractors, DelProtractor

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteAllRSTProbes()

void vsp::DeleteAllRSTProbes ( )

extern

Delete all RST Probes from the Measure Tool

string pod1 = AddGeom( "POD", "" );
 
AddRSTProbe( pod1, 0, 0.5, 0.5, 0.5, "RSTProbe_1" );
AddRSTProbe( pod1, 0, 0.25, 0.5, 0.5, "RSTProbe_2" );
 
// Surface probes are a separate list and are left alone.
AddProbe( pod1, 0, 0.5, 0.5, "Surface_Probe" );
 
DeleteAllRSTProbes();
 
if ( GetAllRSTProbes().size() != 0 )
{
    Print( "ERROR: DeleteAllRSTProbes left probes behind" );
    __failure++;
}
 
if ( GetAllProbes().size() != 1 )
{
    Print( "ERROR: DeleteAllRSTProbes removed a surface probe" );
    __failure++;
}

See also

AddRSTProbe, GetAllRSTProbes, DelRSTProbe

Here is the call graph for this function:

Here is the caller graph for this function:

DeleteAllRulers()

void vsp::DeleteAllRulers ( )

extern

Delete all Rulers from the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string pid2 = AddGeom( "POD", "" );
 
SetParmVal( pid2, "Z_Rel_Location", "XForm", 4.0 );
 
string rid1 = AddRuler( pid1, 0, 0.2, 0.3, pid2, 0, 0.2, 0.3, "Ruler 1" );
 
string rid2 = AddRuler( pid1, 0, 0.4, 0.6, pid1, 0, 0.8, 0.9, "Ruler 2" );
 
DeleteAllRulers();
if ( GetAllRulers().length() != 0 )
{
    Print( "ERROR: DeleteAllRulers left something behind" );
    __failure++;
}

Here is the call graph for this function:

Here is the caller graph for this function:

DelProbe()

void vsp::DelProbe ( const std::string & id )

extern

Delete a specific Probe from the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string probe_id_1 = AddProbe( pid1, 0, 0.5, 0.8, "Probe 1" );
string probe_id_2 = AddProbe( pid1, 0, 0.2, 0.3, "Probe 2" );
 
DelProbe( probe_id_1 );
 
array< string > @probe_array = GetAllProbes();
 
if ( probe_array.size() != 1 ) { Print( "Error: DelProbe" ); __failure++; }

Parameters

[in]

id

string Probe ID

Here is the call graph for this function:

Here is the caller graph for this function:

DelProtractor()

void vsp::DelProtractor ( const std::string & id )

extern

Delete a particular Protractor from the Measure Tool

string pod1 = AddGeom( "POD", "" );
 
string pid1 = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Protractor_1" );
string pid2 = AddProtractor( pod1, 0, 0.1, 0.0, pod1, 0, 0.4, 0.0, pod1, 0, 0.7, 0.0, "Protractor_2" );
 
DelProtractor( pid1 );
 
// Only the named protractor goes.
array< string > @prot_array = GetAllProtractors();
 
if ( prot_array.size() != 1 || prot_array[0] != pid2 )
{
    Print( "ERROR: DelProtractor removed the wrong protractor" );
    __failure++;
}

See also

AddProtractor, GetAllProtractors, DeleteAllProtractors

Parameters

[in]

id

string Protractor ID

Here is the call graph for this function:

Here is the caller graph for this function:

DelRSTProbe()

void vsp::DelRSTProbe ( const std::string & id )

extern

Delete a particular RST Probe from the Measure Tool

string pod1 = AddGeom( "POD", "" );
 
string pid1 = AddRSTProbe( pod1, 0, 0.5, 0.5, 0.5, "RSTProbe_1" );
string pid2 = AddRSTProbe( pod1, 0, 0.25, 0.5, 0.5, "RSTProbe_2" );
 
DelRSTProbe( pid1 );
 
// Only the named probe goes.
array< string > @probe_array = GetAllRSTProbes();
 
if ( probe_array.size() != 1 || probe_array[0] != pid2 )
{
    Print( "ERROR: DelRSTProbe removed the wrong probe" );
    __failure++;
}

See also

AddRSTProbe, GetAllRSTProbes, DeleteAllRSTProbes

Parameters

[in]

id

string RST Probe ID

Here is the call graph for this function:

Here is the caller graph for this function:

DelRuler()

void vsp::DelRuler ( const std::string & id )

extern

Delete a particular Ruler from the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string pid2 = AddGeom( "POD", "" );
 
SetParmVal( pid2, "Z_Rel_Location", "XForm", 4.0 );
 
string rid1 = AddRuler( pid1, 0, 0.2, 0.3, pid2, 0, 0.2, 0.3, "Ruler 1" );
 
string rid2 = AddRuler( pid1, 0, 0.4, 0.6, pid1, 0, 0.8, 0.9, "Ruler 2" );
 
array< string > @ruler_array = GetAllRulers();
 
int num_before_del = GetAllRulers().length();
DelRuler( ruler_array[0] );
if ( GetAllRulers().length() >= num_before_del )
{
    Print( "ERROR: DelRuler removed nothing" );
    __failure++;
}

Parameters

[in]

id

string Ruler ID

Here is the call graph for this function:

Here is the caller graph for this function:

GetAllProbes()

std::vector< std::string > vsp::GetAllProbes ( )

extern

Get an array of all Probe IDs from the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string probe_id = AddProbe( pid1, 0, 0.5, 0.8, "Probe 1" );
 
array< string > @probe_array = GetAllProbes();
if ( probe_array.length() == 0 )
{
    Print( "ERROR: GetAllProbes returned nothing" );
    __failure++;
}
 
Print( "One Probe: ", false );
 
Print( probe_array[0] );

Returns

vector<string> Array of Probe IDs

Here is the call graph for this function:

Here is the caller graph for this function:

GetAllProtractors()

std::vector< std::string > vsp::GetAllProtractors ( )

extern

Get an array of all Protractor IDs from the Measure Tool

string pod1 = AddGeom( "POD", "" );
 
AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Protractor_1" );
AddProtractor( pod1, 0, 0.1, 0.0, pod1, 0, 0.4, 0.0, pod1, 0, 0.7, 0.0, "Protractor_2" );
 
array< string > @prot_array = GetAllProtractors();
 
if ( prot_array.size() != 2 )
{
    Print( "ERROR: GetAllProtractors did not report both protractors" );
    __failure++;
}
 
if ( prot_array.size() == 2 && prot_array[0] == prot_array[1] )
{
    Print( "ERROR: GetAllProtractors reported the same protractor twice" );
    __failure++;
}

See also

AddProtractor, DelProtractor, DeleteAllProtractors

Returns

vector<string> Array of Protractor IDs

Here is the call graph for this function:

Here is the caller graph for this function:

GetAllRSTProbes()

std::vector< std::string > vsp::GetAllRSTProbes ( )

extern

Get an array of all RST Probe IDs from the Measure Tool

string pod1 = AddGeom( "POD", "" );
 
AddRSTProbe( pod1, 0, 0.5, 0.5, 0.5, "RSTProbe_1" );
AddRSTProbe( pod1, 0, 0.25, 0.5, 0.5, "RSTProbe_2" );
 
array< string > @probe_array = GetAllRSTProbes();
 
if ( probe_array.size() != 2 )
{
    Print( "ERROR: GetAllRSTProbes did not report both probes" );
    __failure++;
}
 
if ( probe_array.size() == 2 && probe_array[0] == probe_array[1] )
{
    Print( "ERROR: GetAllRSTProbes reported the same probe twice" );
    __failure++;
}

See also

AddRSTProbe, DelRSTProbe, DeleteAllRSTProbes

Returns

vector<string> Array of RST Probe IDs

Here is the call graph for this function:

Here is the caller graph for this function:

GetAllRulers()

std::vector< std::string > vsp::GetAllRulers ( )

extern

Get an array of all Ruler IDs from the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string pid2 = AddGeom( "POD", "" );
 
SetParmVal( pid2, "Z_Rel_Location", "XForm", 4.0 );
 
string rid1 = AddRuler( pid1, 0, 0.2, 0.3, pid2, 0, 0.2, 0.3, "Ruler 1" );
 
string rid2 = AddRuler( pid1, 0, 0.4, 0.6, pid1, 0, 0.8, 0.9, "Ruler 2" );
 
array< string > @ruler_array = GetAllRulers();
if ( ruler_array.length() == 0 )
{
    Print( "ERROR: GetAllRulers returned nothing" );
    __failure++;
}
 
Print("Two Rulers");
 
for( int n = 0 ; n < int( ruler_array.length() ) ; n++ )
{
    Print( ruler_array[n] );
}

Returns

vector<string> Vector of Ruler IDs

Here is the call graph for this function:

Here is the caller graph for this function:

GetMeasureEndGeomID()

std::string vsp::GetMeasureEndGeomID ( const std::string & measure_id )

extern

Get the Geom the end of a ruler or protractor lies on.

string pod1 = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Span" );
string tid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Angle" );
 
if ( GetMeasureEndGeomID( rid ) != pod1 )
{
    Print( "ERROR: GetMeasureEndGeomID did not return the Geom" );
    __failure++;
}

See also

SetMeasureEndGeomID

Parameters

[in]

measure_id

string Measure ID

Returns

string Geom ID

Here is the call graph for this function:

Here is the caller graph for this function:

GetMeasureMidGeomID()

std::string vsp::GetMeasureMidGeomID ( const std::string & measure_id )

extern

Get the Geom the middle point of a protractor lies on.

string pod1 = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Span" );
string tid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Angle" );
 
if ( GetMeasureMidGeomID( tid ) != pod1 )
{
    Print( "ERROR: GetMeasureMidGeomID did not return the Geom" );
    __failure++;
}

See also

SetMeasureMidGeomID

Parameters

[in]

measure_id

string Measure ID

Returns

string Geom ID

Here is the call graph for this function:

Here is the caller graph for this function:

GetMeasureOriginGeomID()

std::string vsp::GetMeasureOriginGeomID ( const std::string & measure_id )

extern

Get the Geom the origin of a ruler, probe, RST probe or protractor lies on.

string pod1 = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Span" );
string tid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Angle" );
 
if ( GetMeasureOriginGeomID( rid ) != pod1 )
{
    Print( "ERROR: GetMeasureOriginGeomID did not return the Geom" );
    __failure++;
}

See also

SetMeasureOriginGeomID

Parameters

[in]

measure_id

string Measure ID

Returns

string Geom ID

Here is the call graph for this function:

Here is the caller graph for this function:

HideAllProbes()

void vsp::HideAllProbes ( )

extern

Hide every Probe in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddProbe( pid, 0, 0.5, 0.5, "P" );
 
HideAllProbes();

See also

ShowAllProbes

Here is the call graph for this function:

Here is the caller graph for this function:

HideAllProtractors()

void vsp::HideAllProtractors ( )

extern

Hide every Protractor in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddProtractor( pid, 0, 0.2, 0.0, pid, 0, 0.5, 0.0, pid, 0, 0.8, 0.0, "P" );
 
HideAllProtractors();

See also

ShowAllProtractors

Here is the call graph for this function:

Here is the caller graph for this function:

HideAllRSTProbes()

void vsp::HideAllRSTProbes ( )

extern

Hide every RST Probe in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddRSTProbe( pid, 0, 0.5, 0.5, 0.5, "P" );
 
HideAllRSTProbes();

See also

ShowAllRSTProbes

Here is the call graph for this function:

Here is the caller graph for this function:

HideAllRulers()

void vsp::HideAllRulers ( )

extern

Hide every Ruler in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddRuler( pid, 0, 0.2, 0.0, pid, 0, 0.8, 0.0, "R" );
 
HideAllRulers();

See also

ShowAllRulers

Here is the call graph for this function:

Here is the caller graph for this function:

SetMeasureEndGeomID()

void vsp::SetMeasureEndGeomID ( const std::string & measure_id, const std::string & geom_id )

extern

Set the Geom the end of a ruler or protractor lies on.

string pod1 = AddGeom( "POD" );
string pod2 = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Span" );
string tid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Angle" );
 
SetMeasureEndGeomID( rid, pod2 );
 
if ( GetMeasureEndGeomID( rid ) != pod2 )
{
    Print( "ERROR: SetMeasureEndGeomID did not set the Geom" );
    __failure++;
}

See also

GetMeasureEndGeomID

Parameters

[in]	measure_id	string Measure ID
[in]	geom_id	string Geom ID, or an empty string

Here is the call graph for this function:

Here is the caller graph for this function:

SetMeasureMidGeomID()

void vsp::SetMeasureMidGeomID ( const std::string & measure_id, const std::string & geom_id )

extern

Set the Geom the middle point of a protractor lies on.

string pod1 = AddGeom( "POD" );
string pod2 = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Span" );
string tid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Angle" );
 
SetMeasureMidGeomID( tid, pod2 );
 
if ( GetMeasureMidGeomID( tid ) != pod2 )
{
    Print( "ERROR: SetMeasureMidGeomID did not set the Geom" );
    __failure++;
}

See also

GetMeasureMidGeomID

Parameters

[in]	measure_id	string Measure ID
[in]	geom_id	string Geom ID, or an empty string

Here is the call graph for this function:

Here is the caller graph for this function:

SetMeasureOriginGeomID()

void vsp::SetMeasureOriginGeomID ( const std::string & measure_id, const std::string & geom_id )

extern

Set the Geom the origin of a ruler, probe, RST probe or protractor lies on.

string pod1 = AddGeom( "POD" );
string pod2 = AddGeom( "POD" );
 
Update();
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Span" );
string tid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Angle" );
 
SetMeasureOriginGeomID( rid, pod2 );
 
if ( GetMeasureOriginGeomID( rid ) != pod2 )
{
    Print( "ERROR: SetMeasureOriginGeomID did not set the Geom" );
    __failure++;
}

See also

GetMeasureOriginGeomID

Parameters

[in]	measure_id	string Measure ID
[in]	geom_id	string Geom ID, or an empty string

Here is the call graph for this function:

Here is the caller graph for this function:

ShowAllProbes()

void vsp::ShowAllProbes ( )

extern

Show every Probe in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddProbe( pid, 0, 0.5, 0.5, "P" );
 
ShowAllProbes();

See also

HideAllProbes

Here is the call graph for this function:

Here is the caller graph for this function:

ShowAllProtractors()

void vsp::ShowAllProtractors ( )

extern

Show every Protractor in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddProtractor( pid, 0, 0.2, 0.0, pid, 0, 0.5, 0.0, pid, 0, 0.8, 0.0, "P" );
 
ShowAllProtractors();

See also

HideAllProtractors

Here is the call graph for this function:

Here is the caller graph for this function:

ShowAllRSTProbes()

void vsp::ShowAllRSTProbes ( )

extern

Show every RST Probe in the Measure Tool.

string pid = AddGeom( "POD" );
 
Update();
 
AddRSTProbe( pid, 0, 0.5, 0.5, 0.5, "P" );
 
ShowAllRSTProbes();

See also

HideAllRSTProbes

Here is the call graph for this function:

Here is the caller graph for this function:

ShowAllRulers()

void vsp::ShowAllRulers ( )

extern

Create a new Ruler and add it to the Measure Tool

string pid1 = AddGeom( "POD", "" );
 
SetParmVal( pid1, "Y_Rel_Location", "XForm", 2.0 );
 
string pid2 = AddGeom( "POD", "" );
 
SetParmVal( pid2, "Z_Rel_Location", "XForm", 4.0 );
 
string rid = AddRuler( pid1, 0, 0.2, 0.3, pid2, 0, 0.2, 0.3, "Ruler 1" );
 
SetParmVal( FindParm( rid, "X_Offset", "Measure" ), 6.0 );
 
if ( rid.length() == 0 || rid == "NONE" )
{
    Print( "ERROR: AddRuler returned no id" );
    __failure++;
}

Parameters

[in]	startgeomid	string Start parent Geom ID
[in]	startsurfindx	int Main surface index from the staring parent Geom
[in]	startu	double Surface u (0 - 1) start coordinate
[in]	startw	double Surface w (0 - 1) start coordinate
[in]	endgeomid	string End parent Geom ID
[in]	endsurfindx	int Main surface index on the end parent Geom
[in]	endu	double Surface u (0 - 1) end coordinate
[in]	endw	double Surface w (0 - 1) end coordinate
[in]	name	string Ruler name

Returns

string Ruler ID

Create and add a Protractor object from three points on Geom surfaces. The angle is measured at the middle point, between the legs running out to the start and end points.

string pod1 = AddGeom( "POD", "" );
 
string pid = AddProtractor( pod1, 0, 0.2, 0.0, pod1, 0, 0.5, 0.0, pod1, 0, 0.8, 0.0, "Example_Protractor" );
 
if ( pid.length() == 0 || pid == "NONE" )
{
    Print( "ERROR: AddProtractor returned no id" );
    __failure++;
}
 
// The new protractor is the only one in the model.
array< string > @prot_array = GetAllProtractors();
 
if ( prot_array.size() != 1 || prot_array[0] != pid )
{
    Print( "ERROR: AddProtractor did not add the protractor" );
    __failure++;
}
 
// Protractors are their own Parm Containers, so the name is readable.
if ( GetContainerName( pid ) != "Example_Protractor" )
{
    Print( "ERROR: AddProtractor did not name the protractor" );
    __failure++;
}

See also

GetAllProtractors, DelProtractor, DeleteAllProtractors, AddRuler

Parameters

[in]	startgeomid	string Start parent Geom ID
[in]	startsurfindx	int Start surface index from the start parent Geom
[in]	startu	double Start U (0 - 1) surface coordinate
[in]	startw	double Start W (0 - 1) surface coordinate
[in]	midgeomid	string Middle parent Geom ID
[in]	midsurfindx	int Middle surface index from the middle parent Geom
[in]	midu	double Middle U (0 - 1) surface coordinate
[in]	midw	double Middle W (0 - 1) surface coordinate
[in]	endgeomid	string End parent Geom ID
[in]	endsurfindx	int End surface index from the end parent Geom
[in]	endu	double End U (0 - 1) surface coordinate
[in]	endw	double End W (0 - 1) surface coordinate
[in]	name	string Protractor name

Returns

string Protractor ID

Show every Ruler in the Measure Tool. This is the Measure screen's Show All button for rulers.

string pod1 = AddGeom( "POD", "" );
 
string rid = AddRuler( pod1, 0, 0.2, 0.0, pod1, 0, 0.8, 0.0, "Example_Ruler" );
 
HideAllRulers();
 
// Visibility is a Parm on the ruler itself.
if ( !closeTo( GetParmVal( FindParm( rid, "Visible", "Measure" ) ), 0.0, 1e-12 ) )
{
    Print( "ERROR: HideAllRulers did not hide the ruler" );
    __failure++;
}
 
ShowAllRulers();
 
if ( !closeTo( GetParmVal( FindParm( rid, "Visible", "Measure" ) ), 1.0, 1e-12 ) )
{
    Print( "ERROR: ShowAllRulers did not show the ruler" );
    __failure++;
}

See also

HideAllRulers, AddRuler

Here is the call graph for this function:

Here is the caller graph for this function: