Blame tools/tiffinfo.c

Packit 994f1a
/* $Id: tiffinfo.c,v 1.8.2.1 2010-06-08 18:50:44 bfriesen Exp $ */
Packit 994f1a
Packit 994f1a
/*
Packit 994f1a
 * Copyright (c) 1988-1997 Sam Leffler
Packit 994f1a
 * Copyright (c) 1991-1997 Silicon Graphics, Inc.
Packit 994f1a
 *
Packit 994f1a
 * Permission to use, copy, modify, distribute, and sell this software and 
Packit 994f1a
 * its documentation for any purpose is hereby granted without fee, provided
Packit 994f1a
 * that (i) the above copyright notices and this permission notice appear in
Packit 994f1a
 * all copies of the software and related documentation, and (ii) the names of
Packit 994f1a
 * Sam Leffler and Silicon Graphics may not be used in any advertising or
Packit 994f1a
 * publicity relating to the software without the specific, prior written
Packit 994f1a
 * permission of Sam Leffler and Silicon Graphics.
Packit 994f1a
 * 
Packit 994f1a
 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
Packit 994f1a
 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
Packit 994f1a
 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
Packit 994f1a
 * 
Packit 994f1a
 * IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
Packit 994f1a
 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
Packit 994f1a
 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
Packit 994f1a
 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
Packit 994f1a
 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
Packit 994f1a
 * OF THIS SOFTWARE.
Packit 994f1a
 */
