gsmring.h File Reference

#include <gammu-ringtone.h>

Include dependency graph for gsmring.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	SM_CommandEnd_CommandEnd   0x00
#define	SM_Command_RingingToneProgramming   (0x25 << 1)
#define	SM_Command_Sound   (0x1d << 1)
#define	SM_Song_BasicSongType   (0x01 << 5)
#define	SM_PatternID_A_part   (0x00 << 6)
#define	SM_InstructionID_PatternHeaderId   (0x00 << 5)
#define	SM_InstructionID_NoteInstructionId   (0x01 << 5)
#define	SM_InstructionID_ScaleInstructionId   (0x02 << 5)
#define	SM_InstructionID_StyleInstructionId   (0x03 << 5)
#define	SM_InstructionID_TempoInstructionId   (0x04 << 5)
#define	SM_InstructionID_VolumeInstructionId   (0x05 << 5)

Enumerations
enum	GSM_RingtoneVersion { GSM_Ring_NoHeader = 1, GSM_Ring_PartialHeader, GSM_Ring_IMelody10, GSM_Ring_IMelody12 }

Functions
unsigned char	GSM_EncodeNokiaRTTLRingtone (GSM_Ringtone *ringtone, unsigned char *package, size_t *maxlength)
unsigned char	GSM_EncodeEMSSound (GSM_Ringtone *ringtone, unsigned char *package, size_t *maxlength, GSM_RingtoneVersion version, gboolean start)
GSM_Error	GSM_DecodeNokiaRTTLRingtone (GSM_Ringtone *ringtone, unsigned char *package, size_t maxlength)
int	GSM_RingNoteGetFrequency (GSM_RingNote Note)
int	GSM_RingNoteGetFullDuration (GSM_RingNote Note)

Macro Definition Documentation

SM_Command_RingingToneProgramming

#define SM_Command_RingingToneProgramming   (0x25 << 1)

Definition at line 12 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_Command_Sound

#define SM_Command_Sound   (0x1d << 1)

Definition at line 13 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_CommandEnd_CommandEnd

#define SM_CommandEnd_CommandEnd   0x00

Definition at line 9 of file gsmring.h.

Referenced by GSM_EncodeNokiaRTTLRingtone().

SM_InstructionID_NoteInstructionId

#define SM_InstructionID_NoteInstructionId   (0x01 << 5)

Definition at line 23 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_InstructionID_PatternHeaderId

#define SM_InstructionID_PatternHeaderId   (0x00 << 5)

Definition at line 22 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_InstructionID_ScaleInstructionId

#define SM_InstructionID_ScaleInstructionId   (0x02 << 5)

Definition at line 24 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_InstructionID_StyleInstructionId

#define SM_InstructionID_StyleInstructionId   (0x03 << 5)

Definition at line 25 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_InstructionID_TempoInstructionId

#define SM_InstructionID_TempoInstructionId   (0x04 << 5)

Definition at line 26 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

SM_InstructionID_VolumeInstructionId

#define SM_InstructionID_VolumeInstructionId   (0x05 << 5)

Definition at line 27 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone().

SM_PatternID_A_part

#define SM_PatternID_A_part   (0x00 << 6)

Definition at line 19 of file gsmring.h.

Referenced by GSM_EncodeNokiaRTTLRingtone().

SM_Song_BasicSongType

#define SM_Song_BasicSongType   (0x01 << 5)

Definition at line 16 of file gsmring.h.

Referenced by GSM_DecodeNokiaRTTLRingtone(), and GSM_EncodeNokiaRTTLRingtone().

Enumeration Type Documentation

GSM_RingtoneVersion

enum GSM_RingtoneVersion

Enumerator
GSM_Ring_NoHeader	No header and footer.
GSM_Ring_PartialHeader	Partial header and footer.
GSM_Ring_IMelody10	IMelody 1.0.
GSM_Ring_IMelody12	IMelody 1.2.

Definition at line 31 of file gsmring.h.

             {
        GSM_Ring_NoHeader = 1,
        GSM_Ring_PartialHeader,
        GSM_Ring_IMelody10,
        GSM_Ring_IMelody12,
} GSM_RingtoneVersion;

Function Documentation

GSM_DecodeNokiaRTTLRingtone()

