##
##
##	3DEqualizer4 Release 3
##	Python Interface Command Summary
##
##	(c) Science.D.Visions
##
##

###################
# definitions...

<vector 2d>			= [<double>,<double>]
<vector 3d>			= [<double>,<double>,<double>]
<matrix 3d>			= [ [<double>,<double>,<double>],[<double>,<double>,<double>],[<double>,<double>,<double>] ]
<tracking curve>		= [<vector 2d>,<vector2d>...]
<survey mode>			= "SURVEY_FREE"|"SURVEY_APPROX"|"SURVEY_EXACT"|"SURVEY_LINEUP"
<calc mode>			= "CALC_OFF"|"CALC_PASSIVE"|"CALC_ACTIVE"
<curve mode>			= "ROTPOS_CURVES"|"ZOOM_CURVES"|"STEREO_CURVES"|"DISTORTION_CURVES"
<tracking_mode>			= "TRACKING_PATTERN"|"TRACKING_MARKER"|"TRACKING_CORNER"
<tracking_direction>		= "TRACKING_FW"|"TRACKING_BW"|"TRACKING_FW_BW"
<para_type>			= "LDP_STRING"|"LDP_DOUBLE"|"LDP_INT"|"LDP_FILE"|"LDP_TOGGLE"|"LDP_DOUBLE_ADJUST"
<postfilter_mode>		= "POSTFILTER_OFF"|"POSTFILTER_SMOOTHING"|"POSTFILTER_SMOOTHING_FOURIER"
<stereo_mode>			= "STEREO_OFF"|"STEREO_PRIMARY"|"STEREO_SECONDARY"
<stereo_orientation>		= "STEREO_LEFT"|"STEREO_RIGHT"
<blur_mode>			= "BLUR_NONE"|"BLUR_3X3"|"BLUR_5X5"
<point_status>			= "POINT_KEYFRAME"|"POINT_KEYFRAME_END"|"POINT_OBSOLETE"|"POINT_TRACKED"|"POINT_INTERPOLATED"|"POINT_UNDEFINED"
<hom_calc_mode>			= "HOM_TY"|"HOM_STY"|"HOM_RTY"|"HOM_SRTY"|"HOM_SRTYP"|"HOM_T"|"HOM_ST"|"HOM_RT"|"HOM_SRT"|"HOM_SRTP"|"HOM_HOM"
<stereo_interocular>		= "STEREO_IO_STATIC"|"STEREO_IO_DYNAMIC"
<focal length mode>		= "FOCAL_USE_FROM_LENS"|"FOCAL_STATIC"|"FOCAL_DYNAMIC"
<focus mode>			= "FOCUS_USE_FROM_LENS"|"FOCUS_STATIC"|"FOCUS_DYNAMIC"
<matrix_point_status>		= "MATRIX_POINT_RELEASED"|"MATRIX_POINT_USER"|"MATRIX_POINT_AUTO"
<widget_attach_mode>		= "ATTACH_WIDGET"|"ATTACH_OPPOSITE_WIDGET"|"ATTACH_WINDOW"|"ATTACH_OPPOSITE_WINDOW"|"ATTACH_POSITION"|"ATTACH_NONE"|"ATTACH_AS_IS"
<ref_pattern_mode>		= "REF_PATTERN_PREVIOUS_FRAME"|"REF_PATTERN_PREVIOUS_KEYFRAME"|"REF_PATTERN_FIRST_KEYFRAME"|"REF_PATTERN_EXPLICIT_FRAME"
<parameter_type>		= "ADJUST_LENS_FBACK_WIDTH"|"ADJUST_LENS_FBACK_HEIGHT"|"ADJUST_LENS_FOCAL_LENGTH"|"ADJUST_LENS_FILM_ASPECT"|"ADJUST_LENS_LCO_X"|"ADJUST_LENS_LCO_Y"|
				  "ADJUST_LENS_PIXEL_ASPECT"|"ADJUST_LENS_CUSTOM_FOCUS"|"ADJUST_LENS_DISTORTION_PARAMETER"|"ADJUST_CAMERA_SYNC_TIMESHIFT"|"ADJUST_CAMERA_STEREO_VERTICAL_SHIFT"|
				  "ADJUST_CAMERA_STEREO_DEPTH_SHIFT"|"ADJUST_CAMERA_STEREO_INTEROCULAR"|"ADJUST_CAMERA_ROLLING_SHUTTER"
<dynamic_distortion_mode>	= "DISTORTION_STATIC"|"DISTORTION_DYNAMIC_FOCAL_LENGTH"|"DISTORTION_DYNAMIC_FOCUS_DISTANCE"
<script_call_hint>		= "CALL_COMMAND_LINE"|"CALL_WIDGET_CALLBACK"|"CALL_UPDATE_CALLBACK"|"CALL_CREATE_NEW_POINT_CALLBACK"|"CALL_GUI_CONTEXT_MENU"|"CALL_GUI_MENU"|"CALL_GUI_BUTTON"|"CALL_STARTUP"
<sync_mode>			= "SYNC_OFF"|"SYNC_PRIMARY"|"SYNC_SECONDARY"
<bf_culling_mode>		= "BF_CULLING_OFF"|"BF_CULLING_REGULAR"|"BF_CULLING_INVERTED"


############
# misc...

<3de_install_path>		get3DEInstallPath()
<3de_version>			get3DEVersion()

<vector 2d>			removeDistortion2D(<camera_id>, <frame>, <vector 2d>)
<vector 2d>			applyDistortion2D(<camera_id>, <frame>, <vector 2d>)

[m00,m01,m10,m11]		getDistortion2DJacobianMatrix(<camera_id>, <frame>, <vector 2d>)

[double,double,...]		filter1D([double,double,...], <cutoff>, "FOURIER_FILTER"|"GAUSS_FILTER")

