/usr/include/icns.h is in libicns-dev 0.7.1-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 | /*
File: icns.h
Copyright (C) 2001-2008 Mathew Eis <mathew@eisbox.net>
Copyright (C) 2002 Chenxiao Zhao <chenxiao.zhao@gmail.com>
With the exception of the limited portions mentiond, this library
is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published
by the Free Software Foundation; either version 2.1 of the License,
or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <string.h>
#ifndef _ICNS_H_
#define _ICNS_H_
/* basic data types */
typedef uint8_t icns_bool_t;
typedef uint8_t icns_uint8_t;
typedef int8_t icns_sint8_t;
typedef uint16_t icns_uint16_t;
typedef int16_t icns_sint16_t;
typedef uint32_t icns_uint32_t;
typedef int32_t icns_sint32_t;
typedef uint64_t icns_uint64_t;
typedef int64_t icns_sint64_t;
typedef uint8_t icns_byte_t;
/* data header types */
typedef uint32_t icns_type_t;
typedef int32_t icns_size_t;
/* icon family and element types */
typedef struct icns_element_t {
icns_type_t elementType; /* 'ICN#', 'icl8', etc... */
icns_size_t elementSize; /* Total size of element */
icns_byte_t elementData[1]; /* icon image data */
} icns_element_t;
typedef struct icns_family_t {
icns_type_t resourceType; /* Always should be 'icns' */
icns_size_t resourceSize; /* Total size of resource */
icns_element_t elements[1]; /* icon elements */
} icns_family_t;
/* icon image data structure */
typedef struct icns_image_t
{
icns_uint32_t imageWidth; // width of image in pixels
icns_uint32_t imageHeight; // height of image in pixels
icns_uint8_t imageChannels; // number of channels in data
icns_uint16_t imagePixelDepth;// number of bits-per-pixel
icns_uint64_t imageDataSize; // bytes = width * height * depth / bits-per-pixel
icns_byte_t *imageData; // pointer to base address of uncompressed raw image data
} icns_image_t;
/* used for getting information about various types */
/* not part of the actual icns data format */
typedef struct icns_icon_info_t
{
icns_type_t iconType; // type of icon (or mask)
icns_bool_t isImage; // is this type an image
icns_bool_t isMask; // is this type a mask
icns_uint32_t iconWidth; // width of icon in pixels
icns_uint32_t iconHeight; // height of icon in pixels
icns_uint8_t iconChannels; // number of channels in data
icns_uint16_t iconPixelDepth; // number of bits-per-pixel
icns_uint16_t iconBitDepth; // overall bit depth = iconPixelDepth * iconChannels
icns_uint64_t iconRawDataSize; // uncompressed bytes = width * height * depth / bits-per-pixel
} icns_icon_info_t;
/* icns element type constants */
#define ICNS_ICON_VERSION 0x69636E56 // "icnV"
#define ICNS_512x512_32BIT_ARGB_DATA 0x69633039 // "ic09"
#define ICNS_256x256_32BIT_ARGB_DATA 0x69633038 // "ic08"
#define ICNS_128X128_32BIT_DATA 0x69743332 // "it32"
#define ICNS_128X128_8BIT_MASK 0x74386D6B // "t8mk"
#define ICNS_48x48_1BIT_DATA 0x69636823 // "ich#"
#define ICNS_48x48_4BIT_DATA 0x69636834 // "ich4"
#define ICNS_48x48_8BIT_DATA 0x69636838 // "ich8"
#define ICNS_48x48_32BIT_DATA 0x69683332 // "ih32"
#define ICNS_48x48_1BIT_MASK 0x69636823 // "ich#"
#define ICNS_48x48_8BIT_MASK 0x68386D6B // "h8mk"
#define ICNS_32x32_1BIT_DATA 0x49434E23 // "ICN#"
#define ICNS_32x32_4BIT_DATA 0x69636C34 // "icl4"
#define ICNS_32x32_8BIT_DATA 0x69636C38 // "icl8"
#define ICNS_32x32_32BIT_DATA 0x696C3332 // "il32"
#define ICNS_32x32_1BIT_MASK 0x49434E23 // "ICN#"
#define ICNS_32x32_8BIT_MASK 0x6C386D6B // "l8mk"
#define ICNS_16x16_1BIT_DATA 0x69637323 // "ics#"
#define ICNS_16x16_4BIT_DATA 0x69637334 // "ics4"
#define ICNS_16x16_8BIT_DATA 0x69637338 // "ics8"
#define ICNS_16x16_32BIT_DATA 0x69733332 // "is32"
#define ICNS_16x16_1BIT_MASK 0x69637323 // "ics#"
#define ICNS_16x16_8BIT_MASK 0x73386D6B // "s8mk"
#define ICNS_16x12_1BIT_DATA 0x69636D23 // "icm#"
#define ICNS_16x12_4BIT_DATA 0x69636D34 // "icm4"
#define ICNS_16x12_1BIT_MASK 0x69636D23 // "icm#"
#define ICNS_16x12_8BIT_DATA 0x69636D38 // "icm8"
#define ICNS_32x32_1BIT_ICON 0x49434F4E // "ICON"
#define ICNS_NULL_DATA 0x00000000
#define ICNS_NULL_MASK 0x00000000
/* icns file / resource type constants */
#define ICNS_FAMILY_TYPE 0x69636E73 // "icns"
#define ICNS_MACBINARY_TYPE 0x6D42494E // "mBIN"
#define ICNS_NULL_TYPE 0x00000000
/* icns error return values */
#define ICNS_STATUS_OK 0
#define ICNS_STATUS_NULL_PARAM -1
#define ICNS_STATUS_NO_MEMORY -2
#define ICNS_STATUS_INVALID_DATA -3
#define ICNS_STATUS_IO_READ_ERR 1
#define ICNS_STATUS_IO_WRITE_ERR 2
#define ICNS_STATUS_DATA_NOT_FOUND 3
#define ICNS_STATUS_UNSUPPORTED 4
/* icns function prototypes */
/* NOTE: internal functions are found in icns_internals.h */
// icns_io.c
int icns_write_family_to_file(FILE *dataFile,icns_family_t *iconFamilyIn);
int icns_read_family_from_file(FILE *dataFile,icns_family_t **iconFamilyOut);
int icns_read_family_from_rsrc(FILE *rsrcFile,icns_family_t **iconFamilyOut);
int icns_export_family_data(icns_family_t *iconFamily,icns_size_t *dataSizeOut,icns_byte_t **dataPtrOut);
int icns_import_family_data(icns_size_t dataSize,icns_byte_t *data,icns_family_t **iconFamilyOut);
// icns_family.c
int icns_create_family(icns_family_t **iconFamilyOut);
int icns_count_elements_in_family(icns_family_t *iconFamily, icns_sint32_t *elementTotal);
// icns_element.c
int icns_get_element_from_family(icns_family_t *iconFamily,icns_type_t iconType,icns_element_t **iconElementOut);
int icns_set_element_in_family(icns_family_t **iconFamilyRef,icns_element_t *newIconElement);
int icns_add_element_in_family(icns_family_t **iconFamilyRef,icns_element_t *newIconElement);
int icns_remove_element_in_family(icns_family_t **iconFamilyRef,icns_type_t iconType);
int icns_new_element_from_image(icns_image_t *imageIn,icns_type_t iconType,icns_element_t **iconElementOut);
int icns_new_element_from_mask(icns_image_t *imageIn,icns_type_t iconType,icns_element_t **iconElementOut);
int icns_update_element_with_image(icns_image_t *imageIn,icns_element_t **iconElement);
int icns_update_element_with_mask(icns_image_t *imageIn,icns_element_t **iconElement);
// icns_image.c
int icns_get_image32_with_mask_from_family(icns_family_t *iconFamily,icns_type_t sourceType,icns_image_t *imageOut);
int icns_get_image_from_element(icns_element_t *iconElement,icns_image_t *imageOut);
int icns_get_mask_from_element(icns_element_t *iconElement,icns_image_t *imageOut);
int icns_init_image_for_type(icns_type_t iconType,icns_image_t *imageOut);
int icns_init_image(icns_uint32_t iconWidth,icns_uint32_t iconHeight,icns_uint32_t iconChannels,icns_uint32_t iconPixelDepth,icns_image_t *imageOut);
int icns_free_image(icns_image_t *imageIn);
// icns_rle24.c
int icns_decode_rle24_data(icns_size_t rawDataSize, icns_byte_t *rawDataPtr,icns_size_t expectedPixelCount, icns_size_t *dataSizeOut, icns_byte_t **dataPtrOut);
int icns_encode_rle24_data(icns_size_t dataSizeIn, icns_byte_t *dataPtrIn,icns_size_t *dataSizeOut, icns_byte_t **dataPtrOut);
// icns_jp2.c
int icns_jp2_to_image(icns_size_t dataSize, icns_byte_t *dataPtr, icns_image_t *imageOut);
int icns_image_to_jp2(icns_image_t *image, icns_size_t *dataSizeOut, icns_byte_t **dataPtrOut);
// icns_utils.c
icns_icon_info_t icns_get_image_info_for_type(icns_type_t iconType);
icns_type_t icns_get_mask_type_for_icon_type(icns_type_t);
icns_type_t icns_get_type_from_image_info(icns_icon_info_t iconInfo);
icns_type_t icns_get_type_from_image(icns_image_t iconImage);
icns_type_t icns_get_type_from_mask(icns_image_t iconImage);
icns_bool_t icns_types_equal(icns_type_t typeA,icns_type_t typeB);
icns_bool_t icns_types_not_equal(icns_type_t typeA,icns_type_t typeB);
const char * icns_type_str(icns_type_t type, char *strbuf);
void icns_set_print_errors(icns_bool_t shouldPrint);
#endif
|