FoxPro 6.0 ICO File Format Specifications

Visual FoxPro 6.0, released in 1998, represents legacy software with limited graphics capabilities, particularly regarding icon support compared to modern operating systems and image formats.

Key Requirements Summary

FoxPro 6.0 primarily supports Windows 3.x format ICO files, characterized by:

• Color depth: Maximum support up to 256 colors (8-bit). No support for true color (24-bit or 32-bit with alpha channel) ICO files.
• Dimensions: Most compatible sizes are 16x16 pixels and 32x32 pixels.
• Multiple images: Does not support storing multiple dimensions/color depths within a single ICO file. It reads only the first image from the ICO file.

Detailed Specifications and Explanations

1. Color Depth Requirements

• Recommended: 16-color (4-bit) or 256-color (8-bit)
• Avoid: True color (16.7 million colors, 24-bit), alpha-channel PNG-style ICO (32-bit). Using these modern formats may result in improper display, showing blank areas, pixelation, or default system icons.

2. Image Dimensions

• Small icons: 16x16 pixels - used for headers, grids, toolbars
• Standard icons: 32x32 pixels - used for form icons (Form.Icon property), message boxes
• Other sizes: Sizes like 48x48 pixels are typically unsupported or display incorrectly in FoxPro 6.0

3. Format Details

FoxPro 6.0 is compatible with the older "BMP-in-ICO" container format, which essentially packages a BMP bitmap with a simple mask for transparency effects. It cannot interpret modern operating system formats (like Windows XP and later) using "PNG-in-ICO" format.

Preparing or Converting ICO Files for FoxPro 6.0

Since finding tools that generate this legacy format directly is challenging, using professional icon editors or online conversion tools with explicit output settings is the most reliable approach.

Recommended Method: Professional Icon Tools (Axialis IconWorkshop, IcoFX, etc.)

1. Create a new icon project
2. Add images: Create or import 16x16 and/or 32x32 pixel images
3. Set color depth:
   • Explicitly set color mode to 16-coler or 256-color in the palette
   • Do not use "True Color" or "Millions of Colors" modes
4. Export as ICO: Ensure format is Windows 3.x/95/NT compatible ICO during save. Include only one image for FoxPro compatibility (e.g., only 32x32-256 color)

Alternative Method: Online Conversion Tools

1. Find a reliable online image-to-ICO converter
2. Upload source image (PNG, JPG, etc.)
3. In conversion settings, ensure these critical configurations:
   • Dimensions: Select 16x16 and/or 32x32
   • Colors/Bits: Choose 8-bit (256 colors) or lower if available

Implementation in FoxPro 6.0

1. Form Icons:

oMyForm.Icon = "application_icon.ico"

This replaces the icon in the top-left corner of the form's title bar.

2. Project Information Icons:

In the Project Manager, right-click the project root node → "Project Properties" → "Project" tab, where you can set an icon that appears when the project compiles to APP or EXE.

3. Compiled EXE Icons:

In the Project Manager, click "Build Options" → "Build". In the dialog bottom, "Specify Version Information" includes an "Icon" section where the specified ICO becomes the final EXE file's icon.

ANI Animation Cursor Support

FoxPro 6.0 also supports ANI animation cursor files, used similarly to ICO files for custom mouse pointers:

THISFORM.MousePointer = 99 && Must be set to 99 for custom pointer
THISFORM.MouseIcon = "loading_cursor.ani"

Summary

The key to preparing ICO files for FoxPro 6.0 lies in **retro-compatibility**:

• Dimensions: 16x16 or 32x32
• Colors: 16-color or 256-color
• Format: Traditional BMP-in-ICO, not modern PNG-in-ICO

If your ICO doesn't display in FoxPro, it likely contains high color depth or modern formats unrecognized by the application. Use professional icon tools to recreate a low-color-depth version.

Photoshop Color Depth Configuration Guide

