MCI播放mp3音频文件例程.doc

MCI播放mp3音频文件例程
源文件中需要包含头文件 Mmsystem.h，在Project->Settings->Link->Object/libray module中加入库 Winmm.lib。或添加代码#pragma   comment(lib, "winmm.lib")
MCI_OPEN_PARMS op;
void CMCIDlg::OnPlay()
{
 // TODO: Add your control notification handler code here
 DWORD cdlen;//音频文件长度
 op.dwCallback=NULL;
 op.lpstrAlias=NULL;
 op.lpstrDeviceType=_T("MPEGAudio");  //设备类型，大多数文件可以这样设置
 op.lpstrElementName=_T("D:\\2.mp3C:\Documents and Settings\All Users\Documents\My Music\示例音乐"); //文件路径
 op.wDeviceID=NULL;      //打开设备成功以后保存这个设备号备用
 UINT rs;        //接受函数返回结果
 //发送命令打开设备，成功返回0，否则返回错误号，第三个参数这里必须MCI_OPEN_ELEMENT  
 rs=mciSendCommand(NULL,MCI_OPEN,MCI_OPEN_ELEMENT,(DWORD)&op);
mciSendCommand(op.wDeviceID,MCI_PLAY,MCI_NOTIFY,(DWORD)&pp);

 mciSendCommand(NULL,MCI_SET,MCI_SET_DOOR_OPEN,NULL);
 cdlen=getinfo(op.wDeviceID,MCI_STATUS_LENGTH);//获取音频文件长度
 if(rs==0)        //设备打开成功就播放文件
 {
  MCI_PLAY_PARMS pp;
  pp.dwCallback=NULL;
  pp.dwFrom=0;      //开始播放的位置
  mciSendCommand(op.wDeviceID,MCI_PLAY,MCI_NOTIFY,(DWORD)&pp);
  //播放文件，如果第三个参数设为MCI_WAIT则程序窗口会被阻塞，为了避免这种情况可以设为MCI_NOTIFY
 }
 Sleep(cdlen);//根据文件长度等待，与MCI_WAIT效果一样，cdlen参数可以控制播放时间
 OnStop();        //关闭音频文件 
}
DWORD CMCIDlg::getinfo(UINT wDeviceID,DWORD item)
{
 MCI_STATUS_PARMS mcistatusparms;
 mcistatusparms.dwCallback=(DWORD)GetSafeHwnd();
 mcistatusparms.dwItem=item;
 mcistatusparms.dwReturn=0;
 mciSendCommand(wDeviceID,MCI_STATUS,MCI_STATUS_ITEM,(DWORD)&mcistatusparms);
 return mcistatusparms.dwReturn;
}
void CMCIDlg::OnStop()
{
 // TODO: Add your control notification handler code here
 //在WM_CLOSE消息处理过程中发送MCI_CLOSE命令关闭设备
 MCI_GENERIC_PARMS gp;
 gp.dwCallback=NULL;
 mciSendCommand(op.wDeviceID,MCI_CLOSE,MCI_WAIT,(DWORD)&gp);  
}
 ==============================================================================================
