GenerateAPI.swift

//
// GenerateAPI.swift
//
// Generated by openapi-generator
// https://openapi-generator.tech
//

import Foundation

open class GenerateAPI {
    /**
     Generate a barcode using a GET request with parameters in the route and query string.

     - parameter barcodeType: (path) Type of barcode to generate.
     - parameter data: (query) String that represents the data to encode.
     - parameter dataType: (query) Type of data to encode. Default value: StringData. (optional)
     - parameter imageFormat: (query) Barcode output image format. Default value: png. (optional)
     - parameter textLocation: (query) Specify the displayed text location. Set to CodeLocation.None to hide CodeText. Default value depends on BarcodeType: CodeLocation.Below for 1D barcodes and CodeLocation.None for 2D barcodes. (optional)
     - parameter foregroundColor: (query) Specify the display color for bars and content. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: Black. (optional, default to "Black")
     - parameter backgroundColor: (query) Background color of the barcode image. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: White. (optional, default to "White")
     - parameter units: (query) Common units for all measurements. Default units: pixels. (optional)
     - parameter resolution: (query) Resolution of the barcode image. One value for both dimensions. Default value: 96 dpi. Decimal separator is a dot. (optional)
     - parameter imageHeight: (query) Height of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter imageWidth: (query) Width of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter rotationAngle: (query) Barcode image rotation angle, measured in degrees. For example, RotationAngle = 0 or RotationAngle = 360 means no rotation. If RotationAngle is not equal to 90, 180, 270, or 0, it may increase the difficulty for the scanner to read the image. Default value: 0. (optional)
     - parameter qrEncodeMode: (query) QR barcode encode mode. (optional)
     - parameter qrErrorLevel: (query) QR barcode error correction level. (optional)
     - parameter qrVersion: (query) QR barcode version. Automatically selects the smallest version that fits the data. (optional)
     - parameter qrECIEncoding: (query) ECI encoding for QR barcode data. (optional)
     - parameter qrAspectRatio: (query) QR barcode aspect ratio. Values: 0 to 1. (optional)
     - parameter microQRVersion: (query) MicroQR barcode version. Used when BarcodeType is MicroQR. (optional)
     - parameter rectMicroQrVersion: (query) RectMicroQR barcode version. Used when BarcodeType is RectMicroQR. (optional)
     - parameter code128EncodeMode: (query) Code128 barcode encode mode. Controls which Code 128 subset (A, B, C, or mix) is used. (optional)
     - parameter pdf417EncodeMode: (query) PDF417 barcode encode mode. (optional)
     - parameter pdf417ErrorLevel: (query) PDF417 barcode error correction level. (optional)
     - parameter pdf417Truncate: (query) Whether to use truncated PDF417 format (removes right-side stop pattern). (optional)
     - parameter pdf417Columns: (query) Number of columns in the PDF417 barcode. Values between 1 and 30. 0 for auto. (optional)
     - parameter pdf417Rows: (query) Number of rows in the PDF417 barcode. Values between 3 and 90. 0 for automatic. (optional)
     - parameter pdf417AspectRatio: (query) PDF417 barcode aspect ratio (height/width of the barcode module). Values are defined by the standard: 2 to 5 for MicroPdf417; 3 to 5 for Pdf417 and MacroPdf417. (optional)
     - parameter pdf417ECIEncoding: (query) ECI encoding for PDF417 barcode data. (optional)
     - parameter pdf417IsReaderInitialization: (query) Whether the barcode is used for reader initialization (programming). (optional)
     - parameter pdf417MacroCharacters: (query) Macro character to prepend (structured append). (optional)
     - parameter pdf417IsLinked: (query) Whether to use linked mode (for MicroPdf417). (optional)
     - parameter pdf417IsCode128Emulation: (query) Whether to use Code128 emulation for MicroPdf417. (optional)
     - parameter apiConfiguration: The configuration for the http request.
     - parameter completion: completion handler to receive the data and the error objects
     */
    @discardableResult
    open class func generate(barcodeType: EncodeBarcodeType, data: String, dataType: EncodeDataType? = nil, barcodeImageParams: BarcodeImageParams? = nil, qrParams: QrParams? = nil, code128Params: Code128Params? = nil, pdf417Params: Pdf417Params? = nil, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared, completion: @Sendable @escaping (_ data: Data?, _ error: Error?) -> Void) -> RequestTask {
        generateWithRequestBuilder(barcodeType: barcodeType, data: data, dataType: dataType, barcodeImageParams: barcodeImageParams, qrParams: qrParams, code128Params: code128Params, pdf417Params: pdf417Params, apiConfiguration: apiConfiguration).execute { result in
            switch result {
            case let .success(response):
                completion(response.body, nil)
            case let .failure(error):
                completion(nil, error)
            }
        }
    }

