Skip to content

diffscope/image-assets

DiffScope Image Assets Source Files

This repository contains the source files for DiffScope's image assets, including logos, icons, and promotional materials.

Note on Proprietary Softwares

Some of the source files in this repository are created using proprietary softwares:

  • Adobe Photoshop
  • Adobe Illustrator
  • Apple Icon Composer

To maintain the integrity of the design and ensure that all assets are consistent, it is recommended to use the same software for editing these files. You may also try free software alternatives that support the respective file formats, but be aware that some features or effects may not be fully compatible.

In the future, the maintenance of image assets is planned to be completely migrated to free softwares.

File Structure

Indirect Use

  • logo.ai - Vector graphics for the DiffScope logo shape
  • 1.ai - Vector graphics used in low-resolution icon variants

These files will only be embedded in other files and will not be used directly for export.

Core Logo Files

  • logo_demo.psd - Complete DiffScope logo with filter effects applied to the linked logo.ai vector

Low-resolution icon source files:

  • logo_demo_16.psd - DiffScope logo optimized for 16×16 pixel display
  • logo_demo_24.psd - DiffScope logo optimized for 24×24 pixel display

Note: These files are specially designed for low-resolution displays. All low-resolution icon exports should be generated from these sources.

Banner and Splash Screen

  • banner_demo.psd - Horizontal banner combining the DiffScope logo with "DiffScope" text
    • Contains both light and dark text variants
    • Links to logo_demo.psd
  • splash.ai - Application splash screen design
    • Links to logo_demo.psd
    • Text layers are for reference only and should be hidden during export
    • Actual text positioning is configured in config.json.in within the diffscope-project repository

macOS-Specific Assets

  • logo_macos.ai - Vector graphics specially designed for macOS 26 liquid glass effect

    • Contains three separate layers that must be exported individually
  • logo_macos.icon - Icon Composer project for macOS 26 liquid glass icons

    • Import the separately exported layers from logo_macos.ai to create the final liquid glass icon
  • dmg_background.psd - Background image for macOS DMG installer packages

    • Includes installation instructions in English, Simplified Chinese, Traditional Chinese, and Japanese

Document Icon File

  • dspx.ai - Icon for DSPX project files

File Dependencies

Understanding the linking relationships between files is crucial for maintaining consistency when updating assets.

logo.ai
└── logo_demo.psd
    ├── banner_demo.psd
    └── splash.ai

1.ai
├── logo_demo_16.psd
└── logo_demo_24.psd

logo_macos.ai
└── logo_macos.icon (Icon Composer project)

dspx.ai (independent, no linked files)

Since project files can only store absolute paths, the embedded files need to be relinked.

Update Workflow

When modifying the logo design, follow this order to ensure all assets remain synchronized:

  1. Edit base vector files (logo.ai, 1.ai, or logo_macos.ai)
  2. Update linked PSD files in dependency order:
    • First: logo_demo.psd, logo_demo_16.psd, logo_demo_24.psd
    • Then: banner_demo.psd, splash.ai
  3. Update Icon Composer project (logo_macos.icon) if logo_macos.ai was modified
  4. Export final assets from the updated source files

Important: Always update files in the order they are linked. Updating a parent file without refreshing its dependents will result in inconsistent assets.

Scripts

The scripts/ directory contains tools for exporting assets from the source files. These scripts automate the export process and ensure that all assets are generated with the correct settings.

  • export_banner.jsx - Exports the banner image from banner_demo.psd Associated directory in diffscope-project: src/plugins/coreplugin/res/logos
  • export_dmg_background.jsx - Exports the DMG background image from dmg_background.psd Associated directory in diffscope-project: src/app/share/dmg
  • export_dspx_icons.jsx - Exports DSPX icons in various sizes from dspx.ai Associated directory in diffscope-project: src/app/icons/dspx
  • export_logo_icons.jsx - Exports DiffScope logo icons in various sizes from logo_demo.psd, logo_demo_16.psd, and logo_demo_24.psd Associated directory in diffscope-project: src/app/icons/app
  • export_splash.jsx - Exports the splash screen image from splash.ai Associated directory in diffscope-project: src/app
  • update_macos_icon.jsx - Updates the Icon Composer icon with the latest layers from logo_macos.ai Associated directory in diffscope-project: src/app/app.icon

License

The DiffScope image assets are dual-licensed. You may choose either:

  • Apache License 2.0, or
  • Creative Commons Attribution 4.0 International (CC BY 4.0)

The scripts in the scripts/ directory used for exporting assets are licensed under CC0 1.0 Universal (CC0-1.0).

About

No description, website, or topics provided.

Resources

License

Apache-2.0, CC-BY-4.0 licenses found

Licenses found

Apache-2.0
LICENSE_Apache-2.0
CC-BY-4.0
LICENSE_CC-BY-4.0

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors