Explicaciones de funciones de librerías

[albertnet3]

Hoy les voy a enseñar a usar esta fun sirve para poner un icono o una imagen:

ImageID_Get

parametros:
const wchar_t * fpath,(ruta de la imagen).
const wchar_t * fname,( nombre y extension de la imagen).
wchar_t * imageID,(seria como la memoria virtual donde se guardara la imagen).

y se usaria asi en un mensajebox con imagen seria de esta manera:

wchar_t * imageID;
ImageID_Get(L"/card/other",L"picture.jpg",&imageID);
MessageBox(EMPTY_SID, STR("TopSony Elfmaker Team Group"),imageID, 1, 5000 ,0);

Nota1: la imagen puede ser tambien de otros tipos de formatos no solo jpg tambien puede ser bmp, png, gif, etcetera.
Nota2: despus de usarse imageID se tiene que liberar usando esta otra funsion:

ImageID_Free

Parametros:
wchar_t imageID(seria como la memoria virtual donde se guardo la imagen en el ejemplo anterior se uso ,imageID).

ejemplo de como se usa:

wchar_t * imageID;
ImageID_Get(L"/card/other",L"picture.jpg",&imageID);
MessageBox(EMPTY_SID, STR("TopSony Elfmaker Team Group"),imageID, 1, 5000 ,0);
ImageID_Free(imageID);

espero sea de su utilidad

[albertnet3]

Hoy les voy a explicar esta funsion que sirve para renombrar algun archivo:

rename

Parametros:
const wchar_t* oldpath,(Ruta del archivo a renombrar).
const wchar_t* oldfname,(nombre con extension del archivo a renombrar).
const wchar_t* newpath,(nueva ruta del archivo a renombrar).
const wchar_t* newfname,(el nuevo nombre y extension que tendra el archivo).
int zero(Aqui se pone el "0").

creo que no hace falta poner un ejemplo de como usarla ya que es muy parecida a las funsiones de copiar y mover que ya han sido explicadas con ejemplos y todo.
espero sea de su agrado

esta funsion muy conosida es la usada en el source de Hello Word:

StatusIndication_ShowNotes

Parametros:
STRID(seria el Texto a mostrar en standby como si fuese una nota).

ejemplo de como usarla:

int main (void)
{
  CreateHWBook();
  StatusIndication_ShowNotes(STR("TopSony Elfmakers Team Groups!"));
  return(0);
}

[albertnet3]

HOLA!!! hoy les voy a explicar esta funsion muy simple pero util para el que le interese jeje xD

int BookObj_GetDisplayOrientation

Esta funsion obtine la orientacion de la pantalla en la que:
0 es vertical,
1 es horizontal izquierda,
2 es horizontal derecha.

Parametros:

• BOOK *bk(el nombre del book al cual queremos obtener su orientacion de la pantalla).

ejemplo de como usarla:

MessageBox(EMPTY_SID,
            int2strID(BookObj_GetDisplayOrientation(FindBook(isAudioPlayerBook()))),
             NOIMAGE, 1 ,0,0);

ahi nos dira en un mensaje la orientacion del book audioplayerbook().

y esta es para dar orientacion a algun book:

void BookObj_SetDisplayOrientation

Parametros:
BOOK *bk,(el nombre del book al cual le daremos la orientacion)
int orientation(aqui se pone la orientacion que le daremos al book nombrado en el parametro anterior puden poner 0, 1 o 2 ya saben que hace cada uno de estos ya que los explique mas arriba)

ejemplo de como usarla:

BookObj_SetDisplayOrientation(FindBook(isAudioPlayerBook()),1);

ahi le estoy diciendo que al book del audioplayerbook lo pongo en horizontal izquierda.
espero le aya servido esta funsion es usada por el elf orientation y tambien por mi mini elfito LandsCapeViewerForA2.V1.1.elf

[anarkes]

1.

Obtiene el BOOK actual

#pragma swi_number=0x31B
__swi __arm BOOK* Display_GetTopBook( int display );

Parametros:
int display //(0 pantalla interna, 1 pantalla externa, al menos eso recuerdo)

Return (Retorno):
BOOK * //El BOOK actual

2.

Crea una GUI del tipo TextFeedbackWindow... un ejemplo de una GUI asi, es la ventana que aparece cuando
cambias un tema y dice "Configurando tema, espera por favor."

#pragma swi_number=0x2C5
__swi __arm GUI_FEEDBACK* TextFeedbackWindow( BOOK* book, int zero );

Parametros:
BOOK* book //(En el que se desea crear la GUI)
int zero //(Este no se que es con exactitud, pero se pone 0)

Return (Retorno):
GUI_FEEDBACK*
La GUI creada

3.

Funcion que le agrega un texto a cualquier GUI_FEEDBACK

#pragma swi_number=0x2C9
__swi __arm void Feedback_SetTextExtended( GUI_FEEDBACK*, STRID text, int where );

Parametros:
GUI_FEEDBACK* //(GUI al que se le va a añadir el texto)
STRID text //(Aqui es donde va el texto de tipo STRID, para ella puedes usar STR() )
int where //(Este se supone que es en el lugar que se desea que se vea, pero no recuerdo el rango, yo siempre pongo 0)

Return (Retorno):
Ninguno

4.

Funcion que le da funcion a los softkeys en una GUI
para mas info sobre las acciones, ver el archivo ./include/DYN_tag.h o ./dynconst/target/El_modelo_y_firm_de_su_cel.h

#pragma swi_number=0x14B
__swi __arm void GUIObject_SoftKeys_SetAction( GUI*, u16 actionID, void (*proc)( BOOK*, GUI* ) );

Parametros:
GUI*, //(es donde se agrega la accion)
u16 actionID, //(La accion que se agregara)
void (*proc)( BOOK*, GUI* ) //Este parametro, es la Funcion que se ejecutara al cumplirse la accion (ACTION), la cual
debe tener como parametros BOOK*, GUI*, y debera ser sin retorno (void)

Retorno:
Ninguno

5.

Esta funcion sirve para mostrar una GUI en pantalla
#pragma swi_number=0x134
__swi __arm void GUIObject_Show( GUI* );

Parametros:
GUI * //La GUI que se mostrara

Retorno:
Ninguno

6.

Esta Funcion Sirve para "cerrar" una GUI

#pragma swi_number=0x1CE
__swi __arm GUI* GUIObject_Destroy( GUI* );

Parametros:
GUI * //La GUI que se mostrara

Retorno:
GUI * //La GUI que se destruyo (cerro)

Modo de Uso

...
void CloseGUI( BOOK*, GUI*gui ){

  GUIObject_Destroy(gui);

}
...
BOOK * bk = Display_GetTopBook(0);
GUI_FEEDBACK * MyGUI = TextFeedbackWindow(bk, 0);
Feedback_SetTextExtended( MyGUI, STR("TopSony"), 0 );
GUIObject_SoftKeys_SetAction( MyGUI, 0xFC0 /*ACTION_BACK*/, CloseGUI );
GUIObject_SoftKeys_SetAction( MyGUI, 0xFAF /*ACTION_LONG_BACK*/, CloseGUI );
GUIObject_Show( MyGUI);
...

Espero y sea de su agrado

P.D.
No e provado el "Modo de Uso" por que no tengo cel para hacerlo, pero deberia funcionar, de todas formas cualquier error/duda ya saben

Saludos.

[albertnet3]

hoy les voy a explicar esta funsion

BOOK * Find_StandbyBook(void)

Parametros:
no tiene.
esta funsion sirve para obtener como asi decir el book de la pantalla de modo espera.
ejemplo de como usarla:

int main (void)
{
  CreateHWBook();
  BOOK * stb_book = Find_StandbyBook();
  BookObj_SetDisplayOrientation(stb_book,1);
  return(0);
}

ahi le estoy diciendo al elf que si se esta en el standby ponga la orientacion de la pantalla en modo horizontal.