GSM_Error GSM_DecodeNokiaRTTLRingtone	(	GSM_Ringtone *	ringtone,
		unsigned char *	package,
		size_t	maxlength
	)

Definition at line 1128 of file gsmring.c.

References BufferAlignNumber(), GSM_NoteRingtone::Commands, CopyUnicodeString(), dbgprintf, DecodeUnicodeSpecialNOKIAChars(), GSM_RingNote::Duration, Duration_1_32, Duration_Full, GSM_RingNote::DurationSpec, EncodeUnicode(), ERR_NONE, ERR_NOTSUPPORTED, GSM_Ringtone::Format, GetBuffer(), GetBufferInt(), GSM_MAX_RINGTONE_NOTES, Length_2_3, GSM_Ringtone::Name, NaturalStyle, NoSpecialDuration, GSM_RingNote::Note, GSM_RingCommand::Note, Note_C, Note_H, Note_Pause, GSM_Ringtone::NoteTone, GSM_NoteRingtone::NrCommands, RING_Note, RING_NOTETONE, GSM_RingNote::Scale, Scale_880, SM_BeatsPerMinute, SM_Command_RingingToneProgramming, SM_Command_Sound, SM_InstructionID_NoteInstructionId, SM_InstructionID_PatternHeaderId, SM_InstructionID_ScaleInstructionId, SM_InstructionID_StyleInstructionId, SM_InstructionID_TempoInstructionId, SM_InstructionID_VolumeInstructionId, SM_Song_BasicSongType, StaccatoStyle, GSM_RingNote::Style, GSM_RingNote::Tempo, GSM_RingCommand::Type, and UnicodeLength().

Referenced by GSM_DecodeMultiPartSMS(), loadcommunicator(), and loadott().

{
        size_t                  StartBit=0;
        int l, q, i, spec, HowMany;
        char                    Buffer[100];
        GSM_RingNote            *Note;

        /* Default ringtone parameters */
        GSM_RingNoteScale       DefScale        = Scale_880;
        GSM_RingNoteStyle       DefStyle        = NaturalStyle;
        int                     DefTempo        = 63;

        ringtone->Format                = RING_NOTETONE;
        ringtone->NoteTone.NrCommands   = 0;

        GetBufferInt(package,&StartBit,&l,8);
        if (l != 0x02) {
                dbgprintf(NULL, "Not header\n");
                return ERR_NOTSUPPORTED;
        }

        GetBufferInt(package,&StartBit,&l,7);
        if (l != SM_Command_RingingToneProgramming) {
                dbgprintf(NULL, "Not RingingToneProgramming\n");
                return ERR_NOTSUPPORTED;
        }

        /* According to specification we need have next part octet-aligned */
        BufferAlignNumber(&StartBit);

        GetBufferInt(package,&StartBit,&l,7);
        if (l != SM_Command_Sound) {
                dbgprintf(NULL, "Not Sound\n");
                return ERR_NOTSUPPORTED;
        }

        GetBufferInt(package,&StartBit,&l,3);
        if (l != SM_Song_BasicSongType) {
                dbgprintf(NULL, "Not BasicSongType\n");
                return ERR_NOTSUPPORTED;
        }

        /* Getting length of the tune name */
        GetBufferInt(package,&StartBit,&l,4);
        l=l>>4;

        /* Unpacking the name of the tune. */
        GetBuffer(package, &StartBit, Buffer, 8*l);
        Buffer[l]=0;
        EncodeUnicode(ringtone->Name,Buffer,strlen(Buffer));
        DecodeUnicodeSpecialNOKIAChars(Buffer, ringtone->Name, UnicodeLength(ringtone->Name));
        CopyUnicodeString(ringtone->Name,Buffer);

        GetBufferInt(package,&StartBit,&l,8);
        dbgprintf(NULL, "Number of song patterns: %i\n",l);
        /* we support only one song pattern */
        if (l!=1) return ERR_NOTSUPPORTED;

        GetBufferInt(package,&StartBit,&l,3);
        if (l!=SM_InstructionID_PatternHeaderId) {
                dbgprintf(NULL, "Not PatternHeaderId\n");
                return ERR_NOTSUPPORTED;
        }

        /* Pattern ID - we ignore it */
        StartBit+=2;

        GetBufferInt(package,&StartBit,&l,4);
        l=l>>4;
        dbgprintf(NULL, "Loop value: %i\n",l);

        HowMany=0;
        GetBufferInt(package, &StartBit, &HowMany, 8);

        for (i=0;i<HowMany;i++) {
                GetBufferInt(package,&StartBit,&q,3);
                switch (q) {
                case SM_InstructionID_VolumeInstructionId:
                        StartBit+=4;
                        break;
                case SM_InstructionID_StyleInstructionId:
                        GetBufferInt(package,&StartBit,&l,2);
                        if (l>=NaturalStyle && l<=StaccatoStyle) DefStyle = l;
                        break;
                case SM_InstructionID_TempoInstructionId:
                        GetBufferInt(package,&StartBit,&l,5);
                        DefTempo=SM_BeatsPerMinute[l>>3];
                        break;
                case SM_InstructionID_ScaleInstructionId:
                        GetBufferInt(package,&StartBit,&l,2);
                        DefScale=(l>>6)+4;
                        break;
                case SM_InstructionID_NoteInstructionId:
                        Note = &ringtone->NoteTone.Commands[ringtone->NoteTone.NrCommands].Note;
                        ringtone->NoteTone.Commands[ringtone->NoteTone.NrCommands].Type = RING_Note;

                        GetBufferInt(package,&StartBit,&l,4);
                        Note->Note=Note_Pause;
                        if (l >= Note_C && l <= Note_H) Note->Note = l;

                        GetBufferInt(package,&StartBit,&l,3);
                        if (l >= Duration_Full && l <= Duration_1_32) Note->Duration = l;

                        GetBufferInt(package,&StartBit,&spec,2);
                        if (spec >= NoSpecialDuration && spec <= Length_2_3) {
                                Note->DurationSpec = spec;
                        }

                        Note->Scale = DefScale;
                        Note->Style = DefStyle;
                        Note->Tempo = DefTempo;
                        if (ringtone->NoteTone.NrCommands==GSM_MAX_RINGTONE_NOTES) break;
                        ringtone->NoteTone.NrCommands++;
                        break;
                default:
                        dbgprintf(NULL, "Unsupported block %i %i\n",q,i);
                        return ERR_NOTSUPPORTED;
                }
        }
        return ERR_NONE;
}

