Script
Public Slots | Public Member Functions | List of all members
copyPaste Class Reference

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

#include <copypasteinterface.h>

Inheritance diagram for copyPaste:
Inheritance graph
[legend]
Collaboration diagram for copyPaste:
Collaboration graph
[legend]

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: