% SETZ Set the property 'z'.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DESCRIPTION: Set the property 'z'.
%
% CALL:              obj.setZ([1 2 3; 1 2 3]);
%              obj = obj.setZ([1 2 3; 1 2 3]); create copy of the object
%
% INPUTS:      obj - must be a single data3D object.
%
% VERSION:     $Id: setZ.m,v 1.6 2011/03/21 15:47:17 mauro Exp $
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

function varargout = setZ(varargin)

  obj = varargin{1};
  val = varargin{2};

  % decide whether we modify the object, or create a new one.
  obj = copy(obj, nargout);

  % set 'z'
  obj.z = val;

  varargout{1} = obj;
end