Low level data access functions
[Low level access to single components]

---

Detailed Description

Data access per component.

Consider these as low level pfspd data access routines. There is no interpretation of the data, so these routines are more generic that all others. However, you can create files that cannot be processed by standard tools.

Typical use:

• Add extra component to standard pfspd files.
• Exotic applications applying functionality beyond standard.

Supported on (almost) all pfspd file formats. Therefore, these functions use less strict header checking.

For standard i/o: the component shall be accessed in the same order as the data is stored in the file. This corresponds with the order in the header. Furthermore, for interlaced files only the field access functions can be used. For file i/o these restriction do not apply.

In the following functions:

Parameters:

	comp	the component id. i.e. the index in the header structure.
	c_frm	pointer to frame buffer
	c_fld	pointer to field buffer

For this set of functions, specify read_mode as: read_mode = mem_data_fmt

The write mode is identical to the other functions: write_mode = mem_data_fmt

Functions
pT_status	p_read_field_comp (const char *filename, pT_header *header, int frame, int field, int comp, unsigned char *c_fld, int read_mode, int width, int fld_height, int stride)
pT_status	p_read_frame_comp (const char *filename, pT_header *header, int frame, int comp, unsigned char *c_frm, int read_mode, int width, int frm_height, int stride)
pT_status	p_write_field_comp (const char *filename, pT_header *header, int frame, int field, int comp, const unsigned char *c_fld, int width, int fld_height, int stride)
pT_status	p_write_frame_comp (const char *filename, pT_header *header, int frame, int comp, const unsigned char *c_frm, int width, int frm_height, int stride)
pT_status	p_read_field_comp_16 (const char *filename, pT_header *header, int frame, int field, int comp, unsigned short *c_fld, int read_mode, int width, int fld_height, int stride)
pT_status	p_read_frame_comp_16 (const char *filename, pT_header *header, int frame, int comp, unsigned short *c_frm, int read_mode, int width, int frm_height, int stride)
pT_status	p_write_field_comp_16 (const char *filename, pT_header *header, int frame, int field, int comp, const unsigned short *c_fld, int write_mode, int width, int fld_height, int stride)
pT_status	p_write_frame_comp_16 (const char *filename, pT_header *header, int frame, int comp, const unsigned short *c_frm, int write_mode, int width, int frm_height, int stride)

---

Function Documentation

pT_status p_read_field_comp (  const char *  filename, pT_header *  header, int  frame, int  field, int  comp, unsigned char *  c_fld, int  read_mode, int  width, int  fld_height, int  stride )

pT_status p_read_frame_comp (  const char *  filename, pT_header *  header, int  frame, int  comp, unsigned char *  c_frm, int  read_mode, int  width, int  frm_height, int  stride )

pT_status p_write_field_comp (  const char *  filename, pT_header *  header, int  frame, int  field, int  comp, const unsigned char *  c_fld, int  width, int  fld_height, int  stride )

pT_status p_write_frame_comp (  const char *  filename, pT_header *  header, int  frame, int  comp, const unsigned char *  c_frm, int  width, int  frm_height, int  stride )

pT_status p_read_field_comp_16 (  const char *  filename, pT_header *  header, int  frame, int  field, int  comp, unsigned short *  c_fld, int  read_mode, int  width, int  fld_height, int  stride )

pT_status p_read_frame_comp_16 (  const char *  filename, pT_header *  header, int  frame, int  comp, unsigned short *  c_frm, int  read_mode, int  width, int  frm_height, int  stride )

pT_status p_write_field_comp_16 (  const char *  filename, pT_header *  header, int  frame, int  field, int  comp, const unsigned short *  c_fld, int  write_mode, int  width, int  fld_height, int  stride )

pT_status p_write_frame_comp_16 (  const char *  filename, pT_header *  header, int  frame, int  comp, const unsigned short *  c_frm, int  write_mode, int  width, int  frm_height, int  stride )

---