<double>			acos(<double>)
<double>			asin(<double>)
<double>			atan2(<double>, <double>)
<double>			cos(<double>)
<double>			sin(<double>)
<double>			sqrt(<double>)

<matrix 3d>			calcHomography2D([<vector 2d>,<vector 2d>,...], [<vector 2d>,<vector 2d>,...], [<weight>,<weight>,...], <pivot 2d>, <hom_calc_mode>)

<string>			getProjectNotes()
				setProjectNotes(<string>)
				
<double>			getNearClippingPlane()
				setNearClippingPlane(<double>)
<double>			getFarClippingPlane()
				setFarClippingPlane(<double>)
				
0|1				checkPointConsistency2D(<pgroup_id>, <point_id>, <camera_id>, <frame_a>, <frame_b>, <sensitivity>)
				
[<matrix 3d>,<vector 3d>]	alignPlaneToPoints3D([<vector 3d>,<vector 3d>,...])



########################################
# custom gui, requester and widgets...

<int>				postQuestionRequester(<window title>, <message>, <label 0>, <label 1> ,...)
<path>				postFileRequester(<window title>, <filter_pattern>, <default path>)

				postProgressRequesterAndContinue(<window title>, <message>, <max_progress>, <label 0>, <label 1> ,...)
<int>				updateProgressRequester(<progress>, <message>)
				unpostProgressRequester()

<requester id>			createCustomRequester()
				deleteCustomRequester(<requester id>)
<int>				postCustomRequester(<requester id>, <window title>, <width>, <height>, <label 0>, <label 1> ,...)
				postCustomRequesterAndContinue(<requester id>, <window title>, <width>, <height>, <update callback function name>)
				unpostCustomRequester(<requester id>)

				addFileWidget(<requester id>, <widget name>, <label>, <filter_pattern>, <default path>)

				addTextFieldWidget(<requester id>, <widget name>, <label>, <default string>)

				addToggleWidget(<requester id>, <widget name>, <label>, 0|1)

				addOptionMenuWidget(<requester id>, <widget name>, <label>, <string 1>, <string 2> ,...)
				modifyOptionMenuWidget(<requester id>, <widget name>, <label>, <string 1>, <string 2> ,...)

				addScaleWidget(<requester id>, <widget name>, <label>, "INT"|"DOUBLE", <min>, <max>, <default value>)

				addButtonWidget(<requester id>, <widget name>, <label>, <width>, <offset>, <right_of_widget>)

				addSeparatorWidget(<requester id>, <widget name>)

				addListWidget(<requester id>, <widget name>, <label>, <multi_selection>, <height>)
				insertListWidgetItem(<requester id>, <widget name>, <label>, <userdata>)
				removeListWidgetItem(<requester id>, <widget name>, <item_index>)
				removeAllListWidgetItems(<requester id>, <widget name>)
<number_of_items>		getListWidgetNoItems(<requester id>, <widget name>)
<label>				getListWidgetItemLabel(<requester id>, <widget name>, <item_index>)
<userdata>			getListWidgetItemUserdata(<requester id>, <widget name>, <item_index>)
0|1				getListWidgetItemSelectionFlag(<requester id>, <widget name>, <item_index>)
				setListWidgetItemSelectionFlag(<requester id>, <widget name>, <item_index>, 0|1)
				centerListWidgetFirstSelectedItem(<requester id>, <widget name>)

				addCurveAreaWidget(<requester id>, <widget name>, <label>, <height>)
				setCurveAreaWidgetDimensions(<requester id>, <widget name>, <x_min>, <x_max>, <y_min>, <y_max>)
				setCurveAreaWidgetFOV(<requester id>, <widget name>, <x1>, <x2>, <y1>, <y2>)
				setCurveAreaWidgetCursorPosition(<requester id>, <widget name>, <x>, <stepping>)
<x>				getCurveAreaWidgetCursorPosition(<requester id>, <widget name>)
				attachCurveAreaWidgetCurve(<requester id>, <widget name>, <curve_id>, <red>, <green>, <blue>, <editable>)
				detachCurveAreaWidgetCurve(<requester id>, <widget name>, <curve_id>)
				detachCurveAreaWidgetAllCurves(<requester id>, <widget name>)
[<curve_id>,<curve_id>,...]	getCurveAreaWidgetCurveList(<requester id>, <widget name>)
				setCurveAreaWidgetXOffset(<requester id>, <widget name>, <x_offset>)

				addMenuBarWidget(<requester id>, <widget name>)
				addMenuWidget(<requester id>, <widget name>, <label>, <parent widget>, <mutual exclude toggles>)
				addMenuButtonWidget(<requester id>, <widget name>, <label>, <parent widget>)
				addMenuToggleWidget(<requester id>, <widget name>, <label>, <parent widget>, 0|1)
				addMenuSeparator(<requester id>, <widget name>, <parent widget>)
				
				addTextAreaWidget(<requester id>, <widget name>, <label>, <height>, <editable>)
				appendTextAreaWidgetString(<requester id>, <widget name>, <string>)
				clearTextAreaWidget(<requester id>, <widget name>)
<string>			getTextAreaWidgetString(<requester id>, <widget name>)
				setTextAreaWidgetCursorPosition(<requester id>, <widget name>, <position>)
<position>			getTextAreaWidgetCursorPosition(<requester id>, <widget name>)
				setTextAreaWidgetSelection(<requester id>, <widget name>, <start>, <end>)
[<start>, <end>]		getTextAreaWidgetSelection(<requester id>, <widget name>)
				setTextAreaWidgetScrollPosition(<requester id>, <widget name>, <position>)
<position>			getTextAreaWidgetScrollPosition(<requester id>, <widget name>)
				
				
				removeWidget(<requester id>, <widget name>)
