手机CAPP文档
没有找到匹配的文档

目前包含以下库函数可供使用

核心库文件:base.h
音乐播放:sound.h
绘图:graphics.h
安卓手机功能接口:android.h

测试与扩展库

网络接口:net.h
手机c扩展功能接口:exb.h
算法扩展:ex_math.h
游戏开发(精灵):ex_game.h
注:本文档仅适用于手机C图形界面程序

系统头文件:base.h


//系统版本,由于软件的更新,可能会造成有些函数、宏、类型等不一致而导致运行出错
//建议在源码中判断系统版本是否相同
#define _VERSION 3100

//当前平台环境
#define _PLATFORM "android"

//运行模式 解释模式为picoc,编译模式为gcc
#define _RUN_MODE "picoc"

//是否为debug模式
#define _DEBUG 1

typedef unsigned short uint16; //有符号16bit整型
typedef unsigned long int uint32; //无符号32bit整型
typedef long intptr; //用于保存指针地址的整型
typedef long int int32; //有符号32bit整型
typedef unsigned char uint8; //无符号8bit整型
typedef signed char int8; //有符号8bit整型
typedef signed short int16; //有符号16bit整型

//下面四项为大部分系统函数的返回值,没有在系统内定义
#define MR_SUCCESS 0 //成功
#define MR_FAILED -1 //失败
#define MR_IGNORE 1 //不关心
#define MR_WAITING 2 //异步(非阻塞)模式

#define NULL (void*)0
#define TRUE 1
#define FALSE 0
#define SCRW //系统内部宏,值为屏幕宽
#define SCRH //系统内部宏,值为屏幕高

//基本按键值
enum {
_0, _1, _2, _3, _4, _5, _6, _7, _8, _9,
_STAR, _POUND, _UP, _DOWN, _LEFT, _RIGHT,
_SLEFT=17, _SRIGHT, _MENU=17, _BACK, _SEND, _SELECT
};

//基本事件
enum { KY_DOWN, KY_UP, MS_DOWN, MS_UP, MN_SLT, MN_RET, MR_DIALOG, MS_MOVE=12 };

enum { DLG_OK, DLG_CANCEL };

enum { SEEK_SET, SEEK_CUR, SEEK_END };

enum { IS_FILE=1, IS_DIR=2, IS_INVALID=8 };

typedef struct { uint16 x; uint16 y; uint16 w; uint16 h; } rectst;
typedef struct { uint8 r; uint8 g; uint8 b; } colorst;

安卓手机功能:android.h


//控件event事件
enum
{
VIEW_DOWN=20, //控件被按下
VIEW_UP=21 //控件被释放
};
/*
注:当Button被按下时,将执行event事件event(VIEW_DOWN,id,0);
当Button被抬起时,将执行event(VIEW_UP,id,0);
*/

更多具体 API 函数详情请在“搜索”列表检索。

音频控制:sound.h


#ifndef _SOUND_H_
#define _SOUND_H_
/*
要使用以下所有接口请在你的代码中增加“#include "base.h"”和“#include "sound.h"”
*/

typedef struct
{
int32 pos;
}T_DSM_AUDIO_POS;

更多具体 API 函数详情请在“搜索”列表检索。

绘图模块:graphics.h


enum
{
_JPG=0,
_PNG=1,
_BMP16=2
};

typedef struct
{
uint32 width; //宽度
uint32 height; //高度
uint32 stride;
int32 format; //格式
uint32 flags; // 0 for now
void *ptr; //缓存
} BITMAPINFO;

更多具体 API 函数详情请在“搜索”列表检索。

游戏开发:ex_game.h


本文档包含了照相机(Camera)、精灵(Sprite)以及世界(World)等引擎核心对象的管理机制。
利用这些扩展库,可以快速构建基于瓦片图或 2.5D 透视结构的游戏场景。

更多具体 API 函数详情请在“搜索”列表检索。

网络接口:net.h


/*
HTTP下载文件步骤
初始化网络 initnetwork
获取主机IP gethostbyname
建立服务 socket
连接主机 connect
发送数据 send
接收数据 recev
关闭服务 closesocket
关闭网络 closenetwork
*/

// 注意!有回调的函数只能在回调函数被执行后再次调用,
// 如果之前的回调函数还没有被执行,此时如果再次调用将会引起不可预料的结果

// Socket 类型:
#define MR_SOCK_STREAM 0 // 数据流
#define MR_SOCK_DGRAM 1 // 数据包

// 协议类型:
#define MR_IPPROTO_TCP 0 // TCP
#define MR_IPPROTO_UDP 1 // UDP

更多具体 API 函数详情请在“搜索”列表检索。

手机C扩展功能:exb.h


/***** 手机c文件浏览器接口 *****/

文件浏览器类型 (fv_init):
0 普通模式
1 只浏览文件
2 只浏览文件夹

文件浏览器 event 事件:
event(10, DLG_OK, 0); // 确定键被点击
event(10, DLG_CANCEL, 0); // 取消键被点击

/***** 传感器接口 *****/

传感器类型:
1 加速度传感器
2 磁力计
3 倾角事件
4 陀螺仪
5 光线传感器
6 距离传感器
7 温度传感器
注:传感器的支持程度和手机有关。

typedef struct {
int32 x;
int32 y;
int32 z;
} MOTION_ACC;

更多具体 API 函数详情请在“搜索”列表检索。

算法扩展:ex_math.h


本头文件提供了游戏开发中常用的数学和物理计算函数,主要包括:
1. 碰撞检测:点与矩形、圆与矩形、矩形与矩形的交集判断。
2. 距离与角度:两点间距离 (getLineSize)、两点间连线夹角 (getRadiam)。
3. 空间变换:绕中心点旋转后的坐标计算 (toSpin)。

更多具体 API 函数详情请在“搜索”列表检索。

功能开发中...


该文档正文尚未录入,请尝试使用“搜索”功能查找 API 函数。