Packit 994f1a
Packit 994f1a
#include "tif_config.h"
Packit 994f1a
Packit 994f1a
#include <stdio.h>
Packit 994f1a
#include <stdlib.h>
Packit 994f1a
#include <string.h>
Packit 994f1a
Packit 994f1a
#ifdef HAVE_STRINGS_H
Packit 994f1a
# include <strings.h>
Packit 994f1a
#endif
Packit 994f1a
Packit 994f1a
#ifdef HAVE_UNISTD_H
Packit 994f1a
# include <unistd.h>
Packit 994f1a
#endif
Packit 994f1a
Packit 994f1a
#include "tiffio.h"
Packit 994f1a
Packit 994f1a
#define	streq(a,b)	(strcasecmp(a,b) == 0)
Packit 994f1a
Packit 994f1a
int	showdata = 0;			/* show data */
Packit 994f1a
int	rawdata = 0;			/* show raw/decoded data */
Packit 994f1a
int	showwords = 0;			/* show data as bytes/words */
Packit 994f1a
int	readdata = 0;			/* read data in file */
Packit 994f1a
int	stoponerr = 1;			/* stop on first read error */
Packit 994f1a
Packit 994f1a
static	void usage(void);
Packit 994f1a
static	void tiffinfo(TIFF*, uint16, long);
Packit 994f1a
Packit 994f1a
int
Packit 994f1a
main(int argc, char* argv[])
Packit 994f1a
{
Packit 994f1a
	int dirnum = -1, multiplefiles, c;
Packit 994f1a
	uint16 order = 0;
Packit 994f1a
	TIFF* tif;
Packit 994f1a
	extern int optind;
Packit 994f1a
	extern char* optarg;
Packit 994f1a
	long flags = 0;
Packit 994f1a
	uint32 diroff = 0;
Packit 994f1a
	int chopstrips = 0;		/* disable strip chopping */
Packit 994f1a
Packit 994f1a
	while ((c = getopt(argc, argv, "f:o:cdDSjilmrsvwz0123456789")) != -1)
Packit 994f1a
		switch (c) {
Packit 994f1a
		case '0': case '1': case '2': case '3':
Packit 994f1a
		case '4': case '5': case '6': case '7':
Packit 994f1a
		case '8': case '9':
Packit 994f1a
			dirnum = atoi(&argv[optind-1][1]);
Packit 994f1a
			break;
Packit 994f1a
		case 'd':
Packit 994f1a
			showdata++;
Packit 994f1a
			/* fall thru... */
Packit 994f1a
		case 'D':
Packit 994f1a
			readdata++;
Packit 994f1a
			break;
Packit 994f1a
		case 'c':
Packit 994f1a
			flags |= TIFFPRINT_COLORMAP | TIFFPRINT_CURVES;
Packit 994f1a
			break;
Packit 994f1a
		case 'f':		/* fill order */
Packit 994f1a
			if (streq(optarg, "lsb2msb"))
Packit 994f1a
				order = FILLORDER_LSB2MSB;
Packit 994f1a
			else if (streq(optarg, "msb2lsb"))
Packit 994f1a
				order = FILLORDER_MSB2LSB;
Packit 994f1a
			else
Packit 994f1a
				usage();
Packit 994f1a
			break;
Packit 994f1a
		case 'i':
Packit 994f1a
			stoponerr = 0;
Packit 994f1a
			break;
Packit 994f1a
		case 'o':
Packit 994f1a
			diroff = strtoul(optarg, NULL, 0);
Packit 994f1a
			break;
Packit 994f1a
		case 'j':
Packit 994f1a
			flags |= TIFFPRINT_JPEGQTABLES |
Packit 994f1a
				 TIFFPRINT_JPEGACTABLES |
Packit 994f1a
				 TIFFPRINT_JPEGDCTABLES;
Packit 994f1a
			break;
Packit 994f1a
		case 'r':
Packit 994f1a
			rawdata = 1;
Packit 994f1a
			break;
Packit 994f1a
		case 's':
Packit 994f1a
			flags |= TIFFPRINT_STRIPS;
Packit 994f1a
			break;
Packit 994f1a
		case 'w':
Packit 994f1a
			showwords = 1;
Packit 994f1a
			break;
Packit 994f1a
		case 'z':
Packit 994f1a
			chopstrips = 1;
Packit 994f1a
			break;
Packit 994f1a
		case '?':
Packit 994f1a
			usage();
Packit 994f1a
			/*NOTREACHED*/
Packit 994f1a
		}
Packit 994f1a
	if (optind >= argc)
Packit 994f1a
		usage();
Packit 994f1a
	multiplefiles = (argc - optind > 1);
Packit 994f1a
	for (; optind < argc; optind++) {
Packit 994f1a
		if (multiplefiles)
Packit 994f1a
			printf("%s:\n", argv[optind]);
Packit 994f1a
		tif = TIFFOpen(argv[optind], chopstrips ? "rC" : "rc");
Packit 994f1a
		if (tif != NULL) {
Packit 994f1a
			if (dirnum != -1) {
Packit 994f1a
				if (TIFFSetDirectory(tif, (tdir_t) dirnum))
Packit 994f1a
					tiffinfo(tif, order, flags);
Packit 994f1a
			} else if (diroff != 0) {
Packit 994f1a
				if (TIFFSetSubDirectory(tif, diroff))
Packit 994f1a
					tiffinfo(tif, order, flags);
Packit 994f1a
			} else {
Packit 994f1a
				do {
Packit 994f1a
					uint32 offset;
Packit 994f1a
Packit 994f1a
					tiffinfo(tif, order, flags);
Packit 994f1a
					if (TIFFGetField(tif, TIFFTAG_EXIFIFD,
Packit 994f1a
							 &offset)) {
Packit 994f1a
						if (TIFFReadEXIFDirectory(tif, offset))
Packit 994f1a
							tiffinfo(tif, order, flags);
Packit 994f1a
					}
Packit 994f1a
				} while (TIFFReadDirectory(tif));
Packit 994f1a
			}
Packit 994f1a
			TIFFClose(tif);
Packit 994f1a
		}
Packit 994f1a
	}
Packit 994f1a
	return (0);
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
char* stuff[] = {
Packit 994f1a
"usage: tiffinfo [options] input...",
Packit 994f1a
"where options are:",
Packit 994f1a
" -D		read data",
Packit 994f1a
" -i		ignore read errors",
Packit 994f1a
" -c		display data for grey/color response curve or colormap",
Packit 994f1a
" -d		display raw/decoded image data",
Packit 994f1a
" -f lsb2msb	force lsb-to-msb FillOrder for input",
Packit 994f1a
" -f msb2lsb	force msb-to-lsb FillOrder for input",
Packit 994f1a
" -j		show JPEG tables",
Packit 994f1a
" -o offset	set initial directory offset",
Packit 994f1a
" -r		read/display raw image data instead of decoded data",
Packit 994f1a
" -s		display strip offsets and byte counts",
Packit 994f1a
" -w		display raw data in words rather than bytes",
Packit 994f1a
" -z		enable strip chopping",
Packit 994f1a
" -#		set initial directory (first directory is # 0)",
Packit 994f1a
NULL
Packit 994f1a
};
Packit 994f1a
Packit 994f1a
static void
Packit 994f1a
usage(void)
Packit 994f1a
{
Packit 994f1a
	char buf[BUFSIZ];
Packit 994f1a
	int i;
Packit 994f1a
Packit 994f1a
	setbuf(stderr, buf);
Packit 994f1a
        fprintf(stderr, "%s\n\n", TIFFGetVersion());
Packit 994f1a
	for (i = 0; stuff[i] != NULL; i++)
Packit 994f1a
		fprintf(stderr, "%s\n", stuff[i]);
Packit 994f1a
	exit(-1);
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
static void
Packit 994f1a
ShowStrip(tstrip_t strip, unsigned char* pp, uint32 nrow, tsize_t scanline)
Packit 994f1a
{
Packit 994f1a
	register tsize_t cc;
Packit 994f1a
Packit 994f1a
	printf("Strip %lu:\n", (unsigned long) strip);
Packit 994f1a
	while (nrow-- > 0) {
Packit 994f1a
		for (cc = 0; cc < scanline; cc++) {
Packit 994f1a
			printf(" %02x", *pp++);
Packit 994f1a
			if (((cc+1) % 24) == 0)
Packit 994f1a
				putchar('\n');
Packit 994f1a
		}
Packit 994f1a
		putchar('\n');
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
void
Packit 994f1a
TIFFReadContigStripData(TIFF* tif)
Packit 994f1a
{
Packit 994f1a
	unsigned char *buf;
Packit 994f1a
	tsize_t scanline = TIFFScanlineSize(tif);
Packit 994f1a
Packit 994f1a
	buf = (unsigned char *)_TIFFmalloc(TIFFStripSize(tif));
Packit 994f1a
	if (buf) {
Packit 994f1a
		uint32 row, h;
Packit 994f1a
		uint32 rowsperstrip = (uint32)-1;
Packit 994f1a
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &h);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_ROWSPERSTRIP, &rowsperstrip);
Packit 994f1a
		for (row = 0; row < h; row += rowsperstrip) {
Packit 994f1a
			uint32 nrow = (row+rowsperstrip > h ?
Packit 994f1a
			    h-row : rowsperstrip);
Packit 994f1a
			tstrip_t strip = TIFFComputeStrip(tif, row, 0);
Packit 994f1a
			if (TIFFReadEncodedStrip(tif, strip, buf, nrow*scanline) < 0) {
Packit 994f1a
				if (stoponerr)
Packit 994f1a
					break;
Packit 994f1a
			} else if (showdata)
Packit 994f1a
				ShowStrip(strip, buf, nrow, scanline);
Packit 994f1a
		}
Packit 994f1a
		_TIFFfree(buf);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
void
Packit 994f1a
TIFFReadSeparateStripData(TIFF* tif)
Packit 994f1a
{
Packit 994f1a
	unsigned char *buf;
Packit 994f1a
	tsize_t scanline = TIFFScanlineSize(tif);
Packit 994f1a
Packit 994f1a
	buf = (unsigned char *)_TIFFmalloc(TIFFStripSize(tif));
Packit 994f1a
	if (buf) {
Packit 994f1a
		uint32 row, h;
Packit 994f1a
		uint32 rowsperstrip = (uint32)-1;
Packit 994f1a
		tsample_t s, samplesperpixel;
Packit 994f1a
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &h);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_ROWSPERSTRIP, &rowsperstrip);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_SAMPLESPERPIXEL, &samplesperpixel);
Packit 994f1a
		for (row = 0; row < h; row += rowsperstrip) {
Packit 994f1a
			for (s = 0; s < samplesperpixel; s++) {
Packit 994f1a
				uint32 nrow = (row+rowsperstrip > h ?
Packit 994f1a
				    h-row : rowsperstrip);
Packit 994f1a
				tstrip_t strip = TIFFComputeStrip(tif, row, s);
Packit 994f1a
				if (TIFFReadEncodedStrip(tif, strip, buf, nrow*scanline) < 0) {
Packit 994f1a
					if (stoponerr)
Packit 994f1a
						break;
Packit 994f1a
				} else if (showdata)
Packit 994f1a
					ShowStrip(strip, buf, nrow, scanline);
Packit 994f1a
			}
Packit 994f1a
		}
Packit 994f1a
		_TIFFfree(buf);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
static void
Packit 994f1a
ShowTile(uint32 row, uint32 col, tsample_t sample,
Packit 994f1a
    unsigned char* pp, uint32 nrow, uint32 rowsize)
Packit 994f1a
{
Packit 994f1a
	uint32 cc;
Packit 994f1a
Packit 994f1a
	printf("Tile (%lu,%lu", (unsigned long) row, (unsigned long) col);
Packit 994f1a
	if (sample != (tsample_t) -1)
Packit 994f1a
		printf(",%u", sample);
Packit 994f1a
	printf("):\n");
Packit 994f1a
	while (nrow-- > 0) {
Packit 994f1a
		for (cc = 0; cc < rowsize; cc++) {
Packit 994f1a
			printf(" %02x", *pp++);
Packit 994f1a
			if (((cc+1) % 24) == 0)
Packit 994f1a
				putchar('\n');
Packit 994f1a
		}
Packit 994f1a
		putchar('\n');
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
void
Packit 994f1a
TIFFReadContigTileData(TIFF* tif)
Packit 994f1a
{
Packit 994f1a
	unsigned char *buf;
Packit 994f1a
	tsize_t rowsize = TIFFTileRowSize(tif);
Packit 994f1a
Packit 994f1a
	buf = (unsigned char *)_TIFFmalloc(TIFFTileSize(tif));
Packit 994f1a
	if (buf) {
Packit 994f1a
		uint32 tw, th, w, h;
Packit 994f1a
		uint32 row, col;
Packit 994f1a
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_IMAGEWIDTH, &w);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &h);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_TILEWIDTH, &tw);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_TILELENGTH, &th);
Packit 994f1a
		for (row = 0; row < h; row += th) {
Packit 994f1a
			for (col = 0; col < w; col += tw) {
Packit 994f1a
				if (TIFFReadTile(tif, buf, col, row, 0, 0) < 0) {
Packit 994f1a
					if (stoponerr)
Packit 994f1a
						break;
Packit 994f1a
				} else if (showdata)
Packit 994f1a
					ShowTile(row, col, (tsample_t) -1, buf, th, rowsize);
Packit 994f1a
			}
Packit 994f1a
		}
Packit 994f1a
		_TIFFfree(buf);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
void
Packit 994f1a
TIFFReadSeparateTileData(TIFF* tif)
Packit 994f1a
{
Packit 994f1a
	unsigned char *buf;
Packit 994f1a
	tsize_t rowsize = TIFFTileRowSize(tif);
Packit 994f1a
Packit 994f1a
	buf = (unsigned char *)_TIFFmalloc(TIFFTileSize(tif));
Packit 994f1a
	if (buf) {
Packit 994f1a
		uint32 tw, th, w, h;
Packit 994f1a
		uint32 row, col;
Packit 994f1a
		tsample_t s, samplesperpixel;
Packit 994f1a
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_IMAGEWIDTH, &w);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_IMAGELENGTH, &h);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_TILEWIDTH, &tw);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_TILELENGTH, &th);
Packit 994f1a
		TIFFGetField(tif, TIFFTAG_SAMPLESPERPIXEL, &samplesperpixel);
Packit 994f1a
		for (row = 0; row < h; row += th) {
Packit 994f1a
			for (col = 0; col < w; col += tw) {
Packit 994f1a
				for (s = 0; s < samplesperpixel; s++) {
Packit 994f1a
					if (TIFFReadTile(tif, buf, col, row, 0, s) < 0) {
Packit 994f1a
						if (stoponerr)
Packit 994f1a
							break;
Packit 994f1a
					} else if (showdata)
Packit 994f1a
						ShowTile(row, col, s, buf, th, rowsize);
Packit 994f1a
				}
Packit 994f1a
			}
Packit 994f1a
		}
Packit 994f1a
		_TIFFfree(buf);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
void
Packit 994f1a
TIFFReadData(TIFF* tif)
Packit 994f1a
{
Packit 994f1a
	uint16 config;
Packit 994f1a
Packit 994f1a
	TIFFGetField(tif, TIFFTAG_PLANARCONFIG, &config);
Packit 994f1a
	if (TIFFIsTiled(tif)) {
Packit 994f1a
		if (config == PLANARCONFIG_CONTIG)
Packit 994f1a
			TIFFReadContigTileData(tif);
Packit 994f1a
		else
Packit 994f1a
			TIFFReadSeparateTileData(tif);
Packit 994f1a
	} else {
Packit 994f1a
		if (config == PLANARCONFIG_CONTIG)
Packit 994f1a
			TIFFReadContigStripData(tif);
Packit 994f1a
		else
Packit 994f1a
			TIFFReadSeparateStripData(tif);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
static void
Packit 994f1a
ShowRawBytes(unsigned char* pp, uint32 n)
Packit 994f1a
{
Packit 994f1a
	uint32 i;
Packit 994f1a
Packit 994f1a
	for (i = 0; i < n; i++) {
Packit 994f1a
		printf(" %02x", *pp++);
Packit 994f1a
		if (((i+1) % 24) == 0)
Packit 994f1a
			printf("\n ");
Packit 994f1a
	}
Packit 994f1a
	putchar('\n');
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
static void
Packit 994f1a
ShowRawWords(uint16* pp, uint32 n)
Packit 994f1a
{
Packit 994f1a
	uint32 i;
Packit 994f1a
Packit 994f1a
	for (i = 0; i < n; i++) {
Packit 994f1a
		printf(" %04x", *pp++);
Packit 994f1a
		if (((i+1) % 15) == 0)
Packit 994f1a
			printf("\n ");
Packit 994f1a
	}
Packit 994f1a
	putchar('\n');
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
void
Packit 994f1a
TIFFReadRawData(TIFF* tif, int bitrev)
Packit 994f1a
{
Packit 994f1a
	tstrip_t nstrips = TIFFNumberOfStrips(tif);
Packit 994f1a
	const char* what = TIFFIsTiled(tif) ? "Tile" : "Strip";
Packit 994f1a
	uint32* stripbc;
Packit 994f1a
Packit 994f1a
	TIFFGetField(tif, TIFFTAG_STRIPBYTECOUNTS, &stripbc);
Packit 994f1a
	if (nstrips > 0) {
Packit 994f1a
		uint32 bufsize = stripbc[0];
Packit 994f1a
		tdata_t buf = _TIFFmalloc(bufsize);
Packit 994f1a
		tstrip_t s;
Packit 994f1a
Packit 994f1a
		for (s = 0; s < nstrips; s++) {
Packit 994f1a
			if (stripbc[s] > bufsize) {
Packit 994f1a
				buf = _TIFFrealloc(buf, stripbc[s]);
Packit 994f1a
				bufsize = stripbc[s];
Packit 994f1a
			}
Packit 994f1a
			if (buf == NULL) {
Packit 994f1a
				fprintf(stderr,
Packit 994f1a
				   "Cannot allocate buffer to read strip %lu\n",
Packit 994f1a
				    (unsigned long) s);
Packit 994f1a
				break;
Packit 994f1a
			}
Packit 994f1a
			if (TIFFReadRawStrip(tif, s, buf, stripbc[s]) < 0) {
Packit 994f1a
				fprintf(stderr, "Error reading strip %lu\n",
Packit 994f1a
				    (unsigned long) s);
Packit 994f1a
				if (stoponerr)
Packit 994f1a
					break;
Packit 994f1a
			} else if (showdata) {
Packit 994f1a
				if (bitrev) {
Packit 994f1a
					TIFFReverseBits(buf, stripbc[s]);
Packit 994f1a
					printf("%s %lu: (bit reversed)\n ",
Packit 994f1a
					    what, (unsigned long) s);
Packit 994f1a
				} else
Packit 994f1a
					printf("%s %lu:\n ", what,
Packit 994f1a
					    (unsigned long) s);
Packit 994f1a
				if (showwords)
Packit 994f1a
					ShowRawWords((uint16*) buf, stripbc[s]>>1);
Packit 994f1a
				else
Packit 994f1a
					ShowRawBytes((unsigned char*) buf, stripbc[s]);
Packit 994f1a
			}
Packit 994f1a
		}
Packit 994f1a
		if (buf != NULL)
Packit 994f1a
			_TIFFfree(buf);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
static void
Packit 994f1a
tiffinfo(TIFF* tif, uint16 order, long flags)
Packit 994f1a
{
Packit 994f1a
	TIFFPrintDirectory(tif, stdout, flags);
Packit 994f1a
	if (!readdata)
Packit 994f1a
		return;
Packit 994f1a
	if (rawdata) {
Packit 994f1a
		if (order) {
Packit 994f1a
			uint16 o;
Packit 994f1a
			TIFFGetFieldDefaulted(tif,
Packit 994f1a
			    TIFFTAG_FILLORDER, &o);
Packit 994f1a
			TIFFReadRawData(tif, o != order);
Packit 994f1a
		} else
Packit 994f1a
			TIFFReadRawData(tif, 0);
Packit 994f1a
	} else {
Packit 994f1a
		if (order)
Packit 994f1a
			TIFFSetField(tif, TIFFTAG_FILLORDER, order);
Packit 994f1a
		TIFFReadData(tif);
Packit 994f1a
	}
Packit 994f1a
}
Packit 994f1a
Packit 994f1a
/* vim: set ts=8 sts=8 sw=8 noet: */
Packit 994f1a
/*
Packit 994f1a
 * Local Variables:
Packit 994f1a
 * mode: c
Packit 994f1a
 * c-basic-offset: 8
Packit 994f1a
 * fill-column: 78
Packit 994f1a
 * End:
Packit 994f1a
 */