#!/bin/bash
#
# svg_convertPngToBranded.sh -- This function standardizes image
# branding. Once the base PNG image is rendered and the
# `--with-brands' option is provided, this function composites a new
# branded image using the preferences set in the related
# `branding.conf' file.  The `branding.conf' file must be stored
# inside the related design model component used as reference to
# produce the base PNG image.
#
# Copyright (C) 2009-2013 The CentOS Project
#
# This program 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.
#
# This program 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
# General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#
# ----------------------------------------------------------------------
# $Id$
# ----------------------------------------------------------------------

function svg_convertPngToBranded {

    # Verify whether the option `--with-brands' was provided or not to
    # `centos-art.sh' script command-line.
    if [[ $FLAG_WITH_BRANDS == 'false' ]];then
        return
    fi

    local BRANDING_CONF_FILE=''
    local BRANDING_CONF_SECTION=''
    local BRANDING_CONF_VALUES=''
    local BRANDING_CONF_VALUE=''
    local BRANDFILE=''
    local POSITION=''
    local POSITIONS=''

    # Define absolute path to branding configuration file.
    BRANDING_CONF_FILE="$(dirname ${TEMPLATE})/branding.conf"

    # Verify absolute path to branding configuration file. This is
    # required in order to avoid trying to render branded content
    # which doesn't have an associated `branding.conf' file. If there
    # is no associated `branding.conf' file don't stop the script
    # execution. Instead, continue with the next action in the list.
    # This is required in order to perform massive rendition inside
    # structures like themes where components might or might not have
    # `branding.conf' files associated. For example, the `Concept'
    # component doesn't have branding information associated but most
    # elements inside `Distro' component do.
    if [[ ! -f "$BRANDING_CONF_FILE" ]];then
        continue
    fi

    # Define regular expression matching the variable name (i.e., the
    # left column), inside the configuration line, you want to match
    # on.
    BRANDING_CONF_VARNAME=$(basename ${TEMPLATE})

    # Define list of configuration lines related to current design
    # model. This are the lines that tell us how and where to apply
    # branding information on base PNG image. Be sure that only
    # configuration lines from supported section names (e.g.,
    # `symbol', `type', `logo') be read, no need to waste resources
    # with others.
    BRANDING_CONF_VALUES=$(\
        for BRANDING_CONF_SECTION in $(echo "types symbols logos");do
            cli_getConfigValue "${BRANDING_CONF_FILE}" "${BRANDING_CONF_SECTION}" "${BRANDING_CONF_VARNAME}"
        done)

    for BRANDING_CONF_VALUE in $BRANDING_CONF_VALUES;do

        # Define absolute path to image file used as brand. This is
        # the image put over the PNG image produced as result of
        # design models base rendition.
        BRANDFILE=${TCAR_WORKDIR}/Identity/Images/Brands/$(echo $BRANDING_CONF_VALUE \
            | gawk 'BEGIN{ FS=":" } { print $1 }' )

        # Verify absolute path to image file used as brand. Assuming
        # no brand image file is found, continue with the next
        # configuration line.
        if [[ ! -f $BRANDFILE ]];then
            continue
        fi

        # Define list of positions using the format of ImageMagick
        # `-geometry' option argument. 
        POSITIONS=$(echo "$BRANDING_CONF_VALUE" | cut -d: -f2- | tr ':' ' ')

        # Loop through list of brand image positions and use the
        # composite command from ImageMagick, to overlap the unbranded
        # image just rendered with the branded version of itself.
        for POSITION in $POSITIONS;do
            composite -geometry ${POSITION} ${BRANDFILE} ${FILE}.png ${FILE}.png
        done

    done

}