0|1				widgetExists(<requester id>, <widget name>)

<value>				getWidgetValue(<requester id>, <widget name>)
0|1				setWidgetValue(<requester id>, <widget name>, <string>)

<function name>			getWidgetCallbackFunction(<requester id>, <widget name>)
				setWidgetCallbackFunction(<requester id>, <widget name>, <function name>)

0|1				getWidgetSensitiveFlag(<requester id>, <widget name>)
				setWidgetSensitiveFlag(<requester id>, <widget name>, 0|1)
				
				setWidgetSize(<requester id>, <widget name>, <width>, <height>)
				setWidgetOffsets(<requester id>, <widget name>, <left offset>, <right offset>, <top offset>, <bottom offset>)
				setWidgetLinks(<requester id>, <widget name>, <left link>, <right link>, <top link>, <bottom link>)
				setWidgetAttachModes(<requester id>, <widget name>, <left mode>, <right mode>, <top mode>, <bottom mode>)
				
				setWidgetShortcut(<requester id>, <widget name>, <shortcut opcode>)
				
				setWidgetFGColor(<requester id>, <widget name>, <r>, <g>, <b>)
				setWidgetBGColor(<requester id>, <widget name>, <r>, <g>, <b>)
				setWidgetHLColor(<requester id>, <widget name>, <r>, <g>, <b>)
				restoreWidgetDefaultColors(<requester id>, <widget name>)
				
<label>				getWidgetLabel(<requester id>, <widget name>)
				setWidgetLabel(<requester id>, <widget name>, <label>)



##############################################
# interaction with regular user interface...
				
<pgroup_id>			getCurrentPGroup()
<camera_id>			getCurrentCamera()
<frame>				getCurrentFrame(<camera_id>)

				setCurrentPGroup(<pgroup_id>)
				setCurrentCamera(<camera_id>)
<frame>				setCurrentFrame(<camera_id>, <frame>)

<object_id>			getContextMenuObject()
<object_id>			getContextMenuParentObject()

<script_call_hint>		getCurrentScriptCallHint()

<curve_id>			getFirstCurrentCurve()
<curve_id>			getNextCurrentCurve(<curve_id>)

<curve mode>			getCurrentCurveMode()

				pushCurrentCurvesToUndoStack()
				
				pushPointsToUndoStack()
				
				setCreateNewPointCallbackFunction(<function name>)
				
<absolute_path>			getProjectPath()
0|1				isProjectUpToDate()
0|1				loadProject(<absolute_path>)
0|1				saveProject(<absolute_path>)

0|1				calcAllFromScratch()

				updateGUI()
			
				clearConsole()
				
0|1				importBufferCompressionFile(<camera_id>)

				calcMatchFrame(<pgroup_id>, <camera_id>, <frame>)
				
0|1				saveRenderCacheFrame(<camera_id>, <frame>, <filename>, "IMAGE_JPEG"|"IMAGE_TIFF"|"IMAGE_PNG", <image_scale>, <overscan>, <x_offset>, <y_offset>, <window_width>, <window_height>)
				clearRenderCache()
				
<string>			getClipboardString()
				setClipboardString(<string>)

				
##########################
# 2D tracking engine...

				setTrackEngineMode(<tracking_mode>)
				setTrackEngineFlags(<enhanced_mode>, <comp_lum_changes>, <allow_rotation>, <allow_scaling>)
				setTrackEngineRGBWeights(<red>, <blue>, <green>)
				setTrackEngineBlurring(<blur_mode>)
				
				setTrackEnginePattern(<camera_id>, <frame>, <point_2d>, <search_2d>, <pattern_2d>, <offset_2d>, <rot>)
				setTrackEngineRefPattern(<camera_id>, <frame>, <point_2d>, <pattern_2d>, <offset_2d>, <rot>)
				
				setTrackEngineCustomTransform(<matrix 3d>)
				
<vector 2d>			runTrackEngineProcedure("TRACK_ENGINE_USE_DEFAULT_TRANSFORM"|"TRACK_ENGINE_USE_CUSTOM_TRANSFORM"|"TRACK_ENGINE_CALC_TRANSFORM_FROM_SCRATCH")
				
<double>			getTrackEngineProcedureDeviation()
<matrix 3d>			getTrackEngineProcedureTransform()


<vector 2d>			runMatrixTrackingProcedure(<camera_id>, <frame>, <start_vector_2d>, <search_area_width>, <search_area_height>)



###########################
# Parameter Adjustment...

0|1				getParameterAdjustFlag(<db_obj id>, <parameter_type>, <lens_distortion_para_name>)
				setParameterAdjustFlag(<db_obj id>, <parameter_type>, <lens_distortion_para_name>, 0|1)
				removeAllAdjustParameters()



##################
# scene node...

<vector 3d>			getScenePosition3D()
<matrix 3d>			getSceneRotation3D()
<double>			getSceneScale3D()
				setScenePosition3D(<vector 3d>)
				setSceneRotation3D(<matrix 3d>)
				setSceneScale3D(<double>)



####################
# point groups...

<pgroup_id>			createPGroup("CAMERA"|"OBJECT"|"MOCAP")
				deletePGroup(<pgroup_id>)
"CAMERA"|"OBJECT"|"MOCAP"	getPGroupType(<pgroup_id>)
<pgroup_id>			getFirstPGroup()
<pgroup_id>			getNextPGroup(<pgroup_id>)
[<pgroup_id>,<pgroup_id>,...]	getPGroupList(<selected_only>)
<number_of_pgroups>		getNoPGroups()
<pgroup_id>			getIndexPGroup(<index>)
0|1				getPGroupSelectionFlag(<pgroup_id>)
				setPGroupSelectionFlag(<pgroup_id>, 0|1)
