/src/ffmpeg/libavcodec/fits.c

Source
/*
 * FITS implementation of common functions
 * Copyright (c) 2017 Paras Chadha
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg 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.
 *
 * FFmpeg 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 FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

#include <inttypes.h>
#include <limits.h>
#include <stdio.h>
#include <string.h>
#include "libavutil/dict.h"
#include "libavutil/error.h"
#include "libavutil/log.h"
#include "fits.h"

int avpriv_fits_header_init(FITSHeader *header, FITSHeaderState state)
{
    header->state = state;
    header->naxis_index = 0;
    header->naxis = 0;
    memset(header->naxisn, 0, sizeof(header->naxisn));
    header->blank_found = 0;
    header->pcount = 0;
    header->gcount = 1;
    header->groups = 0;
    header->rgb = 0;
    header->image_extension = 0;
    header->bscale = 1.0;
    header->bzero = 0;
    header->data_min_found = 0;
    header->data_max_found = 0;
    return 0;
}

static int dict_set_if_not_null(AVDictionary ***metadata, char *keyword, char *value)
{
    if (metadata)
        av_dict_set(*metadata, keyword, value, 0);
    return 0;
}

/**
 * Extract keyword and value from a header line (80 bytes) and store them in keyword and value strings respectively
 * @param ptr8 pointer to the data
 * @param keyword pointer to the char array in which keyword is to be stored
 * @param value pointer to the char array in which value is to be stored
 * @return 0 if calculated successfully otherwise AVERROR_INVALIDDATA
 */
static int read_keyword_value(const uint8_t *ptr8, char *keyword, char *value)
{
    int i;

    for (i = 0; i < 8 && ptr8[i] != ' '; i++) {
        keyword[i] = ptr8[i];
    }
    keyword[i] = '\0';

    if (ptr8[8] == '=') {
        i = 10;
        while (i < 80 && ptr8[i] == ' ') {
            i++;
        }

        if (i < 80) {
            *value++ = ptr8[i];
            i++;
            if (ptr8[i-1] == '\'') {
                for (; i < 80 && ptr8[i] != '\''; i++) {
                    *value++ = ptr8[i];
                }
                *value++ = '\'';
            } else if (ptr8[i-1] == '(') {
                for (; i < 80 && ptr8[i] != ')'; i++) {
                    *value++ = ptr8[i];
                }
                *value++ = ')';
            } else {
                for (; i < 80 && ptr8[i] != ' ' && ptr8[i] != '/'; i++) {
                    *value++ = ptr8[i];
                }
            }
        }
    }
    *value = '\0';
    return 0;
}

#define CHECK_KEYWORD(key) \
    if (strcmp(keyword, key)) { \
        av_log(avcl, AV_LOG_ERROR, "expected %s keyword, found %s = %s\n", key, keyword, value); \
        return AVERROR_INVALIDDATA; \
    }

#define CHECK_VALUE(key, val) \
    if (sscanf(value, "%d", &header->val) != 1) { \
        av_log(avcl, AV_LOG_ERROR, "invalid value of %s keyword, %s = %s\n", key, keyword, value); \
        return AVERROR_INVALIDDATA; \
    }

