Compare commits

...

3 Commits

Author SHA1 Message Date
Christian Aribaud c8451c07aa Adding info about ESLint in README.md 2023-06-04 20:46:43 +02:00
caribaud 5f3060995b Rework melpomene to respect newly added ESLINT
This includes:

+ Removing trailling whitespaces
+ Adding missing const keywords
+ Fixing equality checks
+ Removing unused variables, functions, etc...
+ Adding missing let & const statements
+ Use strict
+ Correcting all names to use camelCase
+ Using semicolons everywhere
+ Use Allman style everywhere
+ Make comments headers uniform

This also includes:

+ Fixing displayed version number
2023-06-04 20:16:56 +02:00
caribaud 230abf08e8 Adding eslint 2023-06-04 20:16:55 +02:00
5 changed files with 531 additions and 358 deletions

4
.gitignore vendored
View File

@ -1,2 +1,6 @@
# ESLINT report
eslint_report.html
# Demo sources
demos/src_highres demos/src_highres
demos/src_lowres demos/src_lowres

View File

@ -25,16 +25,19 @@ flowchart TB
``` ```
Melpomene is mainly one JS file and one CSS file. You only need to include them in you web page. They are : Melpomene is mainly one JS file and one CSS file. You only need to include them in you web page. They are :
+ `melpomene.js` + `melpomene.js`
+ `melpomene.css` + `melpomene.css`
The JS files expect you to write some very specific HTML tags to be able to work. The JS files expect you to write some very specific HTML tags to be able to work.
To simplify things, you only need to copy-paste the content of `melpomene.html` into your own page and change a few things : To simplify things, you only need to copy-paste the content of `melpomene.html` into your own page and change a few things :
+ You must duplicate the `img` tag for each of you comic page and : + You must duplicate the `img` tag for each of you comic page and :
+ set `url` to the actual URL of your page + set `url` to the actual URL of your page
+ set `height` and `width` to the actual image sizes + set `height` and `width` to the actual image sizes
+ set `data-zooms` with the zooms information, like so : `<zoom 1 width>, <zoom 1 height>, <zoom 1 x offset>, <zoom 1 y offset>; <zoom 2 width> ...` + set `data-zooms` with the zooms information, like so : `<zoom 1 width>, <zoom 1 height>, <zoom 1 x offset>, <zoom 1 y offset>; <zoom 2 width> ...`
+ example : `<img loading="lazy" src="https://www.peppercarrot.com/0_sources/ep35_The-Reflection/hi-res/en_Pepper-and-Carrot_by-David-Revoy_E35P01.jpg" data-zooms="2481.0,1327.1057,0.0,0.0;593.15338,1076.4635,0.0,1364.053;890.72864,491.29874,830.81415,1751.5;2481.0,1078.4192,0.0,1364.053;562.77032,909.44702,102.48115,2491.6567;920.74463,909.44702,698.55927,2491.6567;728.776,909.44702,1652.3695,2491.6567"/>` + example : `<img loading="lazy" src="https://www.peppercarrot.com/0_sources/ep35_The-Reflection/hi-res/en_Pepper-and-Carrot_by-David-Revoy_E35P01.jpg" data-zooms="2481.0,1327.1057,0.0,0.0;593.15338,1076.4635,0.0,1364.053;890.72864,491.29874,830.81415,1751.5;2481.0,1078.4192,0.0,1364.053;562.77032,909.4470    2,102.48115,2491.6567;920.74463,909.44702,698.55927,2491.6567;728.776,909.44702,1652.3695,2491.6567"/>`
Because doing this by hand would be very tedious, Melpomene comes with an helper script that allows generating that HTML for you from SVGs. Because doing this by hand would be very tedious, Melpomene comes with an helper script that allows generating that HTML for you from SVGs.
@ -45,7 +48,7 @@ The following limitations are known and will be improved upon :
+ Mobile support is currently limited + Mobile support is currently limited
+ There are some performences issues + There are some performences issues
# How to setup Melpomene ? # How to use Melpomene ?
## Defining the zooms ## Defining the zooms
@ -61,12 +64,12 @@ To create the zooms for a comic page, what you need to do is :
* If you want to change the zoom order, you can change their order in the layer view of your SVG tool if they support it * If you want to change the zoom order, you can change their order in the layer view of your SVG tool if they support it
3. Once you are done, save the SGV 3. Once you are done, save the SGV
## Generating the HTML files ## Generating the HTML files
Once the SVG for your pages are done, put them in one folder. Then, you can run the zoom generator. Once the SVG for your pages are done, put them in one folder. Then, you can run the zoom generator.
You need to open a terminal and then run : You need to open a terminal and then run :
+ `python zooms_generator.py <path to the SVG folder> html -p <prefix of the img's url> -e <extension of the img's url>` + `python zooms_generator.py <path to the SVG folder> html -p <prefix of the img's url> -e <extension of the img's url>`
+ For example, if your comic pages are hosted at `static/comic/page_x.jpg`, the svg must be named `page_x.svg` + For example, if your comic pages are hosted at `static/comic/page_x.jpg`, the svg must be named `page_x.svg`
and you must run `python zooms_generator.py <path to the SVG folder> html -p /static/comic/ -e jpg` and you must run `python zooms_generator.py <path to the SVG folder> html -p /static/comic/ -e jpg`
@ -89,6 +92,24 @@ If you need to do some global scaling / offset of all zooms in HTML (if for exam
+ If they become greater than the page size, they get clamped to the page size and width / height get reduced to compensate + If they become greater than the page size, they get clamped to the page size and width / height get reduced to compensate
+ `data-global-zoom-scale="<float value>"` : scale all positions / sizes by this factor + `data-global-zoom-scale="<float value>"` : scale all positions / sizes by this factor
# Developpement
## Setting up quality checking for JS
Regarding JS, quality checking is done using [eslint](https://eslint.org/).
The configuration file is `eslint/eslintrc.json`.
To setup eslint, you can either install it on your system reading it's documentation, or use the provided Dockerfile to run it. This requires [docker](https://www.docker.com/).
To do so, assuming you are using linux, after installing docker, you can run from this repository root:
+ `docker build -t melpomene-eslint eslint/`, once
+ `docker run -v .:/melpomene:rw -w /melpomene --user $(id -u):$(id -g) melpomene-eslint`, every time you want to run the analysis
You can now open `eslint_report.html` to see the result.
# Credits # Credits
Most examples and the documentation of Melpomene uses illustrations from David "Deevad" Revoy's "Pepper & Carrot" webcomic, which is published under CC-BY 4.0. Full licence [here](https://www.peppercarrot.com/en/license/index.html). Most examples and the documentation of Melpomene uses illustrations from David "Deevad" Revoy's "Pepper & Carrot" webcomic, which is published under CC-BY 4.0. Full licence [here](https://www.peppercarrot.com/en/license/index.html). 

11
eslint/Dockerfile Normal file
View File

@ -0,0 +1,11 @@
FROM debian:latest
RUN apt-get update && apt-get install -y --no-install-recommends npm
RUN npm install eslint --global
COPY eslintrc.json /eslintrc.json
ENTRYPOINT ["eslint", "--no-eslintrc"]
CMD ["--help"]

34
eslint/eslintrc.json Normal file
View File

@ -0,0 +1,34 @@
{
"env": {
"browser": true,
"es2021": true
},
"extends": [
"eslint:all"
],
"rules": {
"semi": "warn",
"spaced-comment": "warn",
"padded-blocks": ["warn", "never"],
"camelcase": "warn",
"multiline-comment-style": "off",
"max-len": "warn",
"prefer-template": "warn",
"object-curly-spacing" : ["warn", "always"],
"func-style": ["warn", "declaration"],
"key-spacing": "warn",
"one-var": ["warn", "never"],
"quotes": "warn",
"space-before-function-paren": ["warn", "never"],
"no-undefined": "off",
"strict": ["error", "global"],
"keyword-spacing": "warn",
"function-call-argument-newline": "warn",
"operator-assignment": "off",
"space-before-blocks": "warn",
"brace-style": ["warn", "allman", {"allowSingleLine": true}],
"function-call-argument-newline" : ["warn", "consistent"],
"function-paren-newline": ["warn", "consistent"],
"no-magic-numbers": ["error", {"ignore": [0,1,2,100]}]
}
}

View File

@ -2,60 +2,63 @@
/* Version 1.0.0_RC1 */ /* Version 1.0.0_RC1 */
/* CC-BY-NC-SA : https://git.aribaud.net/caribaud/melpomene/ */ /* CC-BY-NC-SA : https://git.aribaud.net/caribaud/melpomene/ */
"use strict";
// ============ // ============
// CONTROLS // CONTROLS
// ============ // ============
MOVE_NEXT = "ArrowRight" const MOVE_NEXT = "ArrowRight";
MOVE_BACK = "ArrowLeft" const MOVE_BACK = "ArrowLeft";
TOGGLE_FULLSCREEN = "F" const TOGGLE_FULLSCREEN = "F";
TOGGLE_PROGRESSBAR = "P" const TOGGLE_PROGRESSBAR = "P";
TOGGLE_VIEW_MODE = "V" const TOGGLE_VIEW_MODE = "V";
// ======================== // ========================
// NAVIGATION CONSTANTS // NAVIGATION CONSTANTS
// ======================== // ========================
PAGE_TRANSITION_SPEED = "1.5s" const MOUSEWHELL_MIN_DELAY = 50;
MOUSEWHELL_MIN_DELAY = 50 const DELAY_BEFORE_HIDDING_CONTROLS = 4000;
DELAY_BEFORE_HIDDING_CONTROLS = 4000;
// ==================== // ====================
// STATES CONSTANTS // STATES CONSTANTS
// ==================== // ====================
MELPOMENE_VERSION = "1.0.0_RC1" const MELPOMENE_VERSION = "1.0.0_UNSTABLE";
READER_FRAME = document.getElementById("melpomene") const READER_FRAME = document.getElementById("melpomene");
READER_CONTENT_FRAME = document.getElementById("melpomene-content-frame") const READER_CONTENT_FRAME = document.getElementById("melpomene-content-frame");
READER_PAGES = document.getElementById("melpomene-pages") const READER_PAGES = document.getElementById("melpomene-pages");
FOCUS_OVERLAY_HEIGHT = document.getElementById("melpomene-focus") const FOCUS_OVERLAY_HEIGHT = document.getElementById("melpomene-focus");
FOCUS_OVERLAY_WIDTH = document.getElementById("melpomene-focus-col") const FOCUS_OVERLAY_WIDTH = document.getElementById("melpomene-focus-col");
HELP_CONTROLS = document.getElementById("melpomene-help-menu") const HELP_CONTROLS = document.getElementById("melpomene-help-menu");
PROGRESS_BAR_CONTAINER = document.getElementById("melpomene-progress-container") const PROGRESS_BAR_CONTAINER = document.getElementById("melpomene-progress-container");
PROGRESS_BAR = document.getElementById("melpomene-progress-bar") const PROGRESS_BAR = document.getElementById("melpomene-progress-bar");
PROGRESS_BAR_PAGES = document.getElementById("melpomene-progress-sections") const PROGRESS_BAR_PAGES = document.getElementById("melpomene-progress-sections");
VERSION_DISPLAY = document.getElementById("melpomene-version") const VERSION_DISPLAY = document.getElementById("melpomene-version");
// =========================== // ===========================
// STATES GLOBAL VARIABLES // STATES GLOBAL VARIABLES
// =========================== // ===========================
var PAGES_ZOOMS;
// The variable ZOOMS can either be defined by another JS file or contructed at init // The variable ZOOMS can either be defined by another JS file or contructed at init
if (typeof PAGES_ZOOMS == 'undefined') { if (typeof PAGES_ZOOMS === 'undefined')
PAGES_ZOOMS = null {
PAGES_ZOOMS = null;
} }
CURRENT_ZOOM = 0 var CURRENT_ZOOM = 0;
CURRENT_PAGE = 1 var CURRENT_PAGE = 1;
CURRENT_WIDTH = 0 var CURRENT_WIDTH = 0;
CURRENT_HEIGHT = 0 var CURRENT_HEIGHT = 0;
CURRENT_X = 0 var CURRENT_X = 0;
CURRENT_Y = 0 var CURRENT_Y = 0;
IS_PAGE_MODE = false var IS_PAGE_MODE = false;
MOUSEWHELL_WAIT = false var MOUSEWHELL_WAIT = false;
// ============= // =============
// UTILITIES // UTILITIES
@ -64,360 +67,433 @@ MOUSEWHELL_WAIT = false
// Zooms utilites // Zooms utilites
// -------------- // --------------
function globalZoomScale(){ function globalZoomScale()
{
if (READER_PAGES.dataset.globalZoomScale != undefined){ if (READER_PAGES.dataset.globalZoomScale !== undefined)
return parseFloat(READER_PAGES.dataset.globalZoomScale) {
return parseFloat(READER_PAGES.dataset.globalZoomScale);
} }
return 1.0 return 1.0;
} }
function globalZoomOffsetX(){ function globalZoomOffsetX()
{
if (READER_PAGES.dataset.globalZoomOffset != undefined){ if (READER_PAGES.dataset.globalZoomOffset !== undefined)
return parseFloat(READER_PAGES.dataset.globalZoomOffset.split(',')[0]) {
return parseFloat(READER_PAGES.dataset.globalZoomOffset.split(',')[0]);
} }
return 0.0 return 0.0;
} }
function globalZoomOffsetY(){ function globalZoomOffsetY()
{
if (READER_PAGES.dataset.globalZoomOffset != undefined){ if (READER_PAGES.dataset.globalZoomOffset !== undefined)
return parseFloat(READER_PAGES.dataset.globalZoomOffset.split(',')[1]) {
return parseFloat(READER_PAGES.dataset.globalZoomOffset.split(',')[1]);
} }
return 0.0 return 0.0;
} }
function loadZoomsFromImgTagsIfRequired(){ function loadZoomsFromImgTagsIfRequired()
{
// Zooms may be defined by another JS file // Zooms may be defined by another JS file
if (PAGES_ZOOMS == null){ if (PAGES_ZOOMS === null)
{
PAGES_ZOOMS = [] PAGES_ZOOMS = [];
// parse the data-zooms of each img and and the page number info // parse the data-zooms of each img and and the page number info
for (var i = 0; i < READER_PAGES.children.length; i++) { for (let idx = 0; idx < READER_PAGES.children.length; idx += 1)
{
zooms_raw_data = READER_PAGES.children[i].dataset.zooms const zoomsRawData = READER_PAGES.children[idx].dataset.zooms;
// ';' separates zooms data, ',' separates values // ';' separates zooms data, ',' separates values
// We add the page number (adding 1 because of indexing) // We add the page number (adding 1 because of indexing)
zooms = zooms_raw_data.split(";").map( const zooms = zoomsRawData.split(";").map(
zoom => [i + 1].concat( zoom => [idx + 1].concat(
zoom.split(',').map( zoom.split(',').map(
value => parseFloat(value) value => parseFloat(value)
) )
) )
) );
PAGES_ZOOMS = PAGES_ZOOMS.concat(zooms) PAGES_ZOOMS = PAGES_ZOOMS.concat(zooms);
}
}
}
function getFirstZoomOfPage(pageNumber){
for (var zoom_idx = 0; zoom_idx < PAGES_ZOOMS.length; zoom_idx++){
if (PAGES_ZOOMS[zoom_idx][0] == pageNumber) {
return zoom_idx
} }
} }
} }
function getLastZoomOfPage(pageNumber){ function getFirstZoomOfPage(pageNumber)
let res = null {
for (let zoomIdx = 0; zoomIdx < PAGES_ZOOMS.length; zoomIdx += 1)
for (var zoom_idx = 0; zoom_idx < PAGES_ZOOMS.length; zoom_idx++){ {
if (PAGES_ZOOMS[zoom_idx][0] == pageNumber) { if (PAGES_ZOOMS[zoomIdx][0] === pageNumber)
res = zoom_idx {
return zoomIdx;
} }
if (res != null && PAGES_ZOOMS[zoom_idx][0] != pageNumber) {
break
} }
} }
return res function getLastZoomOfPage(pageNumber)
{
let res = null;
for (let zoomIdx = 0; zoomIdx < PAGES_ZOOMS.length; zoomIdx += 1)
{
if (PAGES_ZOOMS[zoomIdx][0] === pageNumber)
{
res = zoomIdx;
} }
function getZoomCountForPage(pageNumber) { if (res !== null && PAGES_ZOOMS[zoomIdx][0] !== pageNumber)
return PAGES_ZOOMS.filter(zoom => zoom[0] == pageNumber).length {
break;
}
} }
function getCurrentZoomIndexForPage() { return res;
previousZoomsCount = PAGES_ZOOMS.filter(zoom => zoom[0] < CURRENT_PAGE).length
return CURRENT_ZOOM - previousZoomsCount + 1
} }
function getReadingProgressPercent() { function getZoomCountForPage(pageNumber)
progressPerPage = 1 / getPagesCount() {
return PAGES_ZOOMS.filter(zoom => zoom[0] === pageNumber).length;
if (IS_PAGE_MODE){
return 100 * progressPerPage * CURRENT_PAGE
} }
progressPerZoom = progressPerPage / getZoomCountForPage(CURRENT_PAGE) function getCurrentZoomIndexForPage()
{
readingProgress = (CURRENT_PAGE - 1) * progressPerPage + getCurrentZoomIndexForPage() * progressPerZoom const previousZoomsCount = PAGES_ZOOMS.filter(zoom => zoom[0] < CURRENT_PAGE).length;
return CURRENT_ZOOM - previousZoomsCount + 1;
return 100 * readingProgress
} }
function updateProgressBar(){ function getReadingProgressPercent()
PROGRESS_BAR.style.width = getReadingProgressPercent() + "%" {
const progressPerPage = 1 / getPagesCount();
if (IS_PAGE_MODE)
{
return 100 * progressPerPage * CURRENT_PAGE;
}
const progressPerZoom = progressPerPage / getZoomCountForPage(CURRENT_PAGE);
const readingProgress = (CURRENT_PAGE - 1) * progressPerPage + getCurrentZoomIndexForPage() * progressPerZoom;
return 100 * readingProgress;
}
function updateProgressBar()
{
PROGRESS_BAR.style.width = getReadingProgressPercent() + "%";
} }
// Dimensions utilites // Dimensions utilites
// ------------------- // -------------------
function getPagesCount() { function getPagesCount()
return READER_PAGES.childElementCount {
return READER_PAGES.childElementCount;
} }
function pageOriginalHeight(pageNumber) { function pageOriginalHeight(pageNumber)
return READER_PAGES.children[pageNumber - 1].naturalHeight {
return READER_PAGES.children[pageNumber - 1].naturalHeight;
} }
function pageOriginalWidth(pageNumber) { function pageOriginalWidth(pageNumber)
return READER_PAGES.children[pageNumber - 1].naturalWidth {
return READER_PAGES.children[pageNumber - 1].naturalWidth;
} }
function readerFrameRatio() { function readerFrameRatio()
return READER_CONTENT_FRAME.clientWidth / READER_CONTENT_FRAME.clientHeight {
return READER_CONTENT_FRAME.clientWidth / READER_CONTENT_FRAME.clientHeight;
} }
function pageRatio(pageNumber) { function pageRatio(pageNumber)
return READER_PAGES.children[pageNumber - 1].naturalWidth / READER_PAGES.children[pageNumber - 1].naturalHeight {
return READER_PAGES.children[pageNumber - 1].naturalWidth / READER_PAGES.children[pageNumber - 1].naturalHeight;
} }
function pageMaxHeight(){ function pageMaxHeight()
let max_height = 0 {
let maxHeight = 0;
for (var i = 0; i < READER_PAGES.children.length; i++) { for (let i = 0; i < READER_PAGES.children.length; i += 1)
if(READER_PAGES.children[i].naturalHeight > max_height){ {
max_height = READER_PAGES.children[i].naturalHeight if(READER_PAGES.children[i].naturalHeight > maxHeight)
{
maxHeight = READER_PAGES.children[i].naturalHeight;
} }
} }
return max_height return maxHeight;
} }
function pageVerticalOffset(pageNumber) { function pageVerticalOffset(pageNumber)
return ( pageMaxHeight() - pageOriginalHeight(pageNumber) ) / 2 {
return ( pageMaxHeight() - pageOriginalHeight(pageNumber) ) / 2;
} }
function previousPagesWidth(pageNumber) { function previousPagesWidth(pageNumber)
{
// The width of all previous pages relative to the provided index // The width of all previous pages relative to the provided index
let totalWidth = 0 let totalWidth = 0;
for (let idx = 0; idx < pageNumber - 1; idx++){ for (let idx = 0; idx < pageNumber - 1; idx += 1)
totalWidth = totalWidth + READER_PAGES.children[idx].naturalWidth {
totalWidth += READER_PAGES.children[idx].naturalWidth;
} }
return totalWidth return totalWidth;
} }
// ========= // =========
// ACTIONS // ACTIONS
// ========= // =========
function initReader(){ function initReader()
loadZoomsFromImgTagsIfRequired() {
moveReaderDisplayToZoom(0) VERSION_DISPLAY.innerText = VERSION_DISPLAY.innerText.replace("Unknown version", MELPOMENE_VERSION);
loadZoomsFromImgTagsIfRequired();
moveReaderDisplayToZoom(0);
// Smoothly show pictures when they intersect with the viewport // Smoothly show pictures when they intersect with the viewport
let visibilityObserver = new IntersectionObserver((entries, observer) => { const visibilityObserver = new IntersectionObserver(
entries.forEach((entry) => { (entries, observer) =>
if (entry.isIntersecting) { {
entry.target.style.opacity = 1 entries.forEach((entry) =>
entry.target.style.visibility = "visible" {
} else { if (entry.isIntersecting)
entry.target.style.opacity = 0 {
entry.target.style.visibility = "hidden" entry.target.style.opacity = 1;
entry.target.style.visibility = "visible";
}
else
{
entry.target.style.opacity = 0;
entry.target.style.visibility = "hidden";
} }
}); });
}, { root: READER_CONTENT_FRAME, rootMargin: "-10px" }); },
{ root: READER_CONTENT_FRAME, rootMargin: "-10px" }
);
for (var i = 0; i < READER_PAGES.children.length; i++) { for (let i = 0; i < READER_PAGES.children.length; i += 1)
let img = READER_PAGES.children[i]; {
visibilityObserver.observe(img) const img = READER_PAGES.children[i];
visibilityObserver.observe(img);
PROGRESS_BAR_PAGES.appendChild(document.createElement("div")) PROGRESS_BAR_PAGES.appendChild(document.createElement("div"));
} }
READER_PAGES.style.display = "flex" READER_PAGES.style.display = "flex";
setTimeout(() => { setTimeout(
READER_PAGES.hidden = false () => { READER_PAGES.hidden = false },
}, "300") "300"
);
setTimeout(() => { setTimeout(
() =>
{
HELP_CONTROLS.style.opacity = null; HELP_CONTROLS.style.opacity = null;
HELP_CONTROLS.style.transform = null; HELP_CONTROLS.style.transform = null;
}, DELAY_BEFORE_HIDDING_CONTROLS) },
DELAY_BEFORE_HIDDING_CONTROLS
);
} }
function moveReaderDisplayToArea(pageNumber, width, height, posx, posy){ function moveReaderDisplayToArea(pageNumber, oWidth, oHeight, oPosx, oPosy)
{
// Keep original values for registering // Keep original values for registering
o_width = width let width = oWidth;
o_height = height let height = oHeight;
o_posx = posx let posx = oPosx;
o_posy = posy let posy = oPosy;
// Apply global offsets before scales if we are displaying a zoom // Apply global offsets before scales if we are displaying a zoom
// Pages display uses width & height = 0 // Pages display uses width & height = 0
if (width != 0 || height != 0){ if (width !== 0 || height !== 0)
width = width * globalZoomScale() {
height = height * globalZoomScale() width = width * globalZoomScale();
posx = (posx + globalZoomOffsetX()) * globalZoomScale() height = height * globalZoomScale();
posy = (posy + globalZoomOffsetY()) * globalZoomScale() posx = (posx + globalZoomOffsetX()) * globalZoomScale();
posy = (posy + globalZoomOffsetY()) * globalZoomScale();
} }
// reduce width if offset sent us outside of page // reduce width if offset sent us outside of page
if (posx < 0) { if (posx < 0)
width = width + posx {
posx = 0 width = width + posx;
posx = 0;
} }
if ((posx + width) > pageOriginalWidth(pageNumber)) {
width = pageOriginalWidth(pageNumber) - posx if ((posx + width) > pageOriginalWidth(pageNumber))
{
width = pageOriginalWidth(pageNumber) - posx;
} }
// reduce height if offset sent us outside of page // reduce height if offset sent us outside of page
if (posy < 0) { if (posy < 0)
height = height + posy {
posy = 0 height = height + posy;
posy = 0;
} }
if ((posy + height) > pageOriginalHeight(pageNumber)) {
height = pageOriginalHeight(pageNumber) - posy if ((posy + height) > pageOriginalHeight(pageNumber))
{
height = pageOriginalHeight(pageNumber) - posy;
} }
// Align the top-left corner of the frame with the page // Align the top-left corner of the frame with the page
READER_PAGES.style.transform = "translate(-" + previousPagesWidth(pageNumber) + "px, -" + pageVerticalOffset(pageNumber) + "px )" READER_PAGES.style.transform = "translate(-" + previousPagesWidth(pageNumber) + "px, -" + pageVerticalOffset(pageNumber) + "px )";
// Then move so the top-left point of the zoom match the frame top-left // Then move so the top-left point of the zoom match the frame top-left
READER_PAGES.style.transform = "translate(" + (- posx) + "px, " + (-posy) + "px )" + READER_PAGES.style.transform READER_PAGES.style.transform = "translate(" + (- posx) + "px, " + (-posy) + "px )" + READER_PAGES.style.transform;
// Then, scale so the zoom would fit the frame, and center the zoom // Then, scale so the zoom would fit the frame, and center the zoom
if (width == 0){ if (width === 0)
width = pageOriginalWidth(pageNumber) {
width = pageOriginalWidth(pageNumber);
} }
if (height == 0){ if (height === 0)
height = pageOriginalHeight(pageNumber) {
height = pageOriginalHeight(pageNumber);
} }
zoomRatio = width / height const zoomRatio = width / height;
if (readerFrameRatio() > zoomRatio) { if (readerFrameRatio() > zoomRatio)
{
// Frame wider than zoom => scale so heights are the same, offset on x // Frame wider than zoom => scale so heights are the same, offset on x
var zoomToFrameScaleFactor = READER_CONTENT_FRAME.clientHeight / height const zoomToFrameScaleFactor = READER_CONTENT_FRAME.clientHeight / height;
READER_PAGES.style.transform = "scale(" + zoomToFrameScaleFactor + ")" + READER_PAGES.style.transform READER_PAGES.style.transform = "scale(" + zoomToFrameScaleFactor + ")" + READER_PAGES.style.transform;
var scaledWidth = width * zoomToFrameScaleFactor const scaledWidth = width * zoomToFrameScaleFactor;
var offset = (READER_CONTENT_FRAME.clientWidth - scaledWidth) / 2 const offset = (READER_CONTENT_FRAME.clientWidth - scaledWidth) / 2;
READER_PAGES.style.transform = "translateX(" + offset + "px)" + READER_PAGES.style.transform READER_PAGES.style.transform = "translateX(" + offset + "px)" + READER_PAGES.style.transform;
updateFocusByWidth(scaledWidth) updateFocusByWidth(scaledWidth);
} else { }
else
{
// Frame narower than zoom => scale so left/right match, offset on y // Frame narower than zoom => scale so left/right match, offset on y
var zoomToFrameScaleFactor = READER_CONTENT_FRAME.clientWidth / width const zoomToFrameScaleFactor = READER_CONTENT_FRAME.clientWidth / width;
READER_PAGES.style.transform = "scale(" + zoomToFrameScaleFactor + ")" + READER_PAGES.style.transform READER_PAGES.style.transform = "scale(" + zoomToFrameScaleFactor + ")" + READER_PAGES.style.transform;
var scaledHeight = height * zoomToFrameScaleFactor const scaledHeight = height * zoomToFrameScaleFactor;
var offset = (READER_CONTENT_FRAME.clientHeight - scaledHeight) / 2 const offset = (READER_CONTENT_FRAME.clientHeight - scaledHeight) / 2;
READER_PAGES.style.transform = "translateY(" + offset + "px)" + READER_PAGES.style.transform READER_PAGES.style.transform = "translateY(" + offset + "px)" + READER_PAGES.style.transform;
updateFocusByHeight(scaledHeight) updateFocusByHeight(scaledHeight);
} }
// Use values before global offset / scale // Use values before global offset / scale
CURRENT_PAGE = pageNumber CURRENT_PAGE = pageNumber;
CURRENT_WIDTH = o_width CURRENT_WIDTH = oWidth;
CURRENT_HEIGHT = o_height CURRENT_HEIGHT = oHeight;
CURRENT_X = o_posx CURRENT_X = oPosx;
CURRENT_Y = o_posy CURRENT_Y = oPosy;
} }
function refreshReaderDisplay() { function refreshReaderDisplay()
moveReaderDisplayToArea(CURRENT_PAGE, CURRENT_WIDTH, CURRENT_HEIGHT, CURRENT_X, CURRENT_Y) {
moveReaderDisplayToArea(CURRENT_PAGE, CURRENT_WIDTH, CURRENT_HEIGHT, CURRENT_X, CURRENT_Y);
} }
function moveReaderDisplayToPage(pageNumber) { function moveReaderDisplayToPage(pageNumber)
moveReaderDisplayToArea(pageNumber, 0, 0, 0, 0) {
moveReaderDisplayToArea(pageNumber, 0, 0, 0, 0);
} }
function moveReaderDisplayToZoom(index) { function moveReaderDisplayToZoom(index)
{
moveReaderDisplayToArea(PAGES_ZOOMS[index][0], PAGES_ZOOMS[index][1], PAGES_ZOOMS[index][2], PAGES_ZOOMS[index][3], PAGES_ZOOMS[index][4]);
moveReaderDisplayToArea(PAGES_ZOOMS[index][0], PAGES_ZOOMS[index][1], PAGES_ZOOMS[index][2], PAGES_ZOOMS[index][3], PAGES_ZOOMS[index][4]) CURRENT_ZOOM = index;
CURRENT_ZOOM = index
} }
function updateFocusByWidth(width){ function updateFocusByWidth(width)
FOCUS_OVERLAY_WIDTH.style.width = (width / READER_CONTENT_FRAME.clientWidth * 100) + "%" {
FOCUS_OVERLAY_HEIGHT.style.height = "100%" FOCUS_OVERLAY_WIDTH.style.width = (width / READER_CONTENT_FRAME.clientWidth * 100) + "%";
FOCUS_OVERLAY_HEIGHT.style.height = "100%";
} }
function updateFocusByHeight(height){ function updateFocusByHeight(height)
FOCUS_OVERLAY_WIDTH.style.width = "100%" {
FOCUS_OVERLAY_HEIGHT.style.height = (height / READER_CONTENT_FRAME.clientHeight * 100) + "%" FOCUS_OVERLAY_WIDTH.style.width = "100%";
FOCUS_OVERLAY_HEIGHT.style.height = (height / READER_CONTENT_FRAME.clientHeight * 100) + "%";
} }
function toggleViewMode() { function toggleViewMode()
if (IS_PAGE_MODE){ {
if (CURRENT_ZOOM != null){ if (IS_PAGE_MODE)
moveReaderDisplayToZoom(CURRENT_ZOOM) {
} else { if (CURRENT_ZOOM !== null)
moveReaderDisplayToZoom(getFirstZoomOfPage(CURRENT_PAGE)) {
} moveReaderDisplayToZoom(CURRENT_ZOOM);
IS_PAGE_MODE = false
} else {
moveReaderDisplayToPage(CURRENT_PAGE)
IS_PAGE_MODE = true
} }
updateProgressBar() else
{
moveReaderDisplayToZoom(getFirstZoomOfPage(CURRENT_PAGE));
} }
function moveReader(to_next) { IS_PAGE_MODE = false;
if (IS_PAGE_MODE){
if (to_next && CURRENT_PAGE < getPagesCount()) {
moveReaderDisplayToPage(CURRENT_PAGE + 1)
CURRENT_ZOOM = null
} }
else if (!to_next && CURRENT_PAGE > 1) { else
moveReaderDisplayToPage(CURRENT_PAGE - 1) {
CURRENT_ZOOM = null moveReaderDisplayToPage(CURRENT_PAGE);
IS_PAGE_MODE = true;
} }
} else { updateProgressBar();
if (to_next && CURRENT_ZOOM < PAGES_ZOOMS.length - 1) {
moveReaderDisplayToZoom(CURRENT_ZOOM + 1)
} }
else if (!to_next && CURRENT_ZOOM > 0) { function moveReader(toNext)
moveReaderDisplayToZoom(CURRENT_ZOOM - 1) {
if (IS_PAGE_MODE)
{
if (toNext && CURRENT_PAGE < getPagesCount())
{
moveReaderDisplayToPage(CURRENT_PAGE + 1);
CURRENT_ZOOM = null;
}
else if (!toNext && CURRENT_PAGE > 1)
{
moveReaderDisplayToPage(CURRENT_PAGE - 1);
CURRENT_ZOOM = null;
} }
} }
updateProgressBar() else
{
if (toNext && CURRENT_ZOOM < PAGES_ZOOMS.length - 1)
{
moveReaderDisplayToZoom(CURRENT_ZOOM + 1);
}
else if (!toNext && CURRENT_ZOOM > 0)
{
moveReaderDisplayToZoom(CURRENT_ZOOM - 1);
}
}
updateProgressBar();
} }
@ -425,69 +501,89 @@ function moveReader(to_next) {
// CALLBACKS // CALLBACKS
// ============= // =============
function handleKeyPress(key){ function handleKeyPress(key)
{
if (key == MOVE_NEXT) { if (key === MOVE_NEXT)
moveReader(true) {
moveReader(true);
} }
else if (key == MOVE_BACK) { else if (key === MOVE_BACK)
moveReader(false) {
moveReader(false);
} }
else if (key.toUpperCase() == TOGGLE_FULLSCREEN){ else if (key.toUpperCase() === TOGGLE_FULLSCREEN)
if (document.fullscreenElement == null){ {
if (document.fullscreenElement === null)
{
READER_FRAME.requestFullscreen(); READER_FRAME.requestFullscreen();
} else { }
else
{
document.exitFullscreen(); document.exitFullscreen();
} }
} }
else if (key.toUpperCase() == TOGGLE_PROGRESSBAR){ else if (key.toUpperCase() === TOGGLE_PROGRESSBAR)
if (PROGRESS_BAR_CONTAINER.hidden == true) { {
PROGRESS_BAR_CONTAINER.hidden = false if (PROGRESS_BAR_CONTAINER.hidden === true)
} else { {
PROGRESS_BAR_CONTAINER.hidden = true PROGRESS_BAR_CONTAINER.hidden = false;
} }
else
{
PROGRESS_BAR_CONTAINER.hidden = true;
}
refreshReaderDisplay(); refreshReaderDisplay();
} }
else if (key.toUpperCase() == TOGGLE_VIEW_MODE) { else if (key.toUpperCase() === TOGGLE_VIEW_MODE)
toggleViewMode() {
toggleViewMode();
}
} }
} function handleMouseWhell(event)
{
function handleMouseWhell(event){
// Only handle scroll event if the target is the nav controls // Only handle scroll event if the target is the nav controls
// to avoid preventing page scrolling. // to avoid preventing page scrolling.
// Do disable page scrolling when we do prev/next, though // Do disable page scrolling when we do prev/next, though
if (! READER_FRAME.contains(event.target)){ if (! READER_FRAME.contains(event.target))
return {
return;
} }
event.preventDefault() event.preventDefault();
event.stopPropagation() event.stopPropagation();
if (MOUSEWHELL_WAIT){ if (MOUSEWHELL_WAIT)
return {
} else { return;
MOUSEWHELL_WAIT = true
setTimeout(() => {
MOUSEWHELL_WAIT = false
}, MOUSEWHELL_MIN_DELAY)
} }
if (event.deltaY > 0) { else
moveReader(true, false) {
MOUSEWHELL_WAIT = true;
setTimeout(
() => { MOUSEWHELL_WAIT = false; },
MOUSEWHELL_MIN_DELAY
);
} }
else { if (event.deltaY > 0)
moveReader(false, false) {
moveReader(true, false);
}
else
{
moveReader(false, false);
} }
} }
@ -495,19 +591,26 @@ function handleMouseWhell(event){
// INIT // INIT
// ====== // ======
window.addEventListener("load", (event) => { window.addEventListener(
VERSION_DISPLAY.innerText = VERSION_DISPLAY.innerText.replace("Unknown version", MELPOMENE_VERSION) "load",
initReader() (event) => { initReader() }
}); );
addEventListener("resize", (event) => { addEventListener(
refreshReaderDisplay(); "resize",
}); (event) => { refreshReaderDisplay() }
);
addEventListener("keydown", (event) => { addEventListener(
"keydown",
(event) =>
{
handleKeyPress(event.key, event.shiftKey) handleKeyPress(event.key, event.shiftKey)
}); }
);
addEventListener("wheel", (event) => { addEventListener(
handleMouseWhell(event) "wheel",
}, { passive:false }); (event) => { handleMouseWhell(event) },
{ passive:false }
);