598 lines
49 KiB
HTML
598 lines
49 KiB
HTML
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8">
|
||
<title>colors | Auto.js 3.0.0 文档</title>
|
||
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700,400italic">
|
||
<link rel="stylesheet" href="assets/style.css">
|
||
<link rel="stylesheet" href="assets/sh.css">
|
||
<link rel="canonical" href="https://nodejs.org/api/images.html">
|
||
</head>
|
||
<body class="alt apidoc" id="api-section-images">
|
||
<div id="content" class="clearfix">
|
||
<div id="column2" class="interior">
|
||
<div id="intro" class="interior">
|
||
<a href="/" title="返回首页">
|
||
Auto.js
|
||
</a>
|
||
</div>
|
||
<ul>
|
||
<li><a class="nav-documentation" href="documentation.html">关于本文档</a></li>
|
||
<li><a class="nav-http-www-w3school-com-cn-js-pro_js_syntax-asp" href="http://www.w3school.com.cn/js/pro_js_syntax.asp">W3CSchool - ECMAScript教程</a></li>
|
||
<li><a class="nav-http-es6-ruanyifeng-com-README" href="http://es6.ruanyifeng.com/#README">阮一峰 - ECMAScript 6教程</a></li>
|
||
</ul>
|
||
<div class="line"></div>
|
||
|
||
<ul>
|
||
<li><a class="nav-overview" href="overview.html">Overview - 综述</a></li>
|
||
<li><a class="nav-qa" href="qa.html">Q&A - 常见问题</a></li>
|
||
<li><a class="nav-app" href="app.html">App - 应用</a></li>
|
||
<li><a class="nav-console" href="console.html">Console - 控制台</a></li>
|
||
<li><a class="nav-coordinates-based-automation" href="coordinates-based-automation.html">CoordinatesBasedAutomation - 基于坐标的操作</a></li>
|
||
<li><a class="nav-device" href="device.html">Device - 设备</a></li>
|
||
<li><a class="nav-dialogs" href="dialogs.html">Dialogs - 对话框</a></li>
|
||
<li><a class="nav-engines" href="engines.html">Engines - 脚本引擎</a></li>
|
||
<li><a class="nav-events" href="events.html">Events - 事件与监听</a></li>
|
||
<li><a class="nav-floaty" href="floaty.html">Floaty - 悬浮窗</a></li>
|
||
<li><a class="nav-files" href="files.html">Files - 文件系统</a></li>
|
||
<li><a class="nav-globals" href="globals.html">Globals - 一般全局函数</a></li>
|
||
<li><a class="nav-http" href="http.html">Http - HTTP</a></li>
|
||
<li><a class="nav-images active" href="images.html">Images - 图片与图色处理</a></li>
|
||
<li><a class="nav-keys" href="keys.html">Keys - 按键模拟</a></li>
|
||
<li><a class="nav-media" href="media.html">Media - 多媒体</a></li>
|
||
<li><a class="nav-modules" href="modules.html">Modules - 模块</a></li>
|
||
<li><a class="nav-widgets-based-automation" href="widgets-based-automation.html">WidgetsBasedAutomation - 基于控件的操作</a></li>
|
||
<li><a class="nav-sensors" href="sensors.html">Sensors - 传感器</a></li>
|
||
<li><a class="nav-shell" href="shell.html">Shell - Shell命令</a></li>
|
||
<li><a class="nav-storages" href="storages.html">Storages - 本地存储</a></li>
|
||
<li><a class="nav-threads" href="threads.html">Threads - 多线程</a></li>
|
||
<li><a class="nav-timers" href="timers.html">Timers - 定时器</a></li>
|
||
<li><a class="nav-ui" href="ui.html">UI - 用户界面</a></li>
|
||
<li><a class="nav-https-developer-mozilla-org-zh-CN-docs-Mozilla-Projects-Rhino-Scripting_Java" href="https://developer.mozilla.org/zh-CN/docs/Mozilla/Projects/Rhino/Scripting_Java">Work with Java - 调用Java API</a></li>
|
||
</ul>
|
||
<div class="line"></div>
|
||
|
||
<ul>
|
||
<li><a class="nav-https-github-com-hyb1996-NoRootScriptDroid" href="https://github.com/hyb1996/NoRootScriptDroid">GitHub项目 & Issue提交</a></li>
|
||
<li><a class="nav-http-autojs-org" href="http://autojs.org">Auto.js交流社区</a></li>
|
||
</ul>
|
||
|
||
</div>
|
||
|
||
<div id="column1" data-id="images" class="interior">
|
||
<header>
|
||
<h1>Auto.js 3.0.0 文档</h1>
|
||
<div id="gtoc">
|
||
<p>
|
||
<a href="index.html" name="toc">索引</a> |
|
||
<a href="all.html">查看全部</a>
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
</header>
|
||
|
||
<div id="toc">
|
||
<h2>目录</h2>
|
||
<ul>
|
||
<li><span class="stability_2"><a href="#images_colors">colors</a></span><ul>
|
||
<li><span class="stability_undefined"><a href="#images_colors_tostring_color">colors.toString(color)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_red_color">colors.red(color)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_green_color">colors.green(color)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_blue_color">colors.blue(color)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_alpha_color">colors.alpha(color)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_rgb_red_green_blue">colors.rgb(red, green, blue)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_argb_alpha_red_green_blue">colors.argb(alpha, red, green, blue)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_parsecolor_colorstr">colors.parseColor(colorStr)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_issimilar_color2_color2_threshold_algorithm">colors.isSimilar(color2, color2[, threshold, algorithm])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_equals_color1_color2">colors.equals(color1, color2)</a></span></li>
|
||
</ul>
|
||
</li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_black">colors.BLACK</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_dkgray">colors.DKGRAY</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_gray">colors.GRAY</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_ltgray">colors.LTGRAY</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_white">colors.WHITE</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_red">colors.RED</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_green">colors.GREEN</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_blue">colors.BLUE</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_yellow">colors.YELLOW</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_cyan">colors.CYAN</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_magenta">colors.MAGENTA</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_colors_transparent">colors.TRANSPARENT</a></span></li>
|
||
<li><span class="stability_2"><a href="#images_images">Images</a></span><ul>
|
||
<li><span class="stability_undefined"><a href="#images_images_requestscreencapture_landscape">images.requestScreenCapture([landscape])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_capturescreen">images.captureScreen()</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_capturescreen_path">images.captureScreen(path)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_pixel_image_x_y">images.pixel(image, x, y)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_copy_img">images.copy(img)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_save_image_path_format_png_quality_100">images.save(image, path[, format = "png", quality = 100])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_read_path">images.read(path)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_load_url">images.load(url)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_frombase64_base64">images.fromBase64(base64)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_tobase64_img_format_png_quality_100">images.toBase64(img[, format = "png", quality = 100])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_frombytes_bytes">images.fromBytes(bytes)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_tobytes_img_format_png_quality_100">images.toBytes(img[, format = "png", quality = 100])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_clip_img_x_y_w_h">images.clip(img, x, y, w, h)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_findcolor_image_color_options">images.findColor(image, color, options)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_findcolorinregion_img_color_x_y_width_height_threshold">images.findColorInRegion(img, color, x, y[, width, height, threshold])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_findcolorequals_img_color_x_y_width_height">images.findColorEquals(img, color[, x, y, width, height])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_findmulticolors_img_firstcolor_colors_options">images.findMultiColors(img, firstColor, colors[, options])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_detectscolor_image_color_x_y_threshold_16_algorithm_diff">images.detectsColor(image, color, x, y[, threshold = 16, algorithm = "diff"])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_findimage_img_template_options">images.findImage(img, template[, options])</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_images_findimageinregion_img_template_x_y_width_height_threshold">images.findImageInRegion(img, template, x, y[, width, height, threshold])</a></span></li>
|
||
</ul>
|
||
</li>
|
||
<li><span class="stability_undefined"><a href="#images_image">Image</a></span><ul>
|
||
<li><span class="stability_undefined"><a href="#images_image_getwidth">Image.getWidth()</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_image_getheight">Image.getHeight()</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_image_saveto_path">Image.saveTo(path)</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_image_pixel_x_y">Image.pixel(x, y)</a></span></li>
|
||
</ul>
|
||
</li>
|
||
<li><span class="stability_undefined"><a href="#images_point">Point</a></span><ul>
|
||
<li><span class="stability_undefined"><a href="#images_point_x">Point.x</a></span></li>
|
||
<li><span class="stability_undefined"><a href="#images_point_y">Point.y</a></span></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
</div>
|
||
|
||
<div id="apicontent">
|
||
<h1>colors<span><a class="mark" href="#images_colors" id="images_colors">#</a></span></h1>
|
||
<div class="api_stability api_stability_2"><a href="documentation.html#documentation_stability_index">Stability: 2</a> - Stable</div><p>在Auto.js有两种方式表示一个颜色。</p>
|
||
<p>一种是使用一个字符串"#AARRGGBB"或"#RRGGBB"，其中 AA 是Alpha通道(透明度)的值，RR 是R通道(红色)的值，GG 是G通道(绿色)的值，BB是B通道(蓝色)的值。例如"#ffffff"表示白色, "#7F000000"表示半透明的黑色。</p>
|
||
<p>另一种是使用一个16进制的"32位整数" 0xAARRGGBB 来表示一个颜色，例如 <code>0xFF112233</code>表示颜色"#112233", <code>0x11223344</code>表示颜色"#11223344"。</p>
|
||
<p>可以通过<code>colors.toString()</code>把颜色整数转换为字符串，通过<code>colors.parseColor()</code>把颜色字符串解析为颜色整数。</p>
|
||
<h2>colors.toString(color)<span><a class="mark" href="#images_colors_tostring_color" id="images_colors_tostring_color">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 整数RGB颜色值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a></li>
|
||
</ul>
|
||
</div><p>返回颜色值的字符串，格式为 "#AARRGGBB"。</p>
|
||
<h2>colors.red(color)<span><a class="mark" href="#images_colors_red_color" id="images_colors_red_color">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回颜色color的R通道的值，范围0~255.</p>
|
||
<h2>colors.green(color)<span><a class="mark" href="#images_colors_green_color" id="images_colors_green_color">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回颜色color的G通道的值，范围0~255.</p>
|
||
<h2>colors.blue(color)<span><a class="mark" href="#images_colors_blue_color" id="images_colors_blue_color">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回颜色color的B通道的值，范围0~255.</p>
|
||
<h2>colors.alpha(color)<span><a class="mark" href="#images_colors_alpha_color" id="images_colors_alpha_color">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回颜色color的Alpha通道的值，范围0~255.</p>
|
||
<h2>colors.rgb(red, green, blue)<span><a class="mark" href="#images_colors_rgb_red_green_blue" id="images_colors_rgb_red_green_blue">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li>red <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的R通道的值</li>
|
||
<li>blue <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的G通道的值</li>
|
||
<li>green <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的B通道的值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回这些颜色通道构成的整数颜色值。Alpha通道将是255（不透明）。</p>
|
||
<h2>colors.argb(alpha, red, green, blue)<span><a class="mark" href="#images_colors_argb_alpha_red_green_blue" id="images_colors_argb_alpha_red_green_blue">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>alpha</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的Alpha通道的值</li>
|
||
<li><code>red</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的R通道的值</li>
|
||
<li><code>green</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的G通道的值</li>
|
||
<li><code>blue</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色的B通道的值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回这些颜色通道构成的整数颜色值。</p>
|
||
<h2>colors.parseColor(colorStr)<span><a class="mark" href="#images_colors_parsecolor_colorstr" id="images_colors_parsecolor_colorstr">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>colorStr</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 表示颜色的字符串，例如"#112233"</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a></li>
|
||
</ul>
|
||
</div><p>返回颜色的整数值。</p>
|
||
<h2>colors.isSimilar(color2, color2[, threshold, algorithm])<span><a class="mark" href="#images_colors_issimilar_color2_color2_threshold_algorithm" id="images_colors_issimilar_color2_color2_threshold_algorithm">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color1</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值1</li>
|
||
<li><code>color1</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值2</li>
|
||
<li><code>threshold</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色相似度临界值，默认为4。取值范围为0~255。这个值越大表示允许的相似程度越小，如果这个值为0，则两个颜色相等时该函数才会返回true。</li>
|
||
<li><code>algorithm</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色匹配算法，默认为"diff", 包括:<ul>
|
||
<li>"diff": 差值匹配。与给定颜色的R、G、B差的绝对值之和小于threshold时匹配。</li>
|
||
<li>"rgb": rgb欧拉距离相似度。与给定颜色color的rgb欧拉距离小于等于threshold时匹配。</li>
|
||
<li>"rgb+": 加权rgb欧拉距离匹配(<a href="https://en.wikipedia.org/wiki/Color_difference">LAB Delta E</a>)。</li>
|
||
<li>"hs": hs欧拉距离匹配。hs为HSV空间的色调值。</li>
|
||
</ul>
|
||
</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type"><Boolean></a></li>
|
||
</ul>
|
||
</div><p>返回两个颜色是否相似。</p>
|
||
<h2>colors.equals(color1, color2)<span><a class="mark" href="#images_colors_equals_color1_color2" id="images_colors_equals_color1_color2">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>color1</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值1</li>
|
||
<li><code>color1</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色值2</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type"><Boolean></a></li>
|
||
</ul>
|
||
</div><p>返回两个颜色是否相等。<em>*注意该函数会忽略Alpha通道的值进行比较</em>。</p>
|
||
<pre><code>log(colors.equals("#112233", "#112234"));
|
||
log(colors.equals(0xFF112233, 0xFF223344));
|
||
</code></pre><h1>colors.BLACK<span><a class="mark" href="#images_colors_black" id="images_colors_black">#</a></span></h1>
|
||
<p>黑色，颜色值 #FF000000</p>
|
||
<h1>colors.DKGRAY<span><a class="mark" href="#images_colors_dkgray" id="images_colors_dkgray">#</a></span></h1>
|
||
<p>深灰色，颜色值 #FF444444</p>
|
||
<h1>colors.GRAY<span><a class="mark" href="#images_colors_gray" id="images_colors_gray">#</a></span></h1>
|
||
<p>灰色，颜色值 #FF888888</p>
|
||
<h1>colors.LTGRAY<span><a class="mark" href="#images_colors_ltgray" id="images_colors_ltgray">#</a></span></h1>
|
||
<p>亮灰色，颜色值 #FFCCCCCC</p>
|
||
<h1>colors.WHITE<span><a class="mark" href="#images_colors_white" id="images_colors_white">#</a></span></h1>
|
||
<p>白色，颜色值 #FFFFFFFF</p>
|
||
<h1>colors.RED<span><a class="mark" href="#images_colors_red" id="images_colors_red">#</a></span></h1>
|
||
<p>红色，颜色值 #FFFF0000</p>
|
||
<h1>colors.GREEN<span><a class="mark" href="#images_colors_green" id="images_colors_green">#</a></span></h1>
|
||
<p>绿色，颜色值 #FF00FF00</p>
|
||
<h1>colors.BLUE<span><a class="mark" href="#images_colors_blue" id="images_colors_blue">#</a></span></h1>
|
||
<p>蓝色，颜色值 #FF0000FF</p>
|
||
<h1>colors.YELLOW<span><a class="mark" href="#images_colors_yellow" id="images_colors_yellow">#</a></span></h1>
|
||
<p>黄色，颜色值 #FFFFFF00</p>
|
||
<h1>colors.CYAN<span><a class="mark" href="#images_colors_cyan" id="images_colors_cyan">#</a></span></h1>
|
||
<p>青色，颜色值 #FF00FFFF</p>
|
||
<h1>colors.MAGENTA<span><a class="mark" href="#images_colors_magenta" id="images_colors_magenta">#</a></span></h1>
|
||
<p>品红色，颜色值 #FFFF00FF</p>
|
||
<h1>colors.TRANSPARENT<span><a class="mark" href="#images_colors_transparent" id="images_colors_transparent">#</a></span></h1>
|
||
<p>透明，颜色值 #00000000</p>
|
||
<h1>Images<span><a class="mark" href="#images_images" id="images_images">#</a></span></h1>
|
||
<div class="api_stability api_stability_2"><a href="documentation.html#documentation_stability_index">Stability: 2</a> - Stable</div><p>images模块提供了一些手机设备中常见的图片处理函数，包括截图、读写图片、图片剪裁、找色、找图等。</p>
|
||
<h2>images.requestScreenCapture([landscape])<span><a class="mark" href="#images_images_requestscreencapture_landscape" id="images_images_requestscreencapture_landscape">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>landscape</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type" class="type"><boolean></a> 布尔值， 表示将要执行的截屏是否为横屏。如果landscape为false, 则表示竖屏截图; true为横屏截图。</li>
|
||
</ul>
|
||
</div><p>向系统申请屏幕截图权限，返回是否请求成功。</p>
|
||
<p>第一次使用该函数会弹出截图权限请求，建议选择“总是允许”。</p>
|
||
<p>这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是<code>captureScreen()</code>。</p>
|
||
<p>该函数在截图脚本中只需执行一次，而无需每次调用<code>captureScreen()</code>都调用一次。</p>
|
||
<p><strong>如果不指定landscape值，则截图方向由当前设备屏幕方向决定</strong>，因此务必注意执行该函数时的屏幕方向。</p>
|
||
<p>建议在本软件界面运行该函数，在其他软件界面运行时容易出现一闪而过的黑屏现象。 </p>
|
||
<p>示例:</p>
|
||
<pre><code>//请求截图
|
||
if(!requestScreenCapture()){
|
||
toast("请求截图失败");
|
||
exit();
|
||
}
|
||
//连续截图10张图片(间隔1秒)并保存到存储卡目录
|
||
for(var i = 0; i < 10; i++){
|
||
captureScreen("/sdcard/screencapture" + i + ".png");
|
||
sleep(1000);
|
||
}
|
||
</code></pre><p>该函数也可以作为全局函数使用。</p>
|
||
<h2>images.captureScreen()<span><a class="mark" href="#images_images_capturescreen" id="images_images_capturescreen">#</a></span></h2>
|
||
<p>截取当前屏幕并返回一个Image对象。</p>
|
||
<p>没有截图权限时执行该函数会抛出SecurityException。</p>
|
||
<p>该函数不会返回null，两次调用可能返回相同的Image对象。这是因为设备截图的更新需要一定的时间，短时间内（一般来说是16ms）连续调用则会返回同一张截图。</p>
|
||
<p>截图需要转换为Bitmap格式，从而该函数执行需要一定的时间(0~20ms)。</p>
|
||
<p>另外在requestScreenCapture()执行成功后需要一定时间后才有截图可用，因此如果立即调用captureScreen()，会等待一定时间后(一般为几百ms)才返回截图。</p>
|
||
<p>例子:</p>
|
||
<pre><code>//请求横屏截图
|
||
requestScreenCapture(true);
|
||
//截图
|
||
var img = captureScreen();
|
||
//获取在点(100, 100)的颜色值
|
||
var color = images.pixel(img, 100, 100);
|
||
//显示该颜色值
|
||
toast(colors.toString(color));
|
||
</code></pre><p>该函数也可以作为全局函数使用。</p>
|
||
<h2>images.captureScreen(path)<span><a class="mark" href="#images_images_capturescreen_path" id="images_images_capturescreen_path">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 截图保存路径</li>
|
||
</ul>
|
||
</div><p>截取当前屏幕并以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。</p>
|
||
<p>该函数不会返回任何值。该函数也可以作为全局函数使用。</p>
|
||
<h2>images.pixel(image, x, y)<span><a class="mark" href="#images_images_pixel_image_x_y" id="images_images_pixel_image_x_y">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>image</code> <span class="type"><Image></span> 图片</li>
|
||
<li><code>x</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 要获取的像素的横坐标。</li>
|
||
<li><code>y</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 要获取的像素的纵坐标。</li>
|
||
</ul>
|
||
</div><p>返回图片image在点(x, y)处的像素的ARGB值。 </p>
|
||
<p>该值的格式为0xAARRGGBB，是一个"32位整数"(虽然JavaScript中并不区分整数类型和其他数值类型)。</p>
|
||
<p>坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。</p>
|
||
<h2>images.copy(img)<span><a class="mark" href="#images_images_copy_img" id="images_images_copy_img">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>img</code> <span class="type"><Image></span> 图片</li>
|
||
<li>返回 <span class="type"><Image></span></li>
|
||
</ul>
|
||
</div><p>复制一张图片并返回新的副本。该函数会完全复制img对象的数据。</p>
|
||
<h2>images.save(image, path[, format = "png", quality = 100])<span><a class="mark" href="#images_images_save_image_path_format_png_quality_100" id="images_images_save_image_path_format_png_quality_100">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>image</code> <span class="type"><Image></span> 图片</li>
|
||
<li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 路径</li>
|
||
<li><code>format</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 图片格式，可选的值为:<ul>
|
||
<li><code>png</code></li>
|
||
<li><code>jpeg</code>/<code>jpg</code></li>
|
||
<li><code>webp</code></li>
|
||
</ul>
|
||
</li>
|
||
<li><code>quality</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 图片质量，为0~100的整数值</li>
|
||
</ul>
|
||
</div><p>把图片image以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。</p>
|
||
<pre><code>//把图片压缩为原来的一半质量并保存
|
||
var img = images.read("/sdcard/1.png");
|
||
images.save(img, "/sdcard/1.jpg", "jpg", 50);
|
||
app.viewFile("/sdcard/1.jpg");
|
||
</code></pre><h2>images.read(path)<span><a class="mark" href="#images_images_read_path" id="images_images_read_path">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 图片路径</li>
|
||
</ul>
|
||
</div><p>读取在路径path的图片文件并返回一个Image对象。如果文件不存在或者文件无法解码则返回null。</p>
|
||
<h2>images.load(url)<span><a class="mark" href="#images_images_load_url" id="images_images_load_url">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>url</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 图片URL地址</li>
|
||
</ul>
|
||
</div><p>加载在地址URL的网络图片并返回一个Image对象。如果地址不存在或者图片无法解码则返回null。</p>
|
||
<h2>images.fromBase64(base64)<span><a class="mark" href="#images_images_frombase64_base64" id="images_images_frombase64_base64">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>base64</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 图片的Base64数据</li>
|
||
<li>返回 <span class="type"><Image></span></li>
|
||
</ul>
|
||
</div><p>解码Base64数据并返回解码后的图片Image对象。如果base64无法解码则返回<code>null</code>。</p>
|
||
<h2>images.toBase64(img[, format = "png", quality = 100])<span><a class="mark" href="#images_images_tobase64_img_format_png_quality_100" id="images_images_tobase64_img_format_png_quality_100">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>image</code> <span class="type"><image></span> 图片</li>
|
||
<li><code>format</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 图片格式，可选的值为:<ul>
|
||
<li><code>png</code></li>
|
||
<li><code>jpeg</code>/<code>jpg</code></li>
|
||
<li><code>webp</code></li>
|
||
</ul>
|
||
</li>
|
||
<li><code>quality</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 图片质量，为0~100的整数值</li>
|
||
<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a></li>
|
||
</ul>
|
||
</div><p>把图片编码为base64数据并返回。</p>
|
||
<h2>images.fromBytes(bytes)<span><a class="mark" href="#images_images_frombytes_bytes" id="images_images_frombytes_bytes">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>bytes</code> <span class="type"><byte[]></span> 字节数组</li>
|
||
</ul>
|
||
</div><p>解码字节数组bytes并返回解码后的图片Image对象。如果bytes无法解码则返回<code>null</code>。</p>
|
||
<h2>images.toBytes(img[, format = "png", quality = 100])<span><a class="mark" href="#images_images_tobytes_img_format_png_quality_100" id="images_images_tobytes_img_format_png_quality_100">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>image</code> <span class="type"><image></span> 图片</li>
|
||
<li><code>format</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 图片格式，可选的值为:<ul>
|
||
<li><code>png</code></li>
|
||
<li><code>jpeg</code>/<code>jpg</code></li>
|
||
<li><code>webp</code></li>
|
||
</ul>
|
||
</li>
|
||
<li><code>quality</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 图片质量，为0~100的整数值</li>
|
||
<li>返回 <span class="type"><byte[]></span></li>
|
||
</ul>
|
||
</div><p>把图片编码为字节数组并返回。</p>
|
||
<h2>images.clip(img, x, y, w, h)<span><a class="mark" href="#images_images_clip_img_x_y_w_h" id="images_images_clip_img_x_y_w_h">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>img</code> <span class="type"><Image></span> 图片</li>
|
||
<li><code>x</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 剪切区域的左上角横坐标</li>
|
||
<li><code>y</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 剪切区域的左上角纵坐标</li>
|
||
<li><code>w</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 剪切区域的宽度</li>
|
||
<li><code>h</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 剪切区域的高度</li>
|
||
<li>返回 <span class="type"><Image></span></li>
|
||
</ul>
|
||
</div><p>从图片img的位置(x, y)处剪切大小为w * h的区域，并返回该剪切区域的新图片。</p>
|
||
<pre><code>var src = images.read("/sdcard/1.png");
|
||
var clip = images.clip(src, 100, 100, 400, 400);
|
||
images.save(clip, "/sdcard/clip.png");
|
||
</code></pre><h2>images.findColor(image, color, options)<span><a class="mark" href="#images_images_findcolor_image_color_options" id="images_images_findcolor_image_color_options">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>image</code> <span class="type"><Image></span> 图片</li>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 要寻找的颜色的RGB值。如果是一个整数，则以0xRRGGBB的形式代表RGB值（A通道会被忽略）；如果是字符串，则以"#RRGGBB"代表其RGB值。</li>
|
||
<li><code>options</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="type"><Object></a> 选项</li>
|
||
</ul>
|
||
</div><p>在图片中寻找颜色color。找到时返回找到的点Point，找不到时返回null。</p>
|
||
<p>选项包括：</p>
|
||
<ul>
|
||
<li><code>region</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="type"><Array></a> 找色区域。是一个两个或四个元素的数组。(region[0], region[1])表示找色区域的左上角；region[2]*region[3]表示找色区域的宽高。如果只有region只有两个元素，则找色区域为(region[0], region[1])到屏幕右下角。如果不指定region选项，则找色区域为整张图片。</li>
|
||
<li><code>threshold</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 找色时颜色相似度的临界值，范围为0~255（越小越相似，0为颜色相等，255为任何颜色都能匹配）。默认为4。threshold和浮点数相似度(0.0~1.0)的换算为 similarity = (255 - threshold) / 255.</li>
|
||
</ul>
|
||
<p>该函数也可以作为全局函数使用。</p>
|
||
<p>一个循环找色的例子如下：</p>
|
||
<pre><code>requestScreenCapture();
|
||
|
||
//循环找色，找到红色(#ff0000)时停止并报告坐标
|
||
while(true){
|
||
var img = captureScreen();
|
||
var point = findColor(img, "#ff0000");
|
||
if(point){
|
||
toast("找到红色，坐标为(" + point.x + ", " + point.y + ")");
|
||
}
|
||
}
|
||
</code></pre><p>一个区域找色的例子如下：</p>
|
||
<pre><code>//读取本地图片/sdcard/1.png
|
||
var img = images.read("/sdcard/1.png");
|
||
//判断图片是否加载成功
|
||
if(!img){
|
||
toast("没有该图片");
|
||
exit();
|
||
}
|
||
//在该图片中找色，指定找色区域为在位置(400, 500)的宽为300长为200的区域，指定找色临界值为4
|
||
var point = findColor(img, "#00ff00", {
|
||
region: [400, 500, 300, 200],
|
||
threshold: 4
|
||
});
|
||
if(point){
|
||
toast("找到啦:" + point);
|
||
}else{
|
||
toast("没找到");
|
||
}
|
||
</code></pre><h2>images.findColorInRegion(img, color, x, y[, width, height, threshold])<span><a class="mark" href="#images_images_findcolorinregion_img_color_x_y_width_height_threshold" id="images_images_findcolorinregion_img_color_x_y_width_height_threshold">#</a></span></h2>
|
||
<p>区域找色的简便方法。</p>
|
||
<p>相当于</p>
|
||
<pre><code>images.findColor(img, color, {
|
||
region: [x, y, width, height],
|
||
threshold: threshold
|
||
});
|
||
</code></pre><p>该函数也可以作为全局函数使用。</p>
|
||
<h2>images.findColorEquals(img, color[, x, y, width, height])<span><a class="mark" href="#images_images_findcolorequals_img_color_x_y_width_height" id="images_images_findcolorequals_img_color_x_y_width_height">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>img</code> <span class="type"><Image></span> 图片</li>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 要寻找的颜色</li>
|
||
<li><code>x</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 找色区域的左上角横坐标</li>
|
||
<li><code>y</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 找色区域的左上角纵坐标</li>
|
||
<li><code>width</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 找色区域的宽度</li>
|
||
<li><code>height</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 找色区域的高度</li>
|
||
<li>返回 <span class="type"><Point></span></li>
|
||
</ul>
|
||
</div><p>在图片img指定区域中找到颜色和color完全相等的某个点，并返回该点的左边；如果没有找到，则返回<code>null</code>。</p>
|
||
<p>找色区域通过<code>x</code>, <code>y</code>, <code>width</code>, <code>height</code>指定，如果不指定找色区域，则在整张图片中寻找。</p>
|
||
<p>该函数也可以作为全局函数使用。</p>
|
||
<p>示例：
|
||
(通过找QQ红点的颜色来判断是否有未读消息)</p>
|
||
<pre><code>requestScreenCapture();
|
||
launchApp("QQ");
|
||
sleep(1200);
|
||
var p = findColorEquals(captureScreen(), "#f64d30");
|
||
if(p){
|
||
toast("有未读消息");
|
||
}else{
|
||
toast("没有未读消息");
|
||
}
|
||
</code></pre><h2>images.findMultiColors(img, firstColor, colors[, options])<span><a class="mark" href="#images_images_findmulticolors_img_firstcolor_colors_options" id="images_images_findmulticolors_img_firstcolor_colors_options">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>img</code> <span class="type"><Image></span> 要找色的图片</li>
|
||
<li><code>firstColor</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 第一个点的颜色</li>
|
||
<li><code>colors</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="type"><Array></a> 表示剩下的点相对于第一个点的位置和颜色的数组，数组的每个元素为[x, y, color]</li>
|
||
<li><code>options</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="type"><Object></a> 选项，包括：<ul>
|
||
<li><code>region</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="type"><Array></a> 找色区域。是一个两个或四个元素的数组。(region[0], region[1])表示找色区域的左上角；region[2]*region[3]表示找色区域的宽高。如果只有region只有两个元素，则找色区域为(region[0], region[1])到屏幕右下角。如果不指定region选项，则找色区域为整张图片。</li>
|
||
<li><code>threshold</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 找色时颜色相似度的临界值，范围为0~255（越小越相似，0为颜色相等，255为任何颜色都能匹配）。默认为4。threshold和浮点数相似度(0.0~1.0)的换算为 similarity = (255 - threshold) / 255.</li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</div><p>多点找色，类似于按键精灵的多点找色，其过程如下：</p>
|
||
<ol>
|
||
<li>在图片img中找到颜色firstColor的位置(x0, y0)</li>
|
||
<li>对于数组colors的每个元素[x, y, color]，检查图片img在位置(x + x0, y + y0)上的像素是否是颜色color，是的话返回(x0, y0)，否则继续寻找firstColor的位置，重新执行第1步</li>
|
||
<li>整张图片都找不到时返回<code>null</code></li>
|
||
</ol>
|
||
<p>例如，对于代码<code>images.findMultiColors(img, "#123456", [[10, 20, "#ffffff"], [30, 40, "#000000"]])</code>，假设图片在(100, 200)的位置的颜色为#123456, 这时如果(110, 220)的位置的颜色为#fffff且(130, 240)的位置的颜色为#000000，则函数返回点(100, 200)。</p>
|
||
<p>如果要指定找色区域，则在options中指定，例如:</p>
|
||
<pre><code>var p = images.findMultiColors(img, "#123456", [[10, 20, "#ffffff"], [30, 40, "#000000"]], {
|
||
region: [0, 960, 1080, 960]
|
||
});
|
||
</code></pre><h2>images.detectsColor(image, color, x, y[, threshold = 16, algorithm = "diff"])<span><a class="mark" href="#images_images_detectscolor_image_color_x_y_threshold_16_algorithm_diff" id="images_images_detectscolor_image_color_x_y_threshold_16_algorithm_diff">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>image</code> <span class="type"><Image></span> 图片</li>
|
||
<li><code>color</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 要检测的颜色</li>
|
||
<li><code>x</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 要检测的位置横坐标</li>
|
||
<li><code>y</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 要检测的位置纵坐标</li>
|
||
<li><code>threshold</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 颜色相似度临界值，默认为16。取值范围为0~255。</li>
|
||
<li><p><code>algorithm</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 颜色匹配算法，包括:</p>
|
||
<ul>
|
||
<li>"equal": 相等匹配，只有与给定颜色color完全相等时才匹配。</li>
|
||
<li>"diff": 差值匹配。与给定颜色的R、G、B差的绝对值之和小于threshold时匹配。</li>
|
||
<li><p>"rgb": rgb欧拉距离相似度。与给定颜色color的rgb欧拉距离小于等于threshold时匹配。</p>
|
||
</li>
|
||
<li><p>"rgb+": 加权rgb欧拉距离匹配(<a href="https://en.wikipedia.org/wiki/Color_difference">LAB Delta E</a>)。</p>
|
||
</li>
|
||
<li>"hs": hs欧拉距离匹配。hs为HSV空间的色调值。</li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</div><p>返回图片image在位置(x, y)处是否匹配到颜色color。用于检测图片中某个位置是否是特定颜色。</p>
|
||
<p>一个判断微博客户端的某个微博是否被点赞过的例子：</p>
|
||
<pre><code>requestScreenCapture();
|
||
//找到点赞控件
|
||
var like = id("ly_feed_like_icon").findOne();
|
||
//获取该控件中点坐标
|
||
var x = like.bounds().centerX();
|
||
var y = like.bounds().centerY();
|
||
//截图
|
||
var img = captureScreen();
|
||
//判断在该坐标的颜色是否为橙红色
|
||
if(images.detectsColor(img, "#fed9a8", x, y)){
|
||
//是的话则已经是点赞过的了，不做任何动作
|
||
}else{
|
||
//否则点击点赞按钮
|
||
like.click();
|
||
}
|
||
</code></pre><h2>images.findImage(img, template[, options])<span><a class="mark" href="#images_images_findimage_img_template_options" id="images_images_findimage_img_template_options">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>img</code> <span class="type"><Image></span> 大图片</li>
|
||
<li><code>template</code> <span class="type"><Image></span> 小图片（模板）</li>
|
||
<li><code>options</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object" class="type"><Object></a> 找图选项</li>
|
||
</ul>
|
||
</div><p>找图。在大图片img中查找小图片template的位置（模块匹配），找到时返回位置坐标(Point)，找不到时返回null。</p>
|
||
<p>选项包括：</p>
|
||
<ul>
|
||
<li><code>threshold</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 图片相似度。取值范围为0~1的浮点数。默认值为0.9。</li>
|
||
<li><code>region</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="type"><Array></a> 找图区域。参见findColor函数关于region的说明。</li>
|
||
<li><code>level</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> <strong>一般而言不必修改此参数</strong>。不加此参数时该参数会根据图片大小自动调整。找图算法是采用图像金字塔进行的, level参数表示金字塔的层次, level越大可能带来越高的找图效率，但也可能造成找图失败（图片因过度缩小而无法分辨）或返回错误位置。因此，除非您清楚该参数的意义并需要进行性能调优，否则不需要用到该参数。</li>
|
||
</ul>
|
||
<p>该函数也可以作为全局函数使用。</p>
|
||
<p>一个最简单的找图例子如下：</p>
|
||
<pre><code>var img = images.read("/sdcard/大图.png");
|
||
var templ = images.read("/sdcard/小图.png");
|
||
var p = findImage(img, templ);
|
||
if(p){
|
||
toast("找到啦:" + p);
|
||
}else{
|
||
toast("没找到");
|
||
}
|
||
</code></pre><p>稍微复杂点的区域找图例子如下：</p>
|
||
<pre><code>auto();
|
||
requestScreenCapture();
|
||
var wx = images.read("/sdcard/微信图标.png");
|
||
//返回桌面
|
||
home();
|
||
//截图并找图
|
||
var p = findImage(captureScreen(), wx, {
|
||
region: [0, 50],
|
||
threshold: 0.8
|
||
});
|
||
if(p){
|
||
toast("在桌面找到了微信图标啦: " + p);
|
||
}else{
|
||
toast("在桌面没有找到微信图标");
|
||
}
|
||
</code></pre><h2>images.findImageInRegion(img, template, x, y[, width, height, threshold])<span><a class="mark" href="#images_images_findimageinregion_img_template_x_y_width_height_threshold" id="images_images_findimageinregion_img_template_x_y_width_height_threshold">#</a></span></h2>
|
||
<p>区域找图的简便方法。相当于：</p>
|
||
<pre><code>images.findImage(img, template, {
|
||
region: [x, y, width, height],
|
||
threshold: threshold
|
||
})
|
||
</code></pre><p>该函数也可以作为全局函数使用。</p>
|
||
<h1>Image<span><a class="mark" href="#images_image" id="images_image">#</a></span></h1>
|
||
<p>表示一张图片，可以是截图的图片，或者本地读取的图片，或者从网络获取的图片。</p>
|
||
<h2>Image.getWidth()<span><a class="mark" href="#images_image_getwidth" id="images_image_getwidth">#</a></span></h2>
|
||
<p>返回以像素为单位图片宽度。</p>
|
||
<h2>Image.getHeight()<span><a class="mark" href="#images_image_getheight" id="images_image_getheight">#</a></span></h2>
|
||
<p>返回以像素为单位的图片高度。</p>
|
||
<h2>Image.saveTo(path)<span><a class="mark" href="#images_image_saveto_path" id="images_image_saveto_path">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type"><string></a> 路径</li>
|
||
</ul>
|
||
</div><p>把图片保存到路径path。（如果文件存在则覆盖）</p>
|
||
<h2>Image.pixel(x, y)<span><a class="mark" href="#images_image_pixel_x_y" id="images_image_pixel_x_y">#</a></span></h2>
|
||
<div class="signature"><ul>
|
||
<li><code>x</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 横坐标</li>
|
||
<li><code>y</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type"><number></a> 纵坐标</li>
|
||
</ul>
|
||
</div><p>返回图片image在点(x, y)处的像素的ARGB值。 </p>
|
||
<p>该值的格式为0xAARRGGBB，是一个"32位整数"(虽然JavaScript中并不区分整数类型和其他数值类型)。</p>
|
||
<p>坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。</p>
|
||
<h1>Point<span><a class="mark" href="#images_point" id="images_point">#</a></span></h1>
|
||
<p>findColor, findImage返回的对象。表示一个点（坐标）。</p>
|
||
<h2>Point.x<span><a class="mark" href="#images_point_x" id="images_point_x">#</a></span></h2>
|
||
<p>横坐标。</p>
|
||
<h2>Point.y<span><a class="mark" href="#images_point_y" id="images_point_y">#</a></span></h2>
|
||
<p>纵坐标。</p>
|
||
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<script src="assets/sh_main.js"></script>
|
||
<script src="assets/sh_javascript.min.js"></script>
|
||
<script>highlight(undefined, undefined, 'pre');</script>
|
||
<!-- __TRACKING__ -->
|
||
</body>
|
||
</html> |