int avpriv_fits_header_parse_line(void *avcl, FITSHeader *header, const uint8_t line[80], AVDictionary ***metadata)
{
    int dim_no, ret;
    int64_t t;
    double d;
    char keyword[10], value[72], c;

    read_keyword_value(line, keyword, value);
    switch (header->state) {
    case STATE_SIMPLE:
        CHECK_KEYWORD("SIMPLE");

        if (value[0] == 'F') {
            av_log(avcl, AV_LOG_WARNING, "not a standard FITS file\n");
        } else if (value[0] != 'T') {
            av_log(avcl, AV_LOG_ERROR, "invalid value of SIMPLE keyword, SIMPLE = %c\n", value[0]);
            return AVERROR_INVALIDDATA;
        }

        header->state = STATE_BITPIX;
        break;
    case STATE_XTENSION:
        CHECK_KEYWORD("XTENSION");

        if (!strcmp(value, "'IMAGE   '")) {
            header->image_extension = 1;
        }

        header->state = STATE_BITPIX;
        break;
    case STATE_BITPIX:
        CHECK_KEYWORD("BITPIX");
        CHECK_VALUE("BITPIX", bitpix);

        switch(header->bitpix) {
        case   8:
        case  16:
        case  32: case -32:
        case  64: case -64: break;
        default:
            av_log(avcl, AV_LOG_ERROR, "invalid value of BITPIX %d\n", header->bitpix); \
            return AVERROR_INVALIDDATA;
        }

        dict_set_if_not_null(metadata, keyword, value);

        header->state = STATE_NAXIS;
        break;
    case STATE_NAXIS:
        CHECK_KEYWORD("NAXIS");
        CHECK_VALUE("NAXIS", naxis);
        dict_set_if_not_null(metadata, keyword, value);

        if (header->naxis) {
            header->state = STATE_NAXIS_N;
        } else {
            header->state = STATE_REST;
        }
        break;
    case STATE_NAXIS_N:
        ret = sscanf(keyword, "NAXIS%d", &dim_no);
        if (ret != 1 || dim_no != header->naxis_index + 1) {
            av_log(avcl, AV_LOG_ERROR, "expected NAXIS%d keyword, found %s = %s\n", header->naxis_index + 1, keyword, value);
            return AVERROR_INVALIDDATA;
        }

        if (sscanf(value, "%d", &header->naxisn[header->naxis_index]) != 1) {
            av_log(avcl, AV_LOG_ERROR, "invalid value of NAXIS%d keyword, %s = %s\n", header->naxis_index + 1, keyword, value);
            return AVERROR_INVALIDDATA;
        }

        dict_set_if_not_null(metadata, keyword, value);
        header->naxis_index++;
        if (header->naxis_index == header->naxis) {
            header->state = STATE_REST;
        }
        break;
    case STATE_REST:
        if (!strcmp(keyword, "BLANK") && sscanf(value, "%"SCNd64"", &t) == 1) {
            header->blank = t;
            header->blank_found = 1;
        } else if (!strcmp(keyword, "BSCALE") && sscanf(value, "%lf", &d) == 1) {
            if (d <= 0)
                return AVERROR_INVALIDDATA;
            header->bscale = d;
        } else if (!strcmp(keyword, "BZERO") && sscanf(value, "%lf", &d) == 1) {
            header->bzero = d;
        } else if (!strcmp(keyword, "CTYPE3") && !strncmp(value, "'RGB", 4)) {
            header->rgb = 1;
        } else if (!strcmp(keyword, "DATAMAX") && sscanf(value, "%lf", &d) == 1) {
            header->data_max_found = 1;
            header->data_max = d;
        } else if (!strcmp(keyword, "DATAMIN") && sscanf(value, "%lf", &d) == 1) {
            header->data_min_found = 1;
            header->data_min = d;
        } else if (!strcmp(keyword, "END")) {
            return 1;
        } else if (!strcmp(keyword, "GROUPS") && sscanf(value, "%c", &c) == 1) {
            header->groups = (c == 'T');
        } else if (!strcmp(keyword, "GCOUNT") && sscanf(value, "%"SCNd64"", &t) == 1) {
            if (t < 0 || t > INT_MAX)
                return AVERROR_INVALIDDATA;
            header->gcount = t;
        } else if (!strcmp(keyword, "PCOUNT") && sscanf(value, "%"SCNd64"", &t) == 1) {
            if (t < 0 || t > INT_MAX)
                return AVERROR_INVALIDDATA;
            header->pcount = t;
        }
        dict_set_if_not_null(metadata, keyword, value);
        break;
    }
    return 0;
}

Coverage Report

Created: 2026-04-01 07:42