加入音乐是增强应用程序功能的所有方法中最简单的一个。几乎每个计算机游戏或多媒体程序都以某种MIDI或CD音乐为背景。音乐可以使用户心情愉快；在合适的场合播放恰当的音乐能够使程序员和他的VC++程序焕发光彩。
第一部分 MIDI的播放
乐器数字化接口（MIDI）是由音乐界的一些大公司（包括生产电子音乐合成器的公司）制订的一项协议，后来被计算机产业所采用并成为多媒体音乐文件的标准格式。MIDI文件一般较小，对硬件设备的要求高。
一、 原理
虽然MicroSoft支持MIDI文件，然而Visual C++或MFC并没有创建任何组件来实现这种支持，但是MicroSoft API提供了三种不同的方法来实现MIDI的播放：
MCI（The Media Control Interface）。这是最基本的方法，本文将详细讨论这种方法。
流缓冲器。这种格式允许应用程序为MIDI数据分配缓冲器。在需要精确控制MIDI播放的时候，流缓冲器将很有用处。
低级MIDI设备。需要完全控制MIDI数据的应用程序可以使用这种方法。
MCI可以通过mciSendCommand（）和mciSendString（）来完成，本文仅使用mciSendCommand（）函数。
原型：DWORD mciSendCommand（UINT wDeviceID，UINT wMessage，DWORD dwParam1，DWORD dwParam2）；
参数： wDeviceID：接受消息的设备ID
wMessage：MCI命令消息
dwParam1：命令的标志位
dwParam2：所使用参数块的指针
返值：调用成功，返回零；否则，返回双字中的低字存放有错误信息。
二MIDI的播放控制
1． 打开设备
MCI_OPEN_PARMS OpenParms;
OpenParms.lpstrDeviceType =
(LPCSTR) MCI_DEVTYPE_SEQUENCER;//MIDI类型
OpenParms.lpstrElementName = (LPCSTR) Filename;
OpenParms.wDeviceID = 0;
mciSendCommand (NULL, MCI_OPEN,
MCI_WAIT | MCI_OPEN_TYPE |
MCI_OPEN_TYPE_ID | MCI_OPEN_ELEMENT,
(DWORD)(LPVOID) &OpenParms)
MCI设备ID指明打开了哪个设备，当发送了MCI_OPEN命令时，这个值在参数块中返回——应被保存备用。
2． 关闭设备
mciSendCommand (m_wDeviceID, MCI_CLOSE, NULL, NULL);
3． 播放
MCI_PLAY_PARMS PlayParms;
PlayParms.dwFrom = 0;
// 指定从什么地方（时间）播放
mciSendCommand (m_wDeviceID, MCI_PLAY,
MCI_FROM, (DWORD)(LPVOID)
&PlayParms))；
4． 暂停
MCI_PLAY_PARMS PlayParms;
mciSendCommand (m_wDeviceID, MCI_PAUSE, 0,
(DWORD)(LPVOID) &PlayParms)；
5． 停止
mciSendCommand (m_wDeviceID, MCI_STOP, NULL, NULL);
6． 跳跃
* 跳转到任意地方
MCI_SEEK_PARMS SeekParms;
SeekParms.dwTo = (nMinute * 60 + nSecond) * 1000;
//跳转的目标时间，时间单位为毫秒
mciSendCommand (m_wDeviceID, MCI_SEEK, MCI_TO
| MCI_WAIT,(DWORD)(LPVOID)
&SeekParms)；
* 跳到文件头
mciSendCommand (m_wDeviceID, MCI_SEEK,
MCI_SEEK_TO_START, NULL);
* 跳到文件尾
mciSendCommand (m_wDeviceID, MCI_SEEK,
MCI_SEEK_TO_END, NULL);
7． 查询当前信息
MCI_STATUS_PARMS StatusParms;
StatusParms.dwItem = MCI_SEQ_STATUS_DIVTYPE;
mciSendCommand (m_wDeviceID, MCI_STATUS,
MCI_WAIT | MCI_STATUS_ITEM,
(DWORD)(LPVOID) &StatusParms)；
返回信息存放于StatusParms.dwReturn中。
MCI_STATUS标志
MCI_STATUS_LENGTH 获得文件长度
MCI_STATUS_MODE 获得文件播放的当前状态
MCI_STATUS_POSITION 获得文件播放的当前位置
MCI_STATUS_TIME_FORMAT 获得当前的时间格式
MCI_SEQ_STATUS_DIVTYPE 判断文件是PPQN类型还是SMPTE类型
MCI_SEQ_STATUS_TEMPO 获得当前播放速度，PQRN类型，
此值为节拍/分，SMPTE类型，此值为祯/秒
8． 设置时间格式及播放速度
MCI_SET_PARMS SetParms;
SetParms.dwTimeFormat = MCI_FORMAT_MILLISECONDS;
//设置时间单位为毫秒
mciSendCommand (m_wDeviceID,
MCI_SET, MCI_SET_TIME_FORMAT,
(DWORD)(LPVOID) &SetParms)；
MCI_SEQ_SET_TEMPO 设置播放速度，
PQRN类型，此值为节拍/分，
SMPTE类型，此值为祯/秒
第二部分 WAV文件的播放
一、原理
MicroSoft API提供了三种不同的方法来实现WAV的播放：
PlaySound（）函数。它可以通过单行编码来播放Wave格式的声音。此函数有两个限制：必须将声音数据完整地载入物理内存；数据格式必须被所配置的某一音频驱动器支持。根据经验，PlaySound（）适用于100K以下的文件。
MCI（The Media Control Interface），与上一章播放MIDI文件相似，可以播放100K 以上的文件。
低级Wave音频设备。用这些设备可以运行完全控制Wave数据的应用文件。
二、 WAV文件播放控制
因为同样使用MCI，与上一章相同，只列出不同的部分。
1． 打开设备
将MIDI的MCI_DEVTYPE_SEQUENCER 改为"waveaudio"
2． 录音
MCI_RECORD_PARMS RecordParms;
mciSendCommand (m_wDeviceID, MCI_RECORD,
NULL, (DWORD)(LPVOID)
&RecordParms)；
3． 保存录音
MCI_SAVE_PARMS SaveParms;
SaveParms.lpfilename = (LPCSTR) Filename;
mciSendCommand (m_wDeviceID, MCI_SAVE,
MCI_SAVE_FILE | MCI_WAIT,
(DWORD)(LPVOID) &SaveParms)；
第三部分 CD的播放
CD的独特优势在于，它由作曲家设计，并由音乐厂家生产。不同的计算机播放MIDI 文件时，声音效果也不一样，但是CD的声音效果总是相同的。高品质的音频对计算机用 户产生的效果会使你感到吃惊。我们依然采用MCI播放CD，大部分的播放控制与前两部分相同，只列出不同的部分
1． 开光驱门
mciSendCommand (m_wDeviceID, MCI_SET,
MCI_SET_DOOR_OPEN, NULL);
2． 关光驱门
mciSendCommand (m_wDeviceID, MCI_SET,
MCI_SET_DOOR_CLOSED, NULL);
3． 打开设备
将MIDI的MCI_DEVTYPE_SEQUENCER 改为MCI_DEVTYPE_CD_AUDIO
4． 播放
指定播放起点必须经过MCI_MAKE_TMSF(Track，Minute，Second，Frame)转化
5． 查询当前信息
MCI_STATUS_CURRENT_TRACK 得到当前曲目
MCI_STATUS_LENGTH 得到CD或指定曲目长度
MCI_STATUS_MODE 得到驱动器的当前状态
MCI_STATUS_NUMBER_OF_TRACKS 得到CD曲目的数目
MCI_STATUS_POSITION 得到当前格式下的位置
MCI_STATUS_READY 检查设备是否就绪
MCI_STATUS_TIME_FORMAT 得到当前时间格式
MCI_STATUS_MEDIA_PRESENT 检查以确认CD是否在驱动器内
MCI_CDA_STATUS_TYPE_TRACK 检查已确认某曲目是否为音频曲目
注意：
使用MCI_STATUS_LENGTH参数查询CD 及曲目长度，返回值通过调用MCI_MSF_MINUTE（），MCI_MSF_SECOND（）转换为分、秒。
MCI_STATUS_POSITION参数返回值调用MCI_TMSF_TRACK（）, MCI_TMSF_MINUTE（）， MCI_TMSF_SECOND（），MCI_TMSF_FRAME才能得到当前的位置的道、分、秒、帧。
6． 跳跃
跳转的目标必须经过MCI_MAKE_TMSF(Track，Minute，Second，Frame)转化最好将上述三种格式分开建类，或做成动态连接库。在 Project-- >Setting-- >Link-- >Object/library modules中加入winmm.lib，源程序中包含。
MCI调用简单，功能强大，可以满足日常多媒体编程的基本需要。但是，MCI一次只能播放一个文件，使用DirectSound技术可以实现八个以上WAV文件的同时播放。
 ==============================================================================================
