Developers

onHand Manual: Ruptool (C bindings)

Display support functions

• int getUsWdot(int font, char* str)
  Returns the width of the text in str in pixels using the specified proportional font
• void getGvPos(int *x,int *y)
  Returns the position of the LCD display in the GVRAM buffer
• int getLcdfreezeVal(void)
  Returns true if the LCD is freezed

Character manipulation functions

• void StrCpy(char *s1,const char *s2)
  Copy string from s2 to s1, converting to uppecase
• int StrnCmpI(char *s1,char *s2,int n)
  Compare n bytes of the strings, case insensitive
• void strcpy1(char *s1,const char *s2)
  Copy string s2 to s1, without returning a value
• void strcpy2(char *s1,const char *s2,const char *s3)
  Copy string s2 to s1, then concatenate s3 to s1
• void strcpy3(char *s1,const char *s2,const char *s3,const char *s4)
  Copy string s2 to s1, then concatenate s3 and s4 to s1
• void wstrcpy(char *s1,const char *s2,char *s3,const char *s4)
  Copy string s2 to s1 and s4 to s3 (simultaneously)
• void strcpyadd0(char *s1,const char *s2,int n)
  Copy n characters from string s2 to s1, then add a null character to s1
• void strcat1(char *s1,const char *s2)
  Append string s2 to s1, without returning a value
• void strcat2(char *s1,const char *s2,const char *s3)
  Append string s2 and then s3 to string s1
• int strlength(const char *s1)
  Return a int containing the length of the string (stdlib's strlen() returns a size_t)

Common functions

• int CheckLeapYear(int year)
  Returns true if year is a leap year
• int CheckAmPm(int *hour)
  Returns true if hour is in the afternoon (pm)
• void CheckToday(TypeDate *date)
  Fills in date with the data of today
• int CheckWeek(int year,int month,int day)
  Returns the weekday of the specified date, 0 being Sunday, 1 Monday and so on.
• int GetNWeek(int year, int month, int N, int weekday)
  Returns the day of the Nth occurrence of weekday in the month
• int GetExtFileName(char *path, char extbuf[][9], int nmax)
  Returns nmax files matching path in extbuf
• void SoundDEMO(char *filepath)
  Plays up to 512 bytes of the specified sound file
• void GetNdaysafter(TypeDate *date, long Ndays, int lastyear)
  Advance Ndays in the date specified, being no later than lastyrear
• int YearDayCount(int year)
  Number of days in the specified year
• int CheckDayCountSet(TypeDate *date)
  Number of days since January 1st
• long GetSubDays(TypeDate *date1, TypeDate *date2)
  Returns the number of days elapsed between date1 and date2
• int GetSubTime(TypeTime *time1, TypeTime *time2)
  Returns the number of minutes elapsed between time1 and time2
• int GetNhourafter(TypeTime *time, int N)
  Advance N minutes the specified time
• int CheckTimeTable(TypeDate *date1,TypeDate *date2,TypeDate *date3)
  Returns true if date1 is between date2 and date3

Child process switching functions (aka using overlays in ruputer's W-PsDOS)

• void SetExtensionInfo(unsigned long pInfo)
  Set the pointer to shared data between main app and childs
• int ExtensionAppsExecute(char *path)
  Execute the specified child process, and wait to child termination
• long GetExtensionInfo(void)
  Get the pointer to shared data between main app and childs
• void ClearExtensionInfo(void)
  Clear the pointer to shared data between main app and childs