Animation Control Class

Brief Introduction to Animation Control

Animation control provides rich visual experience to the users through drawing and displaying image group and GIF dynamic images. Animation control in mGNCS is derived from animation control of MiniGUI 3.0, and based on it, support to image group play and GIF image play control is added. At the same time, users can control the play speed through setting image play interval.

Animate class hierarchical relationship:

mStatic
- mAnimate

Control creating method

Automatic creation: through interface designer in miniStudio, drag corresponding animation control, select GIF image or image directory that need to load in the property column, and miniStudio will automatically create control and provides visual control configuration, at the same time, creation codes are generated automatically.
Manual generation: according to mGNCS control creating process, through programming, corresponding control window class ID is imported, and control is generated. Manual programming sets control property and event handling.

mAnimate

Control window class: NCSCTRL_ANIMATE
Control English name: Animate
Brief introduction: Animation control. Display drawn dynamic images through loading different image processing objects on the control.
Schematic diagram:

Style of `mAnimate`

It is inherited from the style of mStatic

Style name

miniStudio property name

Explanation

NCSS_ANMT_AUTOLOOP

Loop

Set animation play as automatic circle or not. When setting as True, the images are played in circle. When setting as False, it will stop after the images are all played.

NCSS_ANMT_SCALE

Scale->ImageScaled

Set the image play area as control region area, and the images can be played enlarged or reduced

NCSS_ANMT_AUTOFIT

Scale->AutoFit

Set the control region automatic matched as image area

NCSS_ANMT_AUTOPLAY

Autoplay

Set images as automatic play or not. When it is True, the images are played automatically. When it is False, it is necessary for the users to send order to control the play

Property of `mAnimate`

It is inherited from the property of mStatic

Property

miniStudio property name

Type

Authority

Explanation

NCSP_ANMT_GIFFILE

GIFFile

String

RW

Name of the GIF image file loaded by the animation control

NCSP_ANMT_DIR

Dir

String

RW

Name if the directory loaded by the animation control. The control loads all the images in the directory. Image play is according to the first letter ascii code sequence of the images supported

NCSP_ANMT_INTERVAL

Interval

int

RW

Time interval between the frames when the images are played

Event of `mAnimate`

It is inherited from the event of mStatic

Renderer of `mAnimate`

For the drawing of non client area, please refer to the renderer of mStatic

Method of `mAnimate`

ncsAnimateStart

BOOL ncsAnimateStart(mAnimate* self);

Parameter:
- self -- animation control pointer that needs operation
Explanation: Start to play the animation control that self corresponds to. If the animation control is being played, then return to the animation starting point to begin playing.
Example:

// Play anim animation
    mAnimate *anim = (mAnimate *)ncsGetChildObj(hwnd, IDC_ANI);
    ncsAnimateStart(anim);

ncsAnimatePauseResume

BOOL ncsAnimatePauseResume(mAnimate* self);

Parameter:
- self -- animation control pointer that needs operation
Explanation: If the current animation is paused, this method will continue to play the animation. If the animation is in play, this method will pause to the animation.
Example:

// Pause anim animation
    mAnimate *anim = (mAnimate *)ncsGetChildObj(hwnd, IDC_ANI);
    ncsAnimateStart(anim);
    ncsAnimatePauseResume(anim);

ncsAnimateStop

BOOL ncsAnimateStop(mAnimate* self);

Parameter:
- self -- animation control pointer that needs operation
Explanation: Stop the animation, and reset the animation back to the first frame.
Example:

// Stop anim animation
    mAnimate *anim = (mAnimate *)ncsGetChildObj(hwnd, IDC_ANI);
    ncsAnimateStop(anim);

Programming Example of `mAnimate`

List 1 animation.c

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include <minigui/common.h>
#include <minigui/minigui.h>
#include <minigui/gdi.h>
#include <minigui/window.h>
#include <minigui/control.h>
#include "../include/mgncs.h"
#include "../include/mrdr.h"
#define IDC_ANI 100
#define IDC_BTN1 101
#define IDC_BTN2 102
#define IDC_BTN3 103
#define IDC_ANIM 104

static BOOL mymain_onCreate(mWidget* self, DWORD add_data)
{
    //TODO : initialize
    return TRUE;
}

static void mymain_onClose(mWidget* self, int message)
{
    DestroyMainWindow(self->hwnd);
    PostQuitMessage(0);
}

//START_OF_PIC
static NCS_PROP_ENTRY animate_props [] = {
    { NCSP_ANMT_GIFFILE, (DWORD)"tuzi1.gif" },
    { NCSP_ANMT_INTERVAL, 6 },
    {0, 0}
};

static NCS_PROP_ENTRY animate_props_ex [] = {
    { NCSP_ANMT_DIR, (DWORD)"." },
    { NCSP_ANMT_INTERVAL, 100 },
    {0, 0}
};
//END_OF_PIC

NCS_RDR_ELEMENT btn_rdr_elements[] =
{
    { NCS_MODE_USEFLAT, 1},
    { -1, 0 }
};

static NCS_RDR_INFO btn_rdr_info[] =
{
    {"flat","flat", NULL}
};

NCS_RDR_ELEMENT animate_rdr_elements[] =
{
    { NCS_MODE_USEFLAT, 1},
    { -1, 0 }
};

static NCS_RDR_INFO animate_rdr_info[] =
{
    {"flat", "flat", NULL}
};

//START_OF_KEY_EVENT
static void btn_notify(mWidget *button, int id, int nc, DWORD add_data)
{
    mAnimate *anim = (mAnimate *)ncsGetChildObj(GetParent(button->hwnd), IDC_ANI);

    switch (id)
    {
        case IDC_BTN1 :
            ncsAnimateStart(anim);
            break;
        case IDC_BTN2 :
            ncsAnimatePauseResume(anim);
            break;
        case IDC_BTN3 :
            ncsAnimateStop(anim);
            break;
    }

}

static NCS_EVENT_HANDLER btn_handlers [] = {
    NCS_MAP_NOTIFY(NCSN_BUTTON_PUSHED, btn_notify),
    {0, NULL}
};
//END_OF_KEY_EVENT

//START_OF_TMPL
static NCS_WND_TEMPLATE _ctrl_templ[] = {
    {
        NCSCTRL_ANIMATE,
        IDC_ANI,
        50, 50, 300, 300,
        WS_BORDER | WS_VISIBLE |NCSS_ANMT_AUTOFIT | NCSS_ANMT_AUTOLOOP | NCSS_ANMT_AUTOPLAY,
        WS_EX_NONE,
        "test",
        animate_props, //props,
        animate_rdr_info,
        NULL, //handlers,
        NULL, //controls
        0,
        0 //add data
    },
    {
        NCSCTRL_ANIMATE,
        IDC_ANIM,
        0, 230, 300, 300,
        WS_BORDER | WS_VISIBLE | NCSS_ANMT_AUTOLOOP | NCSS_ANMT_AUTOFIT | NCSS_ANMT_AUTOPLAY,
        WS_EX_NONE,
        "test2",
        animate_props_ex, //props,
        animate_rdr_info,
        NULL, //handlers,
        NULL, //controls
        0,
        0 //add data
    },
    {
        NCSCTRL_BUTTON,
        IDC_BTN1,
        450, 100, 70, 30,
        WS_VISIBLE | NCSS_NOTIFY,
        WS_EX_NONE,
        "Start",
        NULL,
        btn_rdr_info,
        btn_handlers,
        NULL,
        0,
        0
    },
    {
        NCSCTRL_BUTTON,
        IDC_BTN2,
        450, 200, 70, 30,
        WS_VISIBLE | NCSS_NOTIFY,
        WS_EX_NONE,
        "Pause",
        NULL,
        btn_rdr_info,
        btn_handlers,
        NULL,
        0,
        0
    },
    {
        NCSCTRL_BUTTON,
        IDC_BTN3,
        450, 300, 70, 30,
        WS_VISIBLE | NCSS_NOTIFY,
        WS_EX_NONE,
        "Stop",
        NULL,
        btn_rdr_info,
        btn_handlers,
        NULL,
        0,
        0
    },
};
//END_OF_TMPL

static NCS_EVENT_HANDLER mymain_handlers[] = {
    {MSG_CREATE, mymain_onCreate},
    {MSG_CLOSE, mymain_onClose},
    {0, NULL}
};

//define the main window template
static NCS_MNWND_TEMPLATE mymain_templ = {
    NCSCTRL_DIALOGBOX,
    1,
    0, 0, 600, 600,
    WS_CAPTION | WS_BORDER | WS_VISIBLE,
    WS_EX_NONE,
    "animate Test ....",
    NULL,
    NULL,
    mymain_handlers,
    _ctrl_templ,
    sizeof(_ctrl_templ)/sizeof(NCS_WND_TEMPLATE),
    0,
    0, 0,
};

int MiniGUIMain(int argc, const char* argv[])
{
    ncsInitialize();
    mDialogBox* mydlg = (mDialogBox *)ncsCreateMainWindowIndirect(&mymain_templ, HWND_DESKTOP);

    _c(mydlg)->doModal(mydlg, TRUE);


    MainWindowThreadCleanup(mydlg->hwnd);
    return 0;
}

#ifdef _MGRM_THREADS
#include <minigui/dti.c>
#endif

Set loading image

static NCS_PROP_ENTRY animate_props [] = {
    { NCSP_ANMT_GIFFILE, (DWORD)"tuzi1.gif" },
    { NCSP_ANMT_INTERVAL, 6 },
    {0, 0}
};

static NCS_PROP_ENTRY animate_props_ex [] = {
    { NCSP_ANMT_DIR, (DWORD)"." },
    { NCSP_ANMT_INTERVAL, 100 },
    {0, 0}
};

Set key information

static void btn_notify(mWidget *button, int id, int nc, DWORD add_data)
{
    mAnimate *anim = (mAnimate *)ncsGetChildObj(GetParent(button->hwnd), IDC_ANI);

    switch (id)
    {
        case IDC_BTN1 :
            ncsAnimateStart(anim);
            break;
        case IDC_BTN2 :
            ncsAnimatePauseResume(anim);
            break;
        case IDC_BTN3 :
            ncsAnimateStop(anim);
            break;
    }
}

static NCS_EVENT_HANDLER btn_handlers [] = {
    NCS_MAP_NOTIFY(NCSN_BUTTON_PUSHED, btn_notify),
    {0, NULL}
};

Set display interface template

static NCS_WND_TEMPLATE _ctrl_templ[] = {
    {
        NCSCTRL_ANIMATE,
        IDC_ANI,
        50, 50, 300, 300,
        WS_BORDER | WS_VISIBLE |NCSS_ANMT_AUTOFIT | NCSS_ANMT_AUTOLOOP | NCSS_ANMT_AUTOPLAY,
        WS_EX_NONE,
        "test",
        animate_props, //props,
        animate_rdr_info,
        NULL, //handlers,
        NULL, //controls
        0,
        0 //add data
    },
    {
        NCSCTRL_ANIMATE,
        IDC_ANIM,
        0, 230, 300, 300,
        WS_BORDER | WS_VISIBLE | NCSS_ANMT_AUTOLOOP | NCSS_ANMT_AUTOFIT | NCSS_ANMT_AUTOPLAY,
        WS_EX_NONE,
        "test2",
        animate_props_ex, //props,
        animate_rdr_info,
        NULL, //handlers,
        NULL, //controls
        0,
        0 //add data
    },
    {
        NCSCTRL_BUTTON,
        IDC_BTN1,
        450, 100, 70, 30,
        WS_VISIBLE | NCSS_NOTIFY,
        WS_EX_NONE,
        "Start",
        NULL,
        btn_rdr_info,
        btn_handlers,
        NULL,
        0,
        0
    },
    {
        NCSCTRL_BUTTON,
        IDC_BTN2,
        450, 200, 70, 30,
        WS_VISIBLE | NCSS_NOTIFY,
        WS_EX_NONE,
        "Pause",
        NULL,
        btn_rdr_info,
        btn_handlers,
        NULL,
        0,
        0
    },
    {
        NCSCTRL_BUTTON,
        IDC_BTN3,
        450, 300, 70, 30,
        WS_VISIBLE | NCSS_NOTIFY,
        WS_EX_NONE,
        "Stop",
        NULL,
        btn_rdr_info,
        btn_handlers,
        NULL,
        0,
        0
    },
};

<< Edit Box and Derived Control Classes | Table of Contents | Other Advanced Control Classes >>

PreviousEdit Box Series Control Class NextOther Advanced Control Class

Last updated 2 days ago

Brief Introduction to Animation Control

mAnimate

Style of mAnimate

Property of mAnimate

Event of mAnimate

Renderer of mAnimate

Method of mAnimate

ncsAnimateStart

ncsAnimatePauseResume

ncsAnimateStop

Programming Example of mAnimate

Style of `mAnimate`

Property of `mAnimate`

Event of `mAnimate`

Renderer of `mAnimate`

Method of `mAnimate`

Programming Example of `mAnimate`