# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Library General Public
# License as published by the Free Software Foundation; either
# version 2 of the License, or (at your option) any later version.
#
# This library 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 Library General Public License for more details.
#
# You should have received a copy of the GNU Library General
# Public License along with this library; if not, write to the
# Free Foundation, Inc., 59 Temple Place, Suite 330, Boston,
# MA  02111-1307  USA

# Copyrights (C)
# for this R-port: 
#   1999 - Diethelm Wuertz, GPL
#   2007 - Rmetrics Foundation, GPL
#   Diethelm Wuertz <wuertz@phys.ethz.ch>
#   www.rmetrics.org
# for the code accessed (or partly included) from other R-ports:
#   see R's copyright and license files
# for the code accessed (or partly included) from contributed R-ports
# and other sources
#   see Rmetrics's copyright file


################################################################################
# FUNCTION:                 DESCRIPTION:
#  plot.timeDate             Plots 'timeDate' object
#  points.timeDate           Adds points to a 'timeDate' plot
#  lines.timeDate            Adds lines to a 'timeDate' plot
#  axis.timeDate             Adds an Axis to a Plot
################################################################################


## DW
##  These S3 methods should become S4 methods ...


# ------------------------------------------------------------------------------


plot.timeDate <- 
    function(x, y, ...)
{   
    # A function implemented by Diethelm Wuertz

    # Note:
    #   Doesn't yet support the features of timeDate objects ...
 
    # FUNCTION:
    
    # Plot:
    plot(as.POSIXct(x), y, ...)
}


# ------------------------------------------------------------------------------


points.timeDate <- 
    function(x, y, ...)
{   
    # A function implemented by Diethelm Wuertz

    # FUNCTION:
    
    # Note:
    #   Doesn't yet support the features of timeDate objects ...
    
    # Add Points:
    points(as.POSIXct(x), y, ...)
}


# ------------------------------------------------------------------------------


lines.timeDate <- 
    function(x, y, ...)
{   
    # A function implemented by Diethelm Wuertz

    # FUNCTION:
    
    # Note:
    #   Doesn't yet support the features of timeDate objects ...
    
    # Add Lines:
    lines(as.POSIXct(x), y, ...)
}


# ------------------------------------------------------------------------------


axis.timeDate <-
    function(side, x, at, format = NULL, labels = TRUE, ...)
{
    # A function implemented by Diethelm Wuertz
    
    # Arguments:
    #   side - an integer specifying which side of the plot the axis 
    #       is to be drawn on. The axis is placed as follows: 
    #       1=below, 2=left, 3=above and 4=right.
    #   x - a 'timeDate' object
    #   at - a 'timeDate' object
    #   format - format string  
    #   labels - either a logical value specifying whether annotations 
    #       are to be made at the tickmarks, or a vector of character
    #       strings to be placed at the tickpoints. 
    #   ... - further arguments to be passed from or to other methods, 
    #       typically graphical parameters or arguments of plot.default. 
    #       For the plot methods, also format. 

    # FUNCTION:
    
    # Format:
    if (is.null(format)) format = whichFormat(x)
    
    # Add Axis:
    axis.POSIXct(side = side, x = as.POSIXct(x), at = as.POSIXct(at), 
        format = format, labels = TRUE, ...)
        
    # Return Value:
    invisible()
    
}


################################################################################