vidIVideo SetMeasureType

Syntax

vidIVideo_handle SetMeasureType id type

Application

Tcl Modify

Description

Sets the type of measure. Valid types of measures are master, static, and dynamic. Master is the master measure for a given video which provides units and a conversion factor between pixels and units. It cannot be added or deleted. Other types may be set to a given measure and are described below.

Inputs

id

The ID of the measure to be modified.

type

dynamic

A measure between two tracing markers which is valid for the time range in which both markers exist together.

persistent

A pixel-to-pixel measure which is the same for all time steps. Also called as a static measure.

transient

A pixel-to-pixel static measure with the ‘at the time of creation’ option turned on, meaning this measure is shown only at the time step at which it was created.

Example

// Load a suitable video in the MediaView window:

hwi OpenStack
hwi GetActiveClientHandle v
v AddTracingMarker
v AddMeasure static
v GetMeasureHandle m2 2
m2 SetMeasurePoint1X 300
m2 SetMeasurePoint1Y 300
m2 SetMeasurePoint2X 400
m2 SetMeasurePoint2Y 500
m2 SetShowMagnitude true

v GetTracingMarkerHandle mark1 1
mark1 SetTrackPoint 270 186
v GetTracingMarkerHandle mark2 2
mark2 SetTrackPoint 466 291

v SetMeasureType 2 dynamic
m2 SetMarker1 "Marker:0" 
m2 SetMarker2 "Marker:1"
v Draw true

Errors

Returns success or an error code.

Keywords