GSM_EncodeEMSSound()

unsigned char GSM_EncodeEMSSound	(	GSM_Ringtone *	ringtone,
		unsigned char *	package,
		size_t *	maxlength,
		GSM_RingtoneVersion	version,
		gboolean	start
	)

Definition at line 1565 of file gsmring.c.

References GSM_NoteRingtone::Commands, ContinuousStyle, dbgprintf, DecodeUnicodeString(), DottedNote, DoubleDottedNote, GSM_RingNote::Duration, Duration_1_16, Duration_1_2, Duration_1_32, Duration_1_4, Duration_1_8, Duration_Full, GSM_RingNote::DurationSpec, FALSE, GSM_Ring_IMelody10, GSM_Ring_IMelody12, GSM_Ring_NoHeader, INVALIDStyle, Length_2_3, GSM_Ringtone::Name, NaturalStyle, GSM_RingNote::Note, GSM_RingCommand::Note, Note_A, Note_Ais, Note_C, Note_Cis, Note_D, Note_Dis, Note_E, Note_F, Note_Fis, Note_G, Note_Gis, Note_H, Note_INVALID, Note_Pause, GSM_Ringtone::NoteTone, GSM_NoteRingtone::NrCommands, RING_DisableLED, RING_DisableLight, RING_DisableVibra, RING_EnableLED, RING_EnableLight, RING_EnableVibra, RING_Note, GSM_RingNote::Scale, Scale_880, StaccatoStyle, GSM_RingNote::Style, GSM_RingNote::Tempo, TRUE, and GSM_RingCommand::Type.

Referenced by GSM_EncodeEMSMultiPartSMS(), and GSM_SaveRingtoneIMelody().

