# Coil

**Repository Path**: baijuncheng-open-source/coil

## Basic Information

- **Project Name**: Coil
- **Description**: 一款用于图片加载的库
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2021-02-23
- **Last Updated**: 2021-08-23

## Categories & Tags

**Categories**: harmonyos-image

**Tags**: None

## README

Introduction
============

An image loading library for openharmony. Coil is:
- **Fast**: Coil performs a number of optimizations including memory and disk caching, downsampling the image in memory, re-using bitmaps, and  
            more.
- **Lightweight**: Coil adds ~2000 methods to your hap, which is comparable to Picasso and significantly less than Glide and Fresco.

**Download**

**Preview**
![](img/coil.gif)

gradle uses import
```
implementation 'com.gitee.baijuncheng-open-source:coil:1.0.0'
```

Integrate with local project source code, users can make customized modifications
```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
    compile project(path: ':coil-base')
}
```


Simple Usage
------------

1.) To load an image into an `Image`, use the `Coil.load` extension function:

```java
// URL
Coil.Load(image,"https://www.example.com/image.jpg",ability)

// Resource
Coil.Load(image,ResourceTable.Media_gif,ability)

svg format only supports local loading, and you need to convert svg to xml format first
// And more...
```

2.) You can use ImageRequest to configure the image display effect and placeholder image（The transformation effect currently supports jpg, png  
 and GIF formats）:

```java
ImageRequest.Builder builder = new ImageRequest.Builder("https://www.example.com/image.jpg");
builder.addTransform(new CircleCropTransformation())
.placeholder(ResourceTable.Media_load)
.error(ResourceTable.Media_err);
Coil.load(image, builder.build(), getAbility());
```
 ## Requirements

 - SDK version 3+
 - [Java 8+]

 ## License

 Copyright 2021 Coil Contributors

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

 https://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.