Cicode Programming Reference > Cicode Function Categories > Trend Functions Introduction > TrendZoom

TrendZoom

"Zooms" a specified trend in either one or both axes. Set the zoom values (TimeZoom and/or ScaleZoom) to greater than one to "zoom in" or to less than one to "zoom out".

If you specify a destination AN, you can zoom one trend (at SourceAn) onto another (at DestAn), in the same way as on the standard zoom trend page.

Syntax

TrendZoom(SourceAn, TimeZoom, ScaleZoom [, DestAn] )

SourceAn:

The AN on which the source trend is located.

TimeZoom:

The scale by which the Time axis will be changed (as a real number).

ScaleZoom:

The scale by which the Scale axis will be changed (as a real number).

DestAn:

The AN on which the destination or target trend is located. If you do not enter a DestAn, it is set to the same AN as SourceAn.

Return Value

0 (zero) if successful, otherwise an error is returned.

Related Functions

TrendDspCursorScale, TrendDspCursorTag, TrendDspCursorTime, TrendDspCursorValue, TrendGetAn, TrendRun, TrendSetDate, TrendSetScale, TrendSetSpan, TrendSetTime, TrendSetTimebase

Example

TrendZoom(30, 2.0, 2.0);
/* Zoom in by a factor of 2 on both the time and scale axes. */
TrendZoom(30, 0.5, 0.5);
/* Zoom out by a factor of 2 on both the time and scale axes. */

See Also

Trend Functions