/* Copyright (C) 2001-2026 Artifex Software, Inc.

   All Rights Reserved.

   This software is provided AS-IS with no warranty, either express or

   implied.

   This software is distributed under license and may not be copied,

   modified or distributed except as expressly authorized under the terms

   of the license contained in the file LICENSE in this distribution.

   Refer to licensing information at http://www.artifex.com or contact

   Artifex Software, Inc.,  39 Mesa Street, Suite 108A, San Francisco,

   CA 94129, USA, for further information.

*/

/* Separation color space and operation definition */

#include "memory_.h"

#include "gx.h"

#include "gserrors.h"

#include "gsfunc.h"

#include "gsrefct.h"

#include "gsmatrix.h"   /* for gscolor2.h */

#include "gscsepr.h"

#include "gxcspace.h"

#include "gxfixed.h"    /* for gxcolor2.h */

#include "gxcolor2.h"   /* for gs_indexed_map */

#include "gzstate.h"    /* for pgs->overprint */

#include "gscdevn.h"    /* for alloc_device_n_map */

#include "gxcdevn.h"    /* for gs_device_n_map_s */

#include "gxcmap.h"

#include "gxdevcli.h"

#include "gsovrc.h"

#include "stream.h"

#include "gsicc_cache.h"

#include "gxdevice.h"

#include "gxcie.h"

#include "gxdevsop.h"

/* ---------------- Color space ---------------- */

gs_private_st_composite(st_color_space_Separation, gs_color_space,

                        "gs_color_space_Separation",

                        cs_Separation_enum_ptrs, cs_Separation_reloc_ptrs);

/* Define the Separation color space type. */

static cs_proc_init_color(gx_init_Separation);

static cs_proc_concrete_space(gx_concrete_space_Separation);

static cs_proc_concretize_color(gx_concretize_Separation);

static cs_proc_remap_concrete_color(gx_remap_concrete_Separation);

static cs_proc_remap_color(gx_remap_Separation);

static cs_proc_install_cspace(gx_install_Separation);

static cs_proc_set_overprint(gx_set_overprint_Separation);

static cs_proc_final(gx_final_Separation);

static cs_proc_serialize(gx_serialize_Separation);

const gs_color_space_type gs_color_space_type_Separation = {

    gs_color_space_index_Separation, true, false,

    &st_color_space_Separation, gx_num_components_1,

    gx_init_Separation, gx_restrict01_paint_1,

    gx_concrete_space_Separation,

    gx_concretize_Separation, gx_remap_concrete_Separation,

    gx_remap_Separation, gx_install_Separation,

    gx_set_overprint_Separation,

    gx_final_Separation, gx_no_adjust_color_count,

    gx_serialize_Separation,

    gx_cspace_is_linear_default, gx_polarity_subtractive

};

/* GC procedures */

static

ENUM_PTRS_BEGIN(cs_Separation_enum_ptrs) return 0;

    ENUM_PTR(0, gs_color_space, params.separation.map);

ENUM_PTRS_END

static RELOC_PTRS_BEGIN(cs_Separation_reloc_ptrs)

{

    RELOC_PTR(gs_color_space, params.separation.map);

}

RELOC_PTRS_END

/* Get the concrete space for a Separation space. */

static const gs_color_space *

gx_concrete_space_Separation(const gs_color_space * pcs,

                             const gs_gstate * pgs)

{

    bool is_lab = false;

#ifdef DEBUG

    /*

     * Verify that the color space and gs_gstate info match.

     */

    if (pcs->id != pgs->color_component_map.cspace_id)

        dmprintf(pgs->memory, "gx_concretze_space_Separation: color space id mismatch");

#endif

    /*

     * Check if we are using the alternate color space.

     */

    if (pgs->color_component_map.use_alt_cspace) {

        /* Need to handle PS CIE space */

        if (gs_color_space_is_PSCIE(pcs->base_space)) {

            if (pcs->base_space->icc_equivalent == NULL) {

                (void)gs_colorspace_set_icc_equivalent(pcs->base_space,

                                                    &is_lab, pgs->memory);

            }

            return (pcs->base_space->icc_equivalent);

        }

        return cs_concrete_space(pcs->base_space, pgs);

    }

    /*

     * Separation color spaces are concrete (when not using alt. color space).

     */

    return pcs;

}

static int

check_Separation_component_name(const gs_color_space * pcs, gs_gstate * pgs);

/* Check if the colorant is a process colorant */

static separation_colors

gx_check_process_names_Separation(gs_color_space * pcs, gs_gstate * pgs)

{

    byte *pname = (byte *)pcs->params.separation.sep_name;

    uint name_size = strlen(pcs->params.separation.sep_name);

    /* Classify */

    if (strncmp((char *)pname, "None", name_size) == 0 ||

        strncmp((char *)pname, "All", name_size) == 0) {

        return SEP_ENUM;

    } else {

        if (strncmp((char *)pname, "Cyan", name_size) == 0 ||

            strncmp((char *)pname, "Magenta", name_size) == 0 ||

            strncmp((char *)pname, "Yellow", name_size) == 0 ||

            strncmp((char *)pname, "Black", name_size) == 0) {

            return SEP_PURE_CMYK;

        } else if (strncmp((char *)pname, "Red", name_size) == 0 ||

            strncmp((char *)pname, "Green", name_size) == 0 ||

            strncmp((char *)pname, "Blue", name_size) == 0) {

            return SEP_PURE_RGB;

        } else {

            return SEP_MIX;

        }

    }

}

/* Install a Separation color space. */

static int

gx_install_Separation(gs_color_space * pcs, gs_gstate * pgs)

{

    int code;

    code = check_Separation_component_name(pcs, pgs);

    if (code < 0)

       return code;

    if (pgs->icc_manager->device_named != NULL) {

        pcs->params.separation.named_color_supported =

            gsicc_support_named_color(pcs, pgs);

    }

    pcs->params.separation.color_type =

        gx_check_process_names_Separation(pcs, pgs);

    gs_currentcolorspace_inline(pgs)->params.separation.use_alt_cspace =

        using_alt_color_space(pgs);

    if (gs_currentcolorspace_inline(pgs)->params.separation.use_alt_cspace) {

        code = (pcs->base_space->type->install_cspace)

            (pcs->base_space, pgs);

    } else {

        /*

         * Give the device an opportunity to capture equivalent colors for any

         * spot colors which might be present in the color space.

         */

        if (dev_proc(pgs->device, update_spot_equivalent_colors))

           code = dev_proc(pgs->device, update_spot_equivalent_colors)

                                                        (pgs->device, pgs, pcs);

    }

    return code;

}

/* Set the overprint information appropriate to a separation color space */

static int

gx_set_overprint_Separation(const gs_color_space * pcs, gs_gstate * pgs)

{

    gs_devicen_color_map *  pcmap = &pgs->color_component_map;

    if (pcmap->use_alt_cspace)

        return gx_set_no_overprint(pgs);

    else {

        gs_overprint_params_t params = { 0 };

        params.retain_any_comps = (((pgs->overprint && pgs->is_fill_color) ||

                                   (pgs->stroke_overprint && !pgs->is_fill_color)) &&

                                   (pcs->params.separation.sep_type != SEP_ALL));

        params.is_fill_color = pgs->is_fill_color;

        params.drawn_comps = 0;

        params.op_state = OP_STATE_NONE;

        if (params.retain_any_comps) {

            if (pcs->params.separation.sep_type != SEP_NONE) {

                if (pcs->params.separation.named_color_supported) {

                    /* This color will not actually be the device_n color any more.

                     * It will have been substituted with the named color replacement.

                     * Therefore the drawn comps will be different. */

                    /* FIXME: For now, we assume the replacement color uses

                     * C,M,Y and K. To do better, we'd either need to look at the

                     * device color (but this is problematic, as we may have scaled light

                     * components to 0), or we'd need to get this from the named color

                     * code itself. Possibly by another entry in color_component_map. */

                    params.drawn_comps = 15;

                } else {

                    int mcomp = pcmap->color_map[0];

                    if (mcomp >= 0)

                        gs_overprint_set_drawn_comp( params.drawn_comps, mcomp);

                }

            }

        }

        /* Only DeviceCMYK can use overprint mode */

        params.effective_opm = pgs->color[0].effective_opm = 0;

        return gs_gstate_update_overprint(pgs, &params);

    }

}

/* Finalize contents of a Separation color space. */

static void

gx_final_Separation(gs_color_space * pcs)

{

    rc_adjust_const(pcs->params.separation.map, -1,

                    "gx_adjust_Separation");

    pcs->params.separation.map = NULL;

    gs_free_object(pcs->params.separation.mem, pcs->params.separation.sep_name, "gx_final_Separation");

    pcs->params.separation.sep_name = NULL;

}

/* ------ Constructors/accessors ------ */

/*

 * Construct a new separation color space.

 */

int

gs_cspace_new_Separation(

    gs_color_space **ppcs,

    gs_color_space * palt_cspace,

    gs_memory_t * pmem

)

{

    gs_color_space *pcs;

    int code;

    if (palt_cspace == 0 || !palt_cspace->type->can_be_alt_space)

        return_error(gs_error_rangecheck);

    pcs = gs_cspace_alloc(pmem, &gs_color_space_type_Separation);

    if (pcs == NULL)

        return_error(gs_error_VMerror);

    pcs->params.separation.map = NULL;

    pcs->params.separation.named_color_supported = false;

    code = alloc_device_n_map(&pcs->params.separation.map, pmem,

                              "gs_cspace_build_Separation");

    if (code < 0) {

        gs_free_object(pmem, pcs, "gs_cspace_build_Separation");

        return_error(code);

    }

    pcs->base_space = palt_cspace;

    rc_increment_cs(palt_cspace);

    *ppcs = pcs;

    return 0;

}

#if 0 /* Unused; Unsupported by gx_serialize_device_n_map. */

/*

 * Set the tint transformation procedure used by a Separation color space.

 */

int

gs_cspace_set_sepr_proc(gs_color_space * pcspace,

                        int (*proc)(const float *,

                                    float *,

                                    const gs_gstate *,

                                    void *

                                    ),

                        void *proc_data

                        )

{

    gs_device_n_map *pimap;

    if (gs_color_space_get_index(pcspace) != gs_color_space_index_Separation)

        return_error(gs_error_rangecheck);

    pimap = pcspace->params.separation.map;

    pimap->tint_transform = proc;

    pimap->tint_transform_data = proc_data;

    pimap->cache_valid = false;

    return 0;

}

#endif

/*

 * Set the Separation tint transformation procedure to a Function.

 */

int

gs_cspace_set_sepr_function(const gs_color_space *pcspace, gs_function_t *pfn)

{

    gs_device_n_map *pimap;

    if (gs_color_space_get_index(pcspace) != gs_color_space_index_Separation ||

        pfn->params.m != 1 || pfn->params.n !=

          gs_color_space_num_components(pcspace->base_space)

        )

        return_error(gs_error_rangecheck);

    pimap = pcspace->params.separation.map;

    pimap->tint_transform = map_devn_using_function;

    pimap->tint_transform_data = pfn;

    pimap->cache_valid = false;

    return 0;

}

/*

 * If the Separation tint transformation procedure is a Function,

 * return the function object, otherwise return 0.

 */

gs_function_t *

gs_cspace_get_sepr_function(const gs_color_space *pcspace)

{

    if (gs_color_space_get_index(pcspace) == gs_color_space_index_Separation &&

        pcspace->params.separation.map->tint_transform ==

          map_devn_using_function)

        return pcspace->params.separation.map->tint_transform_data;

    return 0;

}

/* ------ Internal procedures ------ */

/* Initialize a Separation color. */

static void

gx_init_Separation(gs_client_color * pcc, const gs_color_space * pcs)

{

    pcc->paint.values[0] = 1.0;

}

/* Remap a Separation color. */

static int

gx_remap_Separation(const gs_client_color * pcc, const gs_color_space * pcs,

        gx_device_color * pdc, const gs_gstate * pgs, gx_device * dev,

                       gs_color_select_t select)

{

    int code = 0;

    bool mapped = false;

    if (pcs->params.separation.sep_type != SEP_NONE) {

        /* First see if we want to do a direct remap with a named color table.

           Note that this call occurs regardless of the alt color space boolean

           value.  A decision can be made in gsicc_transform_named_color to

           return false if you don't want those named colors to be mapped */

        if (pcs->params.separation.sep_type == SEP_OTHER &&

            pgs->icc_manager->device_named != NULL) {

            /* Try to apply the direct replacement */

            mapped = gx_remap_named_color(pcc, pcs, pdc, pgs, dev, select);

        }

        if (!mapped)

            code = gx_default_remap_color(pcc, pcs, pdc, pgs, dev, select);

    } else {

        color_set_null(pdc);

    }

    /* Save original color space and color info into dev color */

    pdc->ccolor.paint.values[0] = pcc->paint.values[0];

    pdc->ccolor_valid = true;

    return code;

}

static int

gx_concretize_Separation(const gs_client_color *pc, const gs_color_space *pcs,

                         frac *pconc, const gs_gstate *pgs, gx_device *dev)

{

    int code;

    gs_client_color cc;

    gs_color_space *pacs = pcs->base_space;

    bool is_lab;

    if (pcs->params.separation.sep_type == SEP_OTHER &&

        pcs->params.separation.use_alt_cspace) {

        gs_device_n_map *map = pcs->params.separation.map;

        /* Check the 1-element cache first. */

        if (map->cache_valid && map->tint[0] == pc->paint.values[0]) {

            int i, num_out = gs_color_space_num_components(pacs);

            for (i = 0; i < num_out; ++i)

                pconc[i] = map->conc[i];

            return 0;

        }

        code = (*pcs->params.separation.map->tint_transform)

            (pc->paint.values, &cc.paint.values[0],

             pgs, pcs->params.separation.map->tint_transform_data);

        if (code < 0)

            return code;

        (*pacs->type->restrict_color)(&cc, pacs);

        /* First check if this was PS based. */

        if (gs_color_space_is_PSCIE(pacs)) {

            /* We may have to rescale data to 0 to 1 range */

            rescale_cie_colors(pacs, &cc);

            /* If we have not yet created the profile do that now */

            if (pacs->icc_equivalent == NULL) {

                code = gs_colorspace_set_icc_equivalent(pacs, &(is_lab), pgs->memory);

                if (code < 0)

                   return code;

            }

            /* Use the ICC equivalent color space */

            pacs = pacs->icc_equivalent;

        }

        if (pacs->cmm_icc_profile_data &&

            (pacs->cmm_icc_profile_data->data_cs == gsCIELAB ||

            pacs->cmm_icc_profile_data->islab)) {

            /* Get the data in a form that is concrete for the CMM */

            cc.paint.values[0] /= 100.0;

            cc.paint.values[1] = (cc.paint.values[1]+128)/255.0;

            cc.paint.values[2] = (cc.paint.values[2]+128)/255.0;

        }

        return cs_concretize_color(&cc, pacs, pconc, pgs, dev);

    } else {

        pconc[0] = gx_unit_frac(pc->paint.values[0]);

    }

    return 0;

}

static int

gx_remap_concrete_Separation(const gs_color_space * pcs, const frac * pconc,

        gx_device_color * pdc, const gs_gstate * pgs, gx_device * dev,

                             gs_color_select_t select, const cmm_dev_profile_t *dev_profile)

{

#ifdef DEBUG

    /*

     * Verify that the color space and gs_gstate info match.

     */

    if (pcs->id != pgs->color_component_map.cspace_id)

        dmprintf(pgs->memory, "gx_remap_concrete_Separation: color space id mismatch");

#endif

    if (pgs->color_component_map.use_alt_cspace) {

        const gs_color_space *pacs = pcs->base_space;

        return (*pacs->type->remap_concrete_color)

                                (pacs, pconc, pdc, pgs, dev, select, dev_profile);

    } else {

        /* We need to determine if we did a direct color replacement */

        gx_remap_concrete_separation(pconc[0], pdc, pgs, dev, select, pcs);

        return 0;

    }

}

/*

 * Check that the color component name for a Separation color space

 * matches the device colorant names.  Also build a gs_devicen_color_map

 * structure.

 */

static int

check_Separation_component_name(const gs_color_space * pcs, gs_gstate * pgs)

{

    int colorant_number;

    byte *pname;

    uint name_size;

    gs_devicen_color_map * pcolor_component_map

        = &pgs->color_component_map;

    gx_device * dev = pgs->device;

    pcolor_component_map->num_components = 1;

    pcolor_component_map->cspace_id = pcs->id;

    pcolor_component_map->num_colorants = dev->color_info.num_components;

    pcolor_component_map->sep_type = pcs->params.separation.sep_type;

    /*

     * If this is a None or All separation then we do not need to

     * use the alternate color space.  Also if the named color

     * profile supports the component, don't use the alternate

     * tint transform. */

    if (pcs->params.separation.sep_type != SEP_OTHER ||

        gsicc_support_named_color(pcs, pgs)) {

        pcolor_component_map->use_alt_cspace = false;

        return 0;

    }

    /* If our device is using an additive color model, then we need to

     * consider using the alternative color space, as separations are

     * generally only used with a subtractive color model. There are

     * exceptions, however.

     *

     * If we don't support devn, then we will certainly have to use the

     * alternative color space.

     *

     * If we are a pdf14 device, and we are doing transparency blending

     * in an additive space, we need to keep the spots separated and

     * blend them individually as per the PDF specification. Note

     * however, if the spot is a CMYK process color and we are doing

     * the blend in an additive color space the alternate color space

     * is used.  This matches AR.

     *

     * Otherwise, we will always use the alternate colorspace, unless

     * our device specifically claims to be a separation-supporting

     * additive device. Possibly all additive devn devices should

     * support this now, but I lack to confidence to make this change

     * globally. Instead we'll just enable it on a device by device

     * basis for now.

     *

     * This matches logic in check_DeviceN_component_names.

     */

    if (dev->color_info.polarity == GX_CINFO_POLARITY_ADDITIVE) {

        if (dev_proc(dev, dev_spec_op)(dev, gxdso_supports_devn, NULL, 0) == 0 ||

            (dev_proc(dev, dev_spec_op)(dev, gxdso_is_pdf14_device, NULL, 0) == 0 &&

             dev_proc(dev, dev_spec_op)(dev, gxdso_is_sep_supporting_additive_device, NULL, 0) == 0)) {

            pcolor_component_map->use_alt_cspace = true;

            return 0;

        }

    }

    /*

     * Get the character string and length for the component name.

     */

    pname = (byte *)pcs->params.separation.sep_name;

    name_size = strlen(pcs->params.separation.sep_name);

    /*

     * Compare the colorant name to the device's.  If the device's

     * compare routine returns GX_DEVICE_COLOR_MAX_COMPONENTS then the

     * colorant is in the SeparationNames list but not in the

     * SeparationOrder list.

     */

    colorant_number = (*dev_proc(dev, get_color_comp_index))

                (dev, (const char *)pname, name_size, SEPARATION_NAME);

    if (colorant_number >= 0 && colorant_number < dev->color_info.max_components) {   /* If valid colorant name */

        pcolor_component_map->color_map[0] =

                    (colorant_number == GX_DEVICE_COLOR_MAX_COMPONENTS) ? -1

                                                           : colorant_number;

        pcolor_component_map->use_alt_cspace = false;

    }

    else

        pcolor_component_map->use_alt_cspace = true;

    return 0;

}

/* ---------------- Notes on real Separation colors ---------------- */

typedef ulong gs_separation;  /* BOGUS */

#define gs_no_separation ((gs_separation)(-1L))

#define dev_proc_lookup_separation(proc)\

  gs_separation proc(gx_device *dev, const byte *sname, uint len,\

    gx_color_value *num_levels)

#define dev_proc_map_tint_color(proc)\

  gx_color_index proc(gx_device *dev, gs_separation sepr, bool overprint,\

    gx_color_value tint)

/*

 * This next comment is outdated since the Separation color space no longer

 * has the multi element cache (lookup table) however the remainder is

 * still appropriate.

 *

 * In principle, setting a Separation color space, or setting the device

 * when the current color space is a Separation space, calls the

 * lookup_separation device procedure to obtain the separation ID and

 * the number of achievable levels.  Currently, the only hooks for doing

 * this are unsuitable: gx_set_cmap_procs isn't called when the color

 * space changes, and doing it in gx_remap_Separation is inefficient.

 * Probably the best approach is to call gx_set_cmap_procs whenever the

 * color space changes.  In fact, if we do this, we can probably short-cut

 * two levels of procedure call in color remapping (gx_remap_color, by

 * turning it into a macro, and gx_remap_DeviceXXX, by calling the

 * cmap_proc procedure directly).  Some care will be required for the

 * implicit temporary resetting of the color space in [color]image.

 */

/* ---------------- Serialization. -------------------------------- */

static int

gx_serialize_Separation(const gs_color_space * pcs, stream * s)

{

    const gs_separation_params * p = &pcs->params.separation;

    uint n;

    int code = gx_serialize_cspace_type(pcs, s);

    if (code < 0)

        return code;

    code = sputs(s, (const byte *)p->sep_name, strlen(p->sep_name) + 1, &n);

    if (code < 0)

        return code;

    code = cs_serialize(pcs->base_space, s);

    if (code < 0)

        return code;

    code = gx_serialize_device_n_map(pcs, p->map, s);

    if (code < 0)

        return code;

    return sputs(s, (const byte *)&p->sep_type, sizeof(p->sep_type), &n);

    /* p->use_alt_cspace isn't a property of the space. */

}