Skip to content

Latest commit

 

History

History
114 lines (90 loc) · 6.12 KB

README.md

File metadata and controls

114 lines (90 loc) · 6.12 KB
Raw

image-creator

Create and customize images for social media posts with giphy & unsplash

Libraries

Materialize

This project utilizes the materialize css library based on google's Material Design Library

interact.js

This project uses the interact.js library to include reposition, resize, and rotation functions with the gifs.

jQuery

jQuery was utilized to shorten code and work with both materialize and interact.js.

Description

The motivation behind developing this application was to create and image editor that is multiplatform cababilities for various social media sites. The app allows for API calls to unsplash for the background image. This allows for a lot of customizability. It also utilizes a giphy API call to generate and apply any amount of gifs to the background image. With the use of interact.js, the gifs can be repositioned, resized, and rotated for more customizability. Unwanted gifs can be dropped under the bottom of image contaienr to delete. With css-filters and materialize css, The background image can be altered with various sliders, then saved locally. During this project, I learned how to work with the interact.js library. I previously had no expierence with the library, but with the help of the docs and devs github, I was able to apply the UI components to the gifs.

Table of Contents

Installation

N/A

Usage

The link to the deployed site is here. image-creator

When the page is first loaded, this is the home screen. homepage

From here, the user can select a background image via a search bar to the unsplash API. As shown below, there is a functioning sidescroll bar. To make the desired image populate the image container, just click.

image search menu

After an image is selected, the user can apply filters via the filter sidebar scrollers. The user then has the option to save the settings locally.

filter menu before filter menu after applied

Next the user has the option to add gifs via the sticker sidebar menu via a Giphy API call. The user can add them by just clicking. Once added, the user can also reposition, resize, and rotate the images. Drag and drop functions work when the gif is clicked and held in the middle of the gif. The resize feature works from the bottom and ride sides/edge of the gif. The rotation function is activated by clicking the red rotation arrow. These steps are displayed below in a series of images.

gif after a search gif after a drag gif after a resize gif after a rotation

To remove an unwanted gif, simply drag the gif under the image container and it will be deleted.

Credits

List your collaborators, if any, with links to their GitHub profiles. If you used any third-party assets that require attribution, list the creators with links to their primary web presence in this section. If you followed tutorials, include links to those here as well.

  1. interact.js
  2. Materialize
  3. jQuery
  4. giphy
  5. alligator.io
  6. codepen
  7. Plnkr
  8. hacks.mozilla
  9. taye
  10. jsfiddle
  11. unsplash
  12. softauthor
  13. encodedna
  14. imgix
  15. CSS-Tricks: Apply a filter to a background image

License

MIT License

Copyright (c) [2022] [Bonnie Dipasquale]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Features

  1. Interactive sidenav for all options
  2. Unsplash image and Giphy sticker API calls with scoll menu
  3. CSS Filters appliable to image container with working sliders for intensity
  4. Gif drag/drog, resize, and rotation features
  5. Locally storing previous filters in filters sidenav

How to Contribute

If there are any suggestions to improve this generator, this is my GitHub profile account. The repo can be found at, Github repo.