CH_Manager Class Reference

#include <CH_Manager.h>

Inheritance diagram for CH_Manager:

CMD_Manager OP_CommandManager

List of all members.

Public Types

enum  CollisionBehaviour { CH_ON_COLLISION_RENAME, CH_ON_COLLISION_MERGE, CH_ON_COLLISION_REPLACE, CH_ON_COLLISION_ASSERT }
enum  ExpansionType { CH_EXPANSION_TYPE_EXPRESSION = 1, CH_EXPANSION_TYPE_VARIABLE = 1 << 1, CH_EXPANSION_TYPE_DEFAULT }
typedef CollisionBehaviour(* CBCallback )(CH_Group *source, CH_Group *target)

Public Member Functions

 CH_Manager (int initTheExpressionLibrary=1)
virtual ~CH_Manager ()
virtual void setContext ()
int condenseCommon (UT_String &path)
void resetPlayback ()
void resetChannelOptions ()
bool loadChannelOptions (const char *filename)
bool saveChannelOptions (const char *filename)
void setDefaultExpression (const char *s)
const char * getDefaultExpression () const
void setDefaultRotationExpression (const char *s)
const char * getDefaultRotationExpression () const
void setAutoSlope (bool onoff)
bool getAutoSlope () const
void setDefaultSlope (fpreal slope)
fpreal getDefaultSlope () const
void setAutoSplit (bool onoff)
bool getAutoSplit () const
void setDefaultSplitExpression (const char *expr)
const char * getDefaultSplitExpression () const
void setHoldLastKey (bool onoff)
int getHoldLastKey () const
const char * getChanCreateKeyExpression () const
void setChanCreateKeyExpression (const char *s)
bool getAlwaysCommitKeyChange () const
void setAlwaysCommitKeyChange (bool onoff)
bool getSegCacheStatus () const
void setSegCacheStatus (bool onoff)
void clearChannelScope ()
void getScopedChannels (CH_ChannelList &channels, bool sorted=false)
int getNumScopedChanRefs () const
void getScopedChanRefs (CH_ChannelRefList &chanrefs, unsigned mask=0, bool sorted=false) const
void getSelectedScopedChanRefs (CH_ChannelRefList &chanrefs, bool sorted=false, int operateOn=CH_SELECTED)
void getScopedChannelsKeyFrames (UT_IntArray &frames, int minframe, int maxframe)
void blockModifyScope (int on_off)
void scopeChannel (const CH_ChannelRef &chref, bool on_off)
void scopeChannel (const char *full_chan_path, bool on_off)
bool scopeChannelInternal (CH_Channel *chp, bool on_off)
bool scopeChannelInternal (const CH_ChannelRef &chref, bool on_off)
void unscopeChannelsWithNodeId (int node_id, bool force=false)
void scopeChanged (unsigned flags, bool propagate=true)
bool isChannelScoped (CH_Channel *chp) const
bool isChannelScoped (const char *full_chan_path) const
bool isChannelScoped (const CH_ChannelRef &chref) const
void clearPendingChannels ()
void getPendingChannels (CH_ChannelList &channels)
void addPendingChannel (CH_Channel *chp)
void removePendingChannel (CH_Channel *chp)
bool isChannelDisplayed (const CH_ChannelRef &chref) const
bool isChannelDisplayed (const char *full_chan_path) const
void clearDisplayedChannels (bool propagate=true)
void displayAllScopedChannels (bool propagate=true)
void displaySelectedScopedChannels (bool propagate=true)
void displayChannel (const CH_ChannelRef &chref, bool propagate=true)
void displayChannel (const char *full_chan_path, bool propagate=true)
void undisplayChannel (const CH_ChannelRef &chref, bool propagate=true)
void undisplayChannel (const char *full_chan_path, bool propagate=true)
bool isChannelSelected (const CH_ChannelRef &chref) const
bool isChannelSelected (const char *full_chan_path) const
void clearSelectedChannels (bool propagate=true)
void selectAllScopedChannels (bool propagate=true)
void selectChannel (const CH_ChannelRef &chref, bool propagate=true)
void selectChannel (const char *full_chan_path, bool propagate=true)
void deselectChannel (const CH_ChannelRef &chref, bool propagate=true)
void deselectChannel (const char *full_chan_path, bool propagate=true)
void togglePinAllScopedChannels ()
void togglePinScopedChannels (CH_ChannelRefList chanrefs)
void pinAllScopedChannels (bool propagate=true)
void unpinAllScopedChannels (bool propagate=true)
void pinSelectedChannels (bool propagate=true, int operateOn=CH_SELECTED)
void unpinSelectedChannels (bool propagate=true, int operateOn=CH_SELECTED)
void pinChannels (CH_ChannelRefList chanrefs, bool propagate=true)
void unpinChannels (CH_ChannelRefList chanrefs, bool propagate=true)
void setChannelFlags (const CH_ChannelRef &chref, unsigned flags, bool on_off, bool propagate=true)
unsigned getChannelFlags (const CH_ChannelRef &chref) const
int expandString (const char *string, UT_String &expanded, fpreal time, CH_Collection *local=0, int thread=0, int expansion_type=CH_EXPANSION_TYPE_DEFAULT)
void buildStringOpDependencies (const char *str, void *ref_id, CH_Collection *locals, int thread)
bool changeStringOpRef (UT_String &str, const char *new_fullpath, const char *old_fullpath, const char *old_cwd, const char *chan_name, const char *old_chan_name, CH_Collection *locals, int thread)
fpreal evaluate (const char *expr, fpreal now, CH_Collection *local=0, int *frame_dep=0, int thread=0, CH_ExprLanguage language=CH_OLD_EXPR_LANGUAGE)
int evaluateString (const char *expr, UT_String &result, fpreal now, CH_Collection *local=0, int thread=0, CH_ExprLanguage language=CH_OLD_EXPR_LANGUAGE)
bool getIsSettingGlobalParam () const
void getGlobalParamF (const char *token, CH_Collection *scope, fpreal &result, fpreal def, int thread, bool add_dependencies)
void getGlobalParamS (const char *token, CH_Collection *scope, UT_String &result, const char *def, int thread, bool add_dependencies)
int setGlobalFloatParam (const char *token, fpreal val, CH_Collection *&owner)
int setGlobalStringParam (const char *token, const char *strval, CH_Collection *&owner)
int removeGlobalParamOwner (CH_Collection *owner)
void dumpGlobalParams (ostream &out) const
void dirtyOrphanGlobalParamDependents (const char *token, CH_Collection *scope, bool recurse, UT_HashTable *dependents)
bool getIsSettingGuideParam () const
void addGroup (CH_Group *group, int doRename=1)
void renameOpInGroups (const char *full_from, const char *full_to)
void sortGroups ()
CH_Group * getTopGroup () const
CH_Group * findGroup (const char *const_path, bool create=false, CH_Group *head=0)
void findGroups (CH_GroupList &groups, const char *pattern, bool minimal)
void findChannelsFromGroups (CH_ChannelList &channels, const char *pattern)
void findChanRefsFromGroups (CH_ChannelRefList &chanrefs, const char *pattern)
CH_GroupList getSelectedGroups ()
CH_Group * getCurrentGroup ()
void updateGroupSelection (const CH_GroupList &groups, void *by, bool propagate=true)
void updateGroupSelectionFromScoped (void *by, bool propagate=true)
void updateCurrentGroup (CH_Group *group, void *by, bool propagate=true)
void enforceLeafOnlyChannels (CH_Group *group, const char *name="new_group")
CH_Group * createGroup (const char *const_path, bool doRename=true, CH_Group *head=0)
void renameGroup (CH_Group *group, const char *newname)
void deleteGroup (CH_Group *group)
void extractGroup (CH_Group *group, CollisionBehaviour cb)
CH_Group * collapseGroups (CH_GroupList const &groups, const char *name)
void collapseChildren (CH_Group *parent)
void copyIntoGroup (CH_Group *source, CH_Group *target, CollisionBehaviour cb, const char *new_name=0)
void moveIntoGroup (CH_Group *source, CH_Group *target, CollisionBehaviour cb, const char *new_name=0)
void addToGroup (CH_Group *source, CH_Group *target, CollisionBehaviour cb)
void mergeWithGroup (CH_Group *source, CH_Group *target, CollisionBehaviour cb)
void channelCreated (const CH_Channel *chp)
void channelDeleted (const CH_Channel *chp)
void saveGroup (CH_Group *g, ostream &os, int binary)
CH_Group * loadGroup (UT_IStream &is)
CH_ExprLanguage getDefaultExprLanguage ()
void setDefaultExprLanguage (CH_ExprLanguage language)
void timeGroupsChanged ()
void addTimeGroup (CH_TimeGroup *group, bool doRename=true, bool force=false)
void destroyTimeGroup (const CH_TimeGroup *group)
void destroyTimeGroup (int i)
void renameTimeGroup (CH_TimeGroup *group, const char *newname, bool force=false)
int getNTimeGroups () const
CH_TimeGroup * getTimeGroup (int i)
const CH_TimeGroup * getTimeGroup (int i) const
CH_TimeGroup * getTimeGroup (const char *name)
const CH_TimeGroup * getTimeGroup (const char *name) const
int getTimeGroupIdx (const char *name) const
int niceFrameSeparation (fpreal initialSep, int minimumSep=1) const
void stretchCollections (CH_Collection *from, fpreal ostart, fpreal oend)
fpreal getNumSamples () const
void setRawNumSamples (int n)
fpreal getSamplesPerSec () const
void setSamplesPerSec (fpreal fps)
fpreal getSecsPerSample () const
void setRawSamplesPerSec (fpreal fps)
fpreal getGlobalStart () const
fpreal getGlobalEnd () const
int getGlobalStartFrame () const
int getGlobalEndFrame () const
void setGlobalTime (fpreal start, fpreal end)
void setRawInterpolation (int state)
int getRawInterpolation ()
fpreal getTolerance () const
fpreal getTime (fpreal sample) const
fpreal getSampleRaw (fpreal t) const
fpreal getSample (fpreal t) const
int getFrame (fpreal t) const
fpreal getTimeDelta (fpreal sample_delta) const
fpreal getSampleDelta (fpreal time_delta) const
fpreal getSnapToFrameTime (fpreal t) const
fpreal getSnapSample (fpreal frame) const
fpreal getSnapToFrameDelta (fpreal base_time, fpreal time_delta) const
bool getIsAtFrame (fpreal t) const
void getTimeCode (char *buf, fpreal t)
int setTimeCode (const char *buf, fpreal &t)
void setTimeCodeOffset (fpreal t)
fpreal getTimeCodeOffset (fpreal) const
int getIntegerFrameFlag () const
void setIntegerFrameFlag (int flag)
int getRestrictRangeFlag () const
void setRestrictRangeFlag (int flag)
int getShowRangeFlag () const
void setShowRangeFlag (int flag)
int getShowTicksFlag () const
void setShowTicksFlag (int flag)
int getShowAudioFlag () const
void setShowAudioFlag (int flag)
int getShowKeysFlag () const
void setShowKeysFlag (int flag)
fpreal getAudioLevel () const
void setAudioLevel (fpreal lvl)
fpreal getUnitLength () const
void setUnitLength (fpreal unitlength)
fpreal getUnitMass () const
void setUnitMass (fpreal unitmass)
void parseUnitsString (const char *units, fpreal &distexp, fpreal &massexp) const
fpreal scaleToMKS (const char *fromunits) const
fpreal scaleFromMKS (const char *tounits) const
int getRealTimeFlag () const
void setRealTimeFlag (int flag)
fpreal getRealTimeFactor () const
void setRealTimeFactor (fpreal f)
bool getRealTimeDisableSkip () const
void setRealTimeDisableSkip (bool b)
fpreal getSampleStep () const
void setSampleStep (fpreal s)
void getSampleRange (fpreal &start, fpreal &end)
void setSampleRange (fpreal start, fpreal end)
int getHoldFlag () const
void setHoldFlag (int flag)
int saveChannels (const char *filename, bool binary, bool compiled, const CH_ChannelList &channels, bool displayed=false) const
int loadChannels (const char *filename, const char *src_pattern, const char *dest_pattern, bool use_range, const fpreal *tstart, const fpreal *tend, CH_CollectionList &parents, bool delete_keys=false, CH_ChannelRefList *displayed_parms=NULL)
void addExpressionDefine (CH_ExprDefine *def)
void setEvalCollection (CH_Collection *g, int thread)
CH_Collection * getEvalCollection (int thread) const
void setRootCollection (CH_Collection *root)
CH_Collection * getRootCollection () const
virtual CH_ScriptAccessManager * getAccessManager (int)
SYS_DEPRECATED fpreal getEvaluateTime () const
CH_LocalVariable * getLocalVariableTable () const
bool getVariableValue (UT_String &str, int i, int thread) const
bool getVariableValue (fpreal &val, int i, int thread) const
bool getVariableValue (int &val, int i, int thread) const
virtual bool getVariableString (const char *name, UT_String &value, int &timeDepend, int thread)
void removeParamDependency (CH_Collection *coll)
virtual CH_Channel * getChRefChannel (const CH_ChannelRef &r) const
virtual bool isOwnerExposed (const CH_ChannelRef &r) const
virtual bool buildChanRef (CH_ChannelRef &r, const CH_Channel *chp) const
 Use this method to build a channel reference from a channel pointer.
