vector/Vlib/color_read.c

Go to the documentation of this file.

/*!
   \file lib/vector/Vlib/color_read.c
 
   \brief Vector Library - read color table of vector map
 
   SPDX-FileCopyrightText: 2011 GRASS Development Team
   SPDX-License-Identifier: GPL-2.0-or-later
 
   \author Martin Landa <landa.martin gmail.com>
 */
 
#include <string.h>
 
#include <grass/gis.h>
#include <grass/raster.h>
#include <grass/vector.h>
#include <grass/glocale.h>
 
/*!
   \brief Read color table of vector map
 
   The color table for the vector map <i>name</i> in the specified
   <i>mapset</i> is read into the <i>colors</i> structure.
 
   Note: If a secondary color file for map name <i>name</i> exists in
   the current mapset, that color file is read. This allows the user to
   define their own color lookup tables for vector maps found in other
   mapsets.
 
   Warning message is printed if the color file is missing or invalid.
 
   \param name vector map name
   \param mapset mapset name ("" for search path)
   \param[out] colors pointer to Colors structure (can be NULL)
 
   \return -1 on error
   \return 0 if color table missing
   \return 1 on success (color table found)
 */
int Vect_read_colors(const char *name, const char *mapset,
                     struct Colors *colors)
{
    int ret;
    char buf[GPATH_MAX];
    char xname[GNAME_MAX];
 
    if (colors)
        Rast_init_colors(colors);
 
    if (G_strlcpy(xname, name, sizeof(xname)) >= sizeof(xname)) {
        G_warning(_("Vector map name <%s> is too long"), name);
        return -1;
    }
    mapset = G_find_vector(xname, mapset);
    if (!mapset)
        return -1;
 
    name = xname;
 
    /* look for secondary color table in current mapset */
    (void)snprintf(buf, sizeof(buf), "%s/%s", GV_COLR2_DIRECTORY, mapset);
    if (Rast__read_colors(buf, name, G_mapset(), colors) >= 0)
        return 1;
 
    /* look for the regular color table */
    (void)snprintf(buf, sizeof(buf), "%s/%s", GV_DIRECTORY, name);
    ret = Rast__read_colors(buf, GV_COLR_ELEMENT, mapset, colors);
    if (ret >= 0)
        return 1;
 
    if (ret == -2)
        return 0;
 
    return ret;
}