Go to the source code of this file.
Defines | |
#define | EXTERN extern |
Functions | |
SetValueReturnCode_e | TecUtilFrameSetPosAndSize (double X, double Y, double Width, double Height) |
Sets the position and size of the current frame. More... | |
SetValueReturnCode_e | TecUtilStyleSetLowLevelX (ArgList_pa ArgList) |
Low level function used to set most frame and base attribute values in Tecplot. More... | |
SetValueReturnCode_e | TecUtilStyleSetLowLevel (Widget TextFieldWidget, double DValue, ArbParam_t IValue, ArbParam_t SetOrOffset, AssignOp_e AssignModifier, const char *P1, const char *P2, const char *P3, const char *P4, const char *P5, const char *P6, Boolean_t OkToRecord) |
Low level function used to set most frame and base attribute values in Tecplot. More... | |
SetValueReturnCode_e | TecUtilFrameSetMode (FrameMode_e NewFrameMode) |
SetValueReturnCode_e | TecUtilFrameSetPlotType (PlotType_e NewPlotType) |
Set the frame mode. More... | |
SetValueReturnCode_e | TecUtilFrameSetName (const char *Name) |
Set the name for the current frame. More... | |
SetValueReturnCode_e | TecUtilZoneSetActive (Set_pa ZoneSet, AssignOp_e AssignModifier) |
Assign which zones are active. More... | |
SetValueReturnCode_e | TecUtilXYMapSetActive (Set_pa XYMapSet, AssignOp_e AssignModifier) |
SetValueReturnCode_e | TecUtilLineMapSetActive (Set_pa LineMapSet, AssignOp_e AssignModifier) |
Assigns which Line-maps are active. More... | |
SetValueReturnCode_e | TecUtilFieldSetLayer (const char *LayerShowFlag, Boolean_t TurnOnFieldLayer) |
SetValueReturnCode_e | TecUtilFieldLayerSetIsActive (const char *LayerShowFlag, Boolean_t TurnOnFieldLayer) |
Instructs Tecplot to turn the specified layer on or off. More... | |
SetValueReturnCode_e | TecUtilXYSetLayer (const char *LayerShowFlag, Boolean_t TurnOnXYLayer) |
SetValueReturnCode_e | TecUtilLinePlotLayerSetIsActive (const char *LayerShowFlag, Boolean_t TurnOnLinePlotLayer) |
Instructs Tecplot to turn on or off the specified line plot layer. More... | |
SetValueReturnCode_e | TecUtilContourSetVariableX (ArgList_pa ArgList) |
Assign which variable to use for contouring a specific contour group. More... | |
SetValueReturnCode_e | TecUtilContourSetVariable (EntIndex_t NewVariable) |
Assign which variable to use for contouring. More... | |
SetValueReturnCode_e | TecUtilZoneSetMesh (const char *Attribute, Set_pa ZoneSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for mesh plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetContour (const char *Attribute, Set_pa ZoneSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for contour plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetVector (const char *Attribute, Set_pa ZoneSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for vector plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetVectorIJKSkip (const char *Attribute, Set_pa ZoneSet, LgIndex_t Skip) |
Set the vector I-, J-, or K-skipping. More... | |
SetValueReturnCode_e | TecUtilZoneSetScatter (const char *Attribute, Set_pa ZoneSet, double DValue, ArbParam_t IValue) |
Assign top level values to attributes for scatter plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetScatterIJKSkip (const char *Attribute, Set_pa ZoneSet, LgIndex_t Skip) |
Set the scatter I-, J-, or K-skipping. More... | |
SetValueReturnCode_e | TecUtilZoneSetScatterSymbolShape (const char *Attribute, Set_pa ZoneSet, ArbParam_t IValue) |
Assign values for the symbol shape in scatter plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetShade (const char *Attribute, Set_pa ZoneSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for shade plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetBoundary (const char *Attribute, Set_pa ZoneSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for boundary plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetVolumeMode (const char *Attribute, const char *SubAttribute, Set_pa ZoneSet, ArbParam_t IValue) |
Assign the Volume Mode for field plots. More... | |
SetValueReturnCode_e | TecUtilZoneSetIJKMode (const char *Attribute, const char *SubAttribute, Set_pa ZoneSet, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilXYMapSetName (Set_pa XYMapSet, const char *NewName) |
SetValueReturnCode_e | TecUtilLineMapSetName (Set_pa LineMapSet, const char *NewName) |
Set the name of an Line-map. More... | |
SetValueReturnCode_e | TecUtilXYMapSetAssignment (const char *Attribute, Set_pa XYMapSet, double DValue, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetAssignment (const char *Attribute, Set_pa LineMapSet, double DValue, ArbParam_t IValue) |
Define Line-map assignments. More... | |
SetValueReturnCode_e | TecUtilXYMapSetLine (const char *Attribute, Set_pa XYMapSet, double DValue, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetLine (const char *Attribute, Set_pa LineMapSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for lines in Line-plots. More... | |
SetValueReturnCode_e | TecUtilXYMapSetCurve (const char *Attribute, Set_pa XYMapSet, double DValue, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetCurve (const char *Attribute, Set_pa LineMapSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for curves in Line-plots. More... | |
SetValueReturnCode_e | TecUtilXYMapSetSymbol (const char *Attribute, Set_pa XYMapSet, double DValue, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetSymbol (const char *Attribute, Set_pa LineMapSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for symbols in Line-plots. More... | |
SetValueReturnCode_e | TecUtilXYMapSetSymbolShape (const char *Attribute, Set_pa XYMapSet, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetSymbolShape (const char *Attribute, Set_pa LineMapSet, ArbParam_t IValue) |
Assign values for the symbol shape in Line-plots. More... | |
SetValueReturnCode_e | TecUtilXYMapSetBarChart (const char *Attribute, Set_pa XYMapSet, double DValue, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetBarChart (const char *Attribute, Set_pa LineMapSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for bar charts in Line-plots. More... | |
SetValueReturnCode_e | TecUtilXYMapSetErrorBar (const char *Attribute, Set_pa XYMapSet, double DValue, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetErrorBar (const char *Attribute, Set_pa LineMapSet, double DValue, ArbParam_t IValue) |
Assign values to attributes for error bars in Line-plots. More... | |
SetValueReturnCode_e | TecUtilXYMapSetIndices (const char *Attribute, const char *SubAttribute, Set_pa XYMapSet, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLineMapSetIndices (const char *Attribute, const char *SubAttribute, Set_pa LineMapSet, ArbParam_t IValue) |
Assign values to attributes for index ranges in Line-plots. More... | |
SetValueReturnCode_e | TecUtilCurveSetExtendedSettings (EntIndex_t LineMapNum, const char *Settings) |
Sets the extended curve fit settings for the set of Line-maps selected in the Plot Attributes dialog. More... | |
SetValueReturnCode_e | TecUtilPrintSetup (const char *Attribute, const char *SubAttribute, double DValue, ArbParam_t IValue) |
Setup the attributes for printing. More... | |
SetValueReturnCode_e | TecUtilExportSetup (const char *Attribute, const char *SubAttribute, double DValue, ArbParam_t IValue) |
Set up all attributes related to exporting a plot. More... | |
SetValueReturnCode_e | TecUtilFrameSetLinking (const char *Attribute, ArbParam_t IValue) |
SetValueReturnCode_e | TecUtilLinkingSetValue (const char *Attribute, const char *SubAttribute, ArbParam_t IValue) |
Convenience function for setting a frame linking attribute. More... | |
SetValueReturnCode_e | TecUtilColorMapSetBase (ContourColorMap_e BaseColorMap) |
Convenience function used to set the color map in Tecplot to one of the base color map types. More... | |
void | TecUtilDialogSetLaunchPosition (Widget W, int DialogWidth, int DialogHeight, AnchorAlignment_e DialogAnchor, LgIndex_t IOffset, LgIndex_t JOffset) |
Sets the initial position of the dialog when lauched. More... |
|
|
|
Convenience function used to set the color map in Tecplot to one of the base color map types.
INTEGER*4 FUNCTION TecUtilColorMapSetBase(BaseColorMap) To set the current Tecplot color map to be the large rainbow color map:
|
|
Assign which variable to use for contouring. This function only operates on contour group 1. To operate on any contour group you must use TecUtilContourSetVariableX().
INTEGER*4 FUNCTION TecUtilContourSetVariable(NewVariable) To set the contour variable to be variable 3, use:
|
|
Assign which variable to use for contouring a specific contour group.
INTEGER*4 FUNCTION TecUtilContourSetVariableX(ArgListPtr) Set the contour variable of the second contour group to variable number 4:
TecUtilLockStart(AddOnID); ArgList = TecUtilArgListAlloc(); if (ArgList != NULL) { SetValueReturnCode_e SVRC; TecUtilArgListClear(ArgList); TecUtilArgListAppendInt(ArgList, SV_CONTOURGROUP, 2); TecUtilArgListAppendInt(ArgList, SV_VAR, 4); SVRC = TecUtilContourSetVariableX(ArgList); TecUtilArgListDealloc(&ArgList); } TecUtilLockFinish(AddOnID); |
|
Sets the extended curve fit settings for the set of Line-maps selected in the Plot Attributes dialog.
INTEGER*4 FUNCTION TecUtilCurveSetExtendedSettings( |
|
Sets the initial position of the dialog when lauched.
SUBROUTINE TecUtilDialogSetLaunchPosition( |
|
Set up all attributes related to exporting a plot. Use TecUtilExport to do the actual exporting. See the $!EXPORTSETUP macro command in Tecplot Reference Manual for more details on available options.
Attribute Assign To: Value Notes -------------------------------------------------------- SV_EXPORTFNAME IValue string SV_EXPORTFORMAT IValue ExportFormat_e SV_MAKEROUGHDRAFT IValue Boolean_t SV_PALETTE IValue Palette_e SV_SUNRASTERFORMAT IValue SunRaster_e SV_BITDUMPREGION IValue BitDumpRegion_e SV_EPSPREVIEWIMAGE IValue See SubAttribute SV_GRAYSCALEDEPTH IValue SmInteger_t SV_IMAGEWIDTH IValue ScreenDim_t SV_CONVERTTO256COLORS IValue Boolean_t SV_ANIMATIONSPEED DValue double SV_USEMULTIPLECOLORTABLES IValue Boolean_t SV_EXTRASORTFOR3DPLOTS IValue Boolean_t
Attribute Assign to: Value Notes -------------------------------------------------------- SV_IMAGETYPE IValue EPSPreviewImage_e SV_IMAGEWIDTH IValue Must be > 0 SV_IMAGEHEIGHT IValue Must be > 0 SV_GRAYSCALEDEPTH IValue Must be > 0
INTEGER*4 FUNCTION TecUtilExportSetup( Export an EPS file with a TIFF preview image to the file "file1.eps." Then, export a PostScript Image file with a 1.25 scale factor to the file "file1.ps."
TecUtilExportSetup(SV_EXPORTFNAME, NULL, 0.0, (ArbParam_t)"file1.eps"); TecUtilExportSetup(SV_EXPORTFORMAT, NULL, 0.0, (ArbParam_t)ExportFormat_EPS); TecUtilExportSetup(SV_EPSPREVIEWIMAGE, SV_IMAGETYPE, 0.0, (ArbParam_t)Image_TIFF); TecUtilExport(); TecUtilExportSetup(SV_EXPORTFNAME, NULL, 0.0, (ArbParam_t)"file1.ps"); TecUtilExportSetup(SV_EXPORTFORMAT, NULL, 0.0, (ArbParam_t)ExportFormat_PSImage); TecUtilExportSetup(SV_EXPORTSCALEFACTOR, NULL, 1.25, (ArbParam_t)0); TecUtilExport(); |
|
Instructs Tecplot to turn the specified layer on or off.
SetValue_Ok SetValue_DuplicateValue SetValue_ValueRangeError SetValue_InternalMemoryError
Fortran Syntax: Turn on the field's contour layer:
SetValueReturnCode_e SVRC; SVRC = TecUtilFieldLayerSetIsActive(SV_SHOWCONTOUR, TRUE); |
|
|
|
|
|
|
|
Set the name for the current frame.
INTEGER*4 FUNCTION TecUtilFrameSetName(Name) Rename the current frame to be "XY-plot #1":
TecUtilFrameSetName("XY-plot #1"); |
|
Set the frame mode.
INTEGER*4 FUNCTION TecUtilFrameSetPlotType(NewPlotType) Set the current frame's mode to be 3D:
|
|
Sets the position and size of the current frame.
INTEGER*4 FUNCTION TecUtilFrameSetPosAndSize( Set the frame's position and size:
TecUtilFrameSetPosAndSize(1.0,1.0,3.0,3.0); |
|
Assigns which Line-maps are active.
INTEGER*4 FUNCTION TecUtilLineMapSetActive( Add Line-map 3 to the set of Line-maps:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,3,FALSE); TecUtilLineMapSetActive(set,AssigOp_PlusEquals); TecUtilSetDealloc(&set); |
|
Define Line-map assignments.
Attribute Assign To Value Notes --------------------------------------------------------- SV_ZONE IValue Valid Zone Number SV_XAXISVAR IValue Valid Variable Number SV_YAXISVAR IValue Valid Variable Number SV_XAXIS IValue Axis number (1-5) SV_YAXIS IValue Axis number (1-5) SV_FUNCTIONDEPENDENCY IValue FunctionDependency_e SV_SORT IValue LineMapSort_e SV_SORTVAR IValue Valid Variable number.
INTEGER*4 FUNCTION TecUtilLineMapSetAssignment( Assign variable 1 to be on the X-axis and variable 4 to be on the Y-axis for Line-mapping number 7:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,7,FALSE); TecUtilLineMapSetAssignment(SV_XAXISVAR,set,0.0,(ArbParam_t)1); TecUtilLineMapSetAssignment(SV_YAXISVAR,set,0.0,(ArbParam_t)4); TecUtilSetDealloc(&set); |
|
Assign values to attributes for bar charts in Line-plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_COLOR IValue ColorIndex_t SV_ISFILLED IValue TRUE,FALSE SV_FILLCOLOR IValue ColorIndex_t SV_SIZE DValue Frame Units SV_LINETHICKNESS DValue Frame Units
INTEGER*4 FUNCTION TecUtilLineMapSetBarChart( Set the fill color of the bar chart to red for Line-mapping number 7:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,7,FALSE); TecUtilLineMapSetBarChart(SV_FILLCOLOR,set,0.0,(ArbParam_t)Red_C); TecUtilSetDealloc(&set); |
|
Assign values to attributes for curves in Line-plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_NUMPTS IValue SV_POLYORDER IValue 1-10 SV_WEIGHTVAR IValue Valid variable number SV_INDVARMIN DValue SV_INDVARMAX DValue SV_USEINDVARRANGE IValue TRUE,FALSE SV_CLAMPSPLINE IValue TRUE,FALSE SV_SPLINESLOPE1 DValue SV_SPLINESLOPE2 DValue SV_EXTENDEDNAME IValue String SV_EXTENDEDSETTINGS IValue String SV_CURVETYPE IValue CurveType_e
INTEGER*4 FUNCTION TecUtilLineMapSetCurve( Set Line-mappings 3-5 to draw a polynomial curve fit of order 5:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,3,FALSE); TecUtilSetAddMember(set,4,FALSE); TecUtilSetAddMember(set,5,FALSE); TecUtilLineMapSetCurve(SV_POLYORDER,set,0.0,(ArbParam_t)5); TecUtilSetDealloc(&set); |
|
Assign values to attributes for error bars in Line-plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_VAR IValue Valid Variable Number SV_BARTYPE IValue ErrorBar_e SV_COLOR IValue ColorIndex_t SV_LINETHICKNESS DValue Frame Units SV_SIZE DValue Frame Units SV_SKIPMODE IValue SkipMode_e
INTEGER*4 FUNCTION TecUtilLineMapSetErrorBar( Make Error Bars red for all Line-mappings:
TecUtilLineMapSetErrorBar(SV_COLOR,NULL,0.0,(ArbParam_t)Red_C); |
|
Assign values to attributes for index ranges in Line-plots.
Attribute SubAttribute Value Notes -------------------------------------------------- SV_IJKLINES NULL IJKLines_e SV_IRANGE SV_MIN Min range, 0 = IMax SV_IRANGE SV_MAX Max range, 0 = IMax SV_IRANGE SV_SKIP Index skip, 0 = IMax-1 SV_JRANGE SV_MIN Min range, 0 = JMax SV_JRANGE SV_MAX Max range, 0 = JMax SV_JRANGE SV_SKIP Index skip, 0 = JMax-1 SV_KRANGE SV_MIN Min range, 0 = KMax SV_KRANGE SV_MAX Max range, 0 = KMax SV_KRANGE SV_SKIP Index skip, 0 = KMax-1
INTEGER*4 FUNCTION TecUtilLineMapSetIndices( Set the I-range to 0-10 for all Line-mappings:
TecUtilLineMapSetIndices(SV_IRANGE,SV_MIN,NULL,(ArbParam_t)0); TecUtilLineMapSetIndices(SV_IRANGE,SV_MAX,NULL,(ArbParam_t)10); |
|
Assign values to attributes for lines in Line-plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_COLOR IValue ColorIndex_t SV_LINEPATTERN IValue LinePattern_e SV_PATTERNLENGTH DValue Valid pattern length SV_LINETHICKNESS DValue Valid line thickness
INTEGER*4 FUNCTION TecUtilLineMapSetLine( Set line patterns in Line-mappings 3-5 to dashed:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,3,FALSE); TecUtilSetAddMember(set,4,FALSE); TecUtilSetAddMember(set,5,FALSE); TecUtilLineMapSetLine(SV_SHOW,set,0.0,(ArbParam_t)TRUE); TecUtilLineMapSetLine(SV_LINEPATTERN, set, 0.0 (ArbParam_t)LinePattern_Dashed); TecUtilSetDealloc(&set); |
|
Set the name of an Line-map.
INTEGER*4 FUNCTION TecUtilLineMapSetName( Set the name of the first Line-map:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,1,FALSE); TecUtilLineMapSetName(set,"MyName"); TecUtilSetDealloc(&set); |
|
Assign values to attributes for symbols in Line-plots. All attributes except for symbol shape are set here. Use TecUtilLineMapSetSymbolShape to set the symbol shape.
Attribute Assign To Value Notes ------------------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_COLOR IValue ColorIndex_t SV_ISFILLED IValue TRUE,FALSE SV_FILLCOLOR IValue ColorIndex_t SV_SIZE DValue Frame Units SV_LINETHICKNESS DValue Valid line thickness SV_SKIPMODE IValue Skip_ByIndex,Skip_ByFrameUnits SV_SKIPPING DValue If SkipMode is Skip_ByIndex then set to index skip. If SkipMode is Skip_ByFrameUnits then supply a distance in frame units.
INTEGER*4 FUNCTION TecUtilLineMapSetSymbol( Set the skip mode of all Line-maps to frame units (distance):
TecUtilLineMapSetSymbol(SV_SKIPMODE,NULL,0.0, (ArbParam_t)Skip_ByFrameUnits); |
|
Assign values for the symbol shape in Line-plots.
Attribute Assign To Value Notes ---------------------------------------------------------------- SV_ISASCII IValue TRUE,FALSE SV_ASCIICHAR IValue String containing a single character or a lead-in font modifier plus one character. SV_GEOMSHAPE IValue GeomShape_e
INTEGER*4 FUNCTION TecUtilLineMapSetSymbolShape( Change the symbol shape for symbols drawn with Line-map 3 to use circles:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set, 3,FALSE); TecUtilLineMapSetSymbolShape(SV_ISASCII, set,0.0, (ArbParam_t)FALSE); TecUtilLineMapSetSymbolShape(SV_GEOMSHAPE,set,0.0, (ArbParam_t)GeomShape_Circle); TecUtilSetDealloc(&set); |
|
Instructs Tecplot to turn on or off the specified line plot layer.
INTEGER*4 FUNCTION TecUtilLinePlotLayerSetIsActive( Turn on the line plot's symbol layer:
SetValueReturnCode_e SVRC; SVRC = TecUtilLinePlotLayerSetIsActive(SV_SHOWSYMBOLS, TRUE); |
|
Convenience function for setting a frame linking attribute. This function in turn calls TecUtilStyleSetLowLevel.
INTEGER*4 FUNCTION TecUtilLinkingSetValue( Turn on linking for contour levels.
TecUtilLinkingSetValue(SV_BETWEENFRAMES, SV_LINKCONTOURLEVELS,TRUE); |
|
Setup the attributes for printing. Use TecUtilPrint to do the actual printing. See the $!PRINTSETUP macro command in the Tecplot Reference Manual for more details on available options.
Attribute I or D Value Type ----------------------------------------------------------------- SV_PRINTFNAME IValue (char *) SV_PRECISION IValue (SmInteger_t) SV_SENDPRINTTOFILE IValue (Boolean_t) SV_NUMHARDCOPYCOPIES IValue (SmInteger_t) SV_MAKEROUGHDRAFT IValue (Boolean_t) SV_LARGEPAPEROK IValue (Boolean_t) SV_DRIVER IValue (PrinterDriver_e) SV_PALETTE IValue (Palette_e) SV_PENSPEED IValue (SmInteger_t) SV_PLOTTERUNITSPERINCH DValue (double) SV_WINPRINTERSMAPCOLORTOMONO IValue (Boolean_t) SV_SPOOLER ------ Base on SubAttribute SV_JOBCONTROL ------ Base on SubAttribute SV_NUMLIGHTSOURCESHADES IValue (SmInteger_t) SV_FORCEEXTRA3DSORTING IValue (Boolean_t) SV_PRINTRENDERTYPE IValeu (PrintRenderType_e) SV_IMAGERESOLUTION IValue (LgIndex_t)
SV_HPGL2MONOSPOOLCMD SV_HPGL2COLORSPOOLCMD SV_HPGLSPOOLCMD SV_PSMONOSPOOLCMD SV_PSCOLORSPOOLCMD SV_LGSPOOLCMD If Attribute is SV_JOBCONTROL, the sent value is ALWAYS a string (thus assigned to IValue) and SubAttribute can be one of:
SV_HPGLMOPUPSTR SV_HPGL2MOPUPSTR SV_POSTMOPUPSTR SV_LGMOPUPSTR SV_HPGLSETUPSTR SV_HPGL2SETUPSTR SV_POSTSETUPSTR SV_LGSETUPSTR
INTEGER*4 FUNCTION TecUtilPrintSetup( Change the type of print output to be postscript:
SetValueReturnCode_e SVRC; SVRC = TecUtilPrintSetup(SV_DRIVER, NULL, 0.0, // Not used (ArbParam_t)PD_PS); Change the name of the output file for print commands to be "myprint.ps"
SetValueReturnCode_e SVRC; SVRC = TecUtilPrintSetup(SV_PRINTFNAME, NULL, 0.0, // Not used (ArbParam_t)"myprint.ps"); Set the print spooler command for color output to be "lpr -hpcolor @"
SetValueReturnCode_e SVRC; SVRC = TecUtilPrintSetup(SV_SPOOLER, SV_PSCOLORSPOOLCMD, 0.0, // Not used (ArbParam_t)"lpr -hpcolor @"); |
|
Low level function used to set most frame and base attribute values in Tecplot. Use this function only if you cannot find an appropriate convenience function that will do the job. As of Tecplot v. 10, this function has ben superseded by TecUtilStyleSetLowLevelX. The parameters to TecUtilStyleSetLowLevel mimic the Macro Frame SetValue Commands and Macro General SetValue Commands described in the Tecplot Reference Manual.
SetValue_NoAttachedDatasetError SetValue_NoAttachedFrameError SetValue_NotAllowedInConfigError SetValue_ValueRangeError SetValue_ValueSyntaxError SetValue_AssignOpError SetValue_InvalidVarOrZone SetValue_InternalMemoryError SetValue_ContextError1 SetValue_ContextError2 Usually, a return value of SetValue_Ok or SetValue_DuplicateValue can be interpreted as being successful.
Fortran Syntax: Call TecUtilStyleSetLowLevel to assign the color red to the text on the second Y-axis in an XY-plot. From the reference manual (or by recording a macro) we see that the macro command to accomplish this feat is: $!XYAXIS YDETAIL 2 {TICKLABEL {COLOR = BLUE}} The corresponding call to TecUtilStyleSetLowLevel is then:
S = TecUtilStyleSetLowLevel((Widget)NULL, 0.0, / * Not Used * / (ArbParam_t)Blue_C, (ArbParam_t)2, / * second Y-Axis * / AssignOp_Equals, SV_XYAXIS, SV_YDETAIL, SV_TICKLABEL, SV_COLOR, (char *)NULL, (char *)NULL, TRUE);
From the Tecplot Reference Manual (or by recording a macro) we see that the macro command to accomplish this feat is: $!FIELD [1-3,7,9] POINTS { IJKSKIP { I = 2 } } The corresponding call to TecUtilStyleSetLowLevel is then:
Set_pa ZoneSet; SetValueReturnCode_e SVRC; ZoneSet = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(ZoneSet,1,FALSE); TecUtilSetAddMember(ZoneSet,2,FALSE); TecUtilSetAddMember(ZoneSet,3,FALSE); TecUtilSetAddMember(ZoneSet,7,FALSE); TecUtilSetAddMember(ZoneSet,9,FALSE); For $!Field [zoneset] Points {IJKSkip {I = (LgIndex_t)}} use:
SVRC = TecUtilStyleSetLowLevel((Widget)NULL, 0.0, / * Not used * / (ArbParam_t)2, / * Vector Skip * / (ArbParam_t)ZoneSet, AssignOp_Equals, SV_FIELD, SV_POINTS, SV_IJKSKIP, SV_I, (char *)NULL, (char *)NULL, FALSE);
S = TecUtilZoneSetVectorIJKSkip(SV_I, ZoneSet, 2); Call TecUtilStyleSetLowLevel to assign the I-Skip to 2 for vectors and scatter symbols in zones 1-3, 7, and 9. From the Tecplot Reference Manual (or by recording a macro) we see that the macro command to accomplish this feat is: $!FIELD [1-3,7,9] POINTS { IJKSKIP { I = 2 } } The corresponding call to TecUtilStyleSetLowLevel is then:
Set_pa ZoneSet; SetValueReturnCode_e SVRC; ZoneSet = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(ZoneSet,1,FALSE); TecUtilSetAddMember(ZoneSet,2,FALSE); TecUtilSetAddMember(ZoneSet,3,FALSE); TecUtilSetAddMember(ZoneSet,7,FALSE); TecUtilSetAddMember(ZoneSet,9,FALSE); $!Field [zoneset] Points {IJKSkip {I = (LgIndex_t)}}
SVRC = TecUtilStyleSetLowLevel((Widget)NULL, 0.0, / * Not used * / (ArbParam_t)2, / * Vector Skip * / (ArbParam_t)ZoneSet, AssignOp_Equals, SV_FIELD, SV_POINTS, SV_IJKSKIP, SV_I, (char *)NULL, (char *)NULL, FALSE);
Call TecUtilSetAlloc(IShowErr,ZoneListPtr) IErr = TecUtilSetAddMember(ZoneListPtr,2,IShowErr) C C ... Must use a pointer to ship IValue because call stack expects C ... argument the size of a pointer. C IValuePtr = SurfacesToPlot_IPlanes ISVRC = TecUtilStyleSetLowLevel(LocalNullPtr, & 0.0D0, & IValuePtr, & ZoneListPtr, & AssignOp_Equals, & 'FIELD'//char(0), & 'SURFACES'//char(0), & 'SURFACESTOPLOT'//char(0), & char(0), & char(0), & char(0), & FALSE) Call TecUtilSetDealloc(ZoneListPtr) |
|
Low level function used to set most frame and base attribute values in Tecplot. Use this function only if you cannot find an appropriate convenience function that will do the job. The parameters to TecUtilStyleSetLowLevelX mimic the Macro Frame SetValue Commands and Macro General SetValue Commands described in the Tecplot Reference Manual.
Fortran Syntax: Set the contour variable of the second contour group to variable number 4:
TecUtilLockStart(AddOnID); ArgList = TecUtilArgListAlloc(); if (ArgList != NULL) { SetValueReturnCode_e SVRC; TecUtilArgListClear(ArgList); TecUtilArgListAppendString(ArgList, SV_P1, SV_GLOBALCONTOUR); TecUtilArgListAppendString(ArgList, SV_P2, SV_VAR) TecUtilArgListAppendInt(ArgList, SV_OFFSET1, 2); / * contour group * / TecUtilArgListAppendArbParam(ArgList, SV_IVALUE, 4); / * variable * / SVRC = TecUtilStyleSetLowLevelX(ArgList); / * * A more conventient way to do this is to use the * TecUtilContourSetVariableX function. * / TecUtilArgListClear(ArgList); TecUtilArgListAppendInt(ArgList, SV_CONTOURGROUP, 2); TecUtilArgListAppendInt(ArgList, SV_VAR, 4); SVRC = TecUtilContourSetVariableX(ArgList); TecUtilArgListDealloc(&ArgList); } TecUtilLockFinish(AddOnID); FORTRAN EXAMPLE: This will set the value blanking condition cutoff value to be V3 >= 0.6 Using the "X" function we have the following arglist entries are available:
Name Type ------------------------------- 'P1' string 'P2' string 'P3' string 'P4' string 'P5' string 'P6' string 'OBJECTSET' Set_pa 'OFFSET1' LgIndex_t 'OFFSET2' LgIndex_t 'ASSIGNMODIFIER' AssignOp_e 'DVALUE' double 'IVALUE' ArbParam_t *
C C ... Set the value blanking variable to 3 C Call TecUtilArgListAlloc(ArgListPtr) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P1'//char(0), & 'BLANKING'//char(0)) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P2'//char(0), & 'VALUE'//char(0)) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P3'//char(0), & 'CONSTRAINT'//char(0)) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P4'//char(0), & 'VARA'//char(0)) IErr = TecUtilArgListAppendInt( ArgListPtr, & 'OFFSET1'//char(0), & 1) IValuePtr = 3 IErr = TecUtilArgListAppendArbParam( ArgListPtr, & 'IVALUE'//char(0), & IValuePtr) write(*,*) 'setting constraint vara' IRet = TecUtilStyleSetLowLevelX(ArgListPtr) Call TecUtilArgListDealloc(ArgListPtr) C C ... Set cutoff value. C Call TecUtilArgListAlloc(ArgListPtr) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P1'//char(0), & 'BLANKING'//char(0)) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P2'//char(0), & 'VALUE'//char(0)) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P3'//char(0), & 'CONSTRAINT'//char(0)) IErr = TecUtilArgListAppendString(ArgListPtr, & 'P4'//char(0), & 'VALUECUTOFF'//char(0)) IErr = TecUtilArgListAppendInt( ArgListPtr, & 'OFFSET1'//char(0), & 1) IErr = TecUtilArgListAppendDouble( ArgListPtr, & 'DVALUE'//char(0), & 0.6D0) write(*,*) 'setting constraint value cut-off' IRet = TecUtilStyleSetLowLevelX(ArgListPtr) Call TecUtilArgListDealloc(ArgListPtr) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Assign which zones are active.
INTEGER*4 FUNCTION TecUtilZoneSetActive( Activate zone 3:
Set_pa zone_set = TecUtilSetAlloc(); TecUtilSetAddMember(zone_set, 3,TRUE); TecUtilZoneSetActive(zone_set, AssignOp_PlusEquals); TecUtilSetDealloc(&zone_set); |
|
Assign values to attributes for boundary plots.
Attribute I or D Value Notes ----------------------------------------------------------------- SV_SHOW IValue TRUE, FALSE SV_IBOUNDARY IValue BoundaryType_e SV_JBOUNDARY IValue BoundaryType_e SV_KBOUNDARY IValue BoundaryType_e SV_COLOR IValue Valid color index. SV_LINETHICKNESS DValue Valid line thickness
INTEGER*4 FUNCTION TecUtilZoneSetBoundary( Set the line thickness for the first zone to 0.1:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,1,FALSE); TecUtilZoneSetBoundary( SV_LINETHICKNESS,set,0.1,(ArbParam_t)NULL); TecUtilSetDealloc(&set); |
|
Assign values to attributes for contour plots.
Attribute I or D Value Notes ----------------------------------------------------------------- SV_SHOW IValue TRUE, FALSE SV_CONTOURTYPE IValue ContourType_e SV_COLOR IValue ColorIndex_t SV_LINEPATTERN IValue LinePattern_e SV_PATTERNLENGTH DValue Valid length SV_LINETHICKNESS DValue Valid thickness
INTEGER*4 FUNCTION TecUtilZoneSetContour( Change the contour plot type to flood for the first zone:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,1,FALSE); TecUtilZoneSetContour(SV_CONTOURTYPE,set,0.0, (ArbParam_t)Contour_Flood); TecUtilSetDealloc(&set); |
|
|
|
Assign values to attributes for mesh plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_MESHTYPE IValue MeshType_e SV_COLOR IValue ColorIndex_t SV_LINEPATTERN IValue LinePattern_e SV_PATTERNLENGTH DValue Valid pattern length SV_LINETHICKNESS DValue Valid line thickness
INTEGER*4 FUNCTION TecUtilZoneSetMesh( Set the mesh color for all zones to be red:
TecUtilZoneSetMesh(SV_Color,NULL,0.0,(ArbParam_t)Blue_C); |
|
Assign top level values to attributes for scatter plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_COLOR IValue ColorIndex_t SV_ISFILLED IValue TRUE,FALSE SV_FILLCOLOR IValue ColorIndex_t SV_SIZEBYVARIABLE IValue TRUE,FALSE SV_FRAMESIZE DValue 0.0-100.0 SV_LINETHICKNESS DValue 0.001-100.0
INTEGER*4 FUNCTION TecUtilZoneSetScatter( Set scatter line thickness for all zones to 0.1:
TecUtilZoneSetScatter(SV_LINETHICKNESS,NULL,0.1,(ArbParam_t)0); |
|
Set the scatter I-, J-, or K-skipping.
INTEGER*4 FUNCTION TecUtilZoneSetScatterIJKSkip( Set the scatter I-skip to two for all zones:
TecUtilZoneSetScatterIJKSkip(SV_I,NULL,(ArbParam_t)2); |
|
Assign values for the symbol shape in scatter plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_ISASCII IValue TRUE,FALSE SV_GEOMSHAPE IValue GeomShape_e SV_ASCIICHAR IValue Character string. Must be a single character (like "A") or a font modifier plust a single character (like "~A").
INTEGER*4 FUNCTION TecUtilZoneSetScatterSymbolShape( Set the scatter symbol shape to squares for all zones:
TecUtilZoneSetScatterSymbolShape(SV_ISASCII,NULL, (ArbParam_t)FALSE); TecUtilZoneSetScatterSymbolShape(SV_GEOMSHAPE,NULL, (ArbParam_t)GeomShape_Square); |
|
Assign values to attributes for shade plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_COLOR IValue ColorIndex_t SV_USELIGHTINGEFFECT IValue TRUE,FALSE
INTEGER*4 FUNCTION TecUtilZoneSetShade( Set the shade color to red: TecUtilZoneSetShade(SV_COLOR,NULL,0.0,(ArbParam_t)Red_C); |
|
Assign values to attributes for vector plots.
Attribute Assign To Value Notes --------------------------------------------------------- SV_SHOW IValue TRUE,FALSE SV_VECTORTYPE IValue VectorType_e SV_COLOR IValue ColorIndex_t SV_LINEPATTERN DValue LinePattern_e SV_PATTERNLENGTH DValue Valid pattern length SV_LINETHICKNESS DValue Valid line thickness SV_ARROWHEADSTYLE IValue ArrowheadStyle_e SV_ISTANGENT IValue TRUE,FALSE
INTEGER*4 FUNCTION TecUtilZoneSetVector( Set the arrowhead style for vector plots to be "plain" for all zones:
TecUtilZoneSetVector(SV_ARROWHEADSTYLE,NULL,0.0, (ArbParam_t)Arrowhead_Plain); |
|
Set the vector I-, J-, or K-skipping.
INTEGER*4 FUNCTION TecUtilZoneSetVectorIJKSkip( Set the vector I-skip to two for all zones:
TecUtilZoneSetVectorIJKSkip(SV_I,NULL,(ArbParam_t)2); |
|
Assign the Volume Mode for field plots.
Attribute SubAttribute IValue ------------------------------------------------------------------------------------------------ SV_SURFACESTOPLOT NULL SurfacesToPlot_BoundaryFaces,SurfacesToPlot_ExposedCellFaces, SurfacesToPlot_IPlanes,SurfacesToPlot_JPlanes, SurfacesToPlot_KPlanes,SurfacesToPlot_IJPlanes, SurfacesToPlot_JKPlanes,SurfacesToPlot_IKPlanes, SurfacesToPlot_IJKPlanes,SurfacesToPlot_All SV_VOLUMEOBJECTSTOPLOT NULL VolumeObjectsToPlot_All,VolumeObjectsToPlot_StreamtracesOnly, VolumeObjectsToPlot_IsoSurfacesOnly,VolumeObjectsToPlot_None SV_POINTSTOPLOT NULL PointsToPlot_SurfacesOnly, PointsToPlot_All. SV_IRANGE SV_MIN Any integer. 0 means IMax SV_IRANGE SV_MAX Any integer. 0 means IMax SV_IRANGE SV_SKIP Any integer. 0 means IMax-1 SV_JRANGE SV_MIN Any integer. 0 means JMax SV_JRANGE SV_MAX Any integer. 0 means JMax SV_JRANGE SV_SKIP Any integer. 0 means JMax-1 SV_KRANGE SV_MIN Any integer. 0 means KMax SV_KRANGE SV_MAX Any integer. 0 means KMax SV_KRANGE SV_SKIP Any integer. 0 means KMax-1
INTEGER*4 FUNCTION TecUtilZoneSetVolumeMode( Draw I-planes only for the first zone:
Set_pa set = TecUtilSetAlloc(FALSE); TecUtilSetAddMember(set,1,FALSE); TecUtilZoneSetVolumeMode(SV_SURFACESTOPLOT,NULL,set, (ArbParam_t)SurfacesToPlot_IPlanes); TecUtilSetDealloc(&set); |