Implement the copy paste interface, which is available to the scripting environment. More...

#include <copypasteinterface.h>

Inheritance diagram for copyPaste:

Collaboration diagram for copyPaste:

Public Slots
QString	createTemplateFromSelection (QString name, const QString &path)

void	useCreateTemplateSpecial (bool flag, bool addModellingDir=true, bool addScanFiles=true, bool includeDefaultCameraName=true)

bool	pasteTemplateIntoScene (const QString &templateSrcPath, QString insertColumnName, int insertFrame)

bool	pasteActionTemplateIntoNode (const QString &templateSrcPath, QString nodeName, int insertFrame)

void	usePasteSpecial (bool flag)

void	setExtendScene (bool flag)

Module Section
void	setPasteSpecialCreateNewColumn (bool flag)

void	setPasteSpecialElementTimingColumnMode (QString mode)

Pegs and Functions Section
void	setPasteSpecialAddRemoveMotionKeyFrame (bool flag)

void	setPasteSpecialAddRemoveVelocityKeyFrame (bool flag)

void	setPasteSpecialAddRemoveAngleKeyFrame (bool flag)

void	setPasteSpecialAddRemoveSkewKeyFrame (bool flag)

void	setPasteSpecialAddRemoveScalingKeyFrame (bool flag)

void	setPasteSpecialForcesKeyFrameAtBegAndEnd (bool flag)

void	setPasteSpecialOffsetKeyFrames (bool flag)

void	setPasteSpecialReplaceExpressionColumns (bool flag)

Drawings Section
void	setPasteSpecialDrawingAction (QString mode)

void	setPasteSpecialDrawingFileMode (QString mode)

void	setPasteSpecialDrawingAutomaticExtendExposure (bool extendExposure, bool keyFrameMode)

void	setPasteSpecialColorPaletteOption (QString mode)

Misc section
void	setPasteSpecialCopyScanFiles (bool copy)

void	setPasteSpecialCopyModelDir (bool copy)

void	setPasteSpecialTVPreserveName (bool preserve)

void	setPasteSpecialDefaultCameraName (bool flag)

void	setStartFrameSrc (int startFrame)

void	setNumFramesSrc (int nFrames)

Public Member Functions
	copyPaste (QObject parent, const char name)

Detailed Description

Implement the copy paste interface, which is available to the scripting environment.

Constructor & Destructor Documentation

copyPaste::copyPaste	(	QObject *	parent,
		const char *	name
	)

Member Function Documentation

QString copyPaste::createTemplateFromSelection	(	QString	name,
		const QString &	path
	)

slot

Creates template from the current selection in the scene, using only the current drawing versions

Parameters

name	= name of new template
path	= location of new template

bool copyPaste::pasteActionTemplateIntoNode	(	const QString &	templateSrcPath,
		QString	nodeName,
		int	insertFrame
	)

slot

Pastes the action template into the scene

Parameters

templateSrcPath	- path of the template
insertColumnName	- name of existing node in which we will insert template
insertFrame	- frame at which insert commences

bool copyPaste::pasteTemplateIntoScene	(	const QString &	templateSrcPath,
		QString	insertColumnName,
		int	insertFrame
	)

slot

Pastes the template into the scene

Parameters

templateSrcPath	- path of the template
insertColumnName	- name of existing column in which we will insert template
insertFrame	- frame at which insert commences

void copyPaste::setExtendScene ( bool flag )

slot

void copyPaste::setNumFramesSrc ( int nFrames )

slot

void copyPaste::setPasteSpecialAddRemoveAngleKeyFrame ( bool flag )

slot

void copyPaste::setPasteSpecialAddRemoveMotionKeyFrame ( bool flag )

slot

void copyPaste::setPasteSpecialAddRemoveScalingKeyFrame ( bool flag )

slot

void copyPaste::setPasteSpecialAddRemoveSkewKeyFrame ( bool flag )

slot

void copyPaste::setPasteSpecialAddRemoveVelocityKeyFrame ( bool flag )

slot

void copyPaste::setPasteSpecialColorPaletteOption ( QString mode )

slot

Acceptable Strings are: DO_NOTHING REUSE_PALETTES COPY_AND_OVERWRITE_EXISTING_PALETTES COPY_AND_CREATE_NEW_PALETTES COPY_AND_CREATE_NEW_PALETTES_IN_ELEMENT_FOLDER COPY_PALETTE_AND_MERGE_COLOURS COPY_PALETTE_AND_UPDATE_COLOURS LINK_TO_ORIGINAL COPY_SCENE_PALETTE_AND_MERGE_COLOURS COPY_SCENE_PALETTE_AND_UPDATE_COLOURS

