https://github.com/heroesofcode/magicimages

Magic Image is a library to facilitate the development of the image in various ways for iOS & tvOS
https://github.com/heroesofcode/magicimages

image ios ios-swift swift-package-manager tvos

Last synced: 1 day ago
JSON representation

Magic Image is a library to facilitate the development of the image in various ways for iOS & tvOS

• Host: GitHub
• URL: https://github.com/heroesofcode/magicimages
• Owner: heroesofcode
• License: mit
• Created: 2021-05-05T18:58:05.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-04-10T11:05:09.000Z (7 months ago)
• Last Synced: 2024-04-10T12:25:52.551Z (7 months ago)
• Topics: image, ios, ios-swift, swift-package-manager, tvos
• Language: Swift
• Homepage:
• Size: 4.96 MB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT

Awesome Lists containing this project

README

        


    



[![CI](https://github.com/heroesofcode/MagicImages/actions/workflows/CI.yml/badge.svg)](https://github.com/heroesofcode/MagicImages/actions/workflows/CI.yml)

[![SPM compatible](https://img.shields.io/badge/SPM-compatible-brightgreen)](https://swift.org/package-manager)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fheroesofcode%2FMagicImages%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/heroesofcode/MagicImages)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fheroesofcode%2FMagicImages%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/heroesofcode/MagicImages)

[![License](https://img.shields.io/github/license/joaolfp/ViewState.svg)](https://github.com/joaolfp/DataLife/blob/master/LICENSE)

## Overview

- [x] A library to facilitate the development of the image in various ways.

- [x] Provides caching support.

- [x] SwiftUI support.

## Requirements

- iOS 13.0+ / tvOS 13.0+ / visionOS 1.0+

## Usage

#### First Example

You can use it to view an image through a url, follow the example below



```swift

MagicImages(image: imageView)

    .start(url: "IMAGE URL")

    

// OR

MagicImages(image: imageView)

    .start(url: "IMAGE URL", placeholder: "PhotoLocal")

// OR

    

MagicImages(image: imageView)

    .start(name: "IMAGE NAME")

    

// OR

    

MagicImages(image: imageView)

    .start(uiImage: UIImage(systemName: "heart.fill"))

```

#### Example SwiftUI

```swift

var body: some View {

     MagicImagesUI(url: "www.example.com/image.jpg")

        .frame(width: 300, height: 300)

        .cornerRadius(20)

}

```

#### Second Example

You can use it to view a circular image. Measure is the width and height, follow the example below. Here you don't need to put width and height in the constraint, in the measure parameter Magic Images is already doing that.



```swift

MagicImages(image: imageView)

    .start(url: "IMAGE URL")

    .isCircle(measure: 100)

```

#### Third Example

You can use it to see an image with rounded edges. Measure is rounded edges, follow the example below



```swift

MagicImages(image: imageView)

    .start(url: "IMAGE URL")

    .isRounded(measure: 20)

```

#### Last Example

You can use it to see an image with some sides of the rounded edges. Measure is rounded edges, follow the example below



```swift

MagicImages(image: imageView)

    .start(url: "IMAGE URL")

    .isSides([.topLeft, .bottomRight], measures: 50)

```

## Installation

### [Swift Package Manager (SPM)](https://swift.org/package-manager)

```swift

import PackageDescription

let package = Package(

    name: "",

    dependencies: [

       .package(url: "https://github.com/heroesofcode/MagicImages", .upToNextMajor(from: "1.6.0"))

    ],

    targets: [

        .target(

            name: "",

            dependencies: ["MagicImages"]),

    ]

)

```

## Contributing

To contribute, just fork this project and then open a pull request, feel free to contribute, bring ideas and raise any problem in the issue tab.

## License

MagicImages is released under the MIT license. See [LICENSE](https://github.com/heroesofcode/MagicImages/blob/feature/add-contributors/LICENSE) for details.