/* Copyright (C) 2001-2025 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.

*/

/* transparency processing for PDF-writing driver */

#include "gx.h"

#include "string_.h"

#include "gserrors.h"

#include "gstrans.h"

#include "gscolor2.h"

#include "gzstate.h"

#include "gdevpdfx.h"

#include "gdevpdfg.h"

#include "gdevpdfo.h"

#include "gsccolor.h"

static int

pdf_make_soft_mask_dict(gx_device_pdf * pdev, const gs_pdf14trans_params_t * pparams)

{

    pdf_resource_t *pres_soft_mask_dict = 0;

    cos_dict_t *soft_mask_dict;

    int code;

    /* Fixme : merge redundant objects. */

    code = pdf_alloc_resource(pdev, resourceSoftMaskDict, gs_no_id, &pres_soft_mask_dict, -1);

    if (code < 0)

        return code;

    cos_become(pres_soft_mask_dict->object, cos_type_dict);

    pdev->pres_soft_mask_dict = pres_soft_mask_dict;

    soft_mask_dict = (cos_dict_t *)pres_soft_mask_dict->object;

    code = cos_dict_put_c_key_string(soft_mask_dict, "/S",

            pparams->subtype == TRANSPARENCY_MASK_Alpha ? (byte *)"/Alpha" : (byte *)"/Luminosity",

            pparams->subtype == TRANSPARENCY_MASK_Alpha ? 6 : 11);

    if (code < 0)

        return code;

    if (pparams->Background_components) {

        cos_array_t *Background;

        Background = cos_array_from_floats(pdev, pparams->Background,

                    pparams->Background_components, "pdf_write_soft_mask_dict");

        if (Background == NULL)

            return_error(gs_error_VMerror);

        code = cos_dict_put_c_key_object(soft_mask_dict, "/BC", (cos_object_t *)Background);

        if (code < 0)

            return code;

    }

    if (pdev->CompatibilityLevel <= 1.7 && pparams->transfer_function != NULL && pdev->params.TransferFunctionInfo == tfi_Preserve) {

        int64_t id;

        char buf[20];

        code = pdf_write_function(pdev, pparams->transfer_function, &id);

        if (code < 0)

            return code;

        gs_snprintf(buf, sizeof(buf), " %"PRId64" 0 R", id);

        code = cos_dict_put_c_key_string(soft_mask_dict, "/TR", (const byte *)buf, strlen(buf));

        if (code < 0)

            return code;

    }

    return 0;

}

static int

pdf_make_group_dict(gx_device_pdf * pdev, const gs_pdf14trans_params_t * pparams,

                            const gs_gstate * pgs, cos_dict_t **pdict)

{

    pdf_resource_t *pres_group;

    cos_dict_t *group_dict;

    int code;

    cos_value_t cs_value;

    code = pdf_alloc_resource(pdev, resourceGroup, gs_no_id, &pres_group, -1);

    if (code < 0)

        return code;

    cos_become(pres_group->object, cos_type_dict);

    group_dict = (cos_dict_t *)pres_group->object;

    code = cos_dict_put_c_key_string(group_dict, "/Type", (const byte *)"/Group", 6);

    if (code < 0)

        return code;

    code = cos_dict_put_c_key_string(group_dict, "/S", (const byte *)"/Transparency", 13);

    if (code < 0)

        return code;

    if (pparams->Isolated) {

        code = cos_dict_put_c_key_bool(group_dict, "/I", true);

        if (code < 0)

            return code;

    }

    if (pparams->Knockout) {

        code = cos_dict_put_c_key_bool(group_dict, "/K", true);

        if (code < 0)

            return code;

    }

    /* Note that we should not add in the graphic state

       color space for the group color if there was not

       a group color specified.

       In this case, the parent group is inherited from

       the previous group or the device color space */

    if (pgs != NULL && pparams->ColorSpace != NULL) {

        const gs_color_space *cs = pparams->ColorSpace;

        if (pparams->ColorSpace == NULL)

            code = pdf_color_space_named(pdev, pgs, &cs_value, NULL, cs,

                    &pdf_color_space_names, false, NULL, 0, false);

        else

            code = pdf_color_space_named(pdev, pgs, &cs_value, NULL, pparams->ColorSpace,

                    &pdf_color_space_names, false, NULL, 0, false);

        if (code < 0)

            return code;

        code = cos_dict_put_c_key(group_dict, "/CS", &cs_value);

        if (code < 0)

            return code;

    }

    group_dict = NULL; /* The next line invalidates it. */

    code = pdf_substitute_resource(pdev, &pres_group, resourceGroup, NULL, false);

    if (code < 0)

        return code;

    pres_group->where_used |= pdev->used_mask;

    *pdict = (cos_dict_t *)pres_group->object;

    return 0;

}

