Download the PHP package aspose/aspose-omr-cloud without Composer

On this page you can find all versions of the php package aspose/aspose-omr-cloud. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package aspose-omr-cloud

Aspose.OMR Cloud SDK for PHP

Aspose.OMR Cloud is an easy-to-use and versatile online service for designing, rendering and recognizing hand-filled answer sheets, exam papers, surveys, ballots, and similar forms. With it, you can quickly develop web applications for optical mark recognition (OMR) that require minimal resources on the client side.

This software development kit (SDK) simplifies the interaction with Aspose.OMR Cloud services, allowing you to focus on business logic rather than the technical details. It handles all the routine operations such as establishing connections, sending API requests, and parsing responses, wrapping all these tasks into a few simple methods that can be used in PHP code.

Contents of this package

The repository contains:

Licensing

Aspose.OMR Cloud SDK for PHP, demo site, documentation, and form templates are distributed under MIT License.

Prerequisites

Windows environment

Make sure that local repository path and all paths to all required packages do not exceed 255 symbols.

Aspose.OMR Cloud use Guzzle library to perform REST requests. Guzzle framework uses cURL (libcurl) as transport library. On the Windows platform, you may encounter problems accessing HTTPS resources depending on the version of libcurl you are using.

OpenSSL and WinSSL-based versions of libcurl can be downloaded at https://curl.haxx.se/gknw.net/7.40.0/. Choose your platform (x86 or x64), OpenSSL (look for ssl string in the file name) or WinSSL (look for winssl string in the file name).

Authorization

Aspose.OMR Cloud follows industry standards and best practices to keep your data secure. All communication with OCR REST API is done using JWT authentication, which provides an open-standard, highly secure way to exchange information. Time-limited JWT tokens are generated using Client ID and Client Secret credentials that are specific for each application.

  1. Sign in to Aspose Cloud API Dashboard.
  2. Go to Applications page.
  3. Create the storage for exchanging files by clicking the plus icon and following the required steps. You can either use your own cloud storage, create a new storage in our cloud, or reuse the existing one.
  4. Give the application an easily recognizable name so it can be quickly found in a long list.
  5. Click Save button.
  6. Click the newly created application and copy the values from Client Id and Client Secret fields.

Installation and usage

  1. Clone or download the repository.

  2. To install the bindings via Composer, add the following to composer.json:

    Then run composer install.

  3. Run the demo project. The actual steps may vary depending on your platform.

The web application generates a printable OMR-ready form (_aspose-omr-cloud-demo-data/Temp/Asposetest.png) along with the recognition pattern file (_aspose-omr-cloud-demo-data/Temp/Asposetest.omr). The latter is used by Aspose.OMR recognition engine to match filled bubbles with template fields.

Then it recognizes the scanned image of the filled questionnaire and saves results in _aspose-omr-cloud-demo-data/Temp/Asposetest.csv file.

Configuring

The configuration file (_aspose-omr-cloud-demo-data/testconfig.json) contains the basic parameters for working with Aspose.OMR Cloud.

How it works?

Aspose.OMR Cloud supports end-to-end OMR process - from designing a form to recognizing its filled hardcopies. The workflow includes the following stages:

Stages of the OMR process

All resource-consuming tasks (generation and recognition of OMR forms) are done in the cloud, freeing up resources on the end user's device. All cloud tasks are queued, which prevents multiple simultaneous requests from interfering with each other and consuming too much processor time.

Aspose.OMR Cloud SDK for PHP implements wrapper classes that allow you to interact with the Aspose.OMR Cloud REST API without writing low-level HTTP requests and parsing responses. The demo project source code contains extensive comments on all major parts of the code, so you can easily understand the basics without having to consult the SDK reference documentation.

Generating a printable form

To generate a printable form and a recognition pattern file, send the form sources and page configuration to the Aspose.OMR Cloud queue and get the results a few seconds later.

The processing time can vary from a few milliseconds to a couple of seconds, depending on the current load of the Aspose.OMR Cloud service.

GenerateTemplate

This class contains wrapper methods for generating the printable form from the source code and working with the form generation queue.

OmrGenerateTask

This class allows you to prepare a request for sending the form source code, associated images, and page layout to the generation queue.

Page layout

The paper size, orientation, font, and other layout settings are configured through PageSettings object which is passed to the OmrGenerateTask constructor.

Working with images

Aspose.OMR Cloud allows you to customize forms by adding images (such as your company logo) to them. In addition to describing the image element in the form's source code, each image file must be directly submitted to the generation queue.

Images are provided to the OmrGenerateTask constructor as a HashMap, where the key contains the image file name, and the value contains the contents of the image file as an array of bytes.

OMRResponse

Depending on the request type, this class contains:

Recognizing a filled form

To recognize the filled form, send its scanned image or photo along with the recognition pattern file to the Aspose.OMR Cloud queue and get the results a few seconds later.

The processing time can vary from a few milliseconds to a couple of seconds, depending on the current load of the Aspose.OMR Cloud service.

RecognizeTemplate

This class contains wrapper methods for recognizing the scanned or photographed form and working with the form recognition queue.

OmrRecognizeTask

This class allows you to prepare a request for sending the form image to the recognition queue.

The form must be accompanied by the recognition pattern (.OMR) file, which tells Aspose.OMR recognition engine how to match filled bubbles with template fields. Please note that the recognition template file must be taken from the same generation response as the printable form, otherwise the recognition results are not guaranteed to be correct.

Recognition accuracy threshold

A respondent can fill out the form with a pen, pencil or marker, and use various marks inside the bubbles - from a solid fill to small crosses or checks.

Recognition accuracy threshold (recognitionThreshold) parameter determines how marks are processed during recognition. You can provide a value from 0 to 100. Lower values allow even the lightest marks to be recognized, but may cause dirt or paper defects to be treated as marks. Higher values require a more solid fill and may cause pencil marks or small checkmarks to be ignored.

Recognition accuracy threshold

Important: Instruct respondents to use the same type of marks for all bubbles. Otherwise, recognition results may be inaccurate. If you plan to use your smartphone's camera instead of a scanner, we recommend a solid fill with a pen or marker.

Resources

All versions of aspose-omr-cloud with dependencies

PHP Build Version
Package Version
Requires php Version >=5.5
ext-curl Version *
ext-json Version *
ext-mbstring Version *
guzzlehttp/guzzle Version ^6.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package aspose/aspose-omr-cloud contains the following files

Loading the files please wait ....