使用MCI API，源文件中需要包含头文件 Mmsystem.h，在Project->Settings->Link->Object/libray module中加入库 Winmm.lib。
１、MCI简介
MCI(Media Control Interface，媒体控制接口)向Windows程序提供了在高层次上控制媒体设备接口的能力。程序不必关心具体设备，就可以对激光唱机（CD）、视盘机、波形音频设备、视频播放设备和MIDI设备等媒体设备进行控制。
对于程序员来说，可以把MCI理解为设备面板上的一排按键，通过选择不同的按键（发送不同的MCI命令）可以让设备完成各种功能，而不必关心设备内部实现。
比如，对于play，视盘机和CD机有不同的反应（一个是播放视频，一个播放音频），而对用户来说却只需要按同一按钮。
应用程序通过向MCI发送命令来控制媒体设备。MCI命令接口分命令字符串和命令消息两种，两者具有相同的功能。命令字符串具有使用简单的特点，但是它的执行效率不如命令消息。
所有的MCI命令字符串都是通过多媒体API函数mciSendString传递给MCI的，该函数的声明为：
　　MCIERROR mciSendString(
　　　　LPCTSTR lpszCommand, 　　　//MCI命令字符串
　　　　LPTSTR　lpszReturnString,　//存放反馈信息的缓冲区
　　　　UINT　　cchReturn, 　　　　//缓冲区的长度
　　　　HANDLE　hwndCallback 　　　//回调窗口的句柄，一般为NULL
　　); //若成功则返回0，否则返回错误码。
该函数返回的错误码可以用mciGetErrorString函数进行分析，该函数的声明为：
　　BOOL mciGetErrorString(
　　　　DWORD　fdwError,　　　//函数mciSendString返回的错误码
　　　　LPTSTR lpszErrorText, //接收描述错误的字符串的缓冲区
　　　　UINT　 cchErrorText　 //缓冲区的长度
　　);
下面是使用mciSendString函数的一个简单例子：
　　char buf[50];
　　MCIERROR mciError;
　　mciError=mciSendString("open cdaudio",buf,strlen(buf),NULL);
　　if(mciError)
　　{
　　　　mciGetErrorString(mciError,buf,strlen(buf));
　　　　AfxMessageBox(buf);
　　　　return;
　　}
open cdaudio命令打开CD播放器，如果出错（如驱动器内没有CD）则返回错误码，此时可以用mciGetErrorString函数取得错误信息字符串。
２、MCI设备
open是MCI打开设备的命令，cdaudio是MCI设备名。MCI的设备类型如下：
　　animation　　动画设备
　　cdaudio　　　CD播放器
　　dat　　　　　数字音频磁带机
　　digitalvideo 某一窗口中的数字视频（不基于GDI）
　　other　　　　未定义的MCI设备
　　overlay　　　重叠设备（窗口中的模拟视频）
　　scanner　　　图象扫描仪
　　sequencer　　MIDI序列器
　　videodisc　　视盘机
　　waveaudio　　播放数字波形文件的音频设备
设备名是在注册表或SYSTEM.INI的[mci]部分定义的，典型的[mci]段如下：
　　[mci]
　　cdaudio=mcicda.drv
　　sequencer=mciseq.drv
　　waveaudio=mciwave.drv
　　avivideo=mciavi.drv
　　videodisc=mcipionr.drv
等号的左边是设备名，右边是对应的MCI驱动程序。当安装了新的MCI驱动程序时，系统要用不同的设备名来区分。
３、MCI命令
使用MCI设备一般包括打开、使用和关闭三个过程，常用的MCI命令有：
　　open　　　　打开设备
　　close　　　 关闭设备
　　play　　　　开始设备播放
　　stop　　　　停止设备的播放或记录
　　record　　　开始记录
　　save　　　　保存设备内容
　　pause　　　 暂停设备的播放或记录
　　resume　　　恢复暂停播放或记录的设备
　　seek　　　　改变媒体的当前位置
　　capacility　查询设备能力
　　info　　　　查询设备的信息
　　status　　　查询设备状态信息
MCI的大部分命令可以控制不同的媒体设备，但其中record和save命令并不是所有MCI设备都可以使用。
MCI命令的使用是很随意的，只要先打开，最后关闭，中间可以随意调用各种命令。
(1) open　打开设备
MCI设备使用前必须先打开，当然，使用后也必须要关闭，以免影响他人的使用。
open device_name type device_type alias device_alias
　　device_name　 　　　要使用的设备名，通常是文件名。
　　type device_type　　设备类型，例如waveaudio或sequencer，可省略。
　　alias device_alias　设备别名，指定后可在其他命令中代替设备名。
(2) play　开始设备播放
MCI设备打开后即可以播放，可使用设备名或别名。
play device_alias from pos1 to pos2 wait repeat
　　若省略from则从当前磁道开始播放，若省略to则播放到结束。
　　若指明wait则等到播放完毕命令才返回。
　　若指明repeat则会不停的重复播放。
　　若同时指明wait和repeat则命令不会返回，本线程产生堵塞，通常会引起程序失去响应。
(3) 播放CD
void CTttView::OnOpenCD()
{
　　mciSendString("open cdaudio",NULL,0,NULL);
　　mciSendString("play cdaudio",NULL,0,NULL);
);
void CTttView::OnStopCD()
{
　　mciSendString("stop cdaudio",NULL,0,NULL);
　　mciSendString("close cdaudio",NULL,0,NULL);
);
还可以：
　　pause cdaudio 　暂停播放。
　　resume cdaudio　继续被暂停的播放。
　　seek cdaudio to <位置>　移动到指定磁道。
　　set cdaudio door open/closed　弹出或缩进CD盘。
(4) 播放多媒体文件
void CTttView::OnMyMenu()
{
　　mciSendString("open myfolder\\tada.wav alias aa",NULL,0,NULL);
或　mciSendString("open myfolder\\flourish.mid alias aa",NULL,0,NULL);
或　mciSendString("open myfolder\\clock.avi alias aa",NULL,0,NULL);
　　mciSendString("play aa wait",NULL,0,NULL);
　　mciSendString("close aa",NULL,0,m_hWnd);
);
(5) 录制声音
void CTttView::OnStartRecord()
{
　　mciSendString("open new type waveaudio alias aa",NULL,0,NULL);
　　mciSendString("record aa",NULL,0,NULL);
);
void CTttView::OnStopRecord()
{
　　mciSendString("save aa c:\\aaa.wav wait",NULL,0,NULL);
　　mciSendString("close aa",NULL,0,NULL);
);
４、MCI命令消息
到目前为止，我们使用的都是MCI命令字符串。可以发现，命令字符串具有简单易学的优点，但这种接口与C/C++的风格相去甚远，如果程序要查询和设置大量数据，那么用字符串的形式将很不方便。
MCI的命令消息接口提供了C语言接口，它速度更快，并且更能符合C/C++程序员的需要。
所有MCI命令消息都是通过mciSendCommand函数发送的，函数声明为：
　　MCIERROR mciSendCommand(
　　　　MCIDEVICEID wIDDevice, 　//设备的ID，在打开设备时不用该参数
　　　　UINT　　　　uMsg, 　　　//命令消息
　　　　DWORD 　　　fdwCommand, //命令消息的标志
　　　　DWORD 　　　dwParam 　　//指向包含命令消息参数的结构
　　); //若成功则返回0，否则返回错误码
命令消息uMsg与命令字符串是对应的，例如，open与MCI_OPEN完成的是一样的功能。
变量wDeviceID用来保存设备的ID，系统用ID来标识不同的设备，以保证命令发给正确的对象。
void CTttView::OnMyMenu()
{
　　MCI_OPEN_PARMS mciOpen;
　　UINT wDeviceID;
　　mciOpen.lpstrDeviceType = "avivideo";
　　mciOpen.lpstrElementName = "myfolder\\clock.avi";
　　mciSendCommand(0, MCI_OPEN, MCI_OPEN_ELEMENT, (DWORD)&mciOpen);
　　wDeviceID=mciOpen.wDeviceID;
　　MCI_PLAY_PARMS mciPlay;
　　mciSendCommand(wDeviceID, MCI_PLAY, MCI_WAIT, (DWORD)&mciPlay);
);
可以看出，用命令消息比用命令字符串要复杂的多，但它的执行效率高。

