Home
API, Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running applications in batch mode, using Tcl/Tk commands, translators, and result math.
Tcl/Tk Commands
The application's scripting interface is a set of Tcl/Tk commands that follow a simple and consistent syntax.
Tcl/Tk Commands
Tcl/Tk classes for the following Altair HyperWorks applications.
HyperGraph 2D
pltICurve Class
pltICurve AddCursor
Adds a new cursor.

Welcome
What's New
View new features for version 2024.1.
Get Started
Learn the basics and discover the workspace.
Tutorials
Discover product functionality with interactive tutorials.
API, Reference Guides
Overview of external readers and the Altair Binary Format, the generic ASCII reader, running applications in batch mode, using Tcl/Tk commands, translators, and result math.
- Extensions
  Extensions are programs integrated with the application to enhance or extend the user experience.
- External Readers and Altair Binary Format
  Altair Binary Format (ABF) is the standard binary format read by the program. A library called abflib allows you to create files in ABF.
- Generic ASCII Reader
  A generic ASCII reader is now available which allows you to bring custom results directly into HyperView. The Altair ASCII format is useful for reading the results of any in-house or propriety codes which are saved in a generic format.
- Batch Mode
  Batch mode allows you perform a series of operations outside the program interface.
- External Resources
  External resources can be registered in preference files, session files, or Templex files. If an external resource is registered in a program session, it is automatically registered in the session file when the session is saved.
- Python API
  The Python API documentation for HyperMesh applications.