{
        int                     i, NrNotes = 0, Len, Max = *maxlength;

        GSM_RingNote            *Note;

        GSM_RingNoteScale       DefNoteScale;
        GSM_RingNoteStyle       DefNoteStyle=0;
        int                     DefNoteTempo=0;

        gboolean                        started = FALSE, end;

        *maxlength = 0;

        if (start) {
                if (version != GSM_Ring_NoHeader)
                        *maxlength+=sprintf(package,"BEGIN:IMELODY%c%c",13,10);
                if (version == GSM_Ring_IMelody10)
                        *maxlength+=sprintf(package+(*maxlength),"VERSION:1.0%c%c",13,10);
                if (version == GSM_Ring_IMelody12)
                        *maxlength+=sprintf(package+(*maxlength),"VERSION:1.2%c%c",13,10);
                if (version == GSM_Ring_IMelody12 || version == GSM_Ring_IMelody10)
                        *maxlength+=sprintf(package+(*maxlength),"FORMAT:CLASS1.0%c%c",13,10);
                if (version == GSM_Ring_IMelody12)
                        *maxlength+=sprintf(package+(*maxlength),"NAME:%s%c%c",DecodeUnicodeString(ringtone->Name),13,10);
        }

        DefNoteScale = Scale_880; /* by iMelody definition */

        for (i=0;i<ringtone->NoteTone.NrCommands;i++) {
                Len = *maxlength;
                if (ringtone->NoteTone.Commands[i].Type != RING_Note) continue;

                Note = &ringtone->NoteTone.Commands[i].Note;
                if (Note->Note == Note_Pause) continue;

                if (version == GSM_Ring_IMelody12 && start) {
                        /* Save the default tempo */
                        DefNoteTempo = Note->Tempo;
                        Len+=sprintf(package+Len,"BEAT:%i%c%c",DefNoteTempo,13,10);
                        dbgprintf(NULL, "DefNoteTempo=%d\n",DefNoteTempo);

                        /* Save default style */
                        DefNoteStyle = Note->Style;
                        switch (DefNoteStyle) {
                                case INVALIDStyle: break;
                                case NaturalStyle   :Len+=sprintf(package+Len,"STYLE:S0%c%c",13,10); break;
                                case ContinuousStyle:Len+=sprintf(package+Len,"STYLE:S1%c%c",13,10); break;
                                case StaccatoStyle  :Len+=sprintf(package+Len,"STYLE:S2%c%c",13,10); break;
                        }
                }
                Len+=sprintf(package+Len,"MELODY:");
                if (version != GSM_Ring_NoHeader) {
                        /* 15 = Len of END:IMELODY... */
                        if ((Len+15) > Max) { break; }
                } else {
                        if (Len > Max) { break; }
                }
                *maxlength = Len;
                break;
        }

        for (i=0;i<ringtone->NoteTone.NrCommands;i++) {
                end = FALSE;
                Len = *maxlength;
                switch (ringtone->NoteTone.Commands[i].Type) {
                case RING_Note:
                        Note = &ringtone->NoteTone.Commands[i].Note;
                        if (!started && Note->Note != Note_Pause) started = TRUE;
                        if (!started) break;
                        if (Note->Note!=Note_Pause && Note->Scale != DefNoteScale) {
                                Len+=sprintf(package+Len,"*%i",Note->Scale-1);
                        }
                        switch (Note->Note) {
                                case Note_C     :Len+=sprintf(package+Len,"c"); break;
                                case Note_Cis   :Len+=sprintf(package+Len,"#c");break;
                                case Note_D     :Len+=sprintf(package+Len,"d"); break;
                                case Note_Dis   :Len+=sprintf(package+Len,"#d");break;
                                case Note_E     :Len+=sprintf(package+Len,"e"); break;
                                case Note_F     :Len+=sprintf(package+Len,"f"); break;
                                case Note_Fis   :Len+=sprintf(package+Len,"#f");break;
                                case Note_G     :Len+=sprintf(package+Len,"g"); break;
                                case Note_Gis   :Len+=sprintf(package+Len,"#g");break;
                                case Note_A     :Len+=sprintf(package+Len,"a"); break;
                                case Note_Ais   :Len+=sprintf(package+Len,"#a");break;
                                case Note_H     :Len+=sprintf(package+Len,"b"); break;
                                case Note_Pause :Len+=sprintf(package+Len,"r"); break;
                                case Note_INVALID: break;
                        }
                        switch (Note->Duration) {
                                case Duration_Full : package[Len++]='0';        break;
                                case Duration_1_2  : package[Len++]='1';        break;
                                case Duration_1_4  : package[Len++]='2';        break;
                                case Duration_1_8  : package[Len++]='3';        break;
                                case Duration_1_16 : package[Len++]='4';        break;
                                case Duration_1_32 : package[Len++]='5';        break;
                                default            :                            break;
                        }
                        switch (Note->DurationSpec) {
                                case DottedNote         : package[Len++] = '.'; break;
                                case DoubleDottedNote   : package[Len++] = ':'; break;
                                case Length_2_3         : package[Len++] = ';'; break;
                                default                 :                       break;
                        }
                        if (version != 0) {
                                /* 15 = Len of END:IMELODY... */
                                if ((Len+15) > Max) { end = TRUE; break; }
                        } else {
                                if (Len > Max) { end = TRUE; break; }
                        }
                        *maxlength = Len;
                        break;
                case RING_DisableLED:
                        if ((Len + 6) > Max) { end = TRUE; break; }
                        (*maxlength)+=sprintf(package+Len,"ledoff");
                        break;
                case RING_EnableLED:
                        if ((Len + 5) > Max) { end = TRUE; break; }
                        (*maxlength)+=sprintf(package+Len,"ledon");
                        break;
                case RING_DisableVibra:
                        if ((Len + 7) > Max) { end = TRUE; break; }
                        (*maxlength)+=sprintf(package+Len,"vibeoff");
                        break;
                case RING_EnableVibra:
                        if ((Len + 6) > Max) { end = TRUE; break; }
                        (*maxlength)+=sprintf(package+Len,"vibeon");
                        break;
                case RING_DisableLight:
                        if ((Len + 7) > Max) { end = TRUE; break; }
                        (*maxlength)+=sprintf(package+Len,"backoff");
                        break;
                case RING_EnableLight:
                        if ((Len + 6) > Max) { end = TRUE; break; }
                        (*maxlength)+=sprintf(package+Len,"backon");
                        break;
                default:
                        break;
                }
                if (end) break;
                NrNotes ++;
        }

        if (version != 0) *maxlength+=sprintf(package+(*maxlength),"%c%cEND:IMELODY%c%c",13,10,13,10);

        return NrNotes;
}

