3ds Max C++ API Reference
IMXtrack8 Class Referenceabstract

An interface to the new functionality for max 8 for tracks in the mixer. More...

#include <IMixer8.h>

+ Inheritance diagram for IMXtrack8:

Public Member Functions

virtual IMXclip8GetClip8 (int index, int row)=0
 Returns the IMXclip8 interface for the specified clip. More...
 
virtual IMXclip8GetTransClip8 (int index)=0
 Returns the IMXclip8 interface for the specified clip. More...
 
virtual bool IsMax ()=0
 Whether or not a max track or a biped track. More...
 
virtual bool AppendMaxClip (const MCHAR *fname, const MCHAR *mapFile=NULL, int interval=5)=0
 Loads the specified max animation file as a clip onto the track. More...
 
- Public Member Functions inherited from IMXtrack
virtual ~IMXtrack ()
 
virtual int NumClips (int row)=0
 
virtual IMXclipGetClip (int index, int row=BOT_ROW)=0
 
virtual int GetTrackType ()=0
 
virtual void SetTrackType (int toType)=0
 
virtual BOOL GetMute ()=0
 
virtual BOOL SetMute (BOOL val)=0
 
virtual BOOL GetSolo ()=0
 
virtual BOOL SetSolo (BOOL val)=0
 
virtual void GetInterval (Interval &iv)=0
 
virtual void Clear ()=0
 
virtual BOOL AppendClip (const MCHAR *fname, BOOL ZeroFootHeight=true, int interval=5)=0
 
virtual BOOL IsHeightPreservedDuringTransitions ()=0
 
virtual BOOL SetTransPreserveHeight (BOOL val)=0
 
virtual BOOL OptimizeTransitions (int PreferredTransLength, BOOL SearchEntireClip, int SearchRangeBefore, int SearchRangeAfter)=0
 
virtual BOOL OptimizeClipsNextTransition (int PreferredTransLength, BOOL SearchEntireClip, int SearchRangeBefore, int SearchRangeAfter, int ClipIndex)=0
 
virtual void ComputeTransClips ()=0
 
virtual int NumTransClips ()=0
 
virtual IMXclipGetTransClip (int index)=0
 
virtual int NumWeights ()=0
 
virtual float GetWeight (int i)=0
 
virtual int GetWeightTime (int i)=0
 
virtual BOOL DeleteWeight (int i)=0
 
virtual BOOL SetWeight (int i, float w)=0
 
virtual BOOL SetWeightTime (int i, int t)=0
 
virtual float GetWeightAtTime (int t)=0
 
virtual int SetWeightAtTime (int t, float w)=0
 

Additional Inherited Members

- Static Public Member Functions inherited from MaxHeapOperators
static UtilExport voidoperator new (size_t size)
 Standard new operator used to allocate objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e)
 Standard new operator used to allocate objects if there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new (size_t size, const char *filename, int line)
 New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate objects that takes the type of memory, filename and line number where the new was called If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e, const char *filename, int line)
 New operator used to allocate objects that takes the filename and line number where the new was called If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new (size_t size, unsigned long flags)
 New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, const std::nothrow_t &e, unsigned long flags)
 New operator used to allocate objects that takes extra flags to specify special operations If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size, const char *filename, int line)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, int block_type, const char *filename, int line)
 New operator used to allocate arrays of objects. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e, const char *filename, int line)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport voidoperator new[] (size_t size, unsigned long flags)
 New operator used to allocate arrays of objects If there is insufficient memory, an exception will be thrown. More...
 
static UtilExport voidoperator new[] (size_t size, const std::nothrow_t &e, unsigned long flags)
 New operator used to allocate arrays of objects If there is insufficient memory, NULL will be returned. More...
 