0|1				getPGroupEnabledFlag(<pgroup_id>)
				setPGroupEnabledFlag(<pgroup_id>, 0|1)
<name>				getPGroupName(<pgroup_id>)
				setPGroupName(<pgroup_id>, <name>)
<double>			getPGroupDeviation(<pgroup_id>, <camera_id>, <frame>)
				setPGroupDeviation(<pgroup_id>, <camera_id>, <frame>, <double>)
<double>			getPGroupAverageDeviation(<pgroup_id>, <camera_id>)
				setPGroupAverageDeviation(<pgroup_id>, <camera_id>, <double>)
<vector 3d>			getPGroupPosition3D(<pgroup_id>, <camera_id>, <frame>)
<matrix 3d>			getPGroupRotation3D(<pgroup_id>, <camera_id>, <frame>)
<double>			getPGroupScale3D(<pgroup_id>)
				setPGroupScale3D(<pgroup_id>, <double>)
				setPGroupPosition3D(<pgroup_id>, <camera_id>, <frame>, <vector 3d>)
				setPGroupRotation3D(<pgroup_id>, <camera_id>, <frame>, <matrix 3d>)
				filterPGroup(<pgroup_id>, <camera_id>)
<postfilter_mode>		getPGroupPostfilterMode(<pgroup_id>)
				setPGroupPostfilterMode(<pgroup_id>, <postfilter_mode>)
0|1				getPGroupLineup3DPoseFlag(<pgroup_id>, <camera_id>, <frame>)
<vector 3d>			getPGroupLineup3DPosePosition(<pgroup_id>, <camera_id>, <frame>)
<matrix 3d>			getPGroupLineup3DPoseRotation(<pgroup_id>, <camera_id>, <frame>)


###############
# cameras...

<camera_id>			createCamera("SEQUENCE"|"REF_FRAME")
				deleteCamera(<camera_id>)
"SEQUENCE"|"REF_FRAME"		getCameraType(<camera_id>)
<camera_id>			getFirstCamera()
<camera_id>			getNextCamera(<camera_id>)
[<camera_id>,<camera_id>,...]	getCameraList(<selected_only>)
<number_of_cameras>		getNoCameras()
<camera_id>			getIndexCamera(<index>)
0|1				getCameraSelectionFlag(<camera_id>)
				setCameraSelectionFlag(<camera_id>, 0|1)
0|1				getCameraEnabledFlag(<camera_id>)
				setCameraEnabledFlag(<camera_id>, 0|1)
<double>			getCameraFocalLength(<camera_id>, <frame>)
				setCameraFocalLength(<camera_id>, <frame>, <double>)
<name>				getCameraName(<camera_id>)
				setCameraName(<camera_id>, <name>)
<number_of_frames>		getCameraNoFrames(<camera_id>)
<path>				getCameraPath(<camera_id>)
				setCameraPath(<camera_id>, <path>)
[<start>,<end>,<step>]		getCameraSequenceAttr(<camera_id>)
				setCameraSequenceAttr(<camera_id>, <start>, <end>, <step>)
<double>			getCameraFPS(<camera_id>)
				setCameraFPS(<camera_id>, <double>)
<lens_id>			getCameraLens(<camera_id>)
				setCameraLens(<camera_id>, <lens_id>)
0|1				getCameraZoomingFlag(<camera_id>)			# obsolete
				setCameraZoomingFlag(<camera_id>, 0|1)			# obsolete
<curve_id>			getCameraZoomCurve(<camera_id>)
<image_width>			getCameraImageWidth(<camera_id>)
				setCameraImageWidth(<camera_id>, <image_width>)
<image_height>			getCameraImageHeight(<camera_id>)
				setCameraImageHeight(<camera_id>, <image_height>)
[<xa>,<xb>,<ya>,<yb>]		getCameraFOV(<camera_id>)
				setCameraFOV(<camera_id>, <xa>, <xb>, <ya>, <yb>)
<time_shift>			getCameraTimeshift(<camera_id>)
<curve_id>			getCameraStereoInterocularCurve(<camera_id>)
[<x0>,<x1>,<y0>,<y1>]		getCameraMatrixDimensions(<camera_id>)
				setCameraMatrixDimensions(<camera_id>, <x0>, <x1>, <y0>, <y1>)
<vector 2d>			getCameraMatrixPointPos(<camera_id>, <x>, <y>)
				setCameraMatrixPointPos(<camera_id>, <x>, <y>, <vector 2d>)
0|1				getCameraMatrixPointValidFlag(<camera_id>, <x>, <y>)
				setCameraMatrixPointValidFlag(<camera_id>, <x>, <y>, 0|1)
<matrix_point_status>		getCameraMatrixPointStatus(<camera_id>, <x>, <y>)
				setCameraMatrixPointStatus(<camera_id>, <x>, <y>, <matrix_point_status>)
<stereo_mode>			getCameraStereoMode(<camera_id>)
				setCameraStereoMode(<camera_id>, <stereo_mode>)
<stereo_orientation>		getCameraStereoOrientation(<camera_id>)
				setCameraStereoOrientation(<camera_id>, <stereo_orientation>)
<stereo_interocular>		getCameraStereoInterocular(<camera_id>)
				setCameraStereoInterocular(<camera_id>, <stereo_interocular>)
<proxy_footage>			getCameraProxyFootage(<camera_id>)
				setCameraProxyFootage(<camera_id>, <proxy_footage>)
				setCameraPlaybackRange(<camera_id>, <start>, <end>)
[<start>, <end>]		getCameraPlaybackRange(<camera_id>)
				setCameraCalculationRange(<camera_id>, <start>, <end>)
[<start>, <end>]		getCameraCalculationRange(<camera_id>)
				setCameraFrameRangeCalculationFlag(<camera_id>, 0|1)