GSM_EncodeNokiaRTTLRingtone()

unsigned char GSM_EncodeNokiaRTTLRingtone	(	GSM_Ringtone *	ringtone,
		unsigned char *	package,
		size_t *	maxlength
	)

Definition at line 992 of file gsmring.c.

References AddBuffer(), AddBufferByte(), GSM_NoteRingtone::AllNotesScale, BufferAlign(), BufferAlignNumber(), GSM_NoteRingtone::Commands, DecodeUnicodeString(), GSM_RingNote::Duration, GSM_RingNote::DurationSpec, EncodeUnicodeSpecialNOKIAChars(), FALSE, GSM_RTTLGetTempo(), GSM_Ringtone::Name, GSM_RingNote::Note, GSM_RingCommand::Note, Note_Pause, GSM_Ringtone::NoteTone, GSM_NoteRingtone::NrCommands, RING_Note, GSM_RingNote::Scale, SM_Command_RingingToneProgramming, SM_Command_Sound, SM_CommandEnd_CommandEnd, SM_InstructionID_NoteInstructionId, SM_InstructionID_PatternHeaderId, SM_InstructionID_ScaleInstructionId, SM_InstructionID_StyleInstructionId, SM_InstructionID_TempoInstructionId, SM_PatternID_A_part, SM_Song_BasicSongType, GSM_RingNote::Style, GSM_RingNote::Tempo, TRUE, GSM_RingCommand::Type, and UnicodeLength().

Referenced by GSM_EncodeMultiPartSMS(), GSM_EncodeSMS30MultiPartSMS(), and GSM_SaveRingtoneOtt().