使用下面的函数:
GetPrivateProfileString
GetPrivateProfileInt

我的INI文件名叫system.ini 内容

[Server]
ServerIP=10.38.163.11
Port=3002

char ipstr[20];//存储IP地址
GetPrivateProfileString("Server","ServerIP",NULL,ipstr,20,"d:\\test\\system.ini");
//第一个参数表示根节点,第二个参数表示子节点,第三个参数表示如果找不到,默认ipstr返回NULL,第四个参数存储返回结果,本例子ipstr就得到10.38.163.11的地址,第五个参数表示读的长度,最后一个参数是INI文件的路径和文件名

int port;
port = GetPrivateProfileInt("Server","Port",0,"d:\\test\\system.ini");
//参看上面的说明以及INI文件

该方法是使用的Levenshtein算法的一个实现。

 简单介绍下Levenshtein Distance(LD)：LD 可能衡量两字符串的相似性。它们的距离就是一个字符串转换成那一个字符串过程中的添加、删除、修改数值。
    举例：
· 如果str1="test"，str2="test"，那么LD(str1,str2) = 0。没有经过转换。
· 如果str1="test"，str2="tent"，那么LD(str1,str2) = 1。str1的"s"转换"n"，转换了一个字符，所以是1。
如果它们的距离越大，说明它们越是不同。

     Levenshtein distance最先是由俄国科学家Vladimir Levenshtein在1965年发明，用他的名字命名。不会拼读，可以叫它edit distance（编辑距离）。

    Levenshtein distance可以用来：
