图片编辑 1000+

接口声明

{ "name": "system.image" }

导入模块

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

接口定义

image.getImageInfo(OBJECT)

获取图片信息

参数：

success 返回值：

fail 返回错误代码

示例：

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)

压缩图片

参数：

success 返回值：

fail 返回错误代码

示例：

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+

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

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

参数：

支持的编辑操作

• 图片裁剪

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

• 图片缩放

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

• 图片旋转

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

success 返回值：

fail 返回错误代码

示例：

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)

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

参数：

success 返回值：

fail 返回错误代码：

示例：

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。

参数：

success返回值：

fail返回错误代码

示例：

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。

参数：

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, PixelYDimension, 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返回值：

fail返回错误代码

示例：

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}`)
  }
})

后台运行限制

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