Configuring color depth in Photoshop is crucial when working with images requiring specific color limitations, such as creating ICO files for FoxPro 6.0.

Fundamental Concept: Understanding Color Depth

Color depth refers to the number of colors available per pixel, expressed in bits per channel.

• 8-bit/channel: Common mode with 256 levels per channel (red, green, blue). Total of approximately 16.7 million colors, suitable for most scenarios.
• 16-bit/channel: 65,536 levels per channel, richer color information for professional photography and high-end printing, larger file sizes.
• 32-bit/channel: Primarily for high dynamic range (HDR) images with extreme brightness ranges.
• Indexed Color: A mode that reduces color depth by limiting the image to a maximum 256-color "color table" - essential for FoxPro 6.0 icon creasion.

Setting and Changing Color Depth

Main configuraton location: Top menu bar under Image > Mode.

1. Setting High Bit Depths (8-bit/16-bit/32-bit)

Direct operation for switching between common color modes:

1. Open your image
2. Click top menu Image
3. Select Mode
4. Choose required bit depth:
   • 8 Bits/Channel
   • 16 Bits/Channel
   • 32 Bits/Channel

Note: Converting from high bit depth (like 16-bit) to low bit depth (like 8-bit) may lose color information, representing a lossy operation. Photoshop typically shows warnings.

2. Setting Low Bit Depth (Indexed Color Mode) - Critical Step

This is the core step for creating 256-color ICO files compatible with FoxPro.

Prerequisites: Your image must be 8-bit/channel Grayscale or RGB Color mode to convert to "Indexed Color".

Procedure

1. Prepare image: Ensure image is Image > Mode > RGB Color or Grayscale, and 8 Bits/Channel.
2. Click top menu Image > Mode > Indexed Color.
3. An "Indexed Color" dialog appears for precise control:

"Indexed Color" Dialog Breakdown

• Palette options:
  • Perceptual (Selective): Photoshop intelligently selects optimal 256 colors based on current image distribution. Most common, best results.
  • Exact: Uses precise color table if image already has fewer than 256 colors.
  • Web: Uses web-safe palette ensuring color stability in early browsers.
  • Custom...: Allows manual color table creation or modification.
  • Previous: Uses previously converted custom palette.
• Colors:
  • Enter desired maximum color count. For FoxPro-compatible icons, input 16 or 256.
• Dithering:
  • None: No dithering. Colors not in palette are replaced with closest pure color, potentially causing visible blocks.
  • Diffusion: Random patterns mix pixels to simulate unavailable colors. Usually most natural, recommended option.
  • Pattern: Uses halftone-style square patterns for color simulation.
  • Noise: Similar to diffusion, better transitions between color regions.
• Forced colors:
  • Can force certain colors (pure black, pure white) into the color table.

Recommended Parameters for FoxPro Icons

• Palette: Perceptual (Selective)
• Colors: 16 or 256
• Dithering: Diffusion (or None for simple color images)

Complete Photoshop Workflow for FoxPro 6.0 ICO Creation

1. Create new document: 32x32 pixels or 16x16 pixels, RGB Color, 8-bit
2. Design icon: Draw your icon on canvas
3. Convert to indexed:
   • Click Image > Mode > Indexed Color
   • In dialog, set Colors to 256
   • Select Perceptual (Selective) palette, Diffusion dithering
   • Click OK
4. Save as ICO:
   • Install ICO Format.8bi plugin in Photoshop's Plug-ins\File Formats\ folder
   • Use File > Export > Export As or File > Save As, select ICO (*.ICO) format

Summary

• Standard usage: Direct switch between 8/16/32 Bits/Channel under Image > Mode
• Special needs (low-color icons): Convert to Indexed Color mode, specify color count (16 or 256) in dialog
• Critical note: High-to-low color depth conversion (especially indexed) is lossy. Perform after all edits, keep high-depth PSD backup for modifications