Easy Image Editor: Tutorial and Documentation

王林
Release: 2024-08-25 06:35:32
Original
615 people have browsed it

Easy Image Editor: Tutorial and Documentation

Easy Image Editor: Tutorial and Documentation

100daysofMiva Day 5.

Today, I went through the implementation and functionality of a simple yet powerful image editor built with HTML, CSS, and JavaScript. The editor allows users to apply basic filters, rotate, and flip an image. It also supports loading an image from the user's device and saving the edited image.


1.HTML Structure

The HTML structure is divided into several key sections: the filter options, rotation and flip options, an image preview area, and control buttons.

Easy Image Editor

Brighteness

100%

Easy Image Editor: Tutorial and Documentation
Copy after login
  • Container & Wrapper: Wraps the entire image editor.
  • Filter Section: Includes buttons for selecting filters like brightness, saturation, inversion, and grayscale.
  • Rotate & Flip Section: Provides options to rotate and flip the image.
  • Preview Image Section: Displays the image that the user is editing.
  • Controls Section: Contains buttons to reset filters, choose an image, and save the edited image.

2.JavaScript Functionality

The JavaScript code handles the logic behind loading an image, applying filters, rotating and flipping the image, and saving the edited image.

Variables and DOM Elements

const fileInput = document.querySelector(".file-input"), filterOptions = document.querySelectorAll(".filter button"), filterName = document.querySelector(".filter-info .name"), filterValue = document.querySelector(".filter-info .value"), filterSlider = document.querySelector(".slider input"), rotateOptions = document.querySelectorAll(".rotate button"), previewImg = document.querySelector(".Easy Image Editor: Tutorial and Documentation img"), resetFilterBtn = document.querySelector(".reset-filter"), chooseImgBtn = document.querySelector(".choose-img"), saveImgBtn = document.querySelector(".save-img"); let brightness = "100", saturation = "100", inversion = "0", grayscale = "0"; let rotate = 0, flipHorizontal = 1, flipVertical = 1;
Copy after login
  • Variables: Stores default values for filters and rotation/flip states.
  • DOM Elements: Selects various elements in the DOM for interaction (e.g., buttons, sliders, image preview).

Loading the Image

const loadImage = () => { let file = fileInput.files[0]; if(!file) return; previewImg.src = URL.createObjectURL(file); previewImg.addEventListener("load", () => { resetFilterBtn.click(); // Reset filters when a new image is loaded document.querySelector(".container").classList.remove("disable"); }); }
Copy after login
  • loadImage: Loads the selected image from the user's device and displays it in the preview area.

Applying Filters

const applyFilter = () => { previewImg.style.transform = `rotate(${rotate}deg) scale(${flipHorizontal}, ${flipVertical})`; previewImg.style.filter = `brightness(${brightness}%) saturate(${saturation}%) invert(${inversion}%) grayscale(${grayscale}%)`; }
Copy after login
  • applyFilter: Applies the selected filters and transformations (rotate, flip) to the image preview.

Handling Filter Selection and Updates

filterOptions.forEach(option => { option.addEventListener("click", () => { document.querySelector(".active").classList.remove("active"); option.classList.add("active"); filterName.innerText = option.innerText; if(option.id === "brightness") { filterSlider.max = "200"; filterSlider.value = brightness; filterValue.innerText = `${brightness}%`; } else if(option.id === "saturation") { filterSlider.max = "200"; filterSlider.value = saturation; filterValue.innerText = `${saturation}%` } else if(option.id === "inversion") { filterSlider.max = "100"; filterSlider.value = inversion; filterValue.innerText = `${inversion}%`; } else { filterSlider.max = "100"; filterSlider.value = grayscale; filterValue.innerText = `${grayscale}%`; } }); }); const updateFilter = () => { filterValue.innerText = `${filterSlider.value}%`; const selectedFilter = document.querySelector(".filter .active"); if(selectedFilter.id === "brightness") { brightness = filterSlider.value; } else if(selectedFilter.id === "saturation") { saturation = filterSlider.value; } else if(selectedFilter.id === "inversion") { inversion = filterSlider.value; } else { grayscale = filterSlider.value; } applyFilter(); }
Copy after login
  • Event Listeners: These are attached to the filter buttons and slider. They update the filter values and reapply them to the image preview.

Rotating and Flipping the Image

rotateOptions.forEach(option => { option.addEventListener("click", () => { if(option.id === "left") { rotate -= 90; } else if(option.id === "right") { rotate += 90; } else if(option.id === "horizontal") { flipHorizontal = flipHorizontal === 1 ? -1 : 1; } else { flipVertical = flipVertical === 1 ? -1 : 1; } applyFilter(); }); });
Copy after login
  • rotateOptions: These buttons rotate the image by 90 degrees or flip it horizontally/vertically.

Resetting Filters

const resetFilter = () => { brightness = "100"; saturation = "100"; inversion = "0"; grayscale = "0"; rotate = 0; flipHorizontal = 1; flipVertical = 1; filterOptions[0].click(); applyFilter(); }
Copy after login
  • resetFilter: Resets all filters and transformations to their default values.

Saving the Edited Image

const saveImage = () => { const canvas = document.createElement("canvas"); const ctx = canvas.getContext("2d"); canvas.width = previewImg.naturalWidth; canvas.height = previewImg.naturalHeight; ctx.filter = `brightness(${brightness}%) saturate(${saturation}%) invert(${inversion}%) grayscale(${grayscale}%)`; ctx.translate(canvas.width / 2, canvas.height / 2); if(rotate !== 0) { ctx.rotate(rotate * Math.PI / 180); } ctx.scale(flipHorizontal, flipVertical); ctx.drawImage(previewImg, -canvas.width / 2, -canvas.height / 2, canvas.width, canvas.height); const link = document.createElement("a"); link.download = "image.jpg"; link.href = canvas.toDataURL(); link.click(); }
Copy after login
  • saveImage: Creates a canvas element, applies the transformations and filters, and then saves the edited image as a file.

Event Listeners

filterSlider.addEventListener("input", updateFilter); resetFilterBtn.addEventListener("click", resetFilter); saveImgBtn.addEventListener("click", saveImage); fileInput.addEventListener("change", loadImage); chooseImgBtn.addEventListener("click", () => fileInput.click());
Copy after login
  • Event Listeners: Handle user interactions, such as choosing an image, adjusting filters, and saving the edited image.

3.Usage

  1. Choose an Image: Click the "Choose Image" button to load an image from your device.
  2. Apply Filters: Select a filter and adjust its value using

the slider.

  1. Rotate & Flip: Use the rotate and flip buttons to modify the image orientation.
  2. Reset Filters: Click "Reset Filters" to revert all settings to default.
  3. Save Image: Once you're satisfied with the edits, click "Save Image" to download the modified image.

4.Conclusion

This simple image editor provides essential tools to modify and enhance images. The structure is designed to be easy to understand and extendable, allowing for the addition of more features like additional filters or advanced editing tools. Thanks for reading. Unto the next…

Check it out here
https://app.marvelly.com.ng/100daysofMiva/day-5/

Source code
https://github.com/Marvellye/100daysofMiva/tree/main/Projects/Day_5-Image-Editor

The above is the detailed content of Easy Image Editor: Tutorial and Documentation. For more information, please follow other related articles on the PHP Chinese website!

source:dev.to
Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Latest Downloads
More>
Web Effects
Website Source Code
Website Materials
Front End Template
About us Disclaimer Sitemap
php.cn:Public welfare online PHP training,Help PHP learners grow quickly!