DATAMANIP (ksegops) functions
LIBRARY ROUTINE
lkimportraw - import raw binary data into a data segment
LIBRARY CALL
int
lkimportraw(
kobject raw_obj,
kobject add_obj,
int arch,
int type,
char *seg,
int w,
int h,
int d,
int t,
int e,
int header_skip,
int colorspace,
kobject out_obj)
INPUT
- raw_obj - raw source data, must have been opened with the KOBJ_RAW flag
- add_obj - optional object to import the data into
- arch - source architecture of the raw data
- type - data type of the raw data
- seg - string defining which data segment to insert data into; if this is "Comment" then the data will be placed in the comment field of the output object (only up to the first NULL in the data)
w, h, d, t,
- e - size of raw data
- header_skip - skip this number of bytes before reading the data
- colorspace - colorspace for the data
OUTPUT
- out_obj - resulting destination object
RETURN VALUE
TRUE (1) on success, FALSE (0) otherwise
DESCRIPTION
lkimport_raw can be used to read raw binary data and import
it to a data segment. lkimportraw will either create an
object with the new segment in it or append the new
segment to the optionally supplied add_obj object.
Valid arch types are: KMACH_UNKNOWN, KMACH_LOCAL,
KMACH_LITTLE_ENDIAN_IEEE, KMACH_LITTLE_ENDIAN_VAX,
KMACH_LITTLE_ENDIAN_ALPHA, KMACH_BIG_ENDIAN_IEEE,
KMACH_BIG_ENDIAN_CRAY
Valid data types are: KBIT, KBYTE, KUBYTE, KSHORT, KUSHORT,
KINT, KUINT, KLONG, KULONG, KFLOAT, KDOUBLE, KCOMPLEX,
and KDCOMPLEX
Valid color space values are: KNONE, KNONE, KGREY, KRGB,
KCMY, KYIQ, KHSV, KHLS, KIHS, KXYZ, KUVW, KUCSUVW,
KUCSSOW, KUCSLab, KUCSLuv, KUSERDEFINED
The raw data is assumed to be in WHDTE index order.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DATAMANIP/objects/library/ksegops/src/lkimportraw.c
SEE ALSO
ksegops(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.