Navigation: Scripting Reference Manual > Functions & Subroutines > SGSurfFindTermIndexFromName

 

SGSurfFindTermIndexFromName

 

Contact Us: fredsupport@photonengr.com

 

Description

This command retrieves the index number of a term in an SGS surface's term list using the term's name parameter.

 

 

Syntax

termIndex = SGSurfFindTermIndexFromName( surfNode, termName )

 

 

Parameters

termIndex (Long)

Returned term index number..

 

surfNode As Long

Node number of the surface being queried.

 

termName As String

String name of the term whose term list index value is being retrieved.

 

 

Example

The following example creates a default SGS surface, modifies the default 0'th entry name, loops over all terms and prints out the information for each entry.

 

Sub Main

 

 

    Dim ceNode As Long

    Dim ent As T_ENTITY

    InitEntity ent

        ent.name = "Custom Element"

    ceNode = AddCustomElement( ent )

 

    InitEntity ent

        ent.parent = ceNode

        ent.name = "My SGS"

        ent.Description = "Surface made of a superposition of super-gaussians."

    Dim sgsNode As Long

    sgsNode = SGSurfAdd( ent )

    SGSurfSetIthTermName sgsNode, 0, "Default Entry"

 

    Update

 

    Dim sgsTermCount As Long

    sgsTermCount = SGSurfGetTermCount( sgsNode )

    Print "SGS Surf has " & sgsTermCount & " term(s)."

 

 

    Dim curTerm As Long

    Dim pdCoeff As Double, pdX0 As Double, pdY0 As Double, pdSx As Double, pdSy As Double

    Dim pnPx As Long, pnPy As Long, pnP As Long, pdThetaDeg As Double

    Dim termName As String

    Print "Term" & Chr(9) & "Name" & Chr(9) & "Coeff" & Chr(9) & "X off." & Chr(9) & "Y off" & Chr(9) & "Sigma X" & Chr(9) & "Sigma Y" & _

        Chr(9) & "Power X" & Chr(9) & "Power Y" & Chr(9) & "Overall Power" & Chr(9) & "Theta (deg.)"

    For curTerm = 0 To sgsTermCount-1

        SGSurfGetIthTermData sgsNode, _

                             curTerm, _

                             pdCoeff, _

                             pdX0, _

                             pdY0, _

                             pdSx, _

                             pdSy, _

                             pnPx, _

                             pnPy, _

                             pnP, _

                             pdThetaDeg

        termName = SGSurfGetIthTermName( sgsNode, curTerm )

 

        Print curTerm & Chr(9) & termName & Chr(9) & pdCoeff & Chr(9) & pdX0 & Chr(9) & pdY0 & Chr(9) & pdSx & Chr(9) & pdSy & Chr(9) & pnPx & Chr(9) & pnPy & Chr(9) & pnP & Chr(9) & pdThetaDeg

    Next curTerm

 

End Sub

 

 

 

See Also

SGSurfAdd

SGSurfGetTermCount

SGSurfSetTermCount

SGSurfSetIthTermData

SGSurfGetIthTermData

SGSurfSetIthTermName

SGSurfGetIthTermName

 

 

 

 

 

Copyright © Photon Engineering, LLC