Create chinese font

SEGGER - Schoenen · August 11, 2020 at 12:05 PM

Hi,

Try the code below. The font gets created within the parent window of a button. The font data and the handle to the file needs to be valid as long as the button uses the font. Therefore the variables are declared static.

On delete of the window (which does not occur in this example) the button gets also deleted (automatically). At this point the font is not used anymore and can be deleted, too. Although, the window never gets deleted in this example it should show how to make sure a font stays valid as long as it is used.

C

/*********************************************************************
*                    SEGGER Microcontroller GmbH                     *
*        Solutions for real time microcontroller applications        *
**********************************************************************
*                                                                    *
*        (c) 1996 - 2020  SEGGER Microcontroller GmbH                *
*                                                                    *
*        Internet: www.segger.com    Support:  support@segger.com    *
*                                                                    *
**********************************************************************


** emWin V6.10 - Graphical user interface for embedded applications **
emWin is protected by international copyright laws.   Knowledge of the
source code may not be used to write a similar product.  This file may
only  be used  in accordance  with  a license  and should  not be  re-
distributed in any way. We appreciate your understanding and fairness.
----------------------------------------------------------------------
File        : GUI_SetExternalFont_XBF.c
Purpose     : Sample that demonstrates how to create a custom font
              from an external .XBF file
              This sample supports both usage on a Windows PC as well
              as usage on a target device using emFile.
Requirements: WindowManager - ( )
              MemoryDevices - ( )
              AntiAliasing  - ( )
              VNC-Server    - ( )
              PNG-Library   - ( )
              TrueTypeFonts - ( )
---------------------------END-OF-HEADER------------------------------
*/


#include "DIALOG.h"
#include <Windows.h>


/*********************************************************************
*
*       Defines
*
**********************************************************************
*/


#define FILE_PATH "C:\\Work\\emWin\\Intern\\TutorialV6\\Core\\Fonts\\Roboto30.xbf"


/*********************************************************************
*
*       Static code
*
**********************************************************************
*/
/*********************************************************************
*
*       _GetData
*/
static int _GetData(U32 Off, U16 NumBytes, void * pVoid, void * pBuffer) {
  HANDLE    hFile;
  DWORD     NumBytesRead;
  hFile = *(HANDLE *)pVoid;


  //
  // Set file pointer to the requested position
  //
  if (SetFilePointer(hFile, Off, 0, FILE_BEGIN) == 0xFFFFFFFF) {
    return 1; // Error
  }
  //
  // Read font data
  //
  if (!ReadFile(hFile, pBuffer, NumBytes, &NumBytesRead, 0)) {
    return 1; // Error
  }
  if (NumBytesRead != NumBytes) {
    return 1; // Error
  }
  return 0;   // Ok
}


/*********************************************************************
*
*       _cbBk
*/
static void _cbBk(WM_MESSAGE * pMsg) {
  static HANDLE       hFile;
  static GUI_RECT     Rect;
  static GUI_FONT     Font;
  static GUI_XBF_DATA Data;
  WM_HWIN             hItem;


  switch (pMsg->MsgId) {
  case WM_CREATE:
    //
    // Create file handle
    //
    hFile = CreateFile(FILE_PATH, GENERIC_READ, 0, 0, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0);
    //
    // Create the font from the XBF file
    // The font and xbf data will be loaded into the two variables created above.
    // This data has to be valid during the time we use the font.
    //
    GUI_XBF_CreateFont((GUI_FONT*)&Font, &Data, GUI_XBF_TYPE_PROP_AA4_EXT, _GetData, &hFile);


    hItem = BUTTON_CreateEx(10, 10, 160, 40, pMsg->hWin, WM_CF_SHOW, 0, 0);
    BUTTON_SetFont(hItem, &Font);
    BUTTON_SetText(hItem, "A button");


    break;
  case WM_PAINT:
    GUI_SetBkColor(GUI_BLACK);
    GUI_Clear();
    break;
  case WM_DELETE:
    //
    // Close file handle
    //
    CloseHandle(hFile);
    //
    // When the font is no longer currently used, it should be deleted.
    //
    GUI_XBF_DeleteFont(&Font);
    break;
  default:
    WM_DefaultProc(pMsg);
    break;
  }
}


/*********************************************************************
*
*       Public code
*
**********************************************************************
*/
/*********************************************************************
*
*       MainTask
*/
void MainTask(void) {
  //
  // Init emWin.
  //
  GUI_Init();


  WM_MULTIBUF_Enable(1);
  WM_CreateWindowAsChild(0, 0, LCD_GetXSize(), LCD_GetYSize(), WM_HBKWIN, WM_CF_SHOW, _cbBk, 0);


  while (1) {
    GUI_Delay(100);
  }
}


/*************************** End of file ****************************/

Display More

Regards,
Sven

bio_med · August 11, 2020 at 1:44 PM

Sven,

Much appreciate the response but I cannot use createfile because I am using a non OS system. Is there a way to get around that?

Thanks and regards,
BMD

bio_med · October 13, 2020 at 5:33 PM

Hi,

Can anyone tell me if there is a workaround CreateFile for non-OS systems?

Thanks and regards,
BMD

SEGGER - Florian · October 14, 2020 at 11:15 AM

Hi,

CreateFile() is a function provided by the Win32-API. It is used in the above example so it can be run in the emWin simulation on Windows.

If you want to use an XBF font from external memory, your target needs a file system. You can then adapt the sample by replacing the Win32-functions by the equal functions provided by the target file system you are going to use.

You can find an example in the SEGGER Wiki that demonstrates how external XBF fonts can be used in emWin, demonstrated via both the Windows and the emFile system.

Best regards,
Florian

bio_med · October 14, 2020 at 3:37 PM

Florian,

I have tried that example but for some reason it doesn't work on widgets.
Is there a way to set this external Font as default font or this function has to be called every time a new screen is drawn?

Best regards,
BMD

SEGGER - Florian · October 14, 2020 at 5:50 PM

Hi,

since a regular GUI_FONT is created from the XBF-file, the font can be used at any point where a font can be set, including widgets.

Though it is crucial the pointers to GUI_FONT and GUI_XBF_DATA stay valid and the file is kept open while using the font. This is because, every time the font is redrawn (like when a widget uses it), the pixel data of the font is read from the file.

When the font is not needed anymore (e.g. when the widget is deleted), GUI_XBF_DeleteFont() can be called and the file can be closed.

Best regards,
Florian

bio_med · October 19, 2020 at 3:55 PM

HI Florian,

Appreciate all your help. So I tried the following code but I don't see anything on the display whatsoever. Could you please tell me where I am possibly going wrong?
Thank you for all your help.

Best regards,
BMD

C

/*********************************************************************
*                    SEGGER Microcontroller GmbH                     *
*        Solutions for real time microcontroller applications        *
**********************************************************************
*                                                                    *
*        (c) 1996 - 2020  SEGGER Microcontroller GmbH                *
*                                                                    *
*        Internet: www.segger.com    Support:  support@segger.com    *
*                                                                    *
**********************************************************************
** emWin V6.10 - Graphical user interface for embedded applications **
emWin is protected by international copyright laws.   Knowledge of the
source code may not be used to write a similar product.  This file may
only  be used  in accordance  with  a license  and should  not be  re-
distributed in any way. We appreciate your understanding and fairness.
----------------------------------------------------------------------
File        : GUI_SetExternalFont_XBF.c
Purpose     : Sample that demonstrates how to create a custom font
              from an external .XBF file
              This sample supports both usage on a Windows PC as well
              as usage on a target device using emFile.
Requirements: WindowManager - ( )
              MemoryDevices - ( )
              AntiAliasing  - ( )
              VNC-Server    - ( )
              PNG-Library   - ( )
              TrueTypeFonts - ( )
---------------------------END-OF-HEADER------------------------------
*/
#include "DIALOG.h"
#include "FS.h"
/*********************************************************************
*
*       Defines
*
**********************************************************************
*/
#define FILE_PATH "Font.xbf"
/*********************************************************************
*
*       Static code
*
**********************************************************************
*/
/*********************************************************************
*
*       _GetData
*/
static int _GetData(U32 Off, U16 NumBytes, void * pVoid, void * pBuffer) 
{
    FS_FILE * pFile;
    int       NumBytesRead;


    pFile = (FS_FILE *)pVoid;
    //
    // Set file pointer to the requested position
    //
    if(FS_SetFilePos(pFile, Off, FS_FILE_BEGIN)) 
    {
        return 1; // Error
    }
    //
    // Read font data
    //
    NumBytesRead = FS_FRead(pBuffer, 1, NumBytes, pFile);


    if (NumBytesRead == 0) 
    {
        return 1; // Error
    }
    if (NumBytesRead != NumBytes) 
    {
        return 1; // Error
    }
    return 0;   // Ok
}
/*********************************************************************
*
*       _cbBk
*/
static void _cbBk(WM_MESSAGE * pMsg) {
FS_FILE *    pFile;
  static GUI_RECT     Rect;
  static GUI_FONT     Font;
  static GUI_XBF_DATA Data;
  WM_HWIN             hItem;
  switch (pMsg->MsgId) {
  case WM_CREATE:
    //
    // Create file handle
    //
   pFile = FS_FOpen(FILE_PATH, "rb");
    //
    // Create the font from the XBF file
    // The font and xbf data will be loaded into the two variables created above.
    // This data has to be valid during the time we use the font.
    //
    GUI_XBF_CreateFont((GUI_FONT*)&Font, &Data, GUI_XBF_TYPE_PROP_AA4_EXT, _GetData, &pFile);
    hItem = BUTTON_CreateEx(10, 10, 160, 40, pMsg->hWin, WM_CF_SHOW, 0, 0);
    BUTTON_SetFont(hItem, &Font);
    BUTTON_SetText(hItem, "A button");
    break;
  case WM_PAINT:
    GUI_SetBkColor(GUI_RED);
    GUI_Clear();
    break;
  case WM_DELETE:
    //
    // Close file handle
    //
    FS_FClose(pFile);
    //
    // When the font is no longer currently used, it should be deleted.
    //
    GUI_XBF_DeleteFont(&Font);
    break;
  default:
    WM_DefaultProc(pMsg);
    break;
  }
}
/*********************************************************************
*
*       Public code
*
**********************************************************************
*/
/*********************************************************************
*
*       MainTask
*/
void MainTask(void) {
  //
  // Init emWin.
  //
  GUI_Init();
  WM_MULTIBUF_Enable(1);
  WM_CreateWindowAsChild(0, 0, LCD_GetXSize(), LCD_GetYSize(), WM_HBKWIN, WM_CF_SHOW, _cbBk, 0);
//  while (1) {
//    GUI_Delay(100);
//  }
}
/*************************** End of file ****************************/

Display More

SEGGER - Florian · October 19, 2020 at 6:02 PM

Hi,

I noticed a few things:

1. You must not comment out the super-loop in your main-task when using the Window Manager. This will only work when only using GUI_... functions in the MainTask. Otherwise emWin isn't kept alive and no more routines will be called after the MainTask finished.
2. You also have to initialize emFile and mount the external volume.

Once again, have a closer look at the XBF font sample, the file is read exactly the same way.

Best regards,
Florian

bio_med · October 19, 2020 at 6:05 PM

Florian,

Thank you for looking into it. Really appreciate it.

But I am initializing emWin and emFile in another file before calling Maintask().
I have tried the XBF font sample. That works perfectly fine. But now I am trying to incorporate it into widgets and that doesn't seem to work at all whatsoever.

Best regards,
BMD

Create chinese font

Participate now!

Tags

Users Viewing This Thread