virtual bool buildChanRef (CH_ChannelRef &r, const char *path) const
 Use this method to build a channel reference from a channel path.
bool buildChannelRefs (CH_ChannelRefList &reflist, const CH_ChannelList &chlist)
bool buildChannelRefs (CH_ChannelRefList &reflist, const UT_StringArray &chlist)
virtual int compareChanRefs (const CH_ChannelRef &r1, const CH_ChannelRef &r2) const
virtual void getChanRefPath (const CH_ChannelRef &r, UT_String &path, bool use_alias=false) const
 Use this method to get the full path of the channel referenced by r.
void changeReferencesToNodeId (int old_id, int new_id)
void removeReferencesToNodeId (int node_id)
void displayScope () const
fpreal evalBezierFunc (int thread)
fpreal evalConstantFunc (int thread)
fpreal evalCubicFunc (int thread)
fpreal evalCycleFunc (fpreal start_frame, fpreal end_frame, int thread)
fpreal evalCycletFunc (fpreal start_frame, fpreal end_frame, int thread)
fpreal evalCycleOffsetFunc (fpreal start_frame, fpreal end_frame, int thread)
fpreal evalCycleOffsettFunc (fpreal start_frame, fpreal end_frame, int thread)
fpreal evalEaseFunc (int thread)
fpreal evalEaseinFunc (int thread)
fpreal evalEaseinpFunc (fpreal ease_speed, int thread)
fpreal evalEaseoutFunc (int thread)
fpreal evalEaseoutpFunc (fpreal ease_speed, int thread)
fpreal evalEasepFunc (fpreal ease_speed, int thread)
fpreal evalLinearFunc (int thread)
fpreal evalMatchFunc (int thread)
fpreal evalMatchinFunc (int thread)
fpreal evalMatchoutFunc (int thread)
fpreal evalQcubicFunc (int thread)
fpreal evalQlinearFunc (int thread)
fpreal evalQuinticFunc (int thread)
fpreal evalRepeatFunc (fpreal start_frame, fpreal end_frame, int thread)
fpreal evalRepeattFunc (fpreal start_frame, fpreal end_frame, int thread)
fpreal evalSplineFunc (int thread)
fpreal evalVmatchFunc (int thread)
fpreal evalVmatchinFunc (int thread)
fpreal evalVmatchoutFunc (int thread)
fpreal getEvaluateTime (int thread) const
 Functions for obtaining and setting the current evaluation time.
void setEvaluateTime (fpreal time, int thread)
 Functions for obtaining and setting the current evaluation time.

Static Public Member Functions

static CH_Manager * getContext ()
static bool getContextExists ()
static CH_KeyState getKeyState (fpreal gtime, const CH_ChannelList &channels, bool loose=false)
static void getUniqueCollections (const CH_ChannelList &channels, CH_CollectionList &collections)
static bool makeGroupPathValid (UT_String &path)
static bool makeGroupNameValid (UT_String &path)
static bool couldExpandString (const char *str)
static fpreal niceNumber (fpreal num, int digits=3)
static fpreal getDefaultFPS ()
static fpreal getDefaultLength (fpreal fps)
static fpreal getDefaultLengthFrames (fpreal fps)
static bool readCHNFileHeader (UT_IStream &is, bool quiet, fpreal32 &version, int &binary, bool &is_fp64, fpreal64 &tstart, fpreal64 &tend)
static bool skipCHNFileHeaderForCollection (UT_IStream &is, bool &is_fp64)
static bool getFileType (const char *filename, int &raw, int &binary)
static bool printFileInfo (ostream &os, const char *filename, CH_Collection *load_coll)
static void lookupVariable (const char *name, UT_String &val, int thread)
static void lookupVariableNoThread (const char *name, UT_String &val)
static void lookupExpression (const char *name, UT_String &val, int thread)
static void lookupExpressionNoThread (const char *name, UT_String &val)

Protected Member Functions

void initExpressionLibrary ()
void initLibraryGlue ()

Friends

class CH_SetGlobalParamScope
class CH_SetGuideParamScope

Detailed Description

Examples:

SOP/SOP_PrimVOP.C, and SOP/SOP_SParticle.C.

Definition at line 67 of file CH_Manager.h.

Member Typedef Documentation

typedef CollisionBehaviour(* CH_Manager::CBCallback)(CH_Group *source, CH_Group *target)

Definition at line 85 of file CH_Manager.h.

Member Enumeration Documentation

enum CH_Manager::CollisionBehaviour

Enumerator:
CH_ON_COLLISION_RENAME 
CH_ON_COLLISION_MERGE 
CH_ON_COLLISION_REPLACE 
CH_ON_COLLISION_ASSERT 

Definition at line 70 of file CH_Manager.h.

enum CH_Manager::ExpansionType

Enumerator:
CH_EXPANSION_TYPE_EXPRESSION 
CH_EXPANSION_TYPE_VARIABLE 
CH_EXPANSION_TYPE_DEFAULT 

Definition at line 78 of file CH_Manager.h.

Constructor & Destructor Documentation

CH_Manager::CH_Manager ( int  initTheExpressionLibrary = 1  ) 

virtual CH_Manager::~CH_Manager (  )  [virtual]

Member Function Documentation

void CH_Manager::addExpressionDefine ( CH_ExprDefine *  def  ) 

void CH_Manager::addGroup ( CH_Group *  group,
int  doRename = 1 
)

void CH_Manager::addPendingChannel ( CH_Channel *  chp  ) 

void CH_Manager::addTimeGroup ( CH_TimeGroup *  group,
bool  doRename = true,
bool  force = false 
)

void CH_Manager::addToGroup ( CH_Group *  source,
CH_Group *  target,
CollisionBehaviour  cb 
)

void CH_Manager::blockModifyScope ( int  on_off  ) 

bool CH_Manager::buildChannelRefs ( CH_ChannelRefList &  reflist,
const UT_StringArray &  chlist 
)

bool CH_Manager::buildChannelRefs ( CH_ChannelRefList &  reflist,
const CH_ChannelList &  chlist 
)

virtual bool CH_Manager::buildChanRef ( CH_ChannelRef &  r,
const char *  path 
) const [virtual]

Use this method to build a channel reference from a channel path.

Reimplemented in OP_CommandManager.

virtual bool CH_Manager::buildChanRef ( CH_ChannelRef &  r,
const CH_Channel *  chp 
) const [virtual]

Use this method to build a channel reference from a channel pointer.

Reimplemented in OP_CommandManager.

void CH_Manager::buildStringOpDependencies ( const char *  str,
void *  ref_id,
CH_Collection *  locals,
int  thread 
)

void CH_Manager::changeReferencesToNodeId ( int  old_id,
int  new_id 
)

bool CH_Manager::changeStringOpRef ( UT_String &  str,
const char *  new_fullpath,
const char *  old_fullpath,
const char *  old_cwd,
const char *  chan_name,
const char *  old_chan_name,
CH_Collection *  locals,
int  thread 
)

void CH_Manager::channelCreated ( const CH_Channel *  chp  ) 

void CH_Manager::channelDeleted ( const CH_Channel *  chp  ) 

void CH_Manager::clearChannelScope (  ) 

void CH_Manager::clearDisplayedChannels ( bool  propagate = true  ) 

void CH_Manager::clearPendingChannels (  ) 

void CH_Manager::clearSelectedChannels ( bool  propagate = true  ) 

void CH_Manager::collapseChildren ( CH_Group *  parent  ) 

CH_Group* CH_Manager::collapseGroups ( CH_GroupList const &  groups,
const char *  name 
)

virtual int CH_Manager::compareChanRefs ( const CH_ChannelRef &  r1,
const CH_ChannelRef &  r2 
) const [virtual]

Returns 0 if r1 and r2 are equal, returns -1 if r1 < r2 and returns 1 if r1 > r2.

Reimplemented in OP_CommandManager.

int CH_Manager::condenseCommon ( UT_String &  path  ) 

void CH_Manager::copyIntoGroup ( CH_Group *  source,
CH_Group *  target,
CollisionBehaviour  cb,
const char *  new_name = 0 
)

static bool CH_Manager::couldExpandString ( const char *  str  )  [static]

CH_Group* CH_Manager::createGroup ( const char *  const_path,
bool  doRename = true,
CH_Group *  head = 0 
)

void CH_Manager::deleteGroup ( CH_Group *  group  ) 

void CH_Manager::deselectChannel ( const char *  full_chan_path,
bool  propagate = true 
)

void CH_Manager::deselectChannel ( const CH_ChannelRef &  chref,
bool  propagate = true 
)

void CH_Manager::destroyTimeGroup ( int  i  ) 

void CH_Manager::destroyTimeGroup ( const CH_TimeGroup *  group  ) 

void CH_Manager::dirtyOrphanGlobalParamDependents ( const char *  token,
CH_Collection *  scope,
bool  recurse,
UT_HashTable *  dependents 
)

void CH_Manager::displayAllScopedChannels ( bool  propagate = true  ) 

void CH_Manager::displayChannel ( const char *  full_chan_path,
bool  propagate = true 
)

void CH_Manager::displayChannel ( const CH_ChannelRef &  chref,
bool  propagate = true 
)

void CH_Manager::displayScope (  )  const

void CH_Manager::displaySelectedScopedChannels ( bool  propagate = true  ) 

void CH_Manager::dumpGlobalParams ( ostream &  out  )  const

void CH_Manager::enforceLeafOnlyChannels ( CH_Group *  group,
const char *  name = "new_group" 
)

fpreal CH_Manager::evalBezierFunc ( int  thread  ) 

fpreal CH_Manager::evalConstantFunc ( int  thread  ) 

fpreal CH_Manager::evalCubicFunc ( int  thread  ) 

fpreal CH_Manager::evalCycleFunc ( fpreal  start_frame,
fpreal  end_frame,
int  thread 
)

fpreal CH_Manager::evalCycleOffsetFunc ( fpreal  start_frame,
fpreal  end_frame,
int  thread 
)

fpreal CH_Manager::evalCycleOffsettFunc ( fpreal  start_frame,
fpreal  end_frame,
int  thread 
)

fpreal CH_Manager::evalCycletFunc ( fpreal  start_frame,
fpreal  end_frame,
int  thread 
)

fpreal CH_Manager::evalEaseFunc ( int  thread  ) 

fpreal CH_Manager::evalEaseinFunc ( int  thread  ) 

fpreal CH_Manager::evalEaseinpFunc ( fpreal  ease_speed,
int  thread 
)

fpreal CH_Manager::evalEaseoutFunc ( int  thread  ) 

fpreal CH_Manager::evalEaseoutpFunc ( fpreal  ease_speed,
int  thread 
)

fpreal CH_Manager::evalEasepFunc ( fpreal  ease_speed,
int  thread 
)

fpreal CH_Manager::evalLinearFunc ( int  thread  ) 

fpreal CH_Manager::evalMatchFunc ( int  thread  ) 

fpreal CH_Manager::evalMatchinFunc ( int  thread  ) 

fpreal CH_Manager::evalMatchoutFunc ( int  thread  ) 

fpreal CH_Manager::evalQcubicFunc ( int  thread  ) 

fpreal CH_Manager::evalQlinearFunc ( int  thread  ) 

fpreal CH_Manager::evalQuinticFunc ( int  thread  ) 

fpreal CH_Manager::evalRepeatFunc ( fpreal  start_frame,
fpreal  end_frame,
int  thread 
)

fpreal CH_Manager::evalRepeattFunc ( fpreal  start_frame,
fpreal  end_frame,
int  thread 
)

fpreal CH_Manager::evalSplineFunc ( int  thread  ) 

fpreal CH_Manager::evaluate ( const char *  expr,
fpreal  now,
CH_Collection *  local = 0,
int *  frame_dep = 0,
int  thread = 0,
CH_ExprLanguage  language = CH_OLD_EXPR_LANGUAGE 
)

int CH_Manager::evaluateString ( const char *  expr,
UT_String &  result,
fpreal  now,
CH_Collection *  local = 0,
int  thread = 0,
CH_ExprLanguage  language = CH_OLD_EXPR_LANGUAGE 
)

fpreal CH_Manager::evalVmatchFunc ( int  thread  ) 

fpreal CH_Manager::evalVmatchinFunc ( int  thread  ) 

fpreal CH_Manager::evalVmatchoutFunc ( int  thread  ) 

int CH_Manager::expandString ( const char *  string,
UT_String &  expanded,
fpreal  time,
CH_Collection *  local = 0,
int  thread = 0,
int  expansion_type = CH_EXPANSION_TYPE_DEFAULT 
)

void CH_Manager::extractGroup ( CH_Group *  group,
CollisionBehaviour  cb 
)

void CH_Manager::findChannelsFromGroups ( CH_ChannelList &  channels,
const char *  pattern 
)

void CH_Manager::findChanRefsFromGroups ( CH_ChannelRefList &  chanrefs,
const char *  pattern 
)

CH_Group* CH_Manager::findGroup ( const char *  const_path,
bool  create = false,
CH_Group *  head = 0 
)

void CH_Manager::findGroups ( CH_GroupList &  groups,
const char *  pattern,
bool  minimal 
)

virtual CH_ScriptAccessManager* CH_Manager::getAccessManager ( int   )  [inline, virtual]

Reimplemented in OP_CommandManager.

Definition at line 700 of file CH_Manager.h.

bool CH_Manager::getAlwaysCommitKeyChange (  )  const [inline]

Definition at line 148 of file CH_Manager.h.

fpreal CH_Manager::getAudioLevel (  )  const [inline]

Definition at line 596 of file CH_Manager.h.

bool CH_Manager::getAutoSlope (  )  const [inline]

Definition at line 124 of file CH_Manager.h.

bool CH_Manager::getAutoSplit (  )  const [inline]

Definition at line 132 of file CH_Manager.h.

const char* CH_Manager::getChanCreateKeyExpression (  )  const [inline]

Definition at line 144 of file CH_Manager.h.

unsigned CH_Manager::getChannelFlags ( const CH_ChannelRef &  chref  )  const

virtual void CH_Manager::getChanRefPath ( const CH_ChannelRef &  r,
UT_String &  path,
bool  use_alias = false 
) const [virtual]

Use this method to get the full path of the channel referenced by r.

Reimplemented in OP_CommandManager.

virtual CH_Channel* CH_Manager::getChRefChannel ( const CH_ChannelRef &  r  )  const [virtual]

Use this method to translate a channel reference to a channel pointer. May return NULL if the channel reference does not reference a valid channel.

Reimplemented in OP_CommandManager.

static CH_Manager* CH_Manager::getContext (  )  [inline, static]

Reimplemented in CMD_Manager.

Definition at line 92 of file CH_Manager.h.

static bool CH_Manager::getContextExists (  )  [inline, static]

Reimplemented in CMD_Manager.

Definition at line 97 of file CH_Manager.h.

CH_Group* CH_Manager::getCurrentGroup (  ) 

const char* CH_Manager::getDefaultExpression (  )  const [inline]

Definition at line 113 of file CH_Manager.h.

CH_ExprLanguage CH_Manager::getDefaultExprLanguage (  )  [inline]

Definition at line 440 of file CH_Manager.h.

static fpreal CH_Manager::getDefaultFPS (  )  [static]

static fpreal CH_Manager::getDefaultLength ( fpreal  fps  )  [static]

static fpreal CH_Manager::getDefaultLengthFrames ( fpreal  fps  )  [static]

const char* CH_Manager::getDefaultRotationExpression (  )  const [inline]

Definition at line 120 of file CH_Manager.h.

fpreal CH_Manager::getDefaultSlope (  )  const [inline]

Definition at line 128 of file CH_Manager.h.

const char* CH_Manager::getDefaultSplitExpression (  )  const [inline]

Definition at line 137 of file CH_Manager.h.

CH_Collection* CH_Manager::getEvalCollection ( int  thread  )  const [inline]

Examples:
expr/channel.C, and SOP/SOP_PrimVOP.C.

Definition at line 677 of file CH_Manager.h.

SYS_DEPRECATED fpreal CH_Manager::getEvaluateTime (  )  const [inline]

The following function only remains for backwards compatibility of HDK users. Calls to this function should be replaced with one of the following forms: getEvaluateTime(context.getThread()) -> inside cooking code path getEvaluateTime(thread) -> in expression functions CHgetEvalTime() -> else without thread variable

Definition at line 716 of file CH_Manager.h.

fpreal CH_Manager::getEvaluateTime ( int  thread  )  const [inline]

Functions for obtaining and setting the current evaluation time.

Definition at line 704 of file CH_Manager.h.

static bool CH_Manager::getFileType ( const char *  filename,
int &  raw,
int &  binary 
) [static]

int CH_Manager::getFrame ( fpreal  t  )  const [inline]

Definition at line 531 of file CH_Manager.h.

fpreal CH_Manager::getGlobalEnd (  )  const [inline]

Definition at line 502 of file CH_Manager.h.

int CH_Manager::getGlobalEndFrame (  )  const [inline]

Definition at line 505 of file CH_Manager.h.

void CH_Manager::getGlobalParamF ( const char *  token,
CH_Collection *  scope,
fpreal &  result,
fpreal  def,
int  thread,
bool  add_dependencies 
)

void CH_Manager::getGlobalParamS ( const char *  token,
CH_Collection *  scope,
UT_String &  result,
const char *  def,
int  thread,
bool  add_dependencies 
)

fpreal CH_Manager::getGlobalStart (  )  const [inline]

Definition at line 501 of file CH_Manager.h.

int CH_Manager::getGlobalStartFrame (  )  const [inline]

Definition at line 503 of file CH_Manager.h.

int CH_Manager::getHoldFlag (  )  const [inline]

Definition at line 629 of file CH_Manager.h.

int CH_Manager::getHoldLastKey (  )  const [inline]

Definition at line 142 of file CH_Manager.h.

int CH_Manager::getIntegerFrameFlag (  )  const [inline]

Definition at line 578 of file CH_Manager.h.

bool CH_Manager::getIsAtFrame ( fpreal  t  )  const [inline]

Definition at line 564 of file CH_Manager.h.

