hl-input-tray.h

Go to the documentation of this file.

/*
 * SPDX-License-Identifier: GPL-2.0-or-later
 *
 * (c) 2020 Juergen Borleis <projects@caps-printing.org>
 *
 * This library is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free
 * Software Foundation; either version 2 of the License, or (at your option)
 * any later version.
 */
 
#if 0
/*
 * "AUTO" always means autoselect between TRAY1 and MANUAL
 *
 * AUTO:
 * @PJL SET SOURCETRAY = AUTO                 <-- the printer selects the source from the given info
 * @PJL SET LPARM:PCL PAPER = <format-name>   <-- paper format to print to
 * @PJL SET TRAY1SIZE = <format-name>         <-- paper format loaded in the tray
 * @PJL SET MANUALFEED = ON                   <-- printer is allowed to select the manual feed if the format to print to isn't in the tray
 *
 * TRAY1:
 * @PJL SET SOURCETRAY = TRAY1                <-- the printer is forced to use the paper from the tray
 * @PJL SET LPARM:PCL PAPER = <format-name>   <-- paper format to print to
 * @PJL SET TRAY1SIZE = <format-name>         <-- paper format loaded in the tray
 * @PJL SET MANUALFEED = OFF                  <-- printer isn't allowed to select the source itself
 *
 * MANUAL:
 * @PJL SET SOURCETRAY = AUTO                 <-- the printer selects the source from the given info
 * @PJL SET LPARM:PCL PAPER = <format-name>   <-- paper format to print to
 * @PJL SET TRAY1SIZE = <format-name>         <-- paper format loaded in the tray
 * @PJL SET MANUALFEED = ON                   <-- printer is allowed to select the manual feed if the format to print to isn't in the tray
 * FIXME How to force the manual feed if the same paper format is loaded in the tray?
 *
 * Ist MANUALFEED nur, um den manuellen Einzug "freizuschalten"? Dann wären es vermutlich nur diese
 * zwei Kombinationen:
 *
 * TRAY1:
 * @PJL SET SOURCETRAY = TRAY1                <-- the printer is forced to use the paper from the tray
 * @PJL SET LPARM:PCL PAPER = <format-name>   <-- paper format to print to
 * @PJL SET TRAY1SIZE = <format-name>         <-- paper format loaded in the tray
 * @PJL SET MANUALFEED = OFF                  <-- printer isn't allowed to select the source itself
 *
 * MANUAL:
 * @PJL SET SOURCETRAY = AUTO                 <-- the printer selects the source from the given info
 * @PJL SET LPARM:PCL PAPER = <format-name>   <-- paper format to print to
 * @PJL SET TRAY1SIZE = <format-name>         <-- paper format loaded in the tray
 * @PJL SET MANUALFEED = ON                   <-- printer is allowed to select the manual feed if the format to print to isn't in the tray
 *
 * Es ist natürlich auch möglich, die erste Seite manuell einzuziehen und die weiteren aus dem Papierfach
 * (das bietet der Windows-Treiber an). -> dann müsste das vor jeder Seite geändert werden.
 *
 * Der Treiber hier im Original sendet auch MANUAL als SOURCETRAY. Vielleicht stimmt das ja auch und
 * die ausgelesenen Daten aus dem Drucker stimmen an der Stelle nicht.
 */
static const struct caps_ppd_selection_entry hl20_input_tray_selections[] = {
    { .option = "Auto", .description = NLS_("Auto Select"), .value = "AUTO", },
    { .option = "TRAY", .description = NLS_("Tray"), .value = "TRAY1", },
    { .option = "MANUAL", .description = NLS_("Manual Feed"), .value = "MANUAL", },
};
 
static struct caps_ppd_selection hl20_input_tray_selection = {
    .option_type = LIBCAPS_OT_PICKONE,
    .option = "InputSlot",
    .description =  NLS_("Paper Source"),
    .entry_count = ARRAY_SIZE(hl20_input_tray_selections),
    .default_entry = 0, 
    .entries = hl20_input_tray_selections,
};
 
static __nonnull() void hl20_adapt_input_tray(struct brother_doc *info)
{
    static struct caps_ppd_option one_type_only[] = {
        { .keyword = "DefaultInputSlot", .value = NULL, },
        { .keyword = "InputSlot", .name = NULL, .description = NLS_("Paper Source"), .value = NULL, },
    };
    const char *input_slot, *default_input_slot;
    ssize_t idx;
 
    input_slot = hl_setup_value_get(info->instance, "paper", "type");
    if (input_slot != NULL) {
        /* the user has pre-selected one paper type in its INI, use it as the default */
 
        /* user has selected one, validate it */
        idx = hl_selection_entry_get(hl20_paper_type_selections, ARRAY_SIZE(hl20_paper_type_selections), paper_type);
        if (idx < 0) {
            /* user's selection is invalid, fall back to the default */
            caps_assert(drv_spl2_media_type_selection.default_entry <= SSIZE_MAX);
            idx = (ssize_t)drv_spl2_media_type_selection.default_entry;
            caps_print_warn(_("Unknown paper type '%s', falling back to '%s'\n"), paper_type, hl20_paper_type_selections[idx].option);
        } else {
            /* user's selection is valid, use it */
            caps_print_noisy(_("Using predefined paper type '%s'\n"), paper_type);
        }
        one_type_only[0].value = hl20_paper_type_selections[idx].option;
        one_type_only[1].name = hl20_paper_type_selections[idx].option;
        one_type_only[1].value = hl20_paper_type_selections[idx].value;
 
        /* add (invisible) options instead of the (useless) selection for this case */
        hl_options_add(&hl20_options, ARRAY_SIZE(one_type_only), one_type_only);
        return;
    }
 
    /* no predefined paper type, thus, we add the full selection to the PPD */
    hl_feature_selection_add(&hl20_featuresX, &hl20_media_type_selection);
 
    /* if we have the list of paper types, we need its default as well */
    default_paper_type = hl_setup_value_get(info->instance, "paper", "default_type");
    if (default_paper_type == NULL) {
        idx = 0; /* keep "PLAIN" as the default */
        goto fallback;
    }
 
    /* user has selected one, validate it and get its index */
    idx = hl_selection_entry_get(hl20_paper_type_selections, ARRAY_SIZE(hl20_paper_type_selections), default_paper_type);
    if (idx < 0) {
        caps_print_warn(_("Unknown paper type '%s', falling back to '%s'\n"), default_paper_type, hl20_paper_type_selections[0].option);
        idx = 0; /* keep "PLAIN" as the default */
    }
 
fallback:
    hl20_media_type_selection.default_entry = (size_t)idx;
}
#endif