Technical Informations > Cartes32(u).dll errors > Errors on Edit mode functions

The following concepts will help to better understand the origin of errors in the editing mode:

•An Element is a sound extract (a Clip), relative to a loaded song (via LoadMorceau)

•An Event is an attribute (level, effect, name of the Clip, ...), related to 1 Element.

The position of an Event is relative to the Element to which it belongs.

The destruction of an Element causes the destruction of all its events.

•A Process is like an Event, except that it is not related to an Element, so it can exist independently of it. It is linked to a track, the beginning and the end of a treatment are absolute positions.

•Edit Mode is enabled/disabled by the SETMODEMONTAGE function. Its state is retrieved via the GETMODEMONTAGE function.

•Except for these 2 functions above, the other editing functions can only be called in active edit mode, otherwise a [-20] error will be generated.

•An assembly must include sound elements of the same sampling frequency, otherwise an error [-6] will be generated.

This is the first element added to the timeline that "fixes" the sample rate of the timeline.

•The resolution of an assembly (precision of placement of the cutting points) is limited by constraints related to the hardware (Driver + Digigram card) and the sound elements component editing (quantum).

oLinear Elements (PCM): 384 samples.

oMPEG (with or without Linear): 1152 samples.

Positions, edit points, etc., passed to editing functions are therefore rounded to the integer multiple of the resolution.

This rounding is done by default, except in special cases with positions provided in milliseconds or quantums, when the conversions do not give whole reports (eg 44.1KHz), in which case a rounding to the nearest integer multiple is performed.

•The time unit used must be the same for all parameters of the same function.

•A particular function (SHIFT_PISTES) allows to shift in time 1 or all the tracks.

When all tracks are shifted, the overall duration of editing decreases if the offset is negative, it increases if the offset is positive. The current position is also changing accordingly.

While a shift to the right is always possible, a shift to the left is conditioned to the position of the first element on the track(s) concerned.

For these reasons, an offset of all tracks is incompatible with the Cuts mode (see fct SETPLAYOPTIONS), so the Cuts mode is disabled when you move all tracks (it is of course possible to reactivate it later).

Error codes common to all editing functions (MT_xxxx):

[1]: Ok (except functions MT_AJOUTEMAJ_xxx: ≥ 0 è Ok).

[-20]: Not in edit mode.

[-21]: Invalid Song Identifier.

Error codes returned by the MAJ_AJOUT ELEMENT function:

[-1]: Incorrect track number (must be from 1 to 16 currently).

[-2]: Element Identifier> Maximum number of elements (on an update)

[-3]: Element identifier does not exist (on an update).

[-4]: Internal error (corrupted memory).

[-5]: Characteristics of the incompatible piece its use in a montage (ex: non-audio piece).

[-6]: Sampling rate different from assembly.

[-7]: Unknown time unit (neither Milliseconds, nor Quantums, nor samples).

[-8]: Position of the inconsistent element

[-9]: Duration of the zero-piece snippet or incoherent start / end points.

[-10]: End point of the incoherent snippet (eg> to song duration).

[-11]: Overlap with another existing element on the same track.

[-12]: Maximum number of elements reached (1000 currently).

[-13]: Memory allocation error

[-14]: A modification of the length of an existing element is impossible (an event belonging to this element would be out of bounds).

Error codes returned by the GET / DEL_ELEMENT function:

[-1]: Inconsistent Element Identifier.

[-2]: Corrupted element.

Error codes returned by the MAJ_AJOUT EVEN function:

[-1]: Element Identifier to which this inconsistent event refers.

[-2]: Inconsistent start/end positions for the duration of the element.

[-3]: Invalid event type (neither fade nor pan).

[-4]: Overlap on the same event element of the same Type.

[-5]: Maximum number of events per element reached (50 currently)

[-6]: Memory allocation error.

[-7]: Incorrect event identification (on an update)

[-8]: Corrupted event.

Error codes returned by the DEL event function:

[-1]: Element Identifier to which this inconsistent event refers.

[-2]: Corrupted element.

[-3]: Event not found.

Error codes returned by the MAJ_AJOUT PROCESSING function:

[-1]: Incorrect track number (must be from 1 to 16 currently) or wrong specified time unit.

[-2]: Inconsistent start/end positions.

[-3]: Incorrect treatment type (neither fade nor pan).

[-4]: Overlap on the same track with an existing Processing, of the same Type.

[-5]: Maximum number of treatments reached (1000 currently)

[-6]: Memory allocation error.

[-7]: Corrupt treatment

Error codes returned by the DEL_ PROCESS function:

[-1]: Processing identifier incorrect or nonexistent.

[-2]: Treatment not found.

[-3]: Wrong track number for erasing all track processing (must be from -1000 to -16000 currently).