- Tcl/Tk Commands
  The application's scripting interface is a set of Tcl/Tk commands that follow a simple and consistent syntax.
  - Program with APIs for Beginners
    APIs can be used to perform various actions in an application. For example, the AddPage API can be used to add a page within the project.
  - Object Hierarchy
    Overview of object hierarchy for HyperView, HyperGraph, HyperMesh, MotionView, MediaView and TextView.
  - Tcl/Tk Classes
    Links to the introductory pages for the Tcl/Tk commands that can be used in HyperView, MotionView, HyperGraph, HyperGraph 3D, TextView and MediaView.
  - Script Use Cases
    Examples of script uses cases.
  - Tcl/Tk Example
    Learn more about Tcl/Tk with this basic example.
  - Program with Tcl/Tk Command Tutorials
    Learn more about programming with Tcl/Tk commands with this tutorial.
  - Tcl/Tk Commands
    Tcl/Tk classes for the following Altair HyperWorks applications.
    - Framework
    - MotionView
    - HyperView
    - HyperGraph 2D
      - pltIAdvancedDrawControl Class
      - pltIAnimationCursor Class
      - pltIAxis Class
      - pltIBuildPlotsCtrl Class
      - pltICursor Class
      - pltICurve Class
        pltICurve AddCursor
        Adds a new cursor.
        pltICurve AddDataAttribute
        Adds a new empty attribute to the curve.
        pltICurve AddPoint
        Adds a new XY data point to a curve.
        pltICurve Bridge
        Applies a bridge edit to the curve.
        pltICurve CalculateStatistics
        Calculates a statistic.
        pltICurve Cut
        Applies a cut edit to the curve.
        pltICurve DisplayBar
        Indicates whether to display the curve as a line or a series of bars.
        pltICurve GetBarFillPattern
        Gets the bar style of the curve.
        pltICurve GetCursorHandle
        Gets the cursor handle.
        pltICurve GetCurveInTipTail
        Gets whether or not the curve is included in the calculation and drawing of the tip-to-tail curve.
        pltICurve GetCurveType
        Finds the type of curve.
        pltICurve GetDataAttributeHandle
        Gets a handle to an Attribute interface for the specified attribute.
        pltICurve GetDisplayInLegend
        Gets whether or not the curve is displayed in the legend.
        pltICurve GetEditHandle
        Gets a handle to the pltIEdit interface for the specified edit (for example, cut, trim, bridge).
        pltICurve GetHighlighted
        Gets the highlight state of the curve.
        pltICurve GetLayer
        Gets the layer ID of the curve.
        pltICurve GetLineColor
        Gets the line color of the curve.
        pltICurve GetLineStyle
        Gets the line style of the curve.
        pltICurve GetLineThickness
        Gets the line thickness of the curve.
        pltICurve GetMathReference
        Gets the PWC reference for this curve.
        pltICurve GetName
        Gets the title of the curve.
        pltICurve GetNumberOfCursors
        Finds the number of cursors.
        pltICurve GetNumberOfDataAttributes
        Returns the number of attributes in the curve.
        pltICurve GetNumberOfEdits
        Returns the number of edits in the curve.
        pltICurve GetNumberOfPoints
        Gets the number of points on the curve.
        pltICurve GetSymbolColor
        Gets the symbol color of the curve.
        pltICurve GetSymbolEvery
        Gets the symbol frequency of the curve.
        pltICurve GetSymbolStyle
        Gets the symbol style of the curve.
        pltICurve GetVectorHandle
        Gets a handle to a pltIVector interface for the specified curve.
        pltICurve GetVisibility
        Gets whether the curve is displayed or hidden.
        pltICurve Hide
        Applies a hide edit to the curve.
        pltICurve HighlightRangeByIndex
        Highlights between two indices.
        pltICurve HighlightRangeByValue
        Highlights between two values.
        pltICurve Remove
        Removes part of the curve.
        pltICurve RemoveCursor
        Removes a cursor.
        pltICurve RemoveDataAttribute
        Removes the specified attribute from the curve.
        pltICurve RemoveLastEdit
        Removes the most recently applied edit from the curve.
        pltICurve Replace
        Applies a replace edit to the curve.
        pltICurve SetBarFillPattern
        Sets the bar style of the curve.
        pltICurve SetCurveInTipTail
        Sets if the curve is included in the calculation and drawing of the tip-to-tail curve.
        pltICurve SetAttributesToDefault
        Sets the various attributes of the curve to the default.
        pltICurve SetDisplayInLegend
        Sets whether or not the curve is displayed in the legend.
        pltICurve SetHighlighted
        Sets the highlight state of the curve.
        pltICurve SetLayer
        Sets the layer ID of the curve.
        pltICurve SetLineColor
        Sets the line color of the curve.
        pltICurve SetLineStyle
        Sets the line style of the curve.
        pltICurve SetLineThickness
        Sets the line thickness of the curve.
        pltICurve SetName
        Sets the title of the curve.
        pltICurve SetSymbolColor
        Sets the symbol color of the curve.
        pltICurve SetSymbolEvery
        Sets the symbol frequency of the curve.
        pltICurve SetSymbolStyle
        Sets the symbol style of the curve.
        pltICurve SetVisibility
        Sets whether the curve is on displayed or hidden.
        pltICurve Trim
        Applies a trim edit to the curve.
      - pltICurveComplex Class
      - pltIDataAttribute Class
      - pltIDatum Class
      - pltIDrawControl Class
      - pltIEdit Class
      - pltIExportCtrl Class
      - pltILegend Class
      - pltIMacro Class
      - pltINote Class
      - pltIPlot Class
      - pltIPlotManager Class
      - pltIStatisticsTemplate Class
      - pltITitle Class
      - pltIVector Class
      - pltIVectorComplex Class
      - pltIViewControl Class
      - pulIAxis Class
      - pulIDataExtractor Class
      - pulIDataGroup Class
      - pulIMacro Class
      - pulIMacroParameter Class
    - HyperGraph 3D
    - MediaView
    - TextView
    - HgTrans
    - TableView
    - Postquery Commands
    - Context Commands
    - Framework Commands
- Translators
  Translators are utilities that are run from the command line of the operating system to convert various types of files into different formats.
- Result Math
  XML commands in the Result Math Module.
- HWC Console
  Record playback workflows in the application.
- HyperMesh Report
- Task Manager
  Use the Task Manager to load an XML file that defines tasks and their attributes.
- HyperMesh
- MotionView
- Templex and Math Reference Guide
- Script and Model Library
  The Script and Model Library is a database of freely accessible scripts and models posted by users and Altair engineers.

pltICurve AddCursor

Adds a new cursor.

Syntax

pltICurve_handle AddCursor

Application

Tcl Modify

Description

This command adds a new, empty cursor. A cursor is an object that points out an exact location on a graph.

Example

hwi GetSessionHandle sess;
sess GetProjectHandle proj;
proj GetPageHandle p1 1;
p1 GetWindowHandle w1 1;
w1 GetClientHandle plot;
plot GetCurveHandle c1 1
c1 AddCursor;

Errors

Success (0) or an error message is returned.

Keywords

Tcl

Cursor

Modify

Create