Merge remote-tracking branch 'origin/master' into release

Author: dynabic-billing-team

CHANGELOG.md

@@ -1,6 +1,12 @@
+## [24.8.0] - Aspose Words Cloud for Dart 24.8 Release Notes
+
+- Added the support of OpenType standard. It is usefull for languages required advanced typography.
+- Added support for send/receive progress callbacks in the dart sdk.
+
 ## [24.7.0] - Aspose Words Cloud for Dart 24.7 Release Notes
 
 - Added support for azw3 (Amazon Kindle Format) documents.
+- Added 'MaxImageResolution' property for SvgSaveOptionsData class.
 
 
 ## [24.6.0] - Aspose Words Cloud for Dart 24.6 Release Notes

README.md

@@ -27,7 +27,7 @@ Add this dependency to your *pubspec.yaml*:
 
 ```yaml
 dependencies:
-  aspose_words_cloud: 24.7.0
+  aspose_words_cloud: 24.8.0
 ```
 
 ## Getting Started

lib/src/api_client.dart

@@ -28,6 +28,7 @@
 library aspose_words_cloud;
 
 import 'dart:convert';
+import 'dart:math';
 import 'dart:typed_data';
 
 import 'package:convert/convert.dart';
@@ -457,7 +458,7 @@ class ApiClient {
     var batchBody = serializeMultipart(bodyParts, boundary);
     batchHeaders['Content-Type'] = 'multipart/form-data; boundary="$boundary"';
 
-    var batchRequestData = ApiRequestData('PUT', batchUrl, batchHeaders, batchBody);
+    var batchRequestData = ApiRequestData('PUT', batchUrl, batchHeaders, batchBody, null, null);
     var response = await _callWithChecks(batchRequestData);
     var responseParts = deserializeMultipartBatch(response.content);
     var result = <dynamic>[];
@@ -501,19 +502,46 @@ class ApiClient {
       print(debugMessage);
     }
 
-    var httpRequest = http.Request(requestData.method, Uri.parse(requestData.url));
+    http.BaseRequest httpRequest;
+    if (requestData.sendDataProgressCallback != null && requestData.body != null) {
+      final streamRequest = httpRequest = http.StreamedRequest(requestData.method, Uri.parse(requestData.url));
+      streamRequest.sink.addStream(_streamedByteData(requestData.body!, requestData.sendDataProgressCallback!)).then((_) {
+        streamRequest.sink.close();
+      });
+    }
+    else {
+      final bodyRequest = httpRequest = http.Request(requestData.method, Uri.parse(requestData.url));
+      if (requestData.body != null) {
+        bodyRequest.bodyBytes = requestData.body!.buffer.asUint8List(
+            requestData.body!.offsetInBytes, requestData.body!.lengthInBytes);
+      }
+    }
+
     httpRequest.headers['x-aspose-client'] = 'dart sdk';
-    httpRequest.headers['x-aspose-client-version'] = '24.7';
+    httpRequest.headers['x-aspose-client-version'] = '24.8';
     httpRequest.headers['Authorization'] = await _getAuthToken();
     httpRequest.headers.addAll(requestData.headers);
 
-    if (requestData.body != null) {
-      httpRequest.bodyBytes = requestData.body!.buffer.asUint8List(requestData.body!.offsetInBytes, requestData.body!.lengthInBytes);
-    }
-
     var response = await httpRequest.send().timeout(configuration.timeout);
-    var bytes = await response.stream.toBytes();
-    var responseData = ByteData.view(bytes.buffer);
+    ByteData responseData;
+    if (requestData.receiveDataProgressCallback != null) {
+      var responseReceivedBytes = 0;
+      final responseTotalBytes = response.contentLength ?? 0;
+      final bytes = BytesBuilder();
+      await for (final chunkValue in response.stream) {
+        final chunk = Uint8List.fromList(chunkValue);
+        bytes.write(chunk, chunk.offsetInBytes, chunk.lengthInBytes);
+        responseReceivedBytes += chunk.lengthInBytes;
+        requestData.receiveDataProgressCallback!(responseReceivedBytes, responseTotalBytes);
+      }
+
+      final totalBytes = bytes.takeBytes();
+      responseData = ByteData.view(totalBytes.buffer, totalBytes.offsetInBytes, totalBytes.lengthInBytes);
+    }
+    else {
+      final bytes = await response.stream.toBytes();
+      responseData = ByteData.view(bytes.buffer, bytes.offsetInBytes, bytes.lengthInBytes);
+    }
 
     if (configuration.debugMode == true) {
       var debugMessage = 'RESPONSE STATUS: ${response.statusCode} ${response.reasonPhrase}\r\n';
@@ -532,6 +560,18 @@ class ApiClient {
     _handleResponse(response.statusCode, response.reasonPhrase ?? "", responseData);
     return ApiResponseData(response.headers, responseData);
   }
+
+  Stream<Uint8List> _streamedByteData(ByteData buffer, final SendDataProgressCallback sendDataProgressCallback) async* {
+    final maxChunkSize = 1024 * 64;
+    final streamTotal = buffer.lengthInBytes;
+    for (int i = 0; i < streamTotal; i += maxChunkSize) {
+      final chunkProgress = i;
+      final chunkOffset = buffer.offsetInBytes + i;
+      final chunkSize = min(maxChunkSize, streamTotal - i);
+      sendDataProgressCallback(chunkProgress + chunkSize, streamTotal);
+      yield buffer.buffer.asUint8List(chunkOffset, chunkSize);
+    }
+  }
 }
 
 extension IterableExtension<T> on Iterable<T> {

lib/src/api_request_data.dart

@@ -28,11 +28,14 @@
 library aspose_words_cloud;
 
 import 'dart:typed_data';
+import './requests/request_base.dart';
 
 class ApiRequestData {
   final String method;
   final String url;
   final Map<String, String> headers;
   final ByteData? body;
-  ApiRequestData(this.method, this.url, this.headers, this.body);
+  final SendDataProgressCallback? sendDataProgressCallback;
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+  ApiRequestData(this.method, this.url, this.headers, this.body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
 }

lib/src/models/svg_save_options_data.dart

@@ -45,6 +45,15 @@ class SvgSaveOptionsData extends FixedPageSaveOptionsData {
   set fitToViewPort(bool? val) => _fitToViewPort = val;
 
 
+  /// Gets or sets a value in pixels per inch that limits resolution of exported raster images.
+  /// If the value of this property is non-zero, it limits resolution of exported raster images.
+  /// That is, higher-resolution images are resampled down to the limit and lower-resolution images are exported as is.
+  int? _maxImageResolution;
+
+  int? get maxImageResolution => _maxImageResolution;
+  set maxImageResolution(int? val) => _maxImageResolution = val;
+
+
   /// Gets or sets the physical folder where resources (images) are saved when exporting.
   String? _resourcesFolder;
 
@@ -241,6 +250,12 @@ class SvgSaveOptionsData extends FixedPageSaveOptionsData {
       fitToViewPort = null;
     }
 
+    if (json.containsKey('MaxImageResolution')) {
+      maxImageResolution = json['MaxImageResolution'] as int;
+    } else {
+      maxImageResolution = null;
+    }
+
     if (json.containsKey('ResourcesFolder')) {
       resourcesFolder = json['ResourcesFolder'] as String;
     } else {
@@ -283,6 +298,10 @@ class SvgSaveOptionsData extends FixedPageSaveOptionsData {
       _result['FitToViewPort'] = fitToViewPort!;
     }
 
+    if (maxImageResolution != null) {
+      _result['MaxImageResolution'] = maxImageResolution!;
+    }
+
     if (resourcesFolder != null) {
       _result['ResourcesFolder'] = resourcesFolder!;
     }

lib/src/requests/accept_all_revisions_online_request.dart

@@ -47,10 +47,19 @@ class AcceptAllRevisionsOnlineRequest implements RequestBase {
   /// Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
   final String? encryptedPassword;
 
+  /// The value indicates whether OpenType support is on.
+  final bool? openTypeSupport;
+
   /// Result path of the document after the operation. If this parameter is omitted then result of the operation will be saved as the source document.
   final String? destFileName;
 
-  AcceptAllRevisionsOnlineRequest(this.document, {this.loadEncoding, this.password, this.encryptedPassword, this.destFileName});
+  /// Request send data progress callback
+  final SendDataProgressCallback? sendDataProgressCallback;
+
+  /// Response receive data progress callback
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+
+  AcceptAllRevisionsOnlineRequest(this.document, {this.loadEncoding, this.password, this.encryptedPassword, this.openTypeSupport, this.destFileName, this.sendDataProgressCallback, this.receiveDataProgressCallback});
 
   @override
   Future<ApiRequestData> createRequestData(final ApiClient _apiClient) async {
@@ -71,6 +80,10 @@ class AcceptAllRevisionsOnlineRequest implements RequestBase {
       _queryParams['encryptedPassword'] = _apiClient.serializeToString(encryptedPassword) ?? "";
     }
 
+    if (openTypeSupport != null) {
+      _queryParams['openTypeSupport'] = _apiClient.serializeToString(openTypeSupport) ?? "";
+    }
+
     if (destFileName != null) {
       _queryParams['destFileName'] = _apiClient.serializeToString(destFileName) ?? "";
     }
@@ -94,7 +107,7 @@ class AcceptAllRevisionsOnlineRequest implements RequestBase {
     }
     var _url = _apiClient.configuration.getApiRootUrl() + _apiClient.applyQueryParams(_path, _queryParams).replaceAll('//', '/');
     var _body = _apiClient.serializeBodyParts(_bodyParts, _headers);
-    return ApiRequestData('PUT', _url, _headers, _body);
+    return ApiRequestData('PUT', _url, _headers, _body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
   }
 
   @override

lib/src/requests/accept_all_revisions_request.dart

@@ -54,10 +54,19 @@ class AcceptAllRevisionsRequest implements RequestBase {
   /// Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
   final String? encryptedPassword;
 
+  /// The value indicates whether OpenType support is on.
+  final bool? openTypeSupport;
+
   /// Result path of the document after the operation. If this parameter is omitted then result of the operation will be saved as the source document.
   final String? destFileName;
 
-  AcceptAllRevisionsRequest(this.name, {this.folder, this.storage, this.loadEncoding, this.password, this.encryptedPassword, this.destFileName});
+  /// Request send data progress callback
+  final SendDataProgressCallback? sendDataProgressCallback;
+
+  /// Response receive data progress callback
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+
+  AcceptAllRevisionsRequest(this.name, {this.folder, this.storage, this.loadEncoding, this.password, this.encryptedPassword, this.openTypeSupport, this.destFileName, this.sendDataProgressCallback, this.receiveDataProgressCallback});
 
   @override
   Future<ApiRequestData> createRequestData(final ApiClient _apiClient) async {
@@ -90,6 +99,10 @@ class AcceptAllRevisionsRequest implements RequestBase {
       _queryParams['encryptedPassword'] = _apiClient.serializeToString(encryptedPassword) ?? "";
     }
 
+    if (openTypeSupport != null) {
+      _queryParams['openTypeSupport'] = _apiClient.serializeToString(openTypeSupport) ?? "";
+    }
+
     if (destFileName != null) {
       _queryParams['destFileName'] = _apiClient.serializeToString(destFileName) ?? "";
     }
@@ -102,7 +115,7 @@ class AcceptAllRevisionsRequest implements RequestBase {
     }
     var _url = _apiClient.configuration.getApiRootUrl() + _apiClient.applyQueryParams(_path, _queryParams).replaceAll('//', '/');
     var _body = _apiClient.serializeBodyParts(_bodyParts, _headers);
-    return ApiRequestData('PUT', _url, _headers, _body);
+    return ApiRequestData('PUT', _url, _headers, _body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
   }
 
   @override

lib/src/requests/append_document_online_request.dart

@@ -50,6 +50,9 @@ class AppendDocumentOnlineRequest implements RequestBase {
   /// Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
   final String? encryptedPassword;
 
+  /// The value indicates whether OpenType support is on.
+  final bool? openTypeSupport;
+
   /// Result path of the document after the operation. If this parameter is omitted then result of the operation will be saved as the source document.
   final String? destFileName;
 
@@ -59,7 +62,13 @@ class AppendDocumentOnlineRequest implements RequestBase {
   /// The date and time to use for revisions.
   final String? revisionDateTime;
 
-  AppendDocumentOnlineRequest(this.document, this.documentList, {this.loadEncoding, this.password, this.encryptedPassword, this.destFileName, this.revisionAuthor, this.revisionDateTime});
+  /// Request send data progress callback
+  final SendDataProgressCallback? sendDataProgressCallback;
+
+  /// Response receive data progress callback
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+
+  AppendDocumentOnlineRequest(this.document, this.documentList, {this.loadEncoding, this.password, this.encryptedPassword, this.openTypeSupport, this.destFileName, this.revisionAuthor, this.revisionDateTime, this.sendDataProgressCallback, this.receiveDataProgressCallback});
 
   @override
   Future<ApiRequestData> createRequestData(final ApiClient _apiClient) async {
@@ -80,6 +89,10 @@ class AppendDocumentOnlineRequest implements RequestBase {
       _queryParams['encryptedPassword'] = _apiClient.serializeToString(encryptedPassword) ?? "";
     }
 
+    if (openTypeSupport != null) {
+      _queryParams['openTypeSupport'] = _apiClient.serializeToString(openTypeSupport) ?? "";
+    }
+
     if (destFileName != null) {
       _queryParams['destFileName'] = _apiClient.serializeToString(destFileName) ?? "";
     }
@@ -124,7 +137,7 @@ class AppendDocumentOnlineRequest implements RequestBase {
     }
     var _url = _apiClient.configuration.getApiRootUrl() + _apiClient.applyQueryParams(_path, _queryParams).replaceAll('//', '/');
     var _body = _apiClient.serializeBodyParts(_bodyParts, _headers);
-    return ApiRequestData('PUT', _url, _headers, _body);
+    return ApiRequestData('PUT', _url, _headers, _body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
   }
 
   @override

lib/src/requests/append_document_request.dart

@@ -57,6 +57,9 @@ class AppendDocumentRequest implements RequestBase {
   /// Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
   final String? encryptedPassword;
 
+  /// The value indicates whether OpenType support is on.
+  final bool? openTypeSupport;
+
   /// Result path of the document after the operation. If this parameter is omitted then result of the operation will be saved as the source document.
   final String? destFileName;
 
@@ -66,7 +69,13 @@ class AppendDocumentRequest implements RequestBase {
   /// The date and time to use for revisions.
   final String? revisionDateTime;
 
-  AppendDocumentRequest(this.name, this.documentList, {this.folder, this.storage, this.loadEncoding, this.password, this.encryptedPassword, this.destFileName, this.revisionAuthor, this.revisionDateTime});
+  /// Request send data progress callback
+  final SendDataProgressCallback? sendDataProgressCallback;
+
+  /// Response receive data progress callback
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+
+  AppendDocumentRequest(this.name, this.documentList, {this.folder, this.storage, this.loadEncoding, this.password, this.encryptedPassword, this.openTypeSupport, this.destFileName, this.revisionAuthor, this.revisionDateTime, this.sendDataProgressCallback, this.receiveDataProgressCallback});
 
   @override
   Future<ApiRequestData> createRequestData(final ApiClient _apiClient) async {
@@ -99,6 +108,10 @@ class AppendDocumentRequest implements RequestBase {
       _queryParams['encryptedPassword'] = _apiClient.serializeToString(encryptedPassword) ?? "";
     }
 
+    if (openTypeSupport != null) {
+      _queryParams['openTypeSupport'] = _apiClient.serializeToString(openTypeSupport) ?? "";
+    }
+
     if (destFileName != null) {
       _queryParams['destFileName'] = _apiClient.serializeToString(destFileName) ?? "";
     }
@@ -132,7 +145,7 @@ class AppendDocumentRequest implements RequestBase {
     }
     var _url = _apiClient.configuration.getApiRootUrl() + _apiClient.applyQueryParams(_path, _queryParams).replaceAll('//', '/');
     var _body = _apiClient.serializeBodyParts(_bodyParts, _headers);
-    return ApiRequestData('PUT', _url, _headers, _body);
+    return ApiRequestData('PUT', _url, _headers, _body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
   }
 
   @override

lib/src/requests/apply_style_to_document_element_online_request.dart

@@ -53,6 +53,9 @@ class ApplyStyleToDocumentElementOnlineRequest implements RequestBase {
   /// Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details.
   final String? encryptedPassword;
 
+  /// The value indicates whether OpenType support is on.
+  final bool? openTypeSupport;
+
   /// Result path of the document after the operation. If this parameter is omitted then result of the operation will be saved as the source document.
   final String? destFileName;
 
@@ -62,7 +65,13 @@ class ApplyStyleToDocumentElementOnlineRequest implements RequestBase {
   /// The date and time to use for revisions.
   final String? revisionDateTime;
 
-  ApplyStyleToDocumentElementOnlineRequest(this.document, this.styledNodePath, this.styleApply, {this.loadEncoding, this.password, this.encryptedPassword, this.destFileName, this.revisionAuthor, this.revisionDateTime});
+  /// Request send data progress callback
+  final SendDataProgressCallback? sendDataProgressCallback;
+
+  /// Response receive data progress callback
+  final ReceiveDataProgressCallback? receiveDataProgressCallback;
+
+  ApplyStyleToDocumentElementOnlineRequest(this.document, this.styledNodePath, this.styleApply, {this.loadEncoding, this.password, this.encryptedPassword, this.openTypeSupport, this.destFileName, this.revisionAuthor, this.revisionDateTime, this.sendDataProgressCallback, this.receiveDataProgressCallback});
 
   @override
   Future<ApiRequestData> createRequestData(final ApiClient _apiClient) async {
@@ -87,6 +96,10 @@ class ApplyStyleToDocumentElementOnlineRequest implements RequestBase {
       _queryParams['encryptedPassword'] = _apiClient.serializeToString(encryptedPassword) ?? "";
     }
 
+    if (openTypeSupport != null) {
+      _queryParams['openTypeSupport'] = _apiClient.serializeToString(openTypeSupport) ?? "";
+    }
+
     if (destFileName != null) {
       _queryParams['destFileName'] = _apiClient.serializeToString(destFileName) ?? "";
     }
@@ -130,7 +143,7 @@ class ApplyStyleToDocumentElementOnlineRequest implements RequestBase {
     }
     var _url = _apiClient.configuration.getApiRootUrl() + _apiClient.applyQueryParams(_path, _queryParams).replaceAll('//', '/');
     var _body = _apiClient.serializeBodyParts(_bodyParts, _headers);
-    return ApiRequestData('PUT', _url, _headers, _body);
+    return ApiRequestData('PUT', _url, _headers, _body, this.sendDataProgressCallback, this.receiveDataProgressCallback);
   }
 
   @override