    /**
     Generate a barcode using a GET request with parameters in the route and query string.

     - parameter barcodeType: (path) Type of barcode to generate.
     - parameter data: (query) String that represents the data to encode.
     - parameter dataType: (query) Type of data to encode. Default value: StringData. (optional)
     - parameter imageFormat: (query) Barcode output image format. Default value: png. (optional)
     - parameter textLocation: (query) Specify the displayed text location. Set to CodeLocation.None to hide CodeText. Default value depends on BarcodeType: CodeLocation.Below for 1D barcodes and CodeLocation.None for 2D barcodes. (optional)
     - parameter foregroundColor: (query) Specify the display color for bars and content. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: Black. (optional, default to "Black")
     - parameter backgroundColor: (query) Background color of the barcode image. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: White. (optional, default to "White")
     - parameter units: (query) Common units for all measurements. Default units: pixels. (optional)
     - parameter resolution: (query) Resolution of the barcode image. One value for both dimensions. Default value: 96 dpi. Decimal separator is a dot. (optional)
     - parameter imageHeight: (query) Height of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter imageWidth: (query) Width of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter rotationAngle: (query) Barcode image rotation angle, measured in degrees. For example, RotationAngle = 0 or RotationAngle = 360 means no rotation. If RotationAngle is not equal to 90, 180, 270, or 0, it may increase the difficulty for the scanner to read the image. Default value: 0. (optional)
     - parameter qrEncodeMode: (query) QR barcode encode mode. (optional)
     - parameter qrErrorLevel: (query) QR barcode error correction level. (optional)
     - parameter qrVersion: (query) QR barcode version. Automatically selects the smallest version that fits the data. (optional)
     - parameter qrECIEncoding: (query) ECI encoding for QR barcode data. (optional)
     - parameter qrAspectRatio: (query) QR barcode aspect ratio. Values: 0 to 1. (optional)
     - parameter microQRVersion: (query) MicroQR barcode version. Used when BarcodeType is MicroQR. (optional)
     - parameter rectMicroQrVersion: (query) RectMicroQR barcode version. Used when BarcodeType is RectMicroQR. (optional)
     - parameter code128EncodeMode: (query) Code128 barcode encode mode. Controls which Code 128 subset (A, B, C, or mix) is used. (optional)
     - parameter pdf417EncodeMode: (query) PDF417 barcode encode mode. (optional)
     - parameter pdf417ErrorLevel: (query) PDF417 barcode error correction level. (optional)
     - parameter pdf417Truncate: (query) Whether to use truncated PDF417 format (removes right-side stop pattern). (optional)
     - parameter pdf417Columns: (query) Number of columns in the PDF417 barcode. Values between 1 and 30. 0 for auto. (optional)
     - parameter pdf417Rows: (query) Number of rows in the PDF417 barcode. Values between 3 and 90. 0 for automatic. (optional)
     - parameter pdf417AspectRatio: (query) PDF417 barcode aspect ratio (height/width of the barcode module). Values are defined by the standard: 2 to 5 for MicroPdf417; 3 to 5 for Pdf417 and MacroPdf417. (optional)
     - parameter pdf417ECIEncoding: (query) ECI encoding for PDF417 barcode data. (optional)
     - parameter pdf417IsReaderInitialization: (query) Whether the barcode is used for reader initialization (programming). (optional)
     - parameter pdf417MacroCharacters: (query) Macro character to prepend (structured append). (optional)
     - parameter pdf417IsLinked: (query) Whether to use linked mode (for MicroPdf417). (optional)
     - parameter pdf417IsCode128Emulation: (query) Whether to use Code128 emulation for MicroPdf417. (optional)
     - parameter apiConfiguration: The configuration for the http request.
     - returns: Data
     */
    open class func generate(barcodeType: EncodeBarcodeType, data: String, dataType: EncodeDataType? = nil, barcodeImageParams: BarcodeImageParams? = nil, qrParams: QrParams? = nil, code128Params: Code128Params? = nil, pdf417Params: Pdf417Params? = nil, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared) async throws(ErrorResponse) -> Data {
        try await generateWithRequestBuilder(barcodeType: barcodeType, data: data, dataType: dataType, barcodeImageParams: barcodeImageParams, qrParams: qrParams, code128Params: code128Params, pdf417Params: pdf417Params, apiConfiguration: apiConfiguration).execute().body
    }