static int

pdf_make_form_dict(gx_device_pdf * pdev, const gs_pdf14trans_params_t * pparams,

                            const gs_gstate * pgs,

                            const cos_dict_t *group_dict, cos_dict_t *form_dict)

{

    cos_array_t *bbox_array;

    float bbox[4];

    gs_rect bbox_rect;

    int code;

    code = gs_bbox_transform(&pparams->bbox, &ctm_only(pgs), &bbox_rect);

    if (code < 0)

        return code;

    bbox[0] = bbox_rect.p.x;

    bbox[1] = bbox_rect.p.y;

    bbox[2] = bbox_rect.q.x;

    bbox[3] = bbox_rect.q.y;

    code = cos_dict_put_c_key_string(form_dict, "/Type", (const byte *)"/XObject", 8);

    if (code < 0)

        return code;

    code = cos_dict_put_c_key_string(form_dict, "/Subtype", (const byte *)"/Form", 5);

    if (code < 0)

        return code;

    code = cos_dict_put_c_key_int(form_dict, "/FormType", 1);

    if (code < 0)

        return code;

    code = cos_dict_put_c_key_string(form_dict, "/Matrix", (const byte *)"[1 0 0 1 0 0]", 13);

    if (code < 0)

        return code;

    bbox_array = cos_array_from_floats(pdev, bbox, 4, "pdf_begin_transparency_group");

    if (bbox_array == NULL)

        return_error(gs_error_VMerror);

    code = cos_dict_put_c_key_object(form_dict, "/BBox", (cos_object_t *)bbox_array);

    if (code < 0)

        return code;

    if (pdev->PendingOC != 0) {

        if (pdev->CompatibilityLevel < 1.4999) {

            if (pdev->PDFA) {

                switch (pdev->PDFACompatibilityPolicy) {

                    case 0:

                        emprintf(pdev->memory,

                                 "Optional Content not valid in this version of PDF, reverting to normal PDF output\n");

                        pdev->AbortPDFAX = true;

                        pdev->PDFA = 0;

                        break;

                    case 1:

                        emprintf(pdev->memory,

                                 "Optional Content not valid in this version of PDF. Dropping feature to preserve PDF/A compatibility\n");

                        break;

                    case 2:

                        emprintf(pdev->memory,

                                 "Optional Content not valid in this version of PDF,  aborting conversion\n");

                        return_error (gs_error_typecheck);

                        break;

                    default:

                        emprintf(pdev->memory,

                                 "Optional Content not valid in this version of PDF, unrecognised PDFACompatibilityLevel,\nreverting to normal PDF output\n");

                        pdev->AbortPDFAX = true;

                        pdev->PDFA = 0;

                        break;

                }

            } else {

                emprintf(pdev->memory,

                         "Optional Content not valid in this version of PDF. Dropping feature to preserve compatibility\n");

            }

        } else {

            char str[256];

            gs_param_string param;

            cos_object_t *pco = NULL;

            param.data = (const byte *)pdev->PendingOC;

            param.size = strlen(pdev->PendingOC);

            code = pdf_refer_named(pdev, &param, &pco);

            if(code < 0)

                return code;

            gs_snprintf(str, sizeof(str), "%"PRId64" 0 R", pco->id);

            code = cos_dict_put_string_copy(form_dict, "/OC", str);

            if (code < 0)

                return code;

            gs_free_object(pdev->memory->non_gc_memory, pdev->PendingOC, "");

            pdev->PendingOC = NULL;

        }

    }

    return cos_dict_put_c_key_object(form_dict, "/Group", (cos_object_t *)group_dict);

}

