https://github.com/artstorm/xc-assetcat-gen

Xcode asset catalog generator for game development.
https://github.com/artstorm/xc-assetcat-gen

asset-catalog game-development gamedev xcode

Last synced: 1 day ago
JSON representation

Xcode asset catalog generator for game development.

• Host: GitHub
• URL: https://github.com/artstorm/xc-assetcat-gen
• Owner: artstorm
• Created: 2020-07-13T14:27:36.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2023-11-17T15:42:47.000Z (over 1 year ago)
• Last Synced: 2025-02-14T09:41:58.239Z (6 days ago)
• Topics: asset-catalog, game-development, gamedev, xcode
• Language: JavaScript
• Homepage: https://blog.bitbebop.com
• Size: 19.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# xc assetcat gen

[![GitHub Actions](https://github.com/artstorm/xc-assetcat-gen/workflows/style/badge.svg)](https://github.com/artstorm/xc-assetcat-gen/actions)

[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)

![Swift Gamedev](https://img.shields.io/badge/swift-gamedev-brightgreen.svg?style=flat)

[![Twitter: @artstorm](https://img.shields.io/badge/[email protected]?style=flat)](https://twitter.com/artstorm)

> **Note:** This repository contains the core code of the xcode asset catalog generator framework. If you want to use the generator in a game project, visit the main [Xcode Asset Catalog Generator repository](https://github.com/artstorm/xcode-asset-catalog-generator).

xc assetcat gen is a batch processing framework that builds the asset catalog from source assets and generates images with optimized sizes for iPad, iPhone, AppleTV and Mac.

## Features

* Creates sizes in @1x, @2x and @3x per device type.

* Saves the output directly to the asset catalog in Xcode.

* Handles numbered image sequences.

* Handles Sprite Atlas generation.

* Handles vector images as Universal, Single Scale. PDF and SVG (Xcode 12+).

* Specifically targets game development with SpriteKit.

* Tracks converted images so on each re-generation only new or updated source images are generated to the asset catalog.

* In early development, available as-is. The same goes for the documentation.

I've developed the tool for personal usage, so everything is subject to change between versions and it does have quite a few rough edges.

### Reference

The [wiki](https://github.com/artstorm/xc-assetcat-gen/wiki

) has more detailed documentation of how to configure and use the tool.