static UtilExport void operator delete (void *ptr)
 Standard delete operator used to deallocate an object If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e)
 Standard delete operator used to deallocate an object If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete (void *ptr, const char *filename, int line)
 Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, int block_type, const char *filename, int line)
 Delete operator used to deallocate an object that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e, const char *filename, int line)
 Delete operator used to deallocate an object that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete (void *ptr, unsigned long flags)
 Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete (void *ptr, const std::nothrow_t &e, unsigned long flags)
 Delete operator used to deallocate an object that takes extra flags to specify special operations If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr)
 Standard delete operator used to deallocate an array of objects If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e)
 Standard delete operator used to deallocate an array of objects If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, int block_type, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the type of memory, filename and line number where the delete was called If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e, const char *filename, int line)
 Delete operator used to deallocate an array of objects that takes the filename and line number where the delete was called If the pointer is invalid, nothing will happen. More...
 
static UtilExport void operator delete[] (void *ptr, unsigned long flags)
 Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport void operator delete[] (void *ptr, const std::nothrow_t &e, unsigned long flags)
 Delete operator used to deallocate an array of objects that takes extra flags to specify special operations If the pointer is invalid, an exception will be thrown. More...
 
static UtilExport voidoperator new (size_t size, void *placement_ptr)
 Placement new operator. More...
 
static UtilExport void operator delete (void *ptr, void *placement_ptr)
 Placement delete operator. More...
 
static UtilExport voidaligned_malloc (size_t size, size_t alignment)
 Allocates memory on a specified alignment boundary. More...
 
static UtilExport voidaligned_realloc (void *ptr, size_t size, size_t alignment)
 Reallocates memory on a specified alignment boundary. More...
 
static UtilExport void aligned_free (void *ptr)
 Frees a block of memory that was allocated with aligned_malloc/aligned_realloc. More...
 

Detailed Description

An interface to the new functionality for max 8 for tracks in the mixer.

Contains functionality relating to the new functionality for max tracks, mainly the ability to get or append new IMXclip8 clips. Inherits from IMXtrack. The interface is accessed via IMXtrackgroup8::GetTrack8. /see IMXtrackgroup8::GetTrack8

Member Function Documentation

◆ GetClip8()

virtual IMXclip8* GetClip8 ( int  index,
int  row 
)
pure virtual

Returns the IMXclip8 interface for the specified clip.

Parameters
[in]indexWhich clip you want to get, >=0.
[in]rowWhich row the clip you want to get is in, value may be BOT_ROW or TOP_ROW defined in IMixer.h For layer tracks, only BOT_ROW is a valid input.
Returns
The new clip interface for this clip. May return NULL if an invalid parameter,either improper row or index, is passed in.

◆ GetTransClip8()

virtual IMXclip8* GetTransClip8 ( int  index)
pure virtual

Returns the IMXclip8 interface for the specified clip.

Parameters
[in]indexThe index of the sorted clips in the transition track. Takes into account both rows when indexing the clips.
Returns
The new clip interface for this clip. May return NULL if an invalid parameter is passed in.

◆ IsMax()

virtual bool IsMax ( )
pure virtual

Whether or not a max track or a biped track.

Returns
Returns true if it's a max track, false if it's a biped track.

◆ AppendMaxClip()

virtual bool AppendMaxClip ( const MCHAR fname,
const MCHAR mapFile = NULL,
int  interval = 5 
)
pure virtual

Loads the specified max animation file as a clip onto the track.

Only works for max tracks.

Parameters
[in]fnameThe filename of the .xaf file to be loaded.
[in]mapFileThe filename of the .xmm map file to be loaded. Defaults to NULL,
[in]intervalThe number of frames from the end of the last clipin the track that the new clip will be appended in layer tracks. The interval must be >=0. Not that for transistion tracks, this parameter is ingnored and the start of the new clip will be at theinpoint of the last clip in the track, and it will be on the opposite row of the last clip. Also the parameter is ignored if there are no clips in the track, the clip will automatically start at frame 0.
Returns
false if the files can't be loaded or the mapping isn't correct. If the clip is created properly, returns true.