gp_pixel.h

Go to the documentation of this file.

// SPDX-License-Identifier: LGPL-2.1-or-later
/*
 * Copyright (C) 2009-2010 Jiri "BlueBear" Dluhos
 *                         <jiri.bluebear.dluhos@gmail.com>
 *
 * Copyright (C) 2009-2024 Cyril Hrubis <metan@ucw.cz>
 *
 * Copyright (C) 2011      Tomas Gavenciak <gavento@ucw.cz>
 */
 
#ifndef CORE_GP_PIXEL_H
#define CORE_GP_PIXEL_H
 
#include <stdint.h>
 
#include <core/gp_types.h>
#include <core/gp_common.h>
 
#define GP_PIXEL_BITS (sizeof(gp_pixel) * 8)
 
#include <core/gp_pixel.gen.h>
#include <core/gp_pixel_channel.gen.h>
#include <core/gp_pixel_alias.h>
#include <core/gp_get_set_bits.h>
 
typedef struct gp_pixel_channel {
        char name[8];
        uint8_t offset;
        uint8_t size;
        uint8_t lin_size;
} gp_pixel_channel;
 
typedef enum gp_pixel_flags {
        GP_PIXEL_HAS_ALPHA = 0x01,
        GP_PIXEL_IS_RGB = 0x02,
        GP_PIXEL_IS_PALETTE = 0x04,
        GP_PIXEL_IS_CMYK = 0x08,
        GP_PIXEL_IS_GRAYSCALE = 0x10,
} gp_pixel_flags;
 
struct gp_pixel_type_desc {
        gp_pixel_type type;
        const char name[16];
        uint8_t size;
        uint8_t pack;
        uint8_t numchannels;
        gp_pixel_flags flags;
        const char bitmap[GP_PIXEL_BITS + 1];
        const gp_pixel_channel channels[GP_PIXEL_CHANS_MAX];
};
 
extern const gp_pixel_type_desc gp_pixel_types[GP_PIXEL_MAX];
 
#define GP_VALID_PIXELTYPE(type) (((type) > 0) && ((type) < GP_PIXEL_MAX))
 
#define GP_CHECK_VALID_PIXELTYPE(type) \
        GP_CHECK(GP_VALID_PIXELTYPE(type), "Invalid PixelType %d", (type))
 
/*
 * Convert pixel type to name.
 */
static inline const char *gp_pixel_type_name(gp_pixel_type type)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].name;
}
 
/*
 * Returns number of bits per pixel.
 */
static inline uint32_t gp_pixel_size(gp_pixel_type type)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].size;
}
 
static inline const gp_pixel_type_desc *gp_pixel_desc(gp_pixel_type type)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return &gp_pixel_types[type];
}
 
static inline unsigned int gp_pixel_channel_count(gp_pixel_type type)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].numchannels;
}
 
static inline uint8_t gp_pixel_channel_bits(gp_pixel_type type, uint8_t channel)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].channels[channel].size;
}
 
static inline uint8_t gp_pixel_channel_lin_bits(gp_pixel_type type, uint8_t channel)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].channels[channel].lin_size;
}
 
static inline const char *gp_pixel_channel_name(gp_pixel_type type,
                                                uint8_t channel)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].channels[channel].name;
}
 
static inline int gp_pixel_channel_is_alpha(gp_pixel_type type,
                                            uint8_t channel)
{
        GP_CHECK_VALID_PIXELTYPE(type);
        return gp_pixel_types[type].channels[channel].name[0] == 'A';
}
 
/*
 * Print a human-readable representation of a pixel value to a string.
 * Arguments as for snprintf().
 */
void gp_pixel_snprint(char *buf, size_t len, gp_pixel pixel, gp_pixel_type type);
 
/*
 * Prints human-readable representation of pixel value into the stdout.
 */
void gp_pixel_print(gp_pixel pixel, gp_pixel_type type);
 
/*
 * Returns pixel type for passed human-readable name (e.g. RGB888).
 */
gp_pixel_type gp_pixel_type_by_name(const char *name);
 
gp_pixel_type gp_pixel_rgb_match(gp_pixel rmask, gp_pixel gmask,
                                 gp_pixel bmask, gp_pixel amask,
                                 uint8_t bits_per_pixel);
 
gp_pixel_type gp_pixel_rgb_lookup(uint32_t rsize, uint32_t roff,
                                  uint32_t gsize, uint32_t goff,
                                  uint32_t bsize, uint32_t boff,
                                  uint32_t asize, uint32_t aoff,
                                  uint8_t bits_per_pixel);
 
int gp_pixel_has_flags(gp_pixel_type pixel_type, gp_pixel_flags flags);
 
gp_pixel gp_pixel_chan_mask(gp_pixel_type pixel_type, const char *chan_name);
 
gp_pixel gp_pixel_chans_add(gp_pixel_type pixel_type, gp_pixel pixel, int add);
 
#endif /* CORE_GP_PIXEL_H */