bool CH_Manager::getIsSettingGlobalParam (  )  const [inline]

Definition at line 321 of file CH_Manager.h.

bool CH_Manager::getIsSettingGuideParam (  )  const [inline]

Definition at line 349 of file CH_Manager.h.

static CH_KeyState CH_Manager::getKeyState ( fpreal  gtime,
const CH_ChannelList &  channels,
bool  loose = false 
) [static]

CH_LocalVariable* CH_Manager::getLocalVariableTable (  )  const

int CH_Manager::getNTimeGroups (  )  const [inline]

Definition at line 464 of file CH_Manager.h.

fpreal CH_Manager::getNumSamples (  )  const [inline]

Definition at line 494 of file CH_Manager.h.

int CH_Manager::getNumScopedChanRefs (  )  const [inline]

Definition at line 166 of file CH_Manager.h.

void CH_Manager::getPendingChannels ( CH_ChannelList &  channels  ) 

int CH_Manager::getRawInterpolation (  )  [inline]

Definition at line 511 of file CH_Manager.h.

bool CH_Manager::getRealTimeDisableSkip (  )  const [inline]

Definition at line 613 of file CH_Manager.h.

fpreal CH_Manager::getRealTimeFactor (  )  const [inline]

Definition at line 611 of file CH_Manager.h.

int CH_Manager::getRealTimeFlag (  )  const [inline]

Definition at line 609 of file CH_Manager.h.

int CH_Manager::getRestrictRangeFlag (  )  const [inline]

Definition at line 581 of file CH_Manager.h.

CH_Collection* CH_Manager::getRootCollection (  )  const [inline]

Definition at line 698 of file CH_Manager.h.

fpreal CH_Manager::getSample ( fpreal  t  )  const [inline]

Examples:
OBJ/OBJ_Shake.C, SOP/SOP_CPPWave.C, SOP/SOP_PrimVOP.C, and SOP/SOP_SParticle.C.

Definition at line 526 of file CH_Manager.h.

fpreal CH_Manager::getSampleDelta ( fpreal  time_delta  )  const [inline]

Definition at line 541 of file CH_Manager.h.

void CH_Manager::getSampleRange ( fpreal &  start,
fpreal &  end 
) [inline]

Definition at line 618 of file CH_Manager.h.

fpreal CH_Manager::getSampleRaw ( fpreal  t  )  const [inline]

Definition at line 521 of file CH_Manager.h.

fpreal CH_Manager::getSamplesPerSec (  )  const [inline]

Examples:
SOP/SOP_PrimVOP.C.

Definition at line 496 of file CH_Manager.h.

fpreal CH_Manager::getSampleStep (  )  const [inline]

Definition at line 615 of file CH_Manager.h.

void CH_Manager::getScopedChannels ( CH_ChannelList &  channels,
bool  sorted = false 
)

void CH_Manager::getScopedChannelsKeyFrames ( UT_IntArray &  frames,
int  minframe,
int  maxframe 
)

void CH_Manager::getScopedChanRefs ( CH_ChannelRefList &  chanrefs,
unsigned  mask = 0,
bool  sorted = false 
) const

fpreal CH_Manager::getSecsPerSample (  )  const [inline]

Definition at line 498 of file CH_Manager.h.

bool CH_Manager::getSegCacheStatus (  )  const [inline]

Definition at line 152 of file CH_Manager.h.

CH_GroupList CH_Manager::getSelectedGroups (  ) 

void CH_Manager::getSelectedScopedChanRefs ( CH_ChannelRefList &  chanrefs,
bool  sorted = false,
int  operateOn = CH_SELECTED 
)

int CH_Manager::getShowAudioFlag (  )  const [inline]

Definition at line 590 of file CH_Manager.h.

int CH_Manager::getShowKeysFlag (  )  const [inline]

Definition at line 593 of file CH_Manager.h.

int CH_Manager::getShowRangeFlag (  )  const [inline]

Definition at line 584 of file CH_Manager.h.

int CH_Manager::getShowTicksFlag (  )  const [inline]

Definition at line 587 of file CH_Manager.h.

fpreal CH_Manager::getSnapSample ( fpreal  frame  )  const [inline]

Definition at line 552 of file CH_Manager.h.

fpreal CH_Manager::getSnapToFrameDelta ( fpreal  base_time,
fpreal  time_delta 
) const

fpreal CH_Manager::getSnapToFrameTime ( fpreal  t  )  const [inline]

Definition at line 546 of file CH_Manager.h.

fpreal CH_Manager::getTime ( fpreal  sample  )  const [inline]

Examples:
SOP/SOP_SParticle.C, and SOP/SOP_TimeCompare.C.

Definition at line 516 of file CH_Manager.h.

void CH_Manager::getTimeCode ( char *  buf,
fpreal  t 
)

fpreal CH_Manager::getTimeCodeOffset ( fpreal   )  const [inline]

Definition at line 576 of file CH_Manager.h.

fpreal CH_Manager::getTimeDelta ( fpreal  sample_delta  )  const [inline]

Definition at line 536 of file CH_Manager.h.

const CH_TimeGroup* CH_Manager::getTimeGroup ( const char *  name  )  const

CH_TimeGroup* CH_Manager::getTimeGroup ( const char *  name  ) 

const CH_TimeGroup* CH_Manager::getTimeGroup ( int  i  )  const [inline]

Definition at line 466 of file CH_Manager.h.

CH_TimeGroup* CH_Manager::getTimeGroup ( int  i  )  [inline]

Definition at line 465 of file CH_Manager.h.

int CH_Manager::getTimeGroupIdx ( const char *  name  )  const

fpreal CH_Manager::getTolerance (  )  const [inline]

Definition at line 514 of file CH_Manager.h.

CH_Group* CH_Manager::getTopGroup (  )  const

static void CH_Manager::getUniqueCollections ( const CH_ChannelList &  channels,
CH_CollectionList &  collections 
) [static]

fpreal CH_Manager::getUnitLength (  )  const [inline]

Definition at line 599 of file CH_Manager.h.

fpreal CH_Manager::getUnitMass (  )  const [inline]

Definition at line 601 of file CH_Manager.h.

virtual bool CH_Manager::getVariableString ( const char *  name,
UT_String &  value,
int &  timeDepend,
int  thread 
) [virtual]

Reimplemented in CMD_Manager.

bool CH_Manager::getVariableValue ( int &  val,
int  i,
int  thread 
) const

