Skip to content

Commit a404db7

Browse files
SF4524LogeshKumarSF4524LogeshKumar
committed
996394: Sample for Distance Annotation
1 parent fe9afa9 commit a404db7

File tree

13 files changed

+388
-0
lines changed

13 files changed

+388
-0
lines changed

‎Annotations/Annotation Types/Distance Annotation/.gitignore‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
dist/
2+
node_modules/

‎Annotations/Annotation Types/Distance Annotation/README.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# Essential JS 2 QuickStart
2+
3+
This project is a skeleton application used to create [Essential JS 2](https://www.syncfusion.com/products/essential-js2) web application.
4+
5+
>This application uses the latest version of the [webpack-cli](https://webpack.js.org/api/cli/#commands). It requires node `v14.15.0` or higher.
6+
7+
## Getting Started
8+
9+
To get started you need to clone the `ej2-quickstart` repository and navigate to `ej2-quickstart` location.
10+
11+
```
12+
git clone https://github.com/syncfusion/ej2-quickstart.git quickstart
13+
cd quickstart
14+
```
15+
16+
## Installing
17+
18+
We can get all the Essential JS 2 components in a single npm package [`ej2`](https://www.npmjs.com/package/@syncfusion/ej2).
19+
20+
We already configure the required packages in the `package.json` file.
21+
22+
You can run the below command to install all dependent packages related to this seed project.
23+
24+
```
25+
npm install
26+
```
27+
28+
## Testing
29+
30+
This application is preconfigured with End-to-End testing and the test case is written in Jasmine.
31+
32+
We run the test scripts with [Protractor](http://www.protractortest.org/#/) end-to-end test runner. The test case file can be found in the `e2e` folder.
33+
34+
Protractor can interact with our web application and verify the test scripts.
35+
36+
We have to install WebDriver and also need to ensure it is updated. Open a separate terminal and run the below npm script.
37+
38+
```
39+
npm run update-webdriver
40+
```
41+
42+
Open another terminal and run the below npm script. It will start web server to serve our application.
43+
44+
```
45+
npm run serve
46+
```
47+
48+
Once the web server is up and running, we can run the end-to-end tests using the below npm script
49+
50+
```
51+
npm run test
52+
```
53+
54+
> **Note:** Since Protractor is using the Selenium Standalone Server, the Java Development Kit (JDK) need to be installed in your local machine.
55+
56+
If JDK is not installed in your local machine, you can download it from [here](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
57+
58+
## Running
59+
60+
The application is configured with [webpack-dev-server](https://webpack.js.org/configuration/dev-server/#devserver), so it will serve the web application in your default browser.
61+
62+
We have used [Webpack](https://github.com/webpack/webpack) for module loading.
63+
64+
You can use the below npm script to run the web application.
65+
66+
```
67+
npm run start
68+
```
69+
70+
## Resources
71+
72+
You can also refer the below resources to know more details about Essential JS 2 components.
73+
74+
* [Pure JS Demos](http://ej2.syncfusion.com/demos/)
75+
* [Pure JS Documentation](http://ej2.syncfusion.com/documentation/)

‎Annotations/Annotation Types/Distance Annotation/e2e/index.spec.js‎

Whitespace-only changes.

‎Annotations/Annotation Types/Distance Annotation/e2e/protractor.conf.js‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
exports.config = {
2+
3+
allScriptsTimeout: 11000,
4+
5+
capabilities: {
6+
'browserName': 'chrome'
7+
},
8+
9+
framework: 'jasmine',
10+
11+
jasmineNodeOpts: {
12+
defaultTimeoutInterval: 10000
13+
},
14+
directConnect: true,
15+
16+
onPrepare: function() {
17+
browser.waitForAngularEnabled(false);
18+
},
19+
20+
specs: ['./*.spec.js']
21+
};

‎Annotations/Annotation Types/Distance Annotation/gulpfile.js‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
'use strict';
2+
3+
var gulp = require('gulp');
4+
5+
/**
6+
* Compile TypeScript to JS
7+
*/
8+
gulp.task('compile', function (done) {
9+
var webpack = require('webpack');
10+
var webpackStream = require('webpack-stream');
11+
gulp.src(['./src/app/app.ts']).pipe(webpackStream({
12+
config: require('./webpack.config.js')
13+
}, webpack))
14+
.pipe(gulp.dest('./dist'))
15+
.on('end', function () {
16+
done();
17+
});
18+
});
19+
20+
/**
21+
* Testing spec files
22+
*/
23+
var protractor = require('gulp-protractor').protractor;
24+
var webdriver_standalone = require('gulp-protractor').webdriver_standalone;
25+
var webdriver_update = require('gulp-protractor').webdriver_update_specific;
26+
27+
gulp.task('e2e-serve', webdriver_standalone);
28+
29+
gulp.task('e2e-webdriver-update', webdriver_update({
30+
webdriverManagerArgs: ['--ie', '--edge']
31+
}));
32+
33+
gulp.task('e2e-test', gulp.series('compile', function (done) {
34+
var browserSync = require('browser-sync');
35+
var bs = browserSync.create('Essential JS 2');
36+
var options = {
37+
server: {
38+
baseDir: [
39+
'./dist/',
40+
],
41+
directory: true
42+
},
43+
ui: false,
44+
open: false,
45+
notify: false
46+
};
47+
bs.init(options, function () {
48+
gulp.src(['./spec/**/*.spec.js'])
49+
.pipe(protractor({
50+
configFile: 'e2e/protractor.conf.js'
51+
}))
52+
.on('error', function (e) {
53+
console.error('Error: ' + e.message);
54+
done();
55+
process.exit(1);
56+
})
57+
.on('end', function () {
58+
done();
59+
process.exit(0);
60+
});
61+
});
62+
}));

‎Annotations/Annotation Types/Distance Annotation/license‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
Essential JS 2 library is available under the Syncfusion Essential Studio program, and can be licensed either under the Syncfusion Community License Program or the Syncfusion commercial license.
2+
3+
To be qualified for the Syncfusion Community License Program you must have a gross revenue of less than one (1) million U.S. dollars ($1,000,000.00 USD) per year and have less than five (5) developers in your organization, and agree to be bound by Syncfusion’s terms and conditions.
4+
5+
Customers who do not qualify for the community license can contact sales@syncfusion.com for commercial licensing options.
6+
7+
Under no circumstances can you use this product without (1) either a Community License or a commercial license and (2) without agreeing and abiding by Syncfusion’s license containing all terms and conditions.
8+
9+
The Syncfusion license that contains the terms and conditions can be found at
10+
https://www.syncfusion.com/content/downloads/syncfusion_license.pdf

‎Annotations/Annotation Types/Distance Annotation/package.json‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
{
2+
"name": "ej2-quickstart",
3+
"version": "0.0.1",
4+
"description": "Essential JS 2 typescript quick start application",
5+
"author": "Syncfusion Inc.",
6+
"license": "SEE LICENSE IN license",
7+
"repository": {
8+
"type": "git",
9+
"url": "https://github.com/syncfusion/ej2-quickstart.git"
10+
},
11+
"scripts": {
12+
"start": "webpack-dev-server --mode development",
13+
"build": "webpack --mode production",
14+
"serve": "gulp e2e-serve",
15+
"test": "gulp e2e-test",
16+
"update-webdriver": "gulp e2e-webdriver-update"
17+
},
18+
"devDependencies": {
19+
"ajv": "^8.11.2",
20+
"browser-sync": "^2.18.12",
21+
"gulp": "*",
22+
"typescript": "*",
23+
"gulp-protractor": "*",
24+
"gulp-typescript": "*",
25+
"jasmine": "^2.6.0",
26+
"css-loader": "^6.7.2",
27+
"ts-loader": "^9.4.1",
28+
"mini-css-extract-plugin": "^2.7.0",
29+
"html-webpack-plugin": "^5.5.0",
30+
"webpack": "^5.75.0",
31+
"webpack-cli": "^5.0.0",
32+
"webpack-dev-server": "^5.2.1",
33+
"webpack-stream": "^7.0.0"
34+
},
35+
"dependencies": {
36+
"@syncfusion/ej2": "*"
37+
}
38+
}

‎Annotations/Annotation Types/Distance Annotation/src/app/app.ts‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
import {
2+
PdfViewer,
3+
Toolbar,
4+
Magnification,
5+
Navigation,
6+
Annotation,
7+
LinkAnnotation,
8+
ThumbnailView,
9+
BookmarkView,
10+
TextSelection,
11+
TextSearch,
12+
FormFields,
13+
FormDesigner,
14+
PageOrganizer,
15+
DistanceSettings
16+
} from '@syncfusion/ej2-pdfviewer';
17+
18+
// Inject required modules
19+
PdfViewer.Inject(
20+
Toolbar,
21+
Magnification,
22+
Navigation,
23+
Annotation,
24+
LinkAnnotation,
25+
ThumbnailView,
26+
BookmarkView,
27+
TextSelection,
28+
TextSearch,
29+
FormFields,
30+
FormDesigner,
31+
PageOrganizer
32+
);
33+
34+
// Create viewer
35+
const pdfviewer: PdfViewer = new PdfViewer();
36+
37+
// Standalone setup (no server)
38+
pdfviewer.documentPath = 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf';
39+
pdfviewer.resourceUrl = 'https://cdn.syncfusion.com/ej2/31.1.23/dist/ej2-pdfviewer-lib';
40+
41+
// Default Distance and Measurement settings BEFORE appendTo
42+
pdfviewer.distanceSettings = {
43+
fillColor: 'blue',
44+
opacity: 0.6,
45+
strokeColor: 'green'
46+
};
47+
48+
pdfviewer.measurementSettings = {
49+
scaleRatio: 2, // 1 PDF unit = 2 display units
50+
conversionUnit: 'cm', // Input unit for calibration dialog
51+
displayUnit: 'cm' // Unit shown with measurement
52+
};
53+
54+
// Mount viewer
55+
pdfviewer.appendTo('#PdfViewer');
56+
57+
// UI actions
58+
document.getElementById('distanceMode')?.addEventListener('click', () => {
59+
pdfviewer.annotationModule.setAnnotationMode('Distance');
60+
});
61+
62+
document.getElementById('setNone')?.addEventListener('click', () => {
63+
pdfviewer.annotationModule.setAnnotationMode('None');
64+
});
65+
66+
document.getElementById('addDistanceAnnotation')?.addEventListener('click', () => {
67+
pdfviewer.annotation.addAnnotation('Distance', {
68+
offset: { x: 200, y: 230 },
69+
pageNumber: 1,
70+
vertexPoints: [{ x: 200, y: 230 }, { x: 350, y: 230 }]
71+
} as DistanceSettings);
72+
});
73+
74+
document.getElementById('editDistanceAnnotation')?.addEventListener('click', () => {
75+
for (let i = 0; i < pdfviewer.annotationCollection.length; i++) {
76+
const item = pdfviewer.annotationCollection[i];
77+
if (item.subject === 'Distance calculation') {
78+
item.strokeColor = '#0000FF';
79+
item.thickness = 2;
80+
item.opacity = 0.8;
81+
pdfviewer.annotation.editAnnotation(item);
82+
}
83+
}
84+
});
85+
86+
/*
87+
If you prefer Server-Backed mode, replace the Standalone setup with:
88+
pdfviewer.serviceUrl = 'https://document.syncfusion.com/web-services/pdf-viewer/api/pdfviewer/';
89+
pdfviewer.documentPath = 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf';
90+
(and remove resourceUrl)
91+
*/

‎Annotations/Annotation Types/Distance Annotation/src/index.html‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
4+
<head>
5+
<title>Essential JS 2</title>
6+
<meta charset="utf-8" />
7+
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no" />
8+
<meta name="description" content="Essential JS 2" />
9+
<meta name="author" content="Syncfusion" />
10+
<link rel="shortcut icon" href="resources/favicon.ico" />
11+
<link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
12+
</head>
13+
14+
<body>
15+
<!-- Controls -->
16+
<div style="margin-top: 12px; display: flex; gap: 8px; flex-wrap: wrap;">
17+
<button id="distanceMode">Distance Mode</button>
18+
<button id="setNone">Normal Mode</button>
19+
<button id="addDistanceAnnotation">Add Distance (programmatic)</button>
20+
<button id="editDistanceAnnotation">Edit Distance (programmatic)</button>
21+
</div>
22+
<!-- Container -->
23+
<div id="PdfViewer" style="height: 650px;"></div>
24+
25+
</body>
26+
27+
</html>

‎Annotations/Annotation Types/Distance Annotation/src/resources/favicon.ico‎

6.42 KB
Binary file not shown.

0 commit comments

Comments
 (0)