阅读(4213) 赞(0)

快应用图片编辑

2018-06-25 17:41:08 更新

接口声明

{"name": "system.image"}

导入模块

import image from '@system.image' 或 const image = require('@system.image')

接口定义image.getImageInfo(OBJECT)

获取图片信息

参数：

参数名	类型	必填	说明
uri	String	是	图片地址，可以是数据文件或应用内的资源。如果是应用内资源，必须使用绝对路径
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

success返回值：

参数名	类型	说明
uri	String	图片地址
width	Integer	图片的宽度，单位为px
height	Integer	图片的高度，单位为px
size	Long	图片的大小，单位为Byte

fail返回错误代码

错误码	说明
202	参数错误
300	I/O错误
301	文件路径不存在

示例：

image.getImageInfo({
  uri: 'internal://tmp/abc.jpg',
  success: function (data) {
    console.log(`handling success: size = ${data.size}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

image.compressImage(OBJECT)

压缩图片

参数：

参数名	类型	必填	说明
uri	String	是	图片地址，可以是数据文件或应用内的资源。如果是应用内资源，必须使用绝对路径
quality	Integer	否	图片的压缩质量，0-100之间，默认是75
ratio	Number	否	尺寸压缩倍数，必须大于0，尺寸会变为原图的1/ratio大小
format	String	否	图片保存格式，支持JPEG，PNG，WEBP三种格式。默认使用JPEG格式
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

success返回值：

参数名	类型	说明
uri	String	压缩后的图片地址

fail返回错误代码

错误码	说明
202	参数错误
300	I/O错误
301	文件路径不存在

示例：

image.compressImage({
  uri: 'internal://tmp/abc.jpg',
  quality: 80,
  radio: 2, // 变为原图的1/2大小
  format: 'JPEG',
  success: function (data) {
    console.log(data.uri)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

image.applyOperations(OBJECT) `1000+`

对图片按顺序执行编辑操作。

在顺序执行编辑操作列表中的操作时，上一步操作生成的结果会作为下一步操作的输入，坐标系也是以上一步操作生成的结果的左上角为坐标原点重新确定的。

参数：

参数名	类型	必填	说明
uri	String	是	图片地址，可以是数据文件或应用内的资源。如果是应用内资源，必须使用绝对路径
operations	ObjectArray	否	编辑操作列表，按照先后顺序执行。如果未提供，则不会执行编辑操作，仅重新保存图片
quality	Integer	否	图片的压缩质量，0-100之间，默认是75
format	String	否	图片保存格式，支持JPEG，PNG，WEBP三种格式。默认使用JPEG格式
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

支持的编辑操作

1) 图片裁剪

参数名	类型	必填	说明
action	String	是	必须是crop
x	Number	否	裁剪的起始点的x坐标，默认是0
y	Number	否	裁剪的起始点的y坐标，默认是0
width	Number	是	裁剪的图片宽度
height	Number	是	裁剪的图片高度

2) 图片缩放

参数名	类型	必填	说明
action	String	是	必须是scale
scaleX	Number	否	宽度的缩放比率，缩放后宽度会变成原图的scaleX倍。默认是1
scaleY	Number	否	高度的缩放比率，缩放后高度会变成原图的scaleY倍。默认是1

3) 图片旋转

参数名	类型	必填	说明
action	String	是	必须是rotate
degree	Number	是	旋转的角度

success返回值：

参数名	类型	说明
uri	String	生成的图片的地址

fail返回错误代码

错误码	说明
202	参数错误
300	I/O错误
301	文件路径不存在

示例：

image.applyOperations({
  uri: 'internal://cache/123.png',
  operations: [
    {
      action: 'scale',
      scaleX: 0.5,
      scaleY: 0.5
    },
    {
      action: 'crop',
      width: 200,
      height: 200
    },
    {
      action: 'rotate',
      degree: 90,
    }
  ],
  quality: 90,
  format: 'webp',
  success: function (data) {
    console.log(`handling success: ${data.uri}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

image.editImage(OBJECT)

打开编辑器来编辑图片。目前支持选择图片范围并裁剪。

参数：

参数名	类型	必填	说明
uri	String	是	图片地址，可以是数据文件或应用内的资源。如果是应用内资源，必须使用绝对路径
aspectRatioX `1050+`	Integer	否	用于限定裁剪结果的宽高比，该参数指定宽高比中宽度比率。例如：aspectRatioX为16，aspectRatioY为9，则限定裁剪结果必须是16:9的图
aspectRatioY `1050+`	Integer	否	用于限定裁剪结果的宽高比，该参数指定宽高比中宽度比率。例如：aspectRatioX为16，aspectRatioY为9，则限定裁剪结果必须是16:9的图
success	Function	否	成功回调
fail	Function	否	失败回调
cancel	Function	否	取消回调
complete	Function	否	执行结束后的回调

success返回值：

参数名	类型	说明
uri	String	生成的图片的地址

fail返回错误代码：

错误码	说明
202	参数错误
300	I/O错误
301	文件路径不存在

示例：

image.editImage({
  uri: 'internal://cache/123.png',
  success: function (data) {
    console.log(`handling success: ${data.uri}`)
  },
  cancel: function () {
    console.log('handling cancel')
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

image.getExifAttributes(OBJECT) 1040+

获取图片的exif信息。支持的格式：JPEG,DNG,CR2,NEF,NRW,ARW,RW2,ORF,PEF,SRW,RAF,HEIF。

参数：

参数名	类型	必填	说明
uri	String	是	图片地址，可以是数据文件或应用内的资源。如果是应用内资源，必须使用绝对路径
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

success返回值：

参数名	类型	说明
uri	String	图片地址
attributes	Object	图片的exif信息

fail返回错误代码

错误码	说明
202	参数错误
300	I/O错误
301	文件路径不存在

示例：

image.getExifAttributes({
  uri: 'internal://cache/123.png',
  success: function (data) {
    console.log(`handling success: ${JSON.stringify(data.attributes)}`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

image.setExifAttributes(OBJECT) 1040+

设置图片的exif信息。设置操作会直接在所给图片上进行，不会生成新的图片。支持的格式：JPEG。

参数：

参数名	类型	必填	说明
uri	String	是	图片地址，可以是数据文件或应用内的资源。如果是应用内资源，必须使用绝对路径
attributes	Object	是	要设置的exif属性列表
success	Function	否	成功回调
fail	Function	否	失败回调
complete	Function	否	执行结束后的回调

attributes接受的exif属性：

Artist	BitsPerSample	Compression	Copyright	DateTime	ImageDescription
ImageLength	ImageWidth	JPEGInterchangeFormat	JPEGInterchangeFormatLength	Make	Model
Orientation	PhotometricInterpretation	PlanarConfiguration	PrimaryChromaticities	ReferenceBlackWhite	ResolutionUnit
RowsPerStrip	SamplesPerPixel	Software	StripByteCounts	StripOffsets	TransferFunction
WhitePoint	XResolution	YCbCrCoefficients	YCbCrPositioning	YCbCrSubSampling	YResolution
ApertureValue	BrightnessValue	CFAPattern	ColorSpace	ComponentsConfiguration	CompressedBitsPerPixel
Contrast	CustomRendered	DateTimeDigitized	DateTimeOriginal	DeviceSettingDescription	DigitalZoomRatio
ExifVersion	ExposureBiasValue	ExposureIndex	ExposureMode	ExposureProgram	ExposureTime
FNumber	FileSource	Flash	FlashEnergy	FlashpixVersion	FocalLength
FocalLengthIn35mmFilm	FocalPlaneResolutionUnit	FocalPlaneXResolution	FocalPlaneYResolution	GainControl	ISOSpeedRatings
ImageUniqueID	LightSource	MakerNote	MaxApertureValue	MeteringMode	NewSubfileType
OECF	PixelXDimension	RelatedSoundFile	Saturation	SceneCaptureType	SceneType
SensingMethod	Sharpness	ShutterSpeedValue	SpatialFrequencyResponse	SpectralSensitivity	SubfileType
SubSecTime	SubSecTimeDigitized	SubSecTimeOriginal	SubjectArea	SubjectDistance	SubjectDistanceRange
SubjectLocation	UserComment	WhiteBalance	GPSAltitude	GPSAltitudeRef	GPSAreaInformation
GPSDOP	GPSDateStamp	GPSDestBearing	GPSDestBearingRef	GPSDestDistance	GPSDestDistanceRef
GPSDestLatitude	GPSDestLatitudeRef	GPSDestLongitude	GPSDestLongitudeRef	GPSDifferential	GPSImgDirection
GPSImgDirectionRef	GPSLatitude	GPSLatitudeRef	GPSLongitude	GPSLongitudeRef	GPSMapDatum
GPSMeasureMode	GPSProcessingMethod	GPSSatellites	GPSSpeed	GPSSpeedRef	GPSStatus
GPSTimeStamp	GPSTrack	GPSTrackRef	GPSVersionID	InteroperabilityIndex	ThumbnailImageLength
ThumbnailImageWidth	DNGVersion	DefaultCropSize	ThumbnailImage	PreviewImageStart	PreviewImageLength
AspectFrame	SensorBottomBorder	SensorLeftBorder	SensorRightBorder	SensorTopBorder	ISO
JpgFromRaw

success返回值：

参数名	类型	说明
uri	String	图片地址

fail返回错误代码

错误码	说明
202	参数错误
300	I/O错误
301	文件路径不存在

示例：

image.setExifAttributes({
  uri: 'internal://cache/123.jpg',
  attributes:{
     Orientation:'1',
     Make:'quick app'
  },
  success: function (data) {
    console.log(`handling success`)
  },
  fail: function (data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后台运行限制

禁止使用。后台运行详细用法参见后台运行脚本。

← 快应用多媒体

快应用音频 →

301 Moved Permanently

快应用 图片编辑

接口声明

导入模块

接口定义image.getImageInfo(OBJECT)

参数：

success返回值：

fail返回错误代码

示例：

image.compressImage(OBJECT)

参数：

success返回值：

fail返回错误代码

示例：

image.applyOperations(OBJECT) 1000+

参数：

支持的编辑操作

success返回值：

fail返回错误代码

示例：

image.editImage(OBJECT)

参数：

success返回值：

fail返回错误代码：

示例：

image.getExifAttributes(OBJECT) 1040+

参数：

success返回值：

fail返回错误代码

示例：

image.setExifAttributes(OBJECT) 1040+

参数：

attributes接受的exif属性：

success返回值：

fail返回错误代码

示例：

后台运行限制

推荐文章

推荐教程

最新教程

快应用图片编辑

image.applyOperations(OBJECT) `1000+`