VPackByteToBit


 
Name
  VPackByteToBit - packs byte data into bit string.
 
Synopsis
  VPackByteToBit(idata, nbytes, odata)
  unsigned char *idata;
  int nbytes;
  unsigned char *odata;                 /*RETURN*/
 
Description
  VPackByteToBit packs byte data into a bit string. If the value of byte is
not 0, the corresponding bit is set to 1, else it is set to 0. The packing
order used by VPackByteToBit is most significant bit first.
 
Return Value
  0 - work successfully.
 
Parameters
  idata - specifies an array of data to be packed.
  nbytes - specifies the number of bytes to be packed.
  odata - returns an array of 1-bit packed data.
 
Side Efects
  None.
 
Entry Conditions
  If idata or odata is NULL, or nbytes is less than or equal to zero,
VPackByteToBit prints an error message to the standard error stream,
produces a core dump file and exits from the current process.
 
Related Functions
VDisplayOverlay.