· Spell checking(拼写检查)
· Speech recognition(语句识别)
· DNA analysis(DNA分析)
· Plagiarism detection(抄袭检测)
LD用m*n的矩阵存储距离值。算法大概过程：
1. str1或str2的长度为0返回另一个字符串的长度。
2. 初始化(n+1)*(m+1)的矩阵d，并让第一行和列的值从0开始增长。
3. 扫描两字符串（n*m级的），如果：str1[i] == str2[j]，用temp记录它，为0。否则temp记为1。然后在矩阵d[i][j]赋于d[i-1][j]+1 、d[i][j-1]+1、d[i-1][j-1]+temp三者的最小值。
4. 扫描完后，返回矩阵的最后一个值即d[n][m]
最后返回的是它们的距离。怎么根据这个距离求出相似度呢？因为它们的最大距离就是两字符串长度的最大值。对字符串不是很敏感。现我把相似度计算公式定为1-它们的距离/字符串长度最大值。

public static float similarity(String str1, String str2) {

//计算两个字符串的长度。
int len1 = str1.length();
int len2 = str2.length();
//建立数组，比字符长度大一个空间
int[][] dif = new int[len1 + 1][len2 + 1];
//赋初值，步骤B。
for (int a = 0; a <= len1; a++) {
dif[a][0] = a;
}
for (int a = 0; a <= len2; a++) {
dif[0][a] = a;
}
//计算两个字符是否一样，计算左上的值
int temp;
for (int i = 1; i <= len1; i++) {
for (int j = 1; j <= len2; j++) {
if (str1.charAt(i - 1) == str2.charAt(j - 1)) {
temp = 0;
} else {
temp = 1;
}
//取三个值中最小的
dif[i][j] = min(dif[i - 1][j - 1] + temp, dif[i][j - 1] + 1,
dif[i - 1][j] + 1);
}
}
return 1 - (float) dif[len1][len2] / Math.max(str1.length(), str2.length());
}