Line	Count	Source
1		/*
2		* FITS implementation of common functions
3		* Copyright (c) 2017 Paras Chadha
4		*
5		* This file is part of FFmpeg.
6		*
7		* FFmpeg is free software; you can redistribute it and/or
8		* modify it under the terms of the GNU Lesser General Public
9		* License as published by the Free Software Foundation; either
10		* version 2.1 of the License, or (at your option) any later version.
11		*
12		* FFmpeg is distributed in the hope that it will be useful,
13		* but WITHOUT ANY WARRANTY; without even the implied warranty of
14		* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15		* Lesser General Public License for more details.
16		*
17		* You should have received a copy of the GNU Lesser General Public
18		* License along with FFmpeg; if not, write to the Free Software
19		* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20		*/
21
22		#include <inttypes.h>
23		#include <limits.h>
24		#include <stdio.h>
25		#include <string.h>
26		#include "libavutil/dict.h"
27		#include "libavutil/error.h"
28		#include "libavutil/log.h"
29		#include "fits.h"
30
31		int avpriv_fits_header_init(FITSHeader *header, FITSHeaderState state)
32	179k	{
33	179k	header->state = state;
34	179k	header->naxis_index = 0;
35	179k	header->naxis = 0;
36	179k	memset(header->naxisn, 0, sizeof(header->naxisn));
37	179k	header->blank_found = 0;
38	179k	header->pcount = 0;
39	179k	header->gcount = 1;
40	179k	header->groups = 0;
41	179k	header->rgb = 0;
42	179k	header->image_extension = 0;
43	179k	header->bscale = 1.0;
44	179k	header->bzero = 0;
45	179k	header->data_min_found = 0;
46	179k	header->data_max_found = 0;
47	179k	return 0;
48	179k	}
49
50		static int dict_set_if_not_null(AVDictionary **metadata, char keyword, char *value)
51	638k	{
52	638k	if (metadata)
53	175k	av_dict_set(*metadata, keyword, value, 0);
54	638k	return 0;
55	638k	}
56
57		/**
58		* Extract keyword and value from a header line (80 bytes) and store them in keyword and value strings respectively
59		* @param ptr8 pointer to the data
60		* @param keyword pointer to the char array in which keyword is to be stored
61		* @param value pointer to the char array in which value is to be stored
62		* @return 0 if calculated successfully otherwise AVERROR_INVALIDDATA
63		*/
64		static int read_keyword_value(const uint8_t ptr8, char keyword, char *value)
65	659k	{
66	659k	int i;
67
68	4.77M	for (i = 0; i < 8 && ptr8[i] != ' '; i++) {
69	4.11M	keyword[i] = ptr8[i];
70	4.11M	}
71	659k	keyword[i] = '\0';
72
73	659k	if (ptr8[8] == '=') {
74	105k	i = 10;
75	611k	while (i < 80 && ptr8[i] == ' ') {
76	505k	i++;
77	505k	}
78
79	105k	if (i < 80) {
80	104k	*value++ = ptr8[i];
81	104k	i++;
82	104k	if (ptr8[i-1] == '\'') {
83	119k	for (; i < 80 && ptr8[i] != '\''; i++) {
84	116k	*value++ = ptr8[i];
85	116k	}
86	2.89k	*value++ = '\'';
87	102k	} else if (ptr8[i-1] == '(') {
88	91.5k	for (; i < 80 && ptr8[i] != ')'; i++) {
89	90.1k	*value++ = ptr8[i];
90	90.1k	}
91	1.44k	*value++ = ')';
92	100k	} else {
93	2.76M	for (; i < 80 && ptr8[i] != ' ' && ptr8[i] != '/'; i++) {
94	2.66M	*value++ = ptr8[i];
95	2.66M	}
96	100k	}
97	104k	}
98	105k	}
99	659k	*value = '\0';
100	659k	return 0;
101	659k	}
102
103		#define CHECK_KEYWORD(key) \
104	43.4k	if (strcmp(keyword, key)) { \
105	2.84k	av_log(avcl, AV_LOG_ERROR, "expected %s keyword, found %s = %s\n", key, keyword, value); \
106	2.84k	return AVERROR_INVALIDDATA; \
107	2.84k	}
108
109		#define CHECK_VALUE(key, val) \
110	37.8k	if (sscanf(value, "%d", &header->val) != 1) { \
111	597	av_log(avcl, AV_LOG_ERROR, "invalid value of %s keyword, %s = %s\n", key, keyword, value); \
112	597	return AVERROR_INVALIDDATA; \
113	597	}
114
115		int avpriv_fits_header_parse_line(void avcl, FITSHeader header, const uint8_t line[80], AVDictionary ***metadata)
116	659k	{
117	659k	int dim_no, ret;
118	659k	int64_t t;
119	659k	double d;
120	659k	char keyword[10], value[72], c;
121
122	659k	read_keyword_value(line, keyword, value);
123	659k	switch (header->state) {
124	2.20k	case STATE_SIMPLE:
125	2.20k	CHECK_KEYWORD("SIMPLE");
126
127	2.10k	if (value[0] == 'F') {
128	4	av_log(avcl, AV_LOG_WARNING, "not a standard FITS file\n");
129	2.10k	} else if (value[0] != 'T') {
130	20	av_log(avcl, AV_LOG_ERROR, "invalid value of SIMPLE keyword, SIMPLE = %c\n", value[0]);
131	20	return AVERROR_INVALIDDATA;
132	20	}
133
134	2.08k	header->state = STATE_BITPIX;
135	2.08k	break;
136	724	case STATE_XTENSION:
137	724	CHECK_KEYWORD("XTENSION");
138
139	619	if (!strcmp(value, "'IMAGE '")) {
140	20	header->image_extension = 1;
141	20	}
142
143	619	header->state = STATE_BITPIX;
144	619	break;
145	22.6k	case STATE_BITPIX:
146	22.6k	CHECK_KEYWORD("BITPIX");
147	20.5k	CHECK_VALUE("BITPIX", bitpix);
148
149	20.3k	switch(header->bitpix) {
150	11.0k	case 8:
151	12.7k	case 16:
152	16.0k	case 32: case -32:
153	19.9k	case 64: case -64: break;
154	387	default:
155	387	av_log(avcl, AV_LOG_ERROR, "invalid value of BITPIX %d\n", header->bitpix); \
156	387	return AVERROR_INVALIDDATA;
157	20.3k	}
158
159	19.9k	dict_set_if_not_null(metadata, keyword, value);
160
161	19.9k	header->state = STATE_NAXIS;
162	19.9k	break;
163	17.8k	case STATE_NAXIS:
164	17.8k	CHECK_KEYWORD("NAXIS");
165	17.2k	CHECK_VALUE("NAXIS", naxis);
166	16.9k	dict_set_if_not_null(metadata, keyword, value);
167
168	16.9k	if (header->naxis) {
169	12.7k	header->state = STATE_NAXIS_N;
170	12.7k	} else {
171	4.19k	header->state = STATE_REST;
172	4.19k	}
173	16.9k	break;
174	22.9k	case STATE_NAXIS_N:
175	22.9k	ret = sscanf(keyword, "NAXIS%d", &dim_no);
176	22.9k	if (ret != 1 \|\| dim_no != header->naxis_index + 1) {
177	774	av_log(avcl, AV_LOG_ERROR, "expected NAXIS%d keyword, found %s = %s\n", header->naxis_index + 1, keyword, value);
178	774	return AVERROR_INVALIDDATA;
179	774	}
180
181	22.1k	if (sscanf(value, "%d", &header->naxisn[header->naxis_index]) != 1) {
182	233	av_log(avcl, AV_LOG_ERROR, "invalid value of NAXIS%d keyword, %s = %s\n", header->naxis_index + 1, keyword, value);
183	233	return AVERROR_INVALIDDATA;
184	233	}
185
186	21.9k	dict_set_if_not_null(metadata, keyword, value);
187	21.9k	header->naxis_index++;
188	21.9k	if (header->naxis_index == header->naxis) {
189	11.1k	header->state = STATE_REST;
190	11.1k	}
191	21.9k	break;
192	592k	case STATE_REST:
193	592k	if (!strcmp(keyword, "BLANK") && sscanf(value, "%"SCNd64"", &t) == 1) {
194	2.47k	header->blank = t;
195	2.47k	header->blank_found = 1;
196	590k	} else if (!strcmp(keyword, "BSCALE") && sscanf(value, "%lf", &d) == 1) {
197	933	if (d <= 0)
198	199	return AVERROR_INVALIDDATA;
199	734	header->bscale = d;
200	589k	} else if (!strcmp(keyword, "BZERO") && sscanf(value, "%lf", &d) == 1) {
201	371	header->bzero = d;
202	588k	} else if (!strcmp(keyword, "CTYPE3") && !strncmp(value, "'RGB", 4)) {
203	607	header->rgb = 1;
204	588k	} else if (!strcmp(keyword, "DATAMAX") && sscanf(value, "%lf", &d) == 1) {
205	803	header->data_max_found = 1;
206	803	header->data_max = d;
207	587k	} else if (!strcmp(keyword, "DATAMIN") && sscanf(value, "%lf", &d) == 1) {
208	945	header->data_min_found = 1;
209	945	header->data_min = d;
210	586k	} else if (!strcmp(keyword, "END")) {
211	11.3k	return 1;
212	575k	} else if (!strcmp(keyword, "GROUPS") && sscanf(value, "%c", &c) == 1) {
213	897	header->groups = (c == 'T');
214	574k	} else if (!strcmp(keyword, "GCOUNT") && sscanf(value, "%"SCNd64"", &t) == 1) {
215	1.49k	if (t < 0 \|\| t > INT_MAX)
216	568	return AVERROR_INVALIDDATA;
217	929	header->gcount = t;
218	572k	} else if (!strcmp(keyword, "PCOUNT") && sscanf(value, "%"SCNd64"", &t) == 1) {
219	1.71k	if (t < 0 \|\| t > INT_MAX)
220	588	return AVERROR_INVALIDDATA;
221	1.13k	header->pcount = t;
222	1.13k	}
223	579k	dict_set_if_not_null(metadata, keyword, value);
224	579k	break;
225	659k	}
226	641k	return 0;
227	659k	}