CUT File Tags

The CUT file is located in the sacc_data directory and contains the following shot information:

Physical location of files, trims, and additional metadata information (such as EDL and keycode data)
Retime effect parameters
Dissolve parameters

The CUT file is built from the sequence of shots, and its order determines the order of shots on the Lustre Storyboard.

When modifying the CUT file, you are restricted to the following tags.

NoteItems in the Children row are occasionally marked with a + (plus sign) or * (asterisk). The + indicates that the parent tag can contain more than one instance of this element. The * indicates that the element is mandatory.

Cut
Description	The root tag that contains opening and closing tags. It is a structure tag and as such can include hard returns.
Parameters	For the current release the only parameter allowed is Ver="3.0"
Parents	N/A
Children	+*Shot

Shot
Description	A single shot (uninterrupted sequence of images). It is a structure tag and as such can include hard returns. The parent cut tag can contain any number of shots.
Parameters	N/A
Parents	Cut
Children	+Seq, +AliasName, +EData

Seq
Description	The image sequence location. For example: [HOME]/scene1/1828x1332/%05d.dpx*7751.
Parameters	N/A
Parents	Shot
Children	N/A

AliasName
Description	The shot's short name. An asterisk (*) indicates a previous wedge number. You can make the alias name appear in the shot bin and the browser by pressing W on the keyboard.
Parameters	N/A
Parents	Shot
Children	N/A

EData
Description	The structure for storing editing metadata.
Parameters	N/A
Parents	Shot
Children	+UniqueId, +SrcFullStart, +SrcFullLength, +SrcTrimStart, +SrcTrimLength, +ResStart, +ResLength, FadeType, FadeStartFromEnd, FadeSize, FadeCurve, RetimeRefFrame, RetimeSpeed, RetimeRemain, EDLEvent, EDLFadeDur, EDLFrameRate, EDLReelName, EDLFadeType, EDLSrcTcIn, EDLSrcTcOut, EDLRecTcIn, EDLRecTcOut, EDLFadeDur, EDLRetimeSpeed, EDLRetimeRef, EDLFadeUID, EDLKeyCodeStart, EDLKeyCodeEnd, DLEDLRes, DLEDLStartTc, DLEDLFrameIdList, DLEDLClipName, MediaUnlinked, MediaPtr, MediaDef, MediaLinkData, DPXTimeCodeStart, DPXTimeCodeEnd, DPXKeyCodeStart, DPXKeyCodeEnd, DPXFrameRate, DPXCodeRes, DPXKeyCodeType

UniqueId
Description	A shot's unique identification string. If generated internally, do not modify. This would result in grade loss since shots and grades are linked by the unique ID. If the CUT file was generated externally, the ID must respect the following conditions: it must be unique within the cutlist, and the data type must be a 64-bit integer in a hexadecimal format. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

SrcFullStart
Description	The first frame of the original image sequence. The frame number is converted and displayed as timecode.
Parameters	N/A
Parents	EData
Children	N/A

SrcFullLength
Description	The shot's number of frames.
Parameters	N/A
Parents	EData
Children	N/A

SrcTrimStart
Description	The trim start frame. This value should be greater than the SrcFullStart value and smaller than the sum of SrcFullStart plus SrcFullLength.
Parameters	N/A
Parents	EData
Children	N/A

SrcTrimLength
Description	The trimmed shot length. The sum of SrcTrimStart plus SrcTrimLength should always be smaller than the sum of SrcFullStart plus SrcFullLength.
Parameters	N/A
Parents	EData
Children	N/A

ResStart
Description	The start record frame. The frame number can be converted to timecode if required.
Parameters	N/A
Parents	EData
Children	N/A

ResLength
Description	The record length in frames.
Parameters	N/A
Parents	EData
Children	N/A

FadeType
Description	The transition type. Type 1 is a dissolve, and type 0 is a cut.
Parameters	N/A
Parents	EData
Children	N/A

FadeStartFromEnd
Description	The starting frame of the transition, counting from the end of the current shot.
Parameters	N/A
Parents	EData
Children	N/A

FadeSize
Description	Length of the transition in frames.
Parameters	N/A
Parents	EData
Children	N/A

FadeCurve
Description	Container for transition curves. There are two types of transition curves: InChannel and OutChannel. The InChannel transition curve determines the transparency of the current shot, whereas the OutChannel transition curve determines the transparency of the overlapped shot.
Parameters	N/A
Parents	EData
Children	+InChannel, +OutChannel

InChannel
Description	The transition curve that determines the transparency of the current shot.
Parameters	N/A
Parents	EData
Children	+*Point

OutChannel
Description	The transition curve that determines the transparency of the overlapped shot.
Parameters	N/A
Parents	EData
Children	+*Point