void copyPaste::setPasteSpecialCopyModelDir ( bool copy )

slot

void copyPaste::setPasteSpecialCopyScanFiles ( bool copy )

slot

void copyPaste::setPasteSpecialCreateNewColumn ( bool flag )

slot

void copyPaste::setPasteSpecialDefaultCameraName ( bool flag )

slot

Use this when you want the camera in a template to be set as default camera in the target scene. Note that this is not necessary if there is NO camera assigned in the target scene, as the incoming camera will automatically be set as default camera.

void copyPaste::setPasteSpecialDrawingAction ( QString mode )

slot

Drawings action Acceptable Strings are: DO_NOTHING ADD_OR_REMOVE_EXPOSURE UPDATE_PIVOT

void copyPaste::setPasteSpecialDrawingAutomaticExtendExposure	(	bool	extendExposure,
		bool	keyFrameMode
	)

slot

void copyPaste::setPasteSpecialDrawingFileMode ( QString mode )

slot

Sets the drawing file mode - only used if the DrawingAction is set to ADD_OR_REMOVE_EXPOSURE Acceptable Strings are: NEVER_CREATE ONLY_CREATE_IF_DOES_NOT_EXIST ALWAYS_CREATE ALWAYS_CREATE_AND_VERSION_IF_NECESSARY

void copyPaste::setPasteSpecialElementTimingColumnMode ( QString mode )

slot

Sets the paste special elementtiming mode for calls to pasteTemplateIntoScene Acceptable strings are:

ELEMENT_AS_ELEMENT_AND_TIMING_AS_TIMING ALL_DRWGS_AS_ELEMENTS ALL_DRWGS_LINKED_THRU_TIMING_COLS

void copyPaste::setPasteSpecialForcesKeyFrameAtBegAndEnd ( bool flag )

slot

void copyPaste::setPasteSpecialOffsetKeyFrames ( bool flag )

slot

void copyPaste::setPasteSpecialReplaceExpressionColumns ( bool flag )

slot

void copyPaste::setPasteSpecialTVPreserveName ( bool preserve )

slot

void copyPaste::setStartFrameSrc ( int startFrame )

slot

When pasting an external template or local content, these two functions controls the # of frames and the start frame of the content that will be pasted.

The default start frame is 1, which means that it will be pasting starting from the first frame of the copied content. Set this to a value >= 1 to specific the frame to use as a starting frame.

The default number of frames is 0, which effectively turn off this override feature and make it paste the entire copied content length. Set this length to anything >0 to override the number of frames pasted.

Must be using the paste special mode.

void copyPaste::useCreateTemplateSpecial	(	bool	flag,
		bool	addModellingDir = `true`,
		bool	addScanFiles = `true`,
		bool	includeDefaultCameraName = `true`
	)

slot

Allows 2 extra options in the template creation

Parameters

addModellingDir	- copies the modelling directory into the template
addScanFiles	- copies the *.scans that match the drawings
includeDefaultCameraName	- Deprecated in 7.8. As long as the camera node is in the selection, it will be copied into the template automatically.

void copyPaste::usePasteSpecial ( bool flag )

slot

Enables PasteSpecial This is a STATIC structure - once initialized it may be re-used for the duration of the session By default, it is NOT used until usePasteSpecial(true) is called

The structure defaults are:

extendScene = false

MODULE createNewColumn = false elementTimingColumnMode = ELEMENT_AS_ELEMENT_AND_TIMING_AS_TIMING

PEG add/remove motion KF = true add/remove velocity KF = true add/remove angle KF = true add/remove skew KF = true add/remove scaling KF = true force keyframes at functions beginning and end = true offset keyframes = false; replace expression columns = true

DRAWING drawing action = add or remove exposure

PALETTE palette mode = REUSE_PALETTES

SRC FRAMES start frame source = 1 - start frame frame of the copied sequenced). num frame source = 0 - 0 indicate to use the original length of the source

If Drawing add/remove exposure is set, the following modes are available drawing file mode = ALWAYS_CREATE if the preference LIBRARY_PASTE_CREATE_NEW_DRAWING is set, otherwise it is ONLY_CREATE_IF_DOES_NOT_EXIST automatically extend exposure = false drawing as key frame = true ( note, only used if automatic extend exposure = true )

The documentation for this class was generated from the following file:

dox_files/copypasteinterface.h

Public Slots

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation