Explicaciones de funciones de librerías

En este tema se Irán dando a conocer las funciones de las tan famosas librerías.vkp.

aquí solo se pondrán ejemplo:

función XXXXX.
para que sirve .
sus parámetros.
y si tiene o no retornos.
y dar un ejemplo de como se usan.

Empezare yo dando un ejemplo.
Explicare la función tan conocida la de:

MessageBox

Parche VKP

;095C: xxxxxxxx yyyyyyyy ; 257: int MessageBox( STRID header_text, STRID message_text, wchar_t IconID, int style, int time, BOOK* book );

esta función lo que hace es poner un mensaje en una ventana, como su nombre lo indica.
estos son sus parámetros:
STRID header_text(esto seria texto como titulo del mensaje si no se usara titulo se pone EMPTY_SID o 0x6FFFFFFF)
STRID message_text(esto seria el texto de la ventana a mostrarse si no se mostrara texto se pone 0)
wchar_t IconID(aquí seria si usara un icono si no se pone icono se pone NOIMAGE o sino 0)
int style( el estilo del mensaje ósea 1 seria como una ventana y 2 seria como por ejemplo cuando vemos el estado del teléfono así seria el otro estilo)
int time(el tiempo de que se mostrara el mensaje es en milisegundos para que se muestra 5 segundos seria así 5000 y si se pone 0 se mostrara asta que se de clik a la opcion aceptar)
BOOK* book (en que book será mostrado 0 seria el book actual)

un ejemplo:

Código:

---

MessageBox(EMPTY_SID, STR("TopSony Elfmaker Team Group"), NOIMAGE, 1, 5000 ,0);

---

Hola compañeros en este caso intentare explicarles de una manera sencilla que todos puedan entender:D

PlayFile

En concreto esta funcion cirve para reproducir un archivo de conido ya sea un archivo *wav*m4a*mp3 etc...

se utiliza de la siguiente manera:
PlayFile( L"/card/other/", L"prueba.mp3");

Como habran notado esta funcion pide 2 parametros :
1.-La ruta del archivo.
2.-El nombre del archivo.

Código:

---

int main (void) {
PlayFile( L"/card/other/", L"prueba.mp3");
  return(0);
}

---

En este caso al iniciar el elf reproducira el sonido prueba.mp3 que esta en la carpeta otros en la M2


:DExito.....

pues ya que esta tambien esta es muy parecida a la de arriba nada mas que esta ademas de hacer lo de arriba tiene un parametro mas:

PlayFileV

Parametros:
const wchar_t* path.( ruta del sonido).
const wchar_t* fname.(nombre del sonido y extension).
int vol.(Volumen que tendra el sonido a reproducirce, se toma en una escala del 1(min.) al 15(max.)).

ejemplo de como usarse:

Código:

---

int main (void) {
PlayFileV(L"/card/other/", L"prueba.mp3", 15);
  return(0);
}

---

otra funcion facil de usar son estas dos una es para apagar su cel y la otra es para reiniciar:

REQUEST_SYSTEM_SHUTDOWN

un ejemplo se puede usar asi que al iniciar el elf apage el cel y diga un mensaje asta que lo apage de esta manera:

Código:

---

int main (void)
{
CreateHWBook();
MessageBox(EMPTY_SID,STR("el telefono sera apagado"),NOIMAGE,1,0,0);
REQUEST_SYSTEM_SHUTDOWN();
return(0);
}

---

REQUEST_SYSTEM_RESTART

un ejemplo se puede usar asi que al iniciar el elf reinicie el cel y dira un mensaje asta que se reinicie de esta manera:

Código:

---

int main (void)
{
CreateHWBook();
MessageBox(EMPTY_SID,STR("el telefono sera reiniciado"),NOIMAGE,1,0,0);
REQUEST_SYSTEM_RESTART();
return(0);
}

---

AudioControl_Vibrate

Hola compañeros de TopSony esta funcion cirve para hacer vibrar el SE.En este caso crearemos un void llamdo vibra que contendra lo necesario para poder utilizar la funcion.

Código:

---

void vibra (){
  PAudioControl pAC = AudioControl_Init();
  if( !pAC )
      pAC = *GetAudioControlPtr();
      AudioControl_Vibrate(pAC, 100, 50, 300);
}

---

Como notaron esta funcion pide 3 parametros:
0-PAudioControl pIAudioControl (seria el puntero a una instancia o objeto en este caso seria "pAC").
1.-int vibratime ( Es el valor que define el tieempo de las vibraciones (milisegundos).
2.-int pausetime (Es el valor que define cuanto duraran las pausas entre vibraciones(milisegundos)).
3.-int totaltime(Es el tiempo total de vibraciones(miliseguntos)).

Ejemplo:
En este caso al iniciar el elf el SE vibrara.

Código:

---

void vibra (){
  PAudioControl pAC = AudioControl_Init();
  if( !pAC )
      pAC = *GetAudioControlPtr();
      AudioControl_Vibrate(pAC, 100, 50, 300);
}

.....

int main (void) {
  vibra ();
  return(0);
}

---

:a01:Exito....

tambien se puede usar de la siguiente manera:

Código:

---

AudioControl_Init();
AudioControl_Vibrate( *GetAudioControlPtr(), 450, 50, 1500);

---

y tambien esta Inicializa una AudioControl y devuelve un puntero a una instancia de objeto como se muestra en el ejemplo anterior para tener vibracion:

AudioControl_Init

esta se usa para obtener el control inicial del audio en algunos casos esta funsion (k600/k750/w700/w800) comienza ni bien es iniciado el telefono pero en otros modelos que al iniciarse no inician esta funsion usan esta otra GetAudioControlPtr por eso es recomendable siempre usar ambas funsiones juntas para no causar errores.
ejemplo:

Código:

---

PAudioControl pAC = AudioControl_Init();

---

GetAudioControlPtr

simplemente Devuelve la dirección de un puntero a una instancia de objeto de AudioControl por eso se usan en conjunto con la de arriba:
ejemplo:

Código:

---

PAudioControl pAC;
  pAC = *GetAudioControlPtr();

---

ejemplo de usando ambas:

Código:

---

PAudioControl pAC = AudioControl_Init();
  if( !pAC )
      pAC = *GetAudioControlPtr();
 
  ...//aqui lo que haran usando estas dos funsinoes.

---

hoy les voy a explicar esta funsion:

Shortcut_Run

Parametros:
wchar_t* shortcut_name( nombre del acceso directo)

ejemplo de como usarla:

Código:

---

int main (void)
{
CreateHWBook();
Shortcut_Run(L"Menu_CalendarMain");
return(0);
}

---

ahi le estoy diciendo que cuando se inicie el elf me mande a el acceso directo de calendario
para obtener los link a accesos directos para usarlos con esta funsion tienen que abrir su menu.ml y de ahi los obtendran.
espero sea de su utilidad ya que yo la uso en mi elfito MyShortcuts

FindBook

Hola compañeros de TopSony en este post les voy a explicar como se usa la funcion FindBook.Lo primero que devemos hacer el definir el book que vamos a ocupar en nuestro elf, en este caso vamos a definir el book de Administrador de archivos;Lo haremos la de la siguiente manera:

Código:

---

int Admin(BOOK *bk)
{
if (!strcmp(bk->xbook->name,"DataBrowserBook")) {
return 1;
}
else{
 return 0;
 }
};

---

Como habran notado para esto devemos tener 1 parametro que es el siguiente:
IS_NEEDED_BOOK Que es el nombre del book que ocuparemos como lo tiene definido el SE(DataBrowserBook).

ahora se necesita El nombre con el que definiremos el book dentro del elf(Admin).
Y listo tenemos definido el book que vamos a ocupar!!!

Esta funcion se puede emprealr dentro de otras como freebook perola mas usual de usarla es con if , if en españo significa sì, ocea que si se cumple cierta sentencia haga cierta accion o acciones
Ejemplo:

Código:

---

int Admin(BOOK *bk){if (!strcmp(bk->xbook->name,"DataBrowserBook")) { return 1; }else { return 0; }};

.......

int main (void){
if(FindBook(Admin)){
 MessageBox(0x6fFFFFFF,STR("El Administrador de archivos esta abierto =)"),0, 1 ,5000,0);
}
  return(0);
}

---

En este caso al iniciar el elf si esta abierto el Administrador de archivos el elf amrira una caja de texto con el texto,El Administrador de archivos esta abierto =).


NOTA:EN EL BookManager encuentrarn el nombre de los books :D

Exito......

mkdir

Funcion sencilla

Parametros:

Código:

---

int mkdir(const wchar_t* path);

---

Lo que hace esta funcion es crear una nueva carpeta en la direccion que pongamos

Ejemplo:

Código:

---

int ret = mkdir((wchar_t*)L"/card/other/Mi Carpeta");

---

Eso quiere decir que nos creara "Mi Carpeta" en la ruta Card/Other

FreeBook

Hola compañeros de TopSony ahora les explicare como usar la funcion FreeBook.Esta funciona para cerrar un book.

EJEMPLO:

Código:

---

int Admin(BOOK *bk){if (!strcmp(bk->xbook->name,"DataBrowserBook")) { return 1; }else { return 0; }};

....

int main (void){
if(FindBook(Admin)){
FreeBook(FindBook(Admin));
 MessageBox(0x6fFFFFFF,STR("Se a cerrado el administrador de archivos."),0, 1 ,5000,0);
}
  return(0);
}

---

Como ya notaron esta funcion solo pide el parametro del book que se desea cerrar.
En el ejemplo anterior al iniciar el elf si esta abierto el Admin de archivos cerrara el administrador de archivos mandara el mensaje "Se a cerrado el administrador de archivos.".

Exito...

hoy les voy a explicar estas dos funsiones son simples una es para copiar y la otra es para mover:

FileCopy

parametros:
wchar_t* src_path, (Ruta del archivo a copiar).
wchar_t* src_name, (Nombre del archivo a copiar con extension).
wchar_t* dest_path, (Ruta de donde se copiara el archivo).
wchar_t* dest_name, (El nuevo nombre y extension que tendra el archivo copiado).
int ( es un entero puede ser 0(desactivado) o 1 (activado).

FileMove

parametros:

wchar_t* src_path, (Ruta del archivo a mover).
wchar_t* src_name, (Nombre del archivo a mover con extension).
wchar_t* dest_path, (Ruta de donde se movera el archivo).
wchar_t* dest_name, (El nuevo nombre y extension que tendra el archivo movido).
int ( es un entero puede ser 0(desactivado) o 1 (activado)).


ejemplo de como usarlas:

Código:

---

int Admin(BOOK *bk){if (!strcmp(bk->xbook->name,"DataBrowserBook")) { return 1; }else { return 0; }};

....

int main (void){
if(FindBook(Admin)){
FileCopy(L"/card/other/Mi Carpeta/",
L"TopSony.txt,L"/card/other/TopSony/",
L"TopSony Elfmakers team group.xml",1);
} else{
FileMove(L"/card/other/Mi Carpeta/",
L"TopSony.txt,L"/card/other/TopSony/",
L"TopSony Elfmakers team group.xml",1);
}
  return(0);
}

---

ahi le estoy diciendo que al iniciarce el elf y si se esta en administrador de archivos copie de esta ruta /card/other/Mi Carpeta/ el archivo TopSony.txt a esta ruta /card/other/TopSony/ y que tendra este nuevo nombre y extension TopSony Elfmakers team group.xml.
Y si no se esta en el administrador de archivos le estoy diciendo que al iniciarce el elf mueva de esta ruta /card/other/Mi Carpeta/ el archivo TopSony.txt a esta ruta /card/other/TopSony/ y que tendra este nuevo nombre y extension TopSony Elfmakers team group.xml.