bool CH_Manager::getVariableValue ( fpreal &  val,
int  i,
int  thread 
) const

bool CH_Manager::getVariableValue ( UT_String &  str,
int  i,
int  thread 
) const

void CH_Manager::initExpressionLibrary (  )  [protected]

void CH_Manager::initLibraryGlue (  )  [protected]

bool CH_Manager::isChannelDisplayed ( const char *  full_chan_path  )  const

bool CH_Manager::isChannelDisplayed ( const CH_ChannelRef &  chref  )  const

bool CH_Manager::isChannelScoped ( const CH_ChannelRef &  chref  )  const

bool CH_Manager::isChannelScoped ( const char *  full_chan_path  )  const

bool CH_Manager::isChannelScoped ( CH_Channel *  chp  )  const

bool CH_Manager::isChannelSelected ( const char *  full_chan_path  )  const

bool CH_Manager::isChannelSelected ( const CH_ChannelRef &  chref  )  const

virtual bool CH_Manager::isOwnerExposed ( const CH_ChannelRef &  r  )  const [virtual]

Use this method to determine if the owner of the channel reference is exposed or not.

Reimplemented in OP_CommandManager.

bool CH_Manager::loadChannelOptions ( const char *  filename  ) 

int CH_Manager::loadChannels ( const char *  filename,
const char *  src_pattern,
const char *  dest_pattern,
bool  use_range,
const fpreal *  tstart,
const fpreal *  tend,
CH_CollectionList &  parents,
bool  delete_keys = false,
CH_ChannelRefList *  displayed_parms = NULL 
)

CH_Group* CH_Manager::loadGroup ( UT_IStream &  is  ) 

static void CH_Manager::lookupExpression ( const char *  name,
UT_String &  val,
int  thread 
) [static]

static void CH_Manager::lookupExpressionNoThread ( const char *  name,
UT_String &  val 
) [static]

static void CH_Manager::lookupVariable ( const char *  name,
UT_String &  val,
int  thread 
) [static]

static void CH_Manager::lookupVariableNoThread ( const char *  name,
UT_String &  val 
) [static]

static bool CH_Manager::makeGroupNameValid ( UT_String &  path  )  [static]

static bool CH_Manager::makeGroupPathValid ( UT_String &  path  )  [static]

void CH_Manager::mergeWithGroup ( CH_Group *  source,
CH_Group *  target,
CollisionBehaviour  cb 
)

void CH_Manager::moveIntoGroup ( CH_Group *  source,
CH_Group *  target,
CollisionBehaviour  cb,
const char *  new_name = 0 
)

int CH_Manager::niceFrameSeparation ( fpreal  initialSep,
int  minimumSep = 1 
) const

static fpreal CH_Manager::niceNumber ( fpreal  num,
int  digits = 3 
) [static]

void CH_Manager::parseUnitsString ( const char *  units,
fpreal &  distexp,
fpreal &  massexp 
) const

void CH_Manager::pinAllScopedChannels ( bool  propagate = true  ) 

void CH_Manager::pinChannels ( CH_ChannelRefList  chanrefs,
bool  propagate = true 
)

void CH_Manager::pinSelectedChannels ( bool  propagate = true,
int  operateOn = CH_SELECTED 
)

static bool CH_Manager::printFileInfo ( ostream &  os,
const char *  filename,
CH_Collection *  load_coll 
) [static]

static bool CH_Manager::readCHNFileHeader ( UT_IStream &  is,
bool  quiet,
fpreal32 &  version,
int &  binary,
bool &  is_fp64,
fpreal64 &  tstart,
fpreal64 &  tend 
) [static]

int CH_Manager::removeGlobalParamOwner ( CH_Collection *  owner  ) 

void CH_Manager::removeParamDependency ( CH_Collection *  coll  ) 

void CH_Manager::removePendingChannel ( CH_Channel *  chp  ) 

void CH_Manager::removeReferencesToNodeId ( int  node_id  ) 

This method will remove all references that this manager knows about channels belonging to node 'node_id'. After this method, scoped channels belonging to node_id will be removed, as will such channels in channel groups.

void CH_Manager::renameGroup ( CH_Group *  group,
const char *  newname 
)

void CH_Manager::renameOpInGroups ( const char *  full_from,
const char *  full_to 
)

void CH_Manager::renameTimeGroup ( CH_TimeGroup *  group,
const char *  newname,
bool  force = false 
)

void CH_Manager::resetChannelOptions (  ) 

void CH_Manager::resetPlayback (  ) 

bool CH_Manager::saveChannelOptions ( const char *  filename  ) 

int CH_Manager::saveChannels ( const char *  filename,
bool  binary,
bool  compiled,
const CH_ChannelList &  channels,
bool  displayed = false 
) const

void CH_Manager::saveGroup ( CH_Group *  g,
ostream &  os,
int  binary 
)

fpreal CH_Manager::scaleFromMKS ( const char *  tounits  )  const

fpreal CH_Manager::scaleToMKS ( const char *  fromunits  )  const

void CH_Manager::scopeChanged ( unsigned  flags,
bool  propagate = true 
)

void CH_Manager::scopeChannel ( const char *  full_chan_path,
bool  on_off 
)

void CH_Manager::scopeChannel ( const CH_ChannelRef &  chref,
bool  on_off 
)

bool CH_Manager::scopeChannelInternal ( const CH_ChannelRef &  chref,
bool  on_off 
)

bool CH_Manager::scopeChannelInternal ( CH_Channel *  chp,
bool  on_off 
)

void CH_Manager::selectAllScopedChannels ( bool  propagate = true  ) 

void CH_Manager::selectChannel ( const char *  full_chan_path,
bool  propagate = true 
)

void CH_Manager::selectChannel ( const CH_ChannelRef &  chref,
bool  propagate = true 
)

void CH_Manager::setAlwaysCommitKeyChange ( bool  onoff  )  [inline]

Definition at line 150 of file CH_Manager.h.

void CH_Manager::setAudioLevel ( fpreal  lvl  )  [inline]

Definition at line 597 of file CH_Manager.h.

void CH_Manager::setAutoSlope ( bool  onoff  )  [inline]

Definition at line 122 of file CH_Manager.h.

void CH_Manager::setAutoSplit ( bool  onoff  )  [inline]

Definition at line 130 of file CH_Manager.h.

void CH_Manager::setChanCreateKeyExpression ( const char *  s  )  [inline]