{
        unsigned char           CommandLength   = 0x02;
        unsigned char           Loop            = 0x15; /* Infinite */

        unsigned char           Buffer[200];
        size_t                  StartBit=0, OldStartBit;
        int                     StartBitHowManyCommands;
        int                     HowManyCommands = 0;    /* How many instructions packed */
        int                     HowManyNotes    = 0;
        int                     i;
        size_t                  j;
        gboolean                        started;
        GSM_RingNote            *Note;

        GSM_RingNoteScale       DefScale = 255;
        GSM_RingNoteStyle       DefStyle = 255;
        int                     DefTempo = 255;

        AddBufferByte(package, &StartBit, CommandLength, 8);
        AddBufferByte(package, &StartBit, SM_Command_RingingToneProgramming, 7);

        /* According to specification we need have next part octet-aligned */
        BufferAlign(package, &StartBit);

        AddBufferByte(package, &StartBit, SM_Command_Sound, 7);
        AddBufferByte(package, &StartBit, SM_Song_BasicSongType, 3);

        /* Packing the name of the tune. */
        EncodeUnicodeSpecialNOKIAChars(Buffer, ringtone->Name, UnicodeLength(ringtone->Name));
        AddBufferByte(package, &StartBit, ((unsigned char)(UnicodeLength(Buffer)<<4)), 4);
        AddBuffer(package, &StartBit, DecodeUnicodeString(Buffer), 8*UnicodeLength(Buffer));

        /* Packing info about song pattern */
        AddBufferByte(package, &StartBit, 0x01, 8); /* one pattern */
        AddBufferByte(package, &StartBit, SM_InstructionID_PatternHeaderId, 3);
        AddBufferByte(package, &StartBit, SM_PatternID_A_part, 2);
        AddBufferByte(package, &StartBit, ((unsigned char)(Loop<<4)), 4);

        /* Later here will be HowManyCommands */
        StartBitHowManyCommands=StartBit;
        StartBit = StartBit + 8;

        started = FALSE;
        for (i=0; i<ringtone->NoteTone.NrCommands; i++) {
                if (ringtone->NoteTone.Commands[i].Type != RING_Note) {
                        HowManyNotes++;
                        continue;
                }
                Note = &ringtone->NoteTone.Commands[i].Note;
                if (!started) {
                        /* First note can't be Pause - it makes problems
                         * for example with PC Composer
                         */
                        if (Note->Note != Note_Pause) started = TRUE;
                }
                if (!started) {
                        HowManyNotes++;
                        continue;
                }
                OldStartBit = StartBit;
                /* we don't write Scale & Style info before "Pause" note - it saves place */
                if (Note->Note!=Note_Pause) {
                        if (DefScale != Note->Scale || ringtone->NoteTone.AllNotesScale) {
                                j = StartBit+5+8;
                                BufferAlignNumber(&j);
                                if ((j/8)>(*maxlength)) {
                                        StartBit = OldStartBit;
                                        break;
                                }
                                DefScale = Note->Scale;
                                AddBufferByte(package, &StartBit, SM_InstructionID_ScaleInstructionId, 3);
                                AddBufferByte(package, &StartBit, ((unsigned char)((DefScale-4)<<6)), 2);
                                HowManyCommands++;
                        }
                        if (DefStyle != Note->Style) {
                                j = StartBit+5+8;
                                BufferAlignNumber(&j);
                                if ((j/8)>(*maxlength)) {
                                        StartBit = OldStartBit;
                                        break;
                                }
                                DefStyle = Note->Style;
                                AddBufferByte(package, &StartBit, SM_InstructionID_StyleInstructionId, 3);
                                AddBufferByte(package, &StartBit, ((unsigned char)DefStyle), 2);
                                HowManyCommands++;
                        }
                }
                /* Beats per minute/tempo of the tune */
                if (DefTempo != GSM_RTTLGetTempo(Note->Tempo)) {
                        j = StartBit+8+8;
                        BufferAlignNumber(&j);
                        if ((j/8)>(*maxlength)) {
                                StartBit = OldStartBit;
                                break;
                        }
                        DefTempo=GSM_RTTLGetTempo(Note->Tempo);
                        /* Adding beats per minute (tempo) of the tune */
                        AddBufferByte(package, &StartBit, SM_InstructionID_TempoInstructionId, 3);
                        AddBufferByte(package, &StartBit, ((unsigned char)DefTempo), 5);
                        HowManyCommands++;
                }
                j = StartBit+12+8;
                BufferAlignNumber(&j);
                if ((j/8)>(*maxlength)) {
                        StartBit = OldStartBit;
                        break;
                }
                /* Note */
                AddBufferByte(package, &StartBit, SM_InstructionID_NoteInstructionId, 3);
                AddBufferByte(package, &StartBit, ((unsigned char)Note->Note), 4);
                AddBufferByte(package, &StartBit, ((unsigned char)Note->Duration), 3);
                AddBufferByte(package, &StartBit, ((unsigned char)Note->DurationSpec), 2);
                HowManyCommands++;
                /* We are sure, we pack it for SMS or setting to phone, not for OTT file */
                if (*maxlength<1000) {
                        /* Like Pc Composer say - before of phone limitations...*/
                        if (HowManyNotes==130-1) break;
                }
                HowManyNotes++;
        }

        BufferAlign(package, &StartBit);
        AddBufferByte(package, &StartBit, SM_CommandEnd_CommandEnd, 8);

        OldStartBit = StartBit;
        StartBit = StartBitHowManyCommands;
        /* HowManyCommands */
        AddBufferByte(package, &StartBit, ((unsigned char)HowManyCommands), 8);
        StartBit = OldStartBit;

        *maxlength=StartBit/8;

        return(i);
}