//得到最小值
public static int min(int... is) {
int min = Integer.MAX_VALUE;
for (int i : is) {
if (min > i) {
min = i;
}
}
return min;
}

1．PDF_show
void PDF_show(PDF *p, const char *text)
void PDF_show2(PDF *p, const char *text, int len)
在当前坐标用当前字体及字体大小输出文本。
PDF_show将认为字符串是以空字符结尾（NULL）；若字符串有可能含有空字符（如多字节字符串），用PDF_show2。
2．PDF_show_xy
void PDF_show_xy(PDF *p, const char *text, double x, double y)
void PDF_show_xy2(PDF *p, const char *text, int len, double x, double y)
在给出的坐标用当前字体及字体大小输出文本。
PDF_show_xy将认为字符串是以空字符结尾（NULL）；若字符串有可能含有空字符（如多字节字符串），用PDF_show_xy2。
3．PDF_continue_text
void PDF_continue_text(PDF *p, const char *text)
void PDF_continue_text2(PDF *p, const char *text, int len)
在下一行用当前字体及字体大小输出文本。
PDF_continue_xy将认为字符串是以空字符结尾（NULL）；若字符串有可能含有空字符（如多字节字符串），用PDF_continue_xy2。
4．PDF_fit_textline
void PDF_fit_textline(PDF*p, const char *text, int len, double x, double y, const char *optlist)
在给出的坐标根据选择项输出一行文本。
若字符串是以空字符结尾（NULL），len为0；否则，给出具体字节数。
5．PDF_fit_textflow
int PDF_create_textflow(PDF *p, const char *text, int len, const char *optlist)
建立文本流对象,并预处理文本为下面的文本格式化做准备。
若字符串是以空字符结尾（NULL），len为0；否则，给出具体字节数。
const char *PDF_fit_textflow(PDF *p, int textflow, double llx, double lly, double urx, double ury, const char *optlist)
将文本输出到相应的矩形块中。
lly, llx, ury, urx, 分别是矩形块左下角及右上角的纵横坐标。
void PDF_delete_textflow(PDF *p, int textflow)
删除文本流对象及相关数据结构。

小结
1，2， 3 组函数简洁，直观，易用。4，5组函数可通过对选择项的控制而输出更灵活的文本格式。尤其是第5组函数，是专门为多行文本设计的，可通过选项控制对齐，字间距，边框显示，旋转等。但4，5组函数有个局限，在字符串是多字节时，它们只能处理Unicode类编码。换而言之，他们不支持cpArray36编码。
下面是一个相关的例子--C 源程序(下载源代码中包含了生成的pdf文件 –PDFlib_cs3.pdf)。
/*******************************************************************/
/* This example demostrates different ways to output Chinese Simplified text
/* under Chinese Simplifed Windows.
/*******************************************************************/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "pdflib.h"
int main(void)
{
PDF *p = NULL;
int i = 0, j = 0, Left = 50, Top = 800, Right = 545;
int Font_E = 0, Font_CS =