    /**
     Generate a barcode using a GET request with parameters in the route and query string.
     - GET /barcode/generate/{barcodeType}
     - OAuth:
       - type: oauth2
       - name: JWT
     - parameter barcodeType: (path) Type of barcode to generate.
     - parameter data: (query) String that represents the data to encode.
     - parameter dataType: (query) Type of data to encode. Default value: StringData. (optional)
     - parameter imageFormat: (query) Barcode output image format. Default value: png. (optional)
     - parameter textLocation: (query) Specify the displayed text location. Set to CodeLocation.None to hide CodeText. Default value depends on BarcodeType: CodeLocation.Below for 1D barcodes and CodeLocation.None for 2D barcodes. (optional)
     - parameter foregroundColor: (query) Specify the display color for bars and content. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: Black. (optional, default to "Black")
     - parameter backgroundColor: (query) Background color of the barcode image. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: White. (optional, default to "White")
     - parameter units: (query) Common units for all measurements. Default units: pixels. (optional)
     - parameter resolution: (query) Resolution of the barcode image. One value for both dimensions. Default value: 96 dpi. Decimal separator is a dot. (optional)
     - parameter imageHeight: (query) Height of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter imageWidth: (query) Width of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter rotationAngle: (query) Barcode image rotation angle, measured in degrees. For example, RotationAngle = 0 or RotationAngle = 360 means no rotation. If RotationAngle is not equal to 90, 180, 270, or 0, it may increase the difficulty for the scanner to read the image. Default value: 0. (optional)
     - parameter qrEncodeMode: (query) QR barcode encode mode. (optional)
     - parameter qrErrorLevel: (query) QR barcode error correction level. (optional)
     - parameter qrVersion: (query) QR barcode version. Automatically selects the smallest version that fits the data. (optional)
     - parameter qrECIEncoding: (query) ECI encoding for QR barcode data. (optional)
     - parameter qrAspectRatio: (query) QR barcode aspect ratio. Values: 0 to 1. (optional)
     - parameter microQRVersion: (query) MicroQR barcode version. Used when BarcodeType is MicroQR. (optional)
     - parameter rectMicroQrVersion: (query) RectMicroQR barcode version. Used when BarcodeType is RectMicroQR. (optional)
     - parameter code128EncodeMode: (query) Code128 barcode encode mode. Controls which Code 128 subset (A, B, C, or mix) is used. (optional)
     - parameter pdf417EncodeMode: (query) PDF417 barcode encode mode. (optional)
     - parameter pdf417ErrorLevel: (query) PDF417 barcode error correction level. (optional)
     - parameter pdf417Truncate: (query) Whether to use truncated PDF417 format (removes right-side stop pattern). (optional)
     - parameter pdf417Columns: (query) Number of columns in the PDF417 barcode. Values between 1 and 30. 0 for auto. (optional)
     - parameter pdf417Rows: (query) Number of rows in the PDF417 barcode. Values between 3 and 90. 0 for automatic. (optional)
     - parameter pdf417AspectRatio: (query) PDF417 barcode aspect ratio (height/width of the barcode module). Values are defined by the standard: 2 to 5 for MicroPdf417; 3 to 5 for Pdf417 and MacroPdf417. (optional)
     - parameter pdf417ECIEncoding: (query) ECI encoding for PDF417 barcode data. (optional)
     - parameter pdf417IsReaderInitialization: (query) Whether the barcode is used for reader initialization (programming). (optional)
     - parameter pdf417MacroCharacters: (query) Macro character to prepend (structured append). (optional)
     - parameter pdf417IsLinked: (query) Whether to use linked mode (for MicroPdf417). (optional)
     - parameter pdf417IsCode128Emulation: (query) Whether to use Code128 emulation for MicroPdf417. (optional)
     - parameter apiConfiguration: The configuration for the http request.
     - returns: RequestBuilder<Data>
     */
    open class func generateWithRequestBuilder(barcodeType: EncodeBarcodeType, data: String, dataType: EncodeDataType? = nil, barcodeImageParams: BarcodeImageParams? = nil, qrParams: QrParams? = nil, code128Params: Code128Params? = nil, pdf417Params: Pdf417Params? = nil, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared) -> RequestBuilder<Data> {
        var localVariablePath = "/barcode/generate/{barcodeType}"
        let barcodeTypePreEscape = "\(APIHelper.mapValueToPathItem(barcodeType))"
        let barcodeTypePostEscape = barcodeTypePreEscape.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) ?? ""
        localVariablePath = localVariablePath.replacingOccurrences(of: "{barcodeType}", with: barcodeTypePostEscape, options: .literal, range: nil)
        let localVariableURLString = apiConfiguration.basePath + localVariablePath
        let localVariableParameters: [String: any Sendable]? = nil