0|1				getCameraFrameRangeCalculationFlag(<camera_id>)
<focal length mode>		getCameraFocalLengthMode(<camera_id>)
				setCameraFocalLengthMode(<camera_id>, <focal length mode>)
<focus mode>			getCameraFocusMode(<camera_id>)
				setCameraFocusMode(<camera_id>, <focus mode>)
<double>			getCameraFocus(<camera_id>, <frame>)
				setCameraFocus(<camera_id>, <frame>, <double>)
<curve_id>			getCameraFocusCurve(<camera_id>)
<double>			getCameraStereoStaticInterocular(<camera_id>)
				setCameraStereoStaticInterocular(<camera_id>, <double>)
<double>			getCameraStereoStaticVerticalShift(<camera_id>)
				setCameraStereoStaticVerticalShift(<camera_id>, <double>)
<double>			getCameraStereoStaticDepthShift(<camera_id>)
				setCameraStereoStaticDepthShift(<camera_id>, <double>)
0|1				getCameraRollingShutterEnabledFlag(<camera_id>)
				setCameraRollingShutterEnabledFlag(<camera_id>, 0|1)
<double>			getCameraRollingShutterTimeShift(<camera_id>)
				setCameraRollingShutterTimeShift(<camera_id>, <double>)
<frame_offset>			getCameraFrameOffset(<camera_id>)
				setCameraFrameOffset(<camera_id>, <frame_offset>)
<sync_mode>			getCameraSyncMode(<camera_id>)
				setCameraSyncMode(<camera_id>, <sync_mode>)



##############
# points...

<point_id>			createPoint(<pgroup_id>)
				deletePoint(<pgroup_id>, <point_id>)
<point_id>			getFirstPoint(<pgroup_id>)
<point_id>			getLastPoint(<pgroup_id>)
<point_id>			getNextPoint(<pgroup_id>, <point_id>, <use_gui_order>)
<point_id>			getPrevPoint(<pgroup_id>, <point_id>, <use_gui_order>)
[<point_id>,<point_id>,...]	getPointList(<pgroup_id>, <selected_only>)
<number_of_points>		getNoPoints(<pgroup_id>)
<point_id>			getIndexPoint(<pgroup_id>, <index>)
<point_id>			findPointByName(<pgroup_id>, <name>)
<name>				getPointName(<pgroup_id>, <point_id>)
				setPointName(<pgroup_id>, <point_id>, <name>)
0|1				getPointSelectionFlag(<pgroup_id>, <point_id>)
				setPointSelectionFlag(<pgroup_id>, <point_id>, 0|1)
<vector 3d>			getPointSurveyPosition3D(<pgroup_id>, <point_id>)
				setPointSurveyPosition3D(<pgroup_id>, <point_id>, <vector 3d>)
<vector 3d>			getPointCalcPosition3D(<pgroup_id>, <point_id>)
				setPointCalcPosition3D(<pgroup_id>, <point_id>, <vector 3d>)
<vector 3d>			getPointMoCapSurveyPosition3D(<pgroup_id>, <point_id>, <camera_id>, <frame>)
				setPointMoCapSurveyPosition3D(<pgroup_id>, <point_id>, <camera_id>, <frame>, <vector 3d>)
<vector 3d>			getPointMoCapCalcPosition3D(<pgroup_id>, <point_id>, <camera_id>, <frame>)
				setPointMoCapCalcPosition3D(<pgroup_id>, <point_id>, <camera_id>, <frame>, <vector 3d>)
<survey mode>			getPointSurveyMode(<pgroup_id>, <point_id>)
				setPointSurveyMode(<pgroup_id>, <point_id>, <survey mode>)
<calc mode>			getPointCalcMode(<pgroup_id>, <point_id>)
				setPointCalcMode(<pgroup_id>, <point_id>, <calc mode>)
<double>			getPointWeight(<pgroup_id>, <point_id>)
				setPointWeight(<pgroup_id>, <point_id>, <double>)
<vector 2d>			getPointPosition2D(<pgroup_id>, <point_id>, <camera_id>, <frame>)
				setPointPosition2D(<pgroup_id>, <point_id>, <camera_id>, <frame>, <vector 2d>)
<tracking curve>		getPointPosition2DBlock(<pgroup_id>, <point_id>, <camera_id>, <start frame>, <end frame>)
				setPointPosition2DBlock(<pgroup_id>, <point_id>, <camera_id>, <start frame>, <tracking curve>)
0|1				isPointPos2DValid(<pgroup_id>, <point_id>, <camera_id>, <frame>)
				deletePointCurve2D(<pgroup_id>, <point_id>, <camera_id>)
0|1				isPointCalculated3D(<pgroup_id>, <point_id>)
				setPointCalculated3D(<pgroup_id>, <point_id>, 0|1)
<double>			getPointDeviation(<pgroup_id>, <point_id>, <camera_id>, <frame>)
				setPointDeviation(<pgroup_id>, <point_id>, <camera_id>, <frame>, <double>)
<color_index>			getPointColor2D(<pgroup_id>, <point_id>)
				setPointColor2D(<pgroup_id>, <point_id>, <color_index>)
<color_index>			getPointColor3D(<pgroup_id>, <point_id>)
				setPointColor3D(<pgroup_id>, <point_id>, <color_index>)
<vector 3d>			calcPointPosition3D(<pgroup_id>, <point_id>, <camera_id>)
<vector 2d>			calcPointBackProjection2D(<pgroup_id>, <point_id>, <camera_id>, <frame>, <with_distortion>)
<tracking_mode>			getPointTrackingMode(<pgroup_id>, <point_id>)
				setPointTrackingMode(<pgroup_id>, <point_id>, <tracking_mode>)
