[English Version]

MFP语言和可编程科学计算器

MFP语言简介

MFP函数

所有函数

整数操作函数

逻辑函数

统计和随机函数

三角函数

指数函数

复数函数

系统函数

数组和矩阵函数

绘图函数

表达式和微积分函数

字符串函数

双曲三角函数

排序函数

多项式函数

信号处理函数

文件操作函数

时间和日期函数

显示函数

多媒体函数

数据结构函数

数据交换文件格式函数

平台和硬件函数

并行计算函数

RTC多媒体函数

反射函数

MFP编译函数

其它函数

部署用户自定义函数

在您的应用中调用MFP

创建安卓安装包

小游戏的开发

绘制图形

使用MFP进行数学分析

使用MFP处理文件

数,字符串和数组

日期时间和系统相关

可编程科学计算器介绍

可编程科学计算器帮助:多媒体函数

函数名 函数帮助信息
clone_image

::mfp::multimedia::image_lib::clone_image(7) :

clone_image(image_src, src_left, src_top, src_right, src_bottom, dest_width, dest_height)返回一个新的被包装过的JAVA图像对象。该图形对象的宽度为dest_width,高度为dest_height。这个被返回的图像是(被拉缩过的)原图像image_src的被选中的区块的拷贝。被选中的区块的左、上、右、下的坐标分别是src_left、src_top、src_right和src_bottom。注意src_left、src_top、src_right和src_botto是可选参数,它们的缺省值分别是0、0、image_src的宽度和image_src的高度。dest_width和dest_height也是可选参数。它们的缺省值分别是src_right - src_left以及src_bottom - src_top。本函数的一个例子为 clone_image(img_src, 0, 0, 100, 200, 50, 300)。

create_image

::mfp::multimedia::image_lib::create_image(2) :

create_image(w, h)返回一个全新的,空白的被包装过的JAVA图像对象。该图形对象的宽度为w,高度为h。

get_image_size

::mfp::multimedia::image_lib::get_image_size(1) :

get_image_size(image_handle)返回由image_handle所代表的被包装过的JAVA图像对象的长和宽组成的数组。

get_sound_path

::mfp::multimedia::audio_lib::get_sound_path(1) :

get_sound_path(sound_handle)返回sound_handle所指向的声音文件的路径。

get_sound_reference_path

::mfp::multimedia::audio_lib::get_sound_reference_path(1) :

get_sound_reference_path(sound_handle)返回sound_handle所指向的声音引用文件的路径。如果声音文件不是从zip压缩的读入的,声音引用文件和sound_handle所指向的声音文件(也就是get_sound_file函数的返回值)是同一个文件。如果声音文件是从zip压缩的读入的,声音引用文件路径是压缩文件的路径加上声音文件的压缩路径,比如"/folder1/folder2/snd.zip/zipped_folder/snd.wav",这里"/folder1/folder2/snd.zip"是压缩文件路径,"zipped_folder/snd.wav"是声音文件的压缩路径。

get_sound_repeat

::mfp::multimedia::audio_lib::get_sound_repeat(1) :

get_sound_repeat(sound_handle)返回一个布尔量,表示参数sound_handle所代表的声音是否会被重复演奏。

get_sound_source_type

::mfp::multimedia::audio_lib::get_sound_source_type(1) :

get_sound_source_type(sound_handle)返回一个整数,代表sound_handle所指向的声音引用文件的类型。0表示常规文件,1表示压缩的zip文件,2表示引用于MFP App中安卓asset中的zip文件。

get_sound_volume

::mfp::multimedia::audio_lib::get_sound_volume(1) :

get_sound_volume(sound_handle)返回参数sound_handle所代表的声音的音量(一个变化范围从0到1的浮点数)。

is_playing

::mfp::multimedia::audio_lib::is_playing(1) :

这个函数接受一个媒体播放器句柄作为参数。如果该媒体播放器正在播放音乐,这个函数返回true,如果该媒体播放器没有正在播放,或者该句柄无效,这个函数返回false。

is_valid_image_handle

::mfp::multimedia::image_lib::is_valid_image_handle(1) :

is_valid_image_handle(image_handle)返回一个布尔量,用于告诉开发人员一个被包装过的JAVA图像对象,也就是image_handle参数,是否依然合法还是已经被关闭。

load_image

::mfp::multimedia::image_lib::load_image(1) :

load_image(image_path)返回一个被包装过的JAVA图像对象。它有一个参数image_path。这个参数是一个基于字符串的,指向一个图形文件的路径。

load_image_from_zip

