2005-10-26 06:58:33

Comparison for /Ringtone Creator Server Error Handling of 2005-10-26 06:58:33 and 2005-10-26 07:08:38

Additions:

If more than 1 status is applicable, the first to occur is returned back. ||
[ringtone bytes] = [server response size] – [result code = 1 byte] [status code = 1 byte]

Deletions:

If more than 1 status is applicable, the first to occur is returned back.
[ringtone bytes] = [server response size] \u2013 [result code = 1 byte] [status code = 1 byte]

2005-10-26 06:36:09

Comparison for /Ringtone Creator Server Error Handling of 2005-10-26 06:36:09 and 2005-10-26 06:58:33

Additions:

FF – error, the error code and message follow;
00 – operation was successful || || <status_code> | byte. Status code tells you about events you may be interested in.
00 – No messages. This event is unlikely if you're dealing with polyphonic ringtones
02 – channel truncation occurred. This means that the ringtone has lost some music data due to truncation of channels.
>10 – At least one PCM track is present in the original ringtone (as Ringtone Creator doesn't convert PCM tracks into note tracks [and no other tool can't as well], it has been removed from the output. Please issue the appropriate command to extract those PCM tracks). To get the number of tracks subtract 10 from the result. For example, if the status is 13, the number of PCM tracks is 3.
|| || <data> | Byte array representing the resulting ringtone or an empty array (i.e. byte[0]). || || <pcm-data> | A text line in the following format:
format=x1;frequency=x2;basebit=x3;channel=x4;offset=x5;duration=x6;bytes=x7

format (x1)
SIGNED
ADPCM
TVINVQ
MP3
unknown
frequency (x2)
4
8
11,025
22,05
44,1
unknown
basebit (x3)
represents the number of bits for a single tick
channel (x4)
takes one of the following values:
mono
poly
offset (x5)
represents an offset (in ms) of the sample from the beginning of the melody.
duration (x6)
represents the duration of the sample in ms.
bytes (x7)
represents a PCM sample in a HEX-encoded form. || || <duration> | 4 bytes parameter representing the duration of a ringtone in milliseconds. It's the last parameter, so you can determine the size of the ringtone using the following formula:

duration[0] << 24 + duration[1] << 16 + duration[2] << 8 + duration[3]
&nolength=true||

Deletions:

FF – error, the error code and message follow;
00 – operation was successful || || | ||
<status_code> byte. Status code tells you about events you may be interested in.
00 No messages. This event is unlikely if you're dealing with polyphonic ringtones
02 channel truncation occurred. This means that the ringtone has lost some music data due to truncation of channels.

>10 At least one PCM track is present in the original ringtone (as Ringtone Creator doesn't convert PCM tracks into note tracks [and no other tool can't as well], it has been removed from the output. Please issue the appropriate command to extract those PCM tracks). To get the number of tracks subtract 10 from the result. For example, if the status is 13, the number of PCM tracks is 3.

<data> Byte array representing the resulting ringtone or an empty array (i.e. byte[0]).
<pcm-data> A text line in the following format:
format=x1;frequency=x2;basebit=x3;channel=x4;offset=x5;duration=x6;bytes=x7
format (x1) SIGNED
ADPCM
TVINVQ
MP3
unknown
frequency (x2) 4
8
11
22.05
44.1
unknown
basebit (x3) represents the number of bits for a single tick
channel (x4) takes one of the following values:
mono
poly
offset (x5) represents an offset (in ms) of the sample from the beginning of the melody.
duration (x6) represents the duration of the sample in ms.
bytes (x7) represents a PCM sample in a HEX-encoded form.

<duration> 4 bytes parameter representing the duration of a ringtone in milliseconds. It's the last parameter, so you can determine the size of the ringtone using the following formula:
duration[0] << 24 + duration[1] << 16 + duration[2] << 8 + duration[3]
&nolength=true

UnwiredtecDocumentation - RingtoneCreatorServerErrorHandling

2005-10-26 06:58:33

2005-10-26 06:36:09