<tracking_direction>		getPointTrackingDirection(<pgroup_id>, <point_id>)
				setPointTrackingDirection(<pgroup_id>, <point_id>, <tracking_direction>)
				shiftPointPositions2D(<pgroup_id>, <point_id>, <camera_id>, <shift>)
				setPointTrackingBoxes2D(<pgroup_id>, <point_id>, <camera_id>, <frame>, <search>, <pattern>, <offset>, <rot>)
[<s>,<p>,<o>,<r>]		getPointTrackingBoxes2D(<pgroup_id>, <point_id>, <camera_id>, <frame>) 
				setPointStatus2D(<pgroup_id>, <point_id>, <camera_id>, <frame>, "POINT_KEYFRAME"|"POINT_KEYFRAME_END"|"POINT_OBSOLETE"|"POINT_TRACKED"|"POINT_INTERPOLATED")
<point_status>			getPointStatus2D(<pgroup_id>, <point_id>, <camera_id>, <frame>)
				setPointTrackingTransform(<pgroup_id>, <point_id>, <camera_id>, <frame>, <forward_pass>, <matrix 3d>)
<matrix 3d>			getPointTrackingTransform(<pgroup_id>, <point_id>, <camera_id>, <frame>, <forward_pass>)
0|1				getPointAutoTrackingFlag(<pgroup_id>, <point_id>)
0|1				getPointInfiniteDistantFlag(<pgroup_id>, <point_id>)
				setPointInfiniteDistantFlag(<pgroup_id>, <point_id>, 0|1)
<set_id>			getPointSet(<pgroup_id>, <point_id>)
				setPointSet(<pgroup_id>, <point_id>, <set_id>)
0|1				getPointHideFlag(<pgroup_id>, <point_id>)
				setPointHideFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointLockFlag(<pgroup_id>, <point_id>, <camera_id>)
				setPointLockFlag(<pgroup_id>, <point_id>, <camera_id>, 0|1)			
0|1				getPointEnhancedTrackingFlag(<pgroup_id>, <point_id>)
				setPointEnhancedTrackingFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointLuminanceChangesFlag(<pgroup_id>, <point_id>)
				setPointLuminanceChangesFlag(<group_id>, <point_id>, 0|1)
0|1				getPointRotatePatternFlag(<pgroup_id>, <point_id>)
				setPointRotatePatternFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointScalePatternFlag(<pgroup_id>, <point_id>)
				setPointScalePatternFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointCreateAutoKeyframesFlag(<pgroup_id>, <point_id>)
				setPointCreateAutoKeyframesFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointStopLowQualityTrackingFlag(<pgroup_id>, <point_id>)
				setPointStopLowQualityTrackingFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointSplineBoxesFlag(<pgroup_id>, <point_id>)
				setPointSplineBoxesFlag(<pgroup_id>, <point_id>, 0|1)
0|1				getPointValidOutsideFOVFlag(<pgroup_id>, <point_id>)
				setPointValidOutsideFOVFlag(<pgroup_id>, <point_id>, 0|1)
<blur_mode>			getPointBlurring(<pgroup_id>, <point_id>)
				setPointBlurring(<pgroup_id>, <point_id>, <blur_mode>)
<double>			getPointAutoKeyframeSensitivity(<pgroup_id>, <point_id>)
				setPointAutoKeyframeSensitivity(<pgroup_id>, <point_id>, <double>)
<ref_pattern_mode>		getPointReferencePatternMode(<pgroup_id>, <point_id>)
				setPointReferencePatternMode(<pgroup_id>, <point_id>, <ref_pattern_mode>)
<frame>				getPointReferencePatternExplicitFrame(<pgroup_id>, <point_id>)
				setPointReferencePatternExplicitFrame(<pgroup_id>, <point_id>, <frame>)
[<red>, <green>, <blue>]	getPointRGBWeights(<pgroup_id>, <point_id>)
				setPointRGBWeights(<pgroup_id>, <point_id>, <red>, <green>, <blue>)
				splinePointPositions2D(<pgroup_id>, <point_id>, <camera_id>)
0|1				getPointTimelineHideFlag(<pgroup_id>, <point_id>, <camera_id>)
				setPointTimelineHideFlag(<pgroup_id>, <point_id>, <camera_id>, 0|1)			

				

##############
# sets...
				
<set_id>			createSet(<pgroup_id>)
				deleteSet(<pgroup_id>, <set_id>)
[<set_id>,<set_id>,...]		getSetList(<pgroup_id>, <selected_only>)
<name>				getSetName(<pgroup_id>, <set_id>)
				setSetName(<pgroup_id>, <set_id>, <name>)
0|1				getSetSelectionFlag(<pgroup_id>, <set_id>)
				setSetSelectionFlag(<pgroup_id>, <set_id>, 0|1)
[<point_id>,<point_id>,...]	getSetPointList(<pgroup_id>, <set_id>)



##############
# lenses & lens distortion models...

<lens_id>			createLens()
				deleteLens(<lens_id>)
<lens_id>			getFirstLens()
<lens_id>			getNextLens(<lens_id>)
[<lens_id>,<lens_id>,...]	getLensList(<selected_only>)
<number_of_lenses>		getNoLenses()
<lens_id>			getIndexLens(<index>)
0|1				getLensSelectionFlag(<lens_id>)
				setLensSelectionFlag(<lens_id>, 0|1)
<name>				getLensName(<lens_id>)
				setLensName(<lens_id>, <name>)
<value>				getLensFBackWidth(<lens_id>)
				setLensFBackWidth(<lens_id>, <value>)
<value>				getLensFBackHeight(<lens_id>)
				setLensFBackHeight(<lens_id>, <value>)
<value>				getLensFocalLength(<lens_id>)
				setLensFocalLength(<lens_id>, <value>)
<value>				getLensFilmAspect(<lens_id>)
				setLensFilmAspect(<lens_id>, <value>)