GSM_RingNoteGetFrequency()

int GSM_RingNoteGetFrequency

(

GSM_RingNote

Note

)

Definition at line 40 of file gsmring.c.

References GSM_RingNote::Note, Note_A, Note_Ais, Note_C, Note_Cis, Note_D, Note_Dis, Note_E, Note_F, Note_Fis, Note_G, Note_Gis, Note_H, Note_INVALID, Note_Pause, GSM_RingNote::Scale, Scale_1760, Scale_3520, Scale_440, and Scale_880.

Referenced by GSM_SaveRingtoneWav(), and PHONE_RTTLPlayOneNote().

{
        int freq = 0;

        /* Values according to the software from http://iki.fi/too/sw/xring/
         * generated with:
         * perl -e 'print int(4400 * (2 **($_/12)) + .5)/10, "\n" for(3..14)'
         */
        switch (Note.Note) {
                case Note_C  : freq = 52330;                            break;
                case Note_Cis: freq = 55440;                            break;
                case Note_D  : freq = 58730;                            break;
                case Note_Dis: freq = 62230;                            break;
                case Note_E  : freq = 65930;                            break;
                case Note_F  : freq = 69850;                            break;
                case Note_Fis: freq = 74000;                            break;
                case Note_G  : freq = 78400;                            break;
                case Note_Gis: freq = 83060;                            break;
                case Note_A  : freq = 88000;                            break;
                case Note_Ais: freq = 93230;                            break;
                case Note_H  : freq = 98780;                            break;
                case Note_Pause:                                        break;
                case Note_INVALID:                                      break;
        }
        if (Note.Note != Note_Pause) {
                switch (Note.Scale) {
                        case Scale_440 : freq = freq / 2;                       break;
                        case Scale_880 :                                        break;
                        case Scale_1760: freq = freq * 2;                       break;
                        case Scale_3520: freq = freq * 4;                       break;
                        default        :                                        break;
                }
        }
        return freq / 100;
}

GSM_RingNoteGetFullDuration()

int GSM_RingNoteGetFullDuration

(

GSM_RingNote

Note

)

Definition at line 76 of file gsmring.c.

References DottedNote, DoubleDottedNote, GSM_RingNote::Duration, Duration_1_16, Duration_1_2, Duration_1_32, Duration_1_4, Duration_1_8, Duration_Full, Duration_INVALID, GSM_RingNote::DurationSpec, DurationSpec_INVALID, Length_2_3, and NoSpecialDuration.

Referenced by GSM_SaveRingtoneMidi(), GSM_SaveRingtoneWav(), PHONE_RTTLPlayOneNote(), and RTTL2Binary().

{
        int duration = 1;

        switch (Note.Duration) {
                case Duration_Full : duration = 128;                    break;
                case Duration_1_2  : duration = 64;                     break;
                case Duration_1_4  : duration = 32;                     break;
                case Duration_1_8  : duration = 16;                     break;
                case Duration_1_16 : duration = 8;                      break;
                case Duration_1_32 : duration = 4;                      break;
                case Duration_INVALID:                                  break;
        }
        switch (Note.DurationSpec) {
                case NoSpecialDuration  :                               break;
                case DottedNote         : duration = duration * 3/2;    break;
                case DoubleDottedNote   : duration = duration * 9/4;    break;
                case Length_2_3         : duration = duration * 2/3;    break;
                case DurationSpec_INVALID:                              break;
        }
        return duration;
}