DCMAttributeTag.h

/*=========================================================================
  Program:   OsiriX

  Copyright (c) OsiriX Team
  All rights reserved.
  Distributed under GNU - GPL
  
  See http://www.osirix-viewer.com/copyright.html for details.

     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.
=========================================================================*/

#import <Foundation/Foundation.h>

/** \brief  DICOM Attribute Tag 
*
*  The DICOM  Attribute tags consist of a 4 byte group and a 4 byte element in hexadecimal notation
* Other properties are the VR value representation.  For implicit transfer syntaxes
* the VR is obtained from the dicom dictionary.  For explicit transfer syntaxes, the VR will be defined in the
* file/data.  The string valeu is the human readable definition of the tag.
*/
@interface DCMAttributeTag : NSObject {

	int  _group;
	int _element;
	NSString *_name;
	NSString *_vr;
	NSString *_stringValue;
	

}
@property(readonly) int group;
@property(readonly) int element;
@property(readonly) NSString *stringValue;
@property(readonly) BOOL isPrivate;
@property(readonly) long longValue;
@property(readonly) NSString *vr;
@property(readonly) NSString *name;
@property(readonly) NSString *description;

/** Create a tag with the defined group and element.*/
+ (id)tagWithGroup:(int)group element:(int)element;

/** Create a copy of a tag */
+ (id)tagWithTag:(DCMAttributeTag *)tag;

/** Create a tag  from a string representation of the element and tag\n
* Format for the string is 0xGGGG,0xEEEE
*/
+ (id)tagWithTagString:(NSString *)tagString;

/** Create a tag with the human readable name
* For Exmaple @"PatientsName.\n
* See the name dictionary for the list of names
*/
+ (id)tagWithName:(NSString *)name;

/** Initialize a tag with the defined group and element.*/
- (id)initWithGroup:(int)group element:(int)element;

/** Initialize a copy of a tag */
- (id)initWithTag:(DCMAttributeTag *)tag;

/** Create a tag  from a string representation of the element and tag\n
* Format for the string is oxGGGGEEEE
*/
- (id)initWithTagString:(NSString *)tagString;

/** Initialize a tag with the human readable name
* For Exmaple @"PatientsName.\n
* See the name dictionary for the list of names
*/
- (id)initWithName:(NSString *)name;


/** Compare tags. Used for sorting */
- (NSComparisonResult)compare:(DCMAttributeTag *)tag;

/** Tests to see if group and element are the same */
- (BOOL)isEquaToTag:(DCMAttributeTag *)tag;

@end