<value>				getLensLensCenterX(<lens_id>)
				setLensLensCenterX(<lens_id>, <value>)
<value>				getLensLensCenterY(<lens_id>)
				setLensLensCenterY(<lens_id>, <value>)
<value>				getLensPixelAspect(<lens_id>)
				setLensPixelAspect(<lens_id>, <value>)
<value>				getLensHorizAngle(<lens_id>)
<value>				getLensVertiAngle(<lens_id>)
<value>				getLensFocus(<lens_id>)
				setLensFocus(<lens_id>, <value>)

<dyn_distortion_mode>		getLensDynamicDistortionMode(<lens_id>)
				setLensDynamicDistortionMode(<lens_id>, <dyn_distortion_mode>)
				
0|1				getLensDynamicDistortionFlag(<lens_id>)					# obsolete
				setLensDynamicDistortionFlag(<lens_id>, 0|1)				# obsolete

<value>				getLensDistortion(<lens_id>, <focal_length_or_focus>)			# obsolete
				setLensDistortion(<lens_id>, <focal_length_or_focus>, <value>)		# obsolete
<value>				getLensAnamorphSqueeze(<lens_id>, <focal_length_or_focus>)		# obsolete
				setLensAnamorphSqueeze(<lens_id>, <focal_length_or_focus>, <value>)	# obsolete
<value>				getLensCurvatureX(<lens_id>, <focal_length_or_focus>)			# obsolete
				setLensCurvatureX(<lens_id>, <focal_length_or_focus>, <value>)		# obsolete
<value>				getLensCurvatureY(<lens_id>, <focal_length_or_focus>)			# obsolete
				setLensCurvatureY(<lens_id>, <focal_length_or_focus>, <value>)		# obsolete
<value>				getLensQuarticDistortion(<lens_id>, <focal_length_or_focus>)		# obsolete
				setLensQuarticDistortion(<lens_id>, <focal_length_or_focus>, <value>)	# obsolete
<curve_id>			getLensDistortionCurve(<lens_id>)					# obsolete
<curve_id>			getLensAnamorphSqueezeCurve(<lens_id>)					# obsolete
<curve_id>			getLensCurvatureXCurve(<lens_id>)					# obsolete
<curve_id>			getLensCurvatureYCurve(<lens_id>)					# obsolete
<curve_id>			getLensQuarticDistortionCurve(<lens_id>)				# obsolete

<model>				getLensLDModel(<lens_id>)
				setLensLDModel(<lens_id>, <model>)
<double>			getLensLDAdjustableParameter(<lens_id>, <para_name>, <focal_length_or_focus_distance>)
				setLensLDAdjustableParameter(<lens_id>, <para_name>, <focal_length_or_focus_distance>, <double>)
<curve_id>			getLensLDAdjustableParameterCurve(<lens_id>, <para_name>)
<value>				getLensLDRegularParameter(<lens_id>, <para_name>)
				setLensLDRegularParameter(<lens_id>, <para_name>, <string>)

<number_of_parameters>		getLDModelNoParameters(<model>)
<para_name>			getLDModelParameterName(<model>, <index>)
<para_type>			getLDModelParameterType(<model>, <para_name>)
<value>				getLDModelParameterDefault(<model>, <para_name>)
[<a>, <b>]			getLDModelParameterRange(<model>, <para_name>)



##############
# curves...

<curve_id>			createCurve()
				deleteCurve(<curve_id>)
<key_id>			createCurveKey(<curve_id>, <vector 2d>)
				deleteCurveKey(<curve_id>, <key_id>)
				deleteAllCurveKeys(<curve_id>)
<double>			evaluateCurve(<curve_id>, <x>)
<key_id>			getFirstCurveKey(<curve_id>)
<key_id>			getNextCurveKey(<curve_id>, <key_id>)
<key_id>			getPrevCurveKey(<curve_id>, <key_id>)
[<key_id>,<key_id>,...]		getCurveKeyList(<curve_id>, <selected_only>)
<number_of_curve_keys>		getNoCurveKeys(<curve_id>)
0|1				getCurveKeySelectionFlag(<curve_id>, <key_id>)
<vector 2d>			getCurveKeyPosition(<curve_id>, <key_id>)
				setCurveKeyPosition(<curve_id>, <key_id>, <vector 2d>)
<vector 2d>			getCurveKeyTangent1(<curve_id>, <key_id>)
				setCurveKeyTangent1(<curve_id>, <key_id>, <vector 2d>)
<vector 2d>			getCurveKeyTangent2(<curve_id>, <key_id>)
				setCurveKeyTangent2(<curve_id>, <key_id>, <vector 2d>)
"LINEAR"|"BROKEN"|"SMOOTH"	getCurveKeyMode(<curve_id>, <key_id>)
				setCurveKeyMode(<curve_id>, <key_id>, "LINEAR"|"BROKEN"|"SMOOTH")
0|1				getCurveKeyFixedXFlag(<curve_id>, <key_id>)
				setCurveKeyFixedXFlag(<curve_id>, <key_id>, 0|1)
			


###########
# geo...

<geo_id>			createGeo(<pgroup_id>)
				deleteGeo(<pgroup_id>, <geo_id>)
<geo_id>			getFirstGeo(<pgroup_id>)
<geo_id>			getNextGeo(<pgroup_id>, <geo_id>)
[<geo_id>,<geo_id>,...]		getGeoList(<pgroup_id>, <selected_only>)
0|1				getGeoSelectionFlag(<pgroup_id>, <geo_id>)
				setGeoSelectionFlag(<pgroup_id>, <geo_id>, 0|1)
<name>				getGeoName(<pgroup_id>, <geo_id>)
				setGeoName(<pgroup_id>, <geo_id>, <name>)