static int

pdf_begin_transparency_group(gs_gstate * pgs, gx_device_pdf * pdev,

                                const gs_pdf14trans_params_t * pparams, bool page_group)

{

    cos_dict_t *group_dict;

    int code;

    if (pgs == NULL)

        return_error(gs_error_unregistered); /* Must not happen. */

    code = pdf_make_group_dict(pdev, pparams, pgs, &group_dict);

    if (code < 0)

        return code;

    code = pdf_open_page(pdev, PDF_IN_STREAM);

    if (code < 0)

        return code;

    code = pdf_check_soft_mask(pdev, pgs);

    if (code < 0)

        return code;

    if (pdf_must_put_clip_path(pdev, pgs->clip_path)) {

        code = pdf_put_clip_path(pdev, pgs->clip_path);

        if (code < 0)

            return code;

    }

    if (page_group)

        pdev->pages[pdev->next_page].group_id = group_dict->id;

    else if (pparams->image_with_SMask) {

        /* An internal group for the image implementation.

           See doimagesmask in gs/lib/pdf_draw.ps .

           Just set a flag for skipping pdf_end_transparency_group. */

        pdev->image_with_SMask |= 1 << ++pdev->FormDepth;

        pdev->PatternsSinceForm = 0;

    } else {

        pdf_resource_t *pres, *pres_gstate = NULL;

        cos_dict_t *pcd = NULL, *pcd_Resources = NULL;

        code = pdf_prepare_drawing(pdev, pgs, &pres_gstate, false);

        if (code < 0)

            return code;

        code = pdf_end_gstate(pdev, pres_gstate);

        if (code < 0)

            return code;

        code = pdf_enter_substream(pdev, resourceXObject,

                gs_no_id, &pres, false, pdev->params.CompressPages);

        if (code < 0)

            return code;

        pdev->FormDepth++;

        pdev->PatternsSinceForm = 0;

        code = pdf_make_form_dict(pdev, pparams, pgs, group_dict, (cos_dict_t *)pres->object);

        if (code < 0)

            return code;

        /* Create a Resources dictionary and add it to the form dictionary */

        pcd = cos_stream_dict((cos_stream_t *)pres->object);

        pcd_Resources = cos_dict_alloc(pdev, "pdf_group(Resources)");

        if (pcd == NULL || pcd_Resources == NULL)

            return_error(gs_error_VMerror);

        code = cos_dict_put_c_key_object(pcd, "/Resources", COS_OBJECT(pcd_Resources));

        pdev->substream_Resources = pcd_Resources;

        return code;

    }

    return 0;

}

static int

pdf_end_transparency_group(gs_gstate * pgs, gx_device_pdf * pdev)

{

    int bottom = (pdev->ResourcesBeforeUsage ? 1 : 0);

    if (!is_in_page(pdev) && pdev->sbstack_depth == 0)

        return 0;  /* A Group definition at the page level, handled separately. */

    if (pdev->image_with_SMask & (1 << pdev->FormDepth)) {

        /* An internal group for the image implementation.

           See pdf_begin_transparency_group. */

        pdev->image_with_SMask &= ~(1 << pdev->FormDepth--);

        pdev->PatternsSinceForm = 0;

        return 0;

    } else if (pdev->sbstack_depth == bottom) {

        /* We're closing the page group. */

        if (pdev->pages[pdev->next_page].group_id == 0)

            return_error(gs_error_unregistered); /* Must not happen. */

        return 0;

    } else {

        pdf_resource_t *pres = pdev->accumulating_substream_resource;

        int code;

        uint ignore;

        if (pres == NULL)

            return_error(gs_error_unregistered);

        pdev->FormDepth--;

        pdev->PatternsSinceForm = 0;

        code = pdf_exit_substream(pdev);

        if (code < 0)

            return code;

        code = pdf_substitute_resource(pdev, &pres, resourceXObject, NULL, false);

        if (code < 0)

            return code;

        /* We need to update the 'where_used' field, in case we substituted a resource */

        pres->where_used |= pdev->used_mask;

        sputc(pdev->strm,'/');

        sputs(pdev->strm, (const byte *)pres->rname, strlen(pres->rname), &ignore);

        sputs(pdev->strm, (const byte *)" Do\n", 4, &ignore);

        code = pdf_add_resource(pdev, pdev->substream_Resources, "/XObject", pres);

        return code;

    }

}

static int

pdf_begin_transparency_mask(gs_gstate * pgs, gx_device_pdf * pdev,

                                const gs_pdf14trans_params_t * pparams)

{

    if (pparams->subtype == TRANSPARENCY_MASK_None) {

        int code;

        pdf_resource_t *pres = 0L;

        /* reset the soft mask ID. Apparently this is only used by pdfwrite, if we don't

         * reset it, then the pdf_prepare_drawing code doesn't know that the SMask has

         * changed, and so doesn't write out the GState

         */

        pgs->soft_mask_id = 0;

        code = pdf_prepare_drawing(pdev, pgs, &pres, false);

        if (code == gs_error_interrupt) {

            /* */

            /* Not in an appropriate context.  Do not restore the soft_mask_id.

               Otherwise any group push that occurs following this will use that

               softmask, which clearly should be NONE here.

             */

            /* ignore return code, we don't care about this graphics state as we aren't

             * emitting it anyway

             */

            pdf_end_gstate(pdev, pres);

            return 0;

        }

        if (code < 0)

            return code;

        code = pdf_end_gstate(pdev, pres);

        if (code < 0)

            return code;

        return 0;

    }

    if (pparams->mask_is_image) {

        /* HACK :

            The control comes here when

            the PDF interpreter will make the PS interpreter

            to interprete the mask for filling the transparency buffer

            with an SMask image.

            Since we handle Type 3 images as a high level objects,

            we don't install the transparency buffer here

            and need to skip the image enumeration for the SMask.

            However we have no right method for skipping

            an image enumeration due to possible side effect

            of the image data proc in Postscript language.

            Therefore we do enumerate the image mask and accumulate

            it as a PDF stream, but don't create a reference to it.

            Later it will be enumerated once again as a part of SMask-ed image,

            and the pdfwrite image handler will recognize duplicated images

            and won't create the second stream for same image.

            We could make a special workaround for

            skipping mask images either in the graphics library or

            in the PS code of the PDF interpreter,

            but we don't want to complicate things now.

            The performance leak for the second enumeration

            shouldn't be harmful.

            So now just set a flag for pdf_end_and_do_image.

        */

        pdev->image_mask_skip = true;

        return 0;

    } else {

        int code;

        pdev->smask_construction = true;

        code = pdf_make_soft_mask_dict(pdev, pparams);

        if (code < 0)

            return code;

        code = pdf_open_page(pdev, PDF_IN_STREAM);

        if (code < 0)

            return code;

        return pdf_begin_transparency_group(pgs, pdev, pparams, 0);

    }

}

static int

pdf_end_transparency_mask(gs_gstate * pgs, gx_device_pdf * pdev,

                                const gs_pdf14trans_params_t * pparams)

{

    pdev->smask_construction = false;

    if (pdev->image_mask_skip)

        pdev->image_mask_skip = false;

    else {

        pdf_resource_t *pres = pdev->accumulating_substream_resource;

        int code;

        char buf[20];

        if (pres == NULL)

            return_error(gs_error_unregistered);

        code = pdf_exit_substream(pdev);

        if (code < 0)

            return code;

        code = pdf_substitute_resource(pdev, &pres, resourceXObject, NULL, false);

        if (code < 0)

            return 0;

        /* We need to update the 'where_used' field, in case we substituted a resource */

        pres->where_used |= pdev->used_mask;

        gs_snprintf(buf, sizeof(buf), "%"PRId64" 0 R", pdf_resource_id(pres));

        if (pdev->pres_soft_mask_dict == 0L) {

            /* something went horribly wrong, we have an 'end' wihtout a matching 'begin'

             * Give up, throw an error.

             */

            return_error(gs_error_undefined);

        }

        code = cos_dict_put_c_key_string((cos_dict_t *)pdev->pres_soft_mask_dict->object,

                "/G", (const byte *)buf, strlen(buf));

        if (code < 0)

            return code;

        code = pdf_substitute_resource(pdev, &pdev->pres_soft_mask_dict,

                                        resourceSoftMaskDict, NULL, false);

        if (code < 0)

            return code;

        pdev->pres_soft_mask_dict->where_used |= pdev->used_mask;

        pgs->soft_mask_id = pdev->pres_soft_mask_dict->object->id;

        pdev->pres_soft_mask_dict = NULL;

        /* We called pdf_start_trnasparency_group (see pdf_begin_transparency_mask

         * above) but we don't call pdf_end_transparency_group, so we must reduce

         * the FormDepth ourselves.

         */

        pdev->FormDepth--;

        pdev->PatternsSinceForm = 0;

    }

    return 0;

}

static int

pdf_set_blend_params(gs_gstate * pgs, gx_device_pdf * dev,

                                const gs_pdf14trans_params_t * pparams)

{

    return 0;

}

int

gdev_pdf_composite(gx_device *dev,

    gx_device **pcdev, const gs_composite_t *pct,

    gs_gstate *pgs, gs_memory_t *memory, gx_device *cdev)

{

    gx_device_pdf *pdev = (gx_device_pdf *)dev;

    if (pdev->HaveTransparency && pdev->CompatibilityLevel >= 1.4 &&

            pct->type->comp_id == GX_COMPOSITOR_PDF14_TRANS &&

            pdev->PDFA != 1) {

        gs_pdf14trans_t *pcte = (gs_pdf14trans_t *)pct;

        gs_pdf14trans_params_t *params = &pcte->params;

        *pcdev = dev;

        switch(params->pdf14_op) {

            case PDF14_PUSH_DEVICE:

                return 0;

            case PDF14_POP_DEVICE:

                return 0;

            case PDF14_ABORT_DEVICE:

                return 0;

            case PDF14_BEGIN_TRANS_PAGE_GROUP:

                return pdf_begin_transparency_group(pgs, pdev, params, 1);

            case PDF14_BEGIN_TRANS_GROUP:

                return pdf_begin_transparency_group(pgs, pdev, params, 0);

            case PDF14_END_TRANS_GROUP:

                return pdf_end_transparency_group(pgs, pdev);

            case PDF14_BEGIN_TRANS_TEXT_GROUP:

                return 0;

            case PDF14_END_TRANS_TEXT_GROUP:

                return 0;

            case PDF14_BEGIN_TRANS_MASK:

                return pdf_begin_transparency_mask(pgs, pdev, params);

            case PDF14_END_TRANS_MASK:

                return pdf_end_transparency_mask(pgs, pdev, params);

            case PDF14_SET_BLEND_PARAMS:

                return pdf_set_blend_params(pgs, pdev, params);

            case PDF14_PUSH_TRANS_STATE:

                return 0;

            case PDF14_POP_TRANS_STATE:

                return 0;

            case PDF14_PUSH_SMASK_COLOR:

                return 0;

            case PDF14_POP_SMASK_COLOR:

                return 0;

            default :

                return_error(gs_error_unregistered); /* Must not happen. */

        }

        return 0;

    }

    return psdf_composite(dev, pcdev, pct, pgs, memory, cdev);

}

/* We're not sure why the folllowing device methods are never called.

   Stub them for a while. */

int

gdev_pdf_begin_transparency_group(gx_device *dev,

    const gs_transparency_group_params_t *ptgp,

    const gs_rect *pbbox,

    gs_gstate *pgs, gs_memory_t *mem)

{

    return 0;

}

int

gdev_pdf_end_transparency_group(gx_device *dev,

    gs_gstate *pgs)

{

    return 0;

}

int

gdev_pdf_begin_transparency_mask(gx_device *dev,

    const gx_transparency_mask_params_t *ptmp,

    const gs_rect *pbbox,

    gs_gstate *pgs, gs_memory_t *mem)

{

    return 0;

}

int

gdev_pdf_end_transparency_mask(gx_device *dev,

    gs_gstate *pgs)

{

    return 0;

}