Definition at line 146 of file CH_Manager.h.

void CH_Manager::setChannelFlags ( const CH_ChannelRef &  chref,
unsigned  flags,
bool  on_off,
bool  propagate = true 
)

virtual void CH_Manager::setContext (  )  [virtual]

Reimplemented in CMD_Manager.

void CH_Manager::setDefaultExpression ( const char *  s  )  [inline]

Definition at line 108 of file CH_Manager.h.

void CH_Manager::setDefaultExprLanguage ( CH_ExprLanguage  language  )  [inline]

Definition at line 442 of file CH_Manager.h.

void CH_Manager::setDefaultRotationExpression ( const char *  s  )  [inline]

Definition at line 115 of file CH_Manager.h.

void CH_Manager::setDefaultSlope ( fpreal  slope  )  [inline]

Definition at line 126 of file CH_Manager.h.

void CH_Manager::setDefaultSplitExpression ( const char *  expr  )  [inline]

Definition at line 134 of file CH_Manager.h.

void CH_Manager::setEvalCollection ( CH_Collection *  g,
int  thread 
) [inline]

Examples:
SOP/SOP_PrimVOP.C.

Definition at line 661 of file CH_Manager.h.

void CH_Manager::setEvaluateTime ( fpreal  time,
int  thread 
) [inline]

Functions for obtaining and setting the current evaluation time.

Definition at line 706 of file CH_Manager.h.

int CH_Manager::setGlobalFloatParam ( const char *  token,
fpreal  val,
CH_Collection *&  owner 
)

int CH_Manager::setGlobalStringParam ( const char *  token,
const char *  strval,
CH_Collection *&  owner 
)

void CH_Manager::setGlobalTime ( fpreal  start,
fpreal  end 
)

void CH_Manager::setHoldFlag ( int  flag  )  [inline]

Definition at line 630 of file CH_Manager.h.

void CH_Manager::setHoldLastKey ( bool  onoff  )  [inline]

Definition at line 140 of file CH_Manager.h.

void CH_Manager::setIntegerFrameFlag ( int  flag  )  [inline]

Definition at line 579 of file CH_Manager.h.

void CH_Manager::setRawInterpolation ( int  state  )  [inline]

Definition at line 510 of file CH_Manager.h.

void CH_Manager::setRawNumSamples ( int  n  ) 

void CH_Manager::setRawSamplesPerSec ( fpreal  fps  ) 

void CH_Manager::setRealTimeDisableSkip ( bool  b  )  [inline]

Definition at line 614 of file CH_Manager.h.

void CH_Manager::setRealTimeFactor ( fpreal  f  )  [inline]

Definition at line 612 of file CH_Manager.h.

void CH_Manager::setRealTimeFlag ( int  flag  )  [inline]

Definition at line 610 of file CH_Manager.h.

void CH_Manager::setRestrictRangeFlag ( int  flag  )  [inline]

Definition at line 582 of file CH_Manager.h.

void CH_Manager::setRootCollection ( CH_Collection *  root  )  [inline]

Definition at line 694 of file CH_Manager.h.

void CH_Manager::setSampleRange ( fpreal  start,
fpreal  end 
) [inline]

Definition at line 623 of file CH_Manager.h.

void CH_Manager::setSamplesPerSec ( fpreal  fps  ) 

void CH_Manager::setSampleStep ( fpreal  s  )  [inline]

Definition at line 616 of file CH_Manager.h.

void CH_Manager::setSegCacheStatus ( bool  onoff  )  [inline]

Definition at line 154 of file CH_Manager.h.

void CH_Manager::setShowAudioFlag ( int  flag  )  [inline]

Definition at line 591 of file CH_Manager.h.

void CH_Manager::setShowKeysFlag ( int  flag  )  [inline]

Definition at line 594 of file CH_Manager.h.

void CH_Manager::setShowRangeFlag ( int  flag  )  [inline]

Definition at line 585 of file CH_Manager.h.

void CH_Manager::setShowTicksFlag ( int  flag  )  [inline]

Definition at line 588 of file CH_Manager.h.

int CH_Manager::setTimeCode ( const char *  buf,
fpreal &  t 
)

void CH_Manager::setTimeCodeOffset ( fpreal  t  )  [inline]

Definition at line 575 of file CH_Manager.h.

void CH_Manager::setUnitLength ( fpreal  unitlength  )  [inline]

Definition at line 600 of file CH_Manager.h.

void CH_Manager::setUnitMass ( fpreal  unitmass  )  [inline]

Definition at line 602 of file CH_Manager.h.

static bool CH_Manager::skipCHNFileHeaderForCollection ( UT_IStream &  is,
bool &  is_fp64 
) [static]

void CH_Manager::sortGroups (  ) 

void CH_Manager::stretchCollections ( CH_Collection *  from,
fpreal  ostart,
fpreal  oend 
)

void CH_Manager::timeGroupsChanged (  ) 

void CH_Manager::togglePinAllScopedChannels (  ) 

void CH_Manager::togglePinScopedChannels ( CH_ChannelRefList  chanrefs  ) 

void CH_Manager::undisplayChannel ( const char *  full_chan_path,
bool  propagate = true 
)

void CH_Manager::undisplayChannel ( const CH_ChannelRef &  chref,
bool  propagate = true 
)

void CH_Manager::unpinAllScopedChannels ( bool  propagate = true  ) 

void CH_Manager::unpinChannels ( CH_ChannelRefList  chanrefs,
bool  propagate = true 
)

void CH_Manager::unpinSelectedChannels ( bool  propagate = true,
int  operateOn = CH_SELECTED 
)

void CH_Manager::unscopeChannelsWithNodeId ( int  node_id,
bool  force = false 
)

void CH_Manager::updateCurrentGroup ( CH_Group *  group,
void *  by,
bool  propagate = true 
)

void CH_Manager::updateGroupSelection ( const CH_GroupList &  groups,
void *  by,
bool  propagate = true 
)

void CH_Manager::updateGroupSelectionFromScoped ( void *  by,
bool  propagate = true 
)

Friends And Related Function Documentation

friend class CH_SetGlobalParamScope [friend]

Definition at line 917 of file CH_Manager.h.

friend class CH_SetGuideParamScope [friend]

Definition at line 918 of file CH_Manager.h.

The documentation for this class was generated from the following file:
Generated on Thu Jan 31 00:30:02 2013 for HDK by  doxygen 1.5.9