[<vector 3d>,<vector 3d>,...]	getGeoPointList(<pgroup_id>, <geo_id>, <camera_id>, <frame>)
				addGeoPoint(<pgroup_id>, <geo_id>, <point_id>, <offset 3d>)
[<r>, <g>, <b>]			getGeoColor(<pgroup_id>, <geo_id>)
				setGeoColor(<pgroup_id>, <geo_id>, <r>, <g>, <b>)



################
# 3d models...



<model_id>			create3DModel(<pgroup_id>, <initial_number_of_vertices>)
				delete3DModel(<pgroup_id>, <model_id>)
0|1				importOBJ3DModel(<pgroup_id>, <model_id>, <path_to_obj>)
<model_id>			getFirst3DModel(<pgroup_id>)
<model_id>			getNext3DModel(<pgroup_id>, <model_id>)
[<model_id>,<model_id>,...]	get3DModelList(<pgroup_id>, <selected_only>)
0|1				get3DModelSelectionFlag(<pgroup_id>, <model_id>)
				set3DModelSelectionFlag(<pgroup_id>, <model_id>, 0|1)
<name>				get3DModelName(<pgroup_id>, <model_id>)
				set3DModelName(<pgroup_id>, <model_id>, <name>)
0|1				get3DModelSurveyFlag(<pgroup_id>, <model_id>)
				set3DModelSurveyFlag(<pgroup_id>, <model_id>, 0|1)
0|1				get3DModelReferenceFlag(<pgroup_id>, <model_id>)
				set3DModelReferenceFlag(<pgroup_id>, <model_id>, 0|1)
<path_to_obj>			get3DModelFilepath(<pgroup_id>, <model_id>)
<vector 3d>			get3DModelPosition3D(<pgroup_id>, <model_id>, <camera_id>, <frame>)
				set3DModelPosition3D(<pgroup_id>, <model_id>, <vector 3d>)
<matrix 3d>			get3DModelRotationScale3D(<pgroup_id>, <model_id>)
				set3DModelRotationScale3D(<pgroup_id>, <model_id>, <matrix 3d>)
<number_of_vertices>		get3DModelNoVertices(<pgroup_id>, <model_id>)
<vector 3d>			get3DModelVertex(<pgroup_id>, <model_id>, <vertex_index>, <camera_id>, <frame>)
				set3DModelVertex(<pgroup_id>, <model_id>, <vertex_index>, <vector 3d>)
<number_of_lines>		get3DModelNoLines(<pgroup_id>, <model_id>)
[<index0>,<index1>,...]		get3DModelLineVertexIndices(<pgroup_id>, <model_id>, <line_index>)
<number_of_faces>		get3DModelNoFaces(<pgroup_id>, <model_id>)
[<index0>,<index1>,...]		get3DModelFaceVertexIndices(<pgroup_id>, <model_id>, <face_index>)
				removeAll3DModelGeometryData(<pgroup_id>, <model_id>)
<vertex_index>			add3DModelVertex(<pgroup_id>, <model_id>, <vector 3d>)
				add3DModelLine(<pgroup_id>, <model_id>, [<index0>,<index1>,...])
				add3DModelFace(<pgroup_id>, <model_id>, [<index0>,<index1>,...])
				remove3DModelLine(<pgroup_id>, <model_id>, <line_index>)
				remove3DModelFace(<pgroup_id>, <model_id>, <face_index>)
				set3DModelSnappingPoint(<pgroup_id>, <model_id>, <point_id>)
<point_id>			get3DModelSnappingPoint(<pgroup_id>, <model_id>)
0|1				get3DModelVisibleFlag(<pgroup_id>, <model_id>)
				set3DModelVisibleFlag(<pgroup_id>, <model_id>, 0|1)
[<r>,<g>,<b>,<a>]		get3DModelColor(<pgroup_id>, <model_id>)
				set3DModelColor(<pgroup_id>, <model_id>, <r>, <g>, <b>, <a>)
[<points>,<lines>,<polygons>]	get3DModelRenderingFlags(<pgroup_id>, <model_id>)
				set3DModelRenderingFlags(<pgroup_id>, <model_id>, <show_points>, <show_lines>, <show_polygons>)
0|1				get3DModelHiddenLinesFlag(<pgroup_id>, <model_id>)
				set3DModelHiddenLinesFlag(<pgroup_id>, <model_id>, 0|1)
<bf_culling_mode>		get3DModelBackfaceCullingMode(<pgroup_id>, <model_id>)
				set3DModelBackfaceCullingMode(<pgroup_id>, <model_id>, <bf_culling_mode>)
[<r>,<g>,<b>,<a>]		get3DModelVertexColor(<pgroup_id>, <model_id>, <vertex_index>)
				set3DModelVertexColor(<pgroup_id>, <model_id>, <vertex_index>, <r>, <g>, <b>, <a>)
0|1				get3DModelPerVertexColorsFlag(<pgroup_id>, <model_id>)
				set3DModelPerVertexColorsFlag(<pgroup_id>, <model_id>, 0|1)
<proxy_geometry>		get3DModelProxyGeometry(<pgroup_id>, <model_id>)
				set3DModelProxyGeometry(<pgroup_id>, <model_id>, <proxy_geometry>)
0|1				get3DModelMapFootageFlag(<pgroup_id>, <model_id>)
				set3DModelMapFootageFlag(<pgroup_id>, <model_id>, 0|1)
0|1				get3DModelPointLinksFlag(<pgroup_id>, <model_id>)
				set3DModelPointLinksFlag(<pgroup_id>, <model_id>, 0|1)
<point_id>			get3DModelPointLink(<pgroup_id>, <model_id>, <vertex_index>)
				set3DModelPointLink(<pgroup_id>, <model_id>, <vertex_index>, <point_id>)