{"id":19847022,"url":"https://github.com/polidea/plximagemanager","last_synced_at":"2026-05-14T19:34:14.837Z","repository":{"id":62450085,"uuid":"43811895","full_name":"Polidea/PLXImageManager","owner":"Polidea","description":"Image manager/downloader for iOS","archived":false,"fork":false,"pushed_at":"2016-01-21T09:14:22.000Z","size":43,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-02-11T15:03:24.190Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Polidea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-10-07T11:47:20.000Z","updated_at":"2016-03-31T14:23:59.000Z","dependencies_parsed_at":"2022-11-01T23:18:00.981Z","dependency_job_id":null,"html_url":"https://github.com/Polidea/PLXImageManager","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Polidea%2FPLXImageManager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Polidea%2FPLXImageManager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Polidea%2FPLXImageManager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Polidea%2FPLXImageManager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Polidea","download_url":"https://codeload.github.com/Polidea/PLXImageManager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241226011,"owners_count":19930318,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T13:13:15.089Z","updated_at":"2026-05-14T19:34:12.152Z","avatar_url":"https://github.com/Polidea.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PLXImageManager\n\n[![CI Status](https://img.shields.io/travis/Polidea/PLXImageManager.svg?style=flat)](https://travis-ci.org/Polidea/PLXImageManager)\n[![Version](https://img.shields.io/cocoapods/v/PLXImageManager.svg?style=flat)](http://cocoapods.org/pods/PLXImageManager)\n[![License](https://img.shields.io/cocoapods/l/PLXImageManager.svg?style=flat)](http://cocoapods.org/pods/PLXImageManager)\n[![Platform](https://img.shields.io/cocoapods/p/PLXImageManager.svg?style=flat)](http://cocoapods.org/pods/PLXImageManager)\n\nImage manager/downloader for iOS\n\n## Usage\n\n### Creation\n```objective-c\nPLXURLImageProvider * provider = [PLXURLImageProvider new];\nPLXImageManager * manager = [[PLXImageManager alloc] initWithProvider:provider];\n```\n\nThe *provider* is responsible for retrieving a image if it is not available in cache. The standard PLXURLImageProvider is provided as convenience. It takes a URL and simply downloads up to 5 images at once. By implementing the *PLXImageManagerProvider* protocol yourself, you can adapt the manager to fit your needs.\n\t\n### Requesting images\n```objective-c\n[manager imageForIdentifier:@”http://placehold.it/350/00aa00/ffffff” \n                placeholder:[UIImage imageNamed:@”placeholder” \n\t               callback:^(UIImage *image, BOOL isPlaceholder) {\n\t//consume the image here\n}];\n```\n### Canceling requests\nThe -imageForIdentifier:placeholder:callback: method returns a PLXImageManagerRequestToken that can be used to cancel requests for images. \n\n\nThis is important in scenarios like scrolling a UITableView, when cells can disappear before the download finishes. Canceling those will spare network usage, and reduce the time for the right image to appear.\n\n\n```objective-c\nPLXImageManagerRequestToken * token = nil;\n\n//get token\ntoken = [manager imageForIdentifier:@”http://placehold.it/350/00aa00/ffffff”\n                        placeholder:[UIImage imageNamed:@”placeholder”\n                           callback:^(UIImage *image, BOOL isPlaceholder) {\n\t//consume the image here\n}];\n\n//cancel the download\n[token cancel];\n```\n\nA convenience method is provided to store (and retrieve) a token on any NSObject subclass.\n\n\n```objective-c\n//storing a token\n[aObject plx_storeToken:token];\n\n//retrieving a token\ntoken = [aObject plx_retrieveToken];\n``` \n\n### Caching\nPLXImageManager makes use of a combination of memory and file based caches. Refer to the documentation for the memoryCacheCountLimit and fileCacheTotalSizeLimit properties for details.\n\n### Example\n\nThe included example project demonstrates:\n\n* instantiating PLXImageManager\n* requesting images using the convenience category on UIImageView\n\nTo run it, clone the repo, and run `pod install` from the Example directory first. \n\n## Requirements\n\niOS 7+\n\n## Installation\n\nPLXImageManager is available through [CocoaPods](http://cocoapods.org). To install\nit, simply add the following line to your Podfile:\n\n```ruby\npod \"PLXImageManager\"\n```\n\n## Author\n\nAntoni Kedracki, antoni.kedracki@polidea.com\n\nYou can read more about the internal workings of PLImageManager [here](http://www.polidea.com/en/Blog,141,Implementing_a_high_performance_image_manager_for_iOS).\n\n## License\n\nPLXImageManager is available under the BSD license. See the LICENSE file for more info.\n\nCopyright (c) 2013 Polidea. This software is licensed under the BSD License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolidea%2Fplximagemanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpolidea%2Fplximagemanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolidea%2Fplximagemanager/lists"}