        var localVariableUrlComponents = URLComponents(string: localVariableURLString)
        localVariableUrlComponents?.queryItems = APIHelper.mapValuesToQueryItems([
            "dataType": (wrappedValue: dataType?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "data": (wrappedValue: data.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "imageFormat": (wrappedValue: barcodeImageParams?.imageFormat?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "textLocation": (wrappedValue: barcodeImageParams?.textLocation?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "foregroundColor": (wrappedValue: barcodeImageParams?.foregroundColor?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "backgroundColor": (wrappedValue: barcodeImageParams?.backgroundColor?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "units": (wrappedValue: barcodeImageParams?.units?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "resolution": (wrappedValue: barcodeImageParams?.resolution?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "imageHeight": (wrappedValue: barcodeImageParams?.imageHeight?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "imageWidth": (wrappedValue: barcodeImageParams?.imageWidth?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "rotationAngle": (wrappedValue: barcodeImageParams?.rotationAngle?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "qrEncodeMode": (wrappedValue: qrParams?.qrEncodeMode?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "qrErrorLevel": (wrappedValue: qrParams?.qrErrorLevel?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "qrVersion": (wrappedValue: qrParams?.qrVersion?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "qrECIEncoding": (wrappedValue: qrParams?.qrECIEncoding?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "qrAspectRatio": (wrappedValue: qrParams?.qrAspectRatio?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "microQRVersion": (wrappedValue: qrParams?.microQRVersion?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "rectMicroQrVersion": (wrappedValue: qrParams?.rectMicroQrVersion?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "code128EncodeMode": (wrappedValue: code128Params?.code128EncodeMode?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417EncodeMode": (wrappedValue: pdf417Params?.pdf417EncodeMode?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417ErrorLevel": (wrappedValue: pdf417Params?.pdf417ErrorLevel?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417Truncate": (wrappedValue: pdf417Params?.pdf417Truncate?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417Columns": (wrappedValue: pdf417Params?.pdf417Columns?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417Rows": (wrappedValue: pdf417Params?.pdf417Rows?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417AspectRatio": (wrappedValue: pdf417Params?.pdf417AspectRatio?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417ECIEncoding": (wrappedValue: pdf417Params?.pdf417ECIEncoding?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417IsReaderInitialization": (wrappedValue: pdf417Params?.pdf417IsReaderInitialization?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417MacroCharacters": (wrappedValue: pdf417Params?.pdf417MacroCharacters?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417IsLinked": (wrappedValue: pdf417Params?.pdf417IsLinked?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
            "pdf417IsCode128Emulation": (wrappedValue: pdf417Params?.pdf417IsCode128Emulation?.asParameter(codableHelper: apiConfiguration.codableHelper), isExplode: true),
        ])

        let localVariableNillableHeaders: [String: (any Sendable)?] = [:]

        let localVariableHeaderParameters = APIHelper.rejectNilHeaders(localVariableNillableHeaders)

        let localVariableRequestBuilder: RequestBuilder<Data>.Type = apiConfiguration.requestBuilderFactory.getBuilder()

        return localVariableRequestBuilder.init(method: "GET", URLString: (localVariableUrlComponents?.string ?? localVariableURLString), parameters: localVariableParameters, headers: localVariableHeaderParameters, requiresAuthentication: true, apiConfiguration: apiConfiguration)
    }

    /**
     Generate a barcode using a POST request with parameters in the request body in JSON or XML format.

     - parameter generateParams: (body) Generation parameters.
     - parameter apiConfiguration: The configuration for the http request.
     - parameter completion: completion handler to receive the data and the error objects
     */
    @discardableResult
    open class func generateBody(generateParams: GenerateParams, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared, completion: @Sendable @escaping (_ data: Data?, _ error: Error?) -> Void) -> RequestTask {
        generateBodyWithRequestBuilder(generateParams: generateParams, apiConfiguration: apiConfiguration).execute { result in
            switch result {
            case let .success(response):
                completion(response.body, nil)
            case let .failure(error):
                completion(nil, error)
            }
        }
    }

    /**
     Generate a barcode using a POST request with parameters in the request body in JSON or XML format.

     - parameter generateParams: (body) Generation parameters.
     - parameter apiConfiguration: The configuration for the http request.
     - returns: Data
     */
    open class func generateBody(generateParams: GenerateParams, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared) async throws(ErrorResponse) -> Data {
        try await generateBodyWithRequestBuilder(generateParams: generateParams, apiConfiguration: apiConfiguration).execute().body
    }

    /**
     Generate a barcode using a POST request with parameters in the request body in JSON or XML format.
     - POST /barcode/generate-body
     - OAuth:
       - type: oauth2
       - name: JWT
     - parameter generateParams: (body) Generation parameters.
     - parameter apiConfiguration: The configuration for the http request.
     - returns: RequestBuilder<Data>
     */
    open class func generateBodyWithRequestBuilder(generateParams: GenerateParams, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared) -> RequestBuilder<Data> {
        let localVariablePath = "/barcode/generate-body"
        let localVariableURLString = apiConfiguration.basePath + localVariablePath
        let localVariableParameters = JSONEncodingHelper.encodingParameters(forEncodableObject: generateParams, codableHelper: apiConfiguration.codableHelper)

        let localVariableUrlComponents = URLComponents(string: localVariableURLString)

        let localVariableNillableHeaders: [String: (any Sendable)?] = [
            "Content-Type": "application/json",
        ]

        let localVariableHeaderParameters = APIHelper.rejectNilHeaders(localVariableNillableHeaders)

        let localVariableRequestBuilder: RequestBuilder<Data>.Type = apiConfiguration.requestBuilderFactory.getBuilder()

        return localVariableRequestBuilder.init(method: "POST", URLString: (localVariableUrlComponents?.string ?? localVariableURLString), parameters: localVariableParameters, headers: localVariableHeaderParameters, requiresAuthentication: true, apiConfiguration: apiConfiguration)
    }

    /**
     Generate a barcode using a POST request with parameters in a multipart form.

     - parameter barcodeType: (form) See https://reference.aspose.com/barcode/net/aspose.barcode.generation/encodetypes/
     - parameter data: (form) String that represents the data to encode.
     - parameter dataType: (form) Type of data to encode. Default value: StringData. (optional)
     - parameter imageFormat: (form) Barcode output image format. Default value: png. (optional)
     - parameter textLocation: (form) Specify the displayed text location. Set to CodeLocation.None to hide CodeText. Default value depends on BarcodeType: CodeLocation.Below for 1D barcodes and CodeLocation.None for 2D barcodes. (optional)
     - parameter foregroundColor: (form) Specify the display color for bars and content. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: Black. (optional, default to "Black")
     - parameter backgroundColor: (form) Background color of the barcode image. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: White. (optional, default to "White")
     - parameter units: (form) Common units for all measurements. Default units: pixels. (optional)
     - parameter resolution: (form) Resolution of the barcode image. One value for both dimensions. Default value: 96 dpi. Decimal separator is a dot. (optional)
     - parameter imageHeight: (form) Height of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter imageWidth: (form) Width of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter rotationAngle: (form) Barcode image rotation angle, measured in degrees. For example, RotationAngle &#x3D; 0 or RotationAngle &#x3D; 360 means no rotation. If RotationAngle is not equal to 90, 180, 270, or 0, it may increase the difficulty for the scanner to read the image. Default value: 0. (optional)
     - parameter qrEncodeMode: (form) QR barcode encode mode. (optional)
     - parameter qrErrorLevel: (form) QR barcode error correction level. (optional)
     - parameter qrVersion: (form) QR barcode version. Automatically selects the smallest version that fits the data. (optional)
     - parameter qrECIEncoding: (form) ECI encoding for QR barcode data. (optional)
     - parameter qrAspectRatio: (form) QR barcode aspect ratio. Values: 0 to 1. (optional)
     - parameter microQRVersion: (form) MicroQR barcode version. Used when BarcodeType is MicroQR. (optional)
     - parameter rectMicroQrVersion: (form) RectMicroQR barcode version. Used when BarcodeType is RectMicroQR. (optional)
     - parameter code128EncodeMode: (form) Code128 barcode encode mode. Controls which Code 128 subset (A, B, C, or mix) is used. (optional)
     - parameter pdf417EncodeMode: (form) PDF417 barcode encode mode. (optional)
     - parameter pdf417ErrorLevel: (form) PDF417 barcode error correction level. (optional)
     - parameter pdf417Truncate: (form) Whether to use truncated PDF417 format (removes right-side stop pattern). (optional)
     - parameter pdf417Columns: (form) Number of columns in the PDF417 barcode. Values between 1 and 30. 0 for auto. (optional)
     - parameter pdf417Rows: (form) Number of rows in the PDF417 barcode. Values between 3 and 90. 0 for automatic. (optional)
     - parameter pdf417AspectRatio: (form) PDF417 barcode aspect ratio (height/width of the barcode module). Values are defined by the standard: 2 to 5 for MicroPdf417; 3 to 5 for Pdf417 and MacroPdf417. (optional)
     - parameter pdf417ECIEncoding: (form) ECI encoding for PDF417 barcode data. (optional)
     - parameter pdf417IsReaderInitialization: (form) Whether the barcode is used for reader initialization (programming). (optional)
     - parameter pdf417MacroCharacters: (form) Macro character to prepend (structured append). (optional)
     - parameter pdf417IsLinked: (form) Whether to use linked mode (for MicroPdf417). (optional)
     - parameter pdf417IsCode128Emulation: (form) Whether to use Code128 emulation for MicroPdf417. (optional)
     - parameter apiConfiguration: The configuration for the http request.
     - parameter completion: completion handler to receive the data and the error objects
     */
    @discardableResult
    open class func generateMultipart(barcodeType: EncodeBarcodeType, data: String, dataType: EncodeDataType? = nil, barcodeImageParams: BarcodeImageParams? = nil, qrParams: QrParams? = nil, code128Params: Code128Params? = nil, pdf417Params: Pdf417Params? = nil, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared, completion: @Sendable @escaping (_ data: Data?, _ error: Error?) -> Void) -> RequestTask {
        generateMultipartWithRequestBuilder(barcodeType: barcodeType, data: data, dataType: dataType, barcodeImageParams: barcodeImageParams, qrParams: qrParams, code128Params: code128Params, pdf417Params: pdf417Params, apiConfiguration: apiConfiguration).execute { result in
            switch result {
            case let .success(response):
                completion(response.body, nil)
            case let .failure(error):
                completion(nil, error)
            }
        }
    }

    /**
     Generate a barcode using a POST request with parameters in a multipart form.

     - parameter barcodeType: (form) See https://reference.aspose.com/barcode/net/aspose.barcode.generation/encodetypes/
     - parameter data: (form) String that represents the data to encode.
     - parameter dataType: (form) Type of data to encode. Default value: StringData. (optional)
     - parameter imageFormat: (form) Barcode output image format. Default value: png. (optional)
     - parameter textLocation: (form) Specify the displayed text location. Set to CodeLocation.None to hide CodeText. Default value depends on BarcodeType: CodeLocation.Below for 1D barcodes and CodeLocation.None for 2D barcodes. (optional)
     - parameter foregroundColor: (form) Specify the display color for bars and content. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: Black. (optional, default to "Black")
     - parameter backgroundColor: (form) Background color of the barcode image. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: White. (optional, default to "White")
     - parameter units: (form) Common units for all measurements. Default units: pixels. (optional)
     - parameter resolution: (form) Resolution of the barcode image. One value for both dimensions. Default value: 96 dpi. Decimal separator is a dot. (optional)
     - parameter imageHeight: (form) Height of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter imageWidth: (form) Width of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter rotationAngle: (form) Barcode image rotation angle, measured in degrees. For example, RotationAngle &#x3D; 0 or RotationAngle &#x3D; 360 means no rotation. If RotationAngle is not equal to 90, 180, 270, or 0, it may increase the difficulty for the scanner to read the image. Default value: 0. (optional)
     - parameter qrEncodeMode: (form) QR barcode encode mode. (optional)
     - parameter qrErrorLevel: (form) QR barcode error correction level. (optional)
     - parameter qrVersion: (form) QR barcode version. Automatically selects the smallest version that fits the data. (optional)
     - parameter qrECIEncoding: (form) ECI encoding for QR barcode data. (optional)
     - parameter qrAspectRatio: (form) QR barcode aspect ratio. Values: 0 to 1. (optional)
     - parameter microQRVersion: (form) MicroQR barcode version. Used when BarcodeType is MicroQR. (optional)
     - parameter rectMicroQrVersion: (form) RectMicroQR barcode version. Used when BarcodeType is RectMicroQR. (optional)
     - parameter code128EncodeMode: (form) Code128 barcode encode mode. Controls which Code 128 subset (A, B, C, or mix) is used. (optional)
     - parameter pdf417EncodeMode: (form) PDF417 barcode encode mode. (optional)
     - parameter pdf417ErrorLevel: (form) PDF417 barcode error correction level. (optional)
     - parameter pdf417Truncate: (form) Whether to use truncated PDF417 format (removes right-side stop pattern). (optional)
     - parameter pdf417Columns: (form) Number of columns in the PDF417 barcode. Values between 1 and 30. 0 for auto. (optional)
     - parameter pdf417Rows: (form) Number of rows in the PDF417 barcode. Values between 3 and 90. 0 for automatic. (optional)
     - parameter pdf417AspectRatio: (form) PDF417 barcode aspect ratio (height/width of the barcode module). Values are defined by the standard: 2 to 5 for MicroPdf417; 3 to 5 for Pdf417 and MacroPdf417. (optional)
     - parameter pdf417ECIEncoding: (form) ECI encoding for PDF417 barcode data. (optional)
     - parameter pdf417IsReaderInitialization: (form) Whether the barcode is used for reader initialization (programming). (optional)
     - parameter pdf417MacroCharacters: (form) Macro character to prepend (structured append). (optional)
     - parameter pdf417IsLinked: (form) Whether to use linked mode (for MicroPdf417). (optional)
     - parameter pdf417IsCode128Emulation: (form) Whether to use Code128 emulation for MicroPdf417. (optional)
     - parameter apiConfiguration: The configuration for the http request.
     - returns: Data
     */
    open class func generateMultipart(barcodeType: EncodeBarcodeType, data: String, dataType: EncodeDataType? = nil, barcodeImageParams: BarcodeImageParams? = nil, qrParams: QrParams? = nil, code128Params: Code128Params? = nil, pdf417Params: Pdf417Params? = nil, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared) async throws(ErrorResponse) -> Data {
        try await generateMultipartWithRequestBuilder(barcodeType: barcodeType, data: data, dataType: dataType, barcodeImageParams: barcodeImageParams, qrParams: qrParams, code128Params: code128Params, pdf417Params: pdf417Params, apiConfiguration: apiConfiguration).execute().body
    }

    /**
     Generate a barcode using a POST request with parameters in a multipart form.
     - POST /barcode/generate-multipart
     - OAuth:
       - type: oauth2
       - name: JWT
     - parameter barcodeType: (form) See https://reference.aspose.com/barcode/net/aspose.barcode.generation/encodetypes/
     - parameter data: (form) String that represents the data to encode.
     - parameter dataType: (form) Type of data to encode. Default value: StringData. (optional)
     - parameter imageFormat: (form) Barcode output image format. Default value: png. (optional)
     - parameter textLocation: (form) Specify the displayed text location. Set to CodeLocation.None to hide CodeText. Default value depends on BarcodeType: CodeLocation.Below for 1D barcodes and CodeLocation.None for 2D barcodes. (optional)
     - parameter foregroundColor: (form) Specify the display color for bars and content. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: Black. (optional, default to "Black")
     - parameter backgroundColor: (form) Background color of the barcode image. Value: Color name from https://reference.aspose.com/drawing/net/system.drawing/color/ or ARGB value starting with #. For example: AliceBlue or #FF000000. Default value: White. (optional, default to "White")
     - parameter units: (form) Common units for all measurements. Default units: pixels. (optional)
     - parameter resolution: (form) Resolution of the barcode image. One value for both dimensions. Default value: 96 dpi. Decimal separator is a dot. (optional)
     - parameter imageHeight: (form) Height of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter imageWidth: (form) Width of the barcode image in the specified units. Default units: pixels. Decimal separator is a dot. (optional)
     - parameter rotationAngle: (form) Barcode image rotation angle, measured in degrees. For example, RotationAngle &#x3D; 0 or RotationAngle &#x3D; 360 means no rotation. If RotationAngle is not equal to 90, 180, 270, or 0, it may increase the difficulty for the scanner to read the image. Default value: 0. (optional)
     - parameter qrEncodeMode: (form) QR barcode encode mode. (optional)
     - parameter qrErrorLevel: (form) QR barcode error correction level. (optional)
     - parameter qrVersion: (form) QR barcode version. Automatically selects the smallest version that fits the data. (optional)
     - parameter qrECIEncoding: (form) ECI encoding for QR barcode data. (optional)
     - parameter qrAspectRatio: (form) QR barcode aspect ratio. Values: 0 to 1. (optional)
     - parameter microQRVersion: (form) MicroQR barcode version. Used when BarcodeType is MicroQR. (optional)
     - parameter rectMicroQrVersion: (form) RectMicroQR barcode version. Used when BarcodeType is RectMicroQR. (optional)
     - parameter code128EncodeMode: (form) Code128 barcode encode mode. Controls which Code 128 subset (A, B, C, or mix) is used. (optional)
     - parameter pdf417EncodeMode: (form) PDF417 barcode encode mode. (optional)
     - parameter pdf417ErrorLevel: (form) PDF417 barcode error correction level. (optional)
     - parameter pdf417Truncate: (form) Whether to use truncated PDF417 format (removes right-side stop pattern). (optional)
     - parameter pdf417Columns: (form) Number of columns in the PDF417 barcode. Values between 1 and 30. 0 for auto. (optional)
     - parameter pdf417Rows: (form) Number of rows in the PDF417 barcode. Values between 3 and 90. 0 for automatic. (optional)
     - parameter pdf417AspectRatio: (form) PDF417 barcode aspect ratio (height/width of the barcode module). Values are defined by the standard: 2 to 5 for MicroPdf417; 3 to 5 for Pdf417 and MacroPdf417. (optional)
     - parameter pdf417ECIEncoding: (form) ECI encoding for PDF417 barcode data. (optional)
     - parameter pdf417IsReaderInitialization: (form) Whether the barcode is used for reader initialization (programming). (optional)
     - parameter pdf417MacroCharacters: (form) Macro character to prepend (structured append). (optional)
     - parameter pdf417IsLinked: (form) Whether to use linked mode (for MicroPdf417). (optional)
     - parameter pdf417IsCode128Emulation: (form) Whether to use Code128 emulation for MicroPdf417. (optional)
     - parameter apiConfiguration: The configuration for the http request.
     - returns: RequestBuilder<Data>
     */
    open class func generateMultipartWithRequestBuilder(barcodeType: EncodeBarcodeType, data: String, dataType: EncodeDataType? = nil, barcodeImageParams: BarcodeImageParams? = nil, qrParams: QrParams? = nil, code128Params: Code128Params? = nil, pdf417Params: Pdf417Params? = nil, apiConfiguration: AsposeBarcodeCloudAPIConfiguration = AsposeBarcodeCloudAPIConfiguration.shared) -> RequestBuilder<Data> {
        let localVariablePath = "/barcode/generate-multipart"
        let localVariableURLString = apiConfiguration.basePath + localVariablePath
        let localVariableFormParams: [String: (any Sendable)?] = [
            "barcodeType": barcodeType.asParameter(codableHelper: apiConfiguration.codableHelper),
            "dataType": dataType?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "data": data.asParameter(codableHelper: apiConfiguration.codableHelper),
            "imageFormat": barcodeImageParams?.imageFormat?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "textLocation": barcodeImageParams?.textLocation?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "foregroundColor": barcodeImageParams?.foregroundColor?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "backgroundColor": barcodeImageParams?.backgroundColor?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "units": barcodeImageParams?.units?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "resolution": barcodeImageParams?.resolution?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "imageHeight": barcodeImageParams?.imageHeight?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "imageWidth": barcodeImageParams?.imageWidth?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "rotationAngle": barcodeImageParams?.rotationAngle?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "qrEncodeMode": qrParams?.qrEncodeMode?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "qrErrorLevel": qrParams?.qrErrorLevel?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "qrVersion": qrParams?.qrVersion?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "qrECIEncoding": qrParams?.qrECIEncoding?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "qrAspectRatio": qrParams?.qrAspectRatio?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "microQRVersion": qrParams?.microQRVersion?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "rectMicroQrVersion": qrParams?.rectMicroQrVersion?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "code128EncodeMode": code128Params?.code128EncodeMode?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417EncodeMode": pdf417Params?.pdf417EncodeMode?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417ErrorLevel": pdf417Params?.pdf417ErrorLevel?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417Truncate": pdf417Params?.pdf417Truncate?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417Columns": pdf417Params?.pdf417Columns?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417Rows": pdf417Params?.pdf417Rows?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417AspectRatio": pdf417Params?.pdf417AspectRatio?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417ECIEncoding": pdf417Params?.pdf417ECIEncoding?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417IsReaderInitialization": pdf417Params?.pdf417IsReaderInitialization?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417MacroCharacters": pdf417Params?.pdf417MacroCharacters?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417IsLinked": pdf417Params?.pdf417IsLinked?.asParameter(codableHelper: apiConfiguration.codableHelper),
            "pdf417IsCode128Emulation": pdf417Params?.pdf417IsCode128Emulation?.asParameter(codableHelper: apiConfiguration.codableHelper),
        ]

        let localVariableNonNullParameters = APIHelper.rejectNil(localVariableFormParams)
        let localVariableParameters = APIHelper.convertBoolToString(localVariableNonNullParameters)

        let localVariableUrlComponents = URLComponents(string: localVariableURLString)

        let localVariableNillableHeaders: [String: (any Sendable)?] = [
            "Content-Type": "multipart/form-data",
        ]

        let localVariableHeaderParameters = APIHelper.rejectNilHeaders(localVariableNillableHeaders)

        let localVariableRequestBuilder: RequestBuilder<Data>.Type = apiConfiguration.requestBuilderFactory.getBuilder()

        return localVariableRequestBuilder.init(method: "POST", URLString: (localVariableUrlComponents?.string ?? localVariableURLString), parameters: localVariableParameters, headers: localVariableHeaderParameters, requiresAuthentication: true, apiConfiguration: apiConfiguration)
    }
}