Point
Description	One control point on a curve. For dissolves, the curve calculation is based on Hermite interpolation, and all values are normalized to a 0-65535 range.
Parameters	N/A
Parents	InChannel, OutChannel
Children	+X, +Y, +TangentX, +TangentY

X
Description	X coordinate of a control point.
Parameters	N/A
Parents	Point
Children	N/A

Y
Description	Y coordinate of a control point.
Parameters	N/A
Parents	Point
Children	N/A

Tangent X
Description	The absolute X position of the tangent point. This is unrelated to the tangent angle.
Parameters	N/A
Parents	Point
Children	N/A

Tangent Y
Description	The absolute Y position of the tangent point. This is unrelated to the tangent angle.
Parameters	N/A
Parents	Point
Children	N/A

RetimeRefFrame
Description	The retime's base point in frames. This is usually equivalent to the SrcTrimStart.
Parameters	N/A
Parents	EData
Children	N/A

RetimeSpeed
Description	Speed change rate. Supported data type is long float (“lf”, aka double). For example, normal speed is 1.0, half speed is 0.5, double speed is 2.0, -1.0 is normal speed reverse play, -0.5 is half speed reverse play, and -2.0 is double speed reverse play.
Parameters	Type
Parents	EData
Children	N/A

RetimeRemain
Description	Value for compensating rounding errors. This tag is used only if a retimed shot was retrimmed. Otherwise its value is zero. Supported data type is long float (“lf”, aka double).
Parameters	Type
Parents	EData
Children	N/A

EDLEvent
Description	EDL event number.
Parameters	N/A
Parents	EData
Children	N/A

EDLFadeDur
Description	EDL fade duration in frames.
Parameters	N/A
Parents	EData
Children	N/A

EDLFrameRate
Description	EDL framerate. This tag's parameter is the float data type. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

EDLReelName
Description	EDL reel name. The tag's parameter is the string data type. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

EDLFadeType
Description	The EDL fade type. Legal values include: -1= cut -2=dissolve >=SMPTE wipe type number
Parameters	N/A
Parents	EData
Children	N/A

EDLSrcTcIn
Description	EDL source in timecode. This tag's parameter is the timecode data type. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

EDLSrcTcOut
Description	EDL source out timecode. This tag's parameter is the timecode data type. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

EDLRecTcIn
Description	EDL record in timecode. This tag's parameter is the timecode data type. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

EDLRecTcOut
Description	EDL record out timecode. This tag's parameter is the timecode data type. See CUT File Data Types.
Parameters	Type
Parents	EData
Children	N/A

EDLFadeDur
Description	EDL fade duration in frames.
Parameters	N/A
Parents	EData
Children	N/A

EDLRetimeSpeed
Description	EDL retime as a percentage value.
Parameters	N/A
Parents	EData
Children	N/A

EDLRetimeRef
Description	The retime's base point in frames. This is usually equivalent to the SrcTrimStart.
Parameters	N/A
Parents	EData
Children	N/A

EDLFadeUID
Description	Unique ID of the second shot in the dissolve.
Parameters	N/A
Parents	EData
Children	N/A

EDLKeyCodeStart
Description	EDL keycode start. This tag's parameter is the keycode data type. See CUT File Data Types.
Parameters	N/A
Parents	EData
Children	N/A

EDLKeyCodeEnd
Description	EDL keycode end. This tag's parameter is the keycode data type. See CUT File Data Types.
Parameters	N/A
Parents	EData
Children	N/A

DLEDLRes
Description	String from the DLEDL that describes the image format.
Parameters	N/A
Parents	EData
Children	N/A

DLEDLStartTc
Description	Start timecode from the DLEDL.
Parameters	N/A
Parents	EData
Children	N/A

DLEDLFrameIdList
Description	Pointer to the frame ID list, which is used by the system to locate frames on the Stone filesystem. Supported data type is integer. See CUT File Data Types.
Parameters	N/A
Parents	EData
Children	N/A

DLEDLClipName
Description	DLEDL clip name.
Parameters	N/A
Parents	EData
Children	N/A

DPXTimeCodeStart
Description	DPX header timecode start.
Parameters	N/A
Parents	EData
Children	N/A

DPXTimeCodeEnd
Description	DPX header timecode end.
Parameters	N/A
Parents	EData
Children	N/A

DPXKeyCodeStart
Description	DPX header keycode start.
Parameters	N/A
Parents	EData
Children	N/A

DPXKeyCodeEnd
Description	DPX header keycode end.
Parameters	N/A
Parents	EData
Children	N/A

DPXFrameRate
Description	DPX header frame rate.
Parameters	N/A
Parents	EData
Children	N/A

DPXCodeRes
Description	The resolution of the DPX header origin (full or half).
Parameters	N/A
Parents	EData
Children	N/A

DPXKeyCodeType
Description	The number of frames stored on one foot of film.
Parameters	N/A
Parents	EData
Children	N/A

Comment on this topic