::mfp::multimedia::image_lib::load_image_from_zip(3) :

load_image_from_zip(zip_file_name, zip_entry_path, zip_file_type)返回一个被包装过的JAVA图像对象。该图形对象从一个zip压缩文件中读取。它的第一个参数是基于字符串的zip文件的压缩路径。它的第二个参数是图像在该zip文件中的压缩路径。它的第三个参数要么是0,要么是1。如果等于0,表示普通的zip文件,而如果等于1,表示MFP App的安卓assets中的zip文件。

open_image_display

::mfp::multimedia::image_lib::open_image_display(1) :

open_image_display(image_path_or_handle)创建一个image display供开发人员调用MFP函数绘图。它有一个参数。这个参数既可以是一个基于字符串的,指向一个图形文件的路径,也可以是null,还可以是一个由load_image,load_image_from_zip,create_image或者clone_image函数返回的JAVA image对象的句柄。

play_sound

::mfp::multimedia::audio_lib::play_sound(4) :

play_sound(source_path, repeat_or_not, volume, create_new_or_not)演奏一个声音文件,该声音文件可以是wave文件,也可以是midi文件,还可以是mp3文件。该函数返回一个演奏器的句柄,该句柄指向一个JAVA或安卓的多媒体演奏器。由于多媒体演奏器的资源是有限的,本函数会尽可能的回收并重用以前生成的多媒体演奏器。本函数有4个参数。第一个参数是声音文件的路径。第二个参数是一个布尔值,表示该声音是否需要重复演奏,这是一个缺省参数,缺省值是false。第三个参数是一个从0到1的浮点数,表示音量大小。这也是一个缺省参数,缺省值是1。第四个参数是一个布尔值,表示是否无论如何都强制生产一个新的多媒体演奏器。这也是一个缺省参数,缺省值是false。

play_sound_from_zip

::mfp::multimedia::audio_lib::play_sound_from_zip(6) :

play_sound_from_zip(source_zip_file_path, zip_entry_path, zip_file_type, repeat_or_not, volume, create_new_or_not)演奏一个从zip文件中抽取出的声音文件,该声音文件可以是wave文件,也可以是midi文件,还可以是mp3文件。该函数返回一个演奏器的句柄,该句柄指向一个JAVA或安卓的多媒体演奏器。由于多媒体演奏器的资源是有限的,本函数会尽可能的回收并重用以前生成的多媒体演奏器。本函数有6个参数。第一个参数是zip文件的路径。第二个参数是被压缩的声音文件的在zip文件中的位置路径。第三个参数是一个布尔值,0表示zip文件是普通的压缩文件,1表示zip文件位于MFP app的安卓asset目录中。第四个参数是一个布尔值,表示该声音是否需要重复演奏,这是一个缺省参数,缺省值是false。第五个参数是一个从0到1的浮点数,表示音量大小。这也是一个缺省参数,缺省值是1。第六个参数是一个布尔值,表示是否无论如何都强制生产一个新的多媒体演奏器。这也是一个缺省参数,缺省值是false。

save_image

::mfp::multimedia::image_lib::save_image(3) :

save_image(image, file_format, path)保存一个被包装过的JAVA图像对象至一个图形文件。本函数的第一个参数是被包装过的JAVA图像对象,第二个参数是基于字符串的图像文件的格式,当前仅支持"png","jpg"以及"bmp"格式。第三个参数是图像文件的路径。如果成功保存,本函数返回True,否则返回False。本函数的一个例子为:save_image(img, "png", "C:\\Temp\\1.png")。

set_sound_repeat

::mfp::multimedia::audio_lib::set_sound_repeat(2) :

set_sound_repeat(sound_handle, repeat_or_not)设置一个sound_handle所代表的声音是否重复演奏。

set_sound_volume

::mfp::multimedia::audio_lib::set_sound_volume(2) :

set_sound_volume(sound_handle, volume)设置一个sound_handle所代表的声音的音量,注意音量参数volume的值变化范围是从0到1。

start_sound

::mfp::multimedia::audio_lib::start_sound(1) :

start_sound(sound_handle)演奏sound_handle所指向的声音文件。如果该声音文件已经启动,这个函数什么也不做。

stop_all_sounds

::mfp::multimedia::audio_lib::stop_all_sounds(0) :

stop_all_sounds()停止所有正在播放的声音。

stop_sound

::mfp::multimedia::audio_lib::stop_sound(1) :

stop_sound(sound_handle)停止sound_handle所代表的声音的